POST
/
delphi
/
workflow
curl --request POST \
  --url https://app.delphihq.com/api/delphi/workflow \
  --header 'Content-Type: application/json' \
  --header 'X-CLIENT-ID: <api-key>' \
  --header 'X-PUBLIC-TOKEN: <api-key>' \
  --data '{
  "message": "<string>",
  "conversation": [
    {
      "author": "delphi",
      "text": "<string>"
    }
  ],
  "data": {},
  "colors": {
    "primary": "<string>",
    "secondary": "<string>"
  },
  "conversationId": "<string>",
  "userId": "<string>"
}'
{
  "conversationId": "<string>"
}

​
Authentication

This route can be called from the frontend, so authentication is slightly different than other routes.

To do so, include an X-PUBLIC-TOKEN header instead of your usual API key. This is combined with a JWT which represents the user’s RBAC permissions in your Delphi semantic layer.

{
  "headers": {
    "X-CLIENT-ID": "delphi-labs",
    "X-PUBLIC-TOKEN": "pt_1234567890abcdefghijklmnopq"
    "X-CUBE-JWT": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...."
  }
}

Authorizations

​
X-CLIENT-ID
string
header
required
​
X-PUBLIC-TOKEN
string
header
required

Body

application/json
​
message
string
required
​
conversation
object[]
required
​
data
object
​
colors
object
​
conversationId
string
​
userId
string

Response

200 - application/json-seq
Workflow
​
conversationId
string