Skip to main content
POST
/
api
/
v1
/
tap
/
brainstorm
Brainstorm chat (AI)
curl --request POST \
  --url http://localhost:8080/api/v1/tap/brainstorm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "messages": [
    {
      "role": "user",
      "content": "<string>"
    }
  ],
  "currentDescription": "<string>"
}
'
{
  "reply": "<string>",
  "description": "<string>",
  "suggestedEnvVars": [
    "<string>"
  ]
}

Authorizations

x-api-key
string
header
required

Optional API key for authentication (enabled via application.yaml)

Body

application/json
messages
object[]
required
currentDescription
string

Current draft instruction (optional context for the AI)

Response

200 - application/json

Updated chat reply, instruction draft, and suggested env vars

reply
string

The AI's next chat message

description
string

Updated draft instruction the UI should sync into the instruction box

suggestedEnvVars
string[]

Environment variable names the script will need (excludes platform-injected DATRIS_* vars)