Invoke

Invoke chat workflow (ag-ui-trigger only)

post

https://actions.voxity.aihttps://actions.dev.voxity.ai

/chat/agents/{agentId}/invoke

Proxies invocation to the real workflow invoke using the published version. Only supports workflows with ag-ui-trigger.

Path parameters

agentIdstring · min: 1Required

The agent identifier

Body

application/json

Other propertiesanyOptional

Responses

200

Successful workflow invocation

application/json

202

Workflow started (SSE mode)

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

/chat/agents/{agentId}/invoke

HTTPcURLJavaScriptPython

POST /chat/agents/{agentId}/invoke HTTP/1.1
Host: actions.voxity.ai
Content-Type: application/json
Accept: */*
Content-Length: 205

{
  "input": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "config": {
    "configurable": {
      "threadId": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "versionId": "text",
  "workflowId": "text",
  "threadId": "text",
  "output": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "runStartContext": {
    "input": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "messages": [
      {
        "id": "text",
        "role": "user",
        "content": "text"
      }
    ]
  },
  "metadata": {
    "sseUrl": "text",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "status": "text",
  "id": "text",
  "createdAt": "2025-12-13T02:28:31.395Z",
  "updatedAt": "2025-12-13T02:28:31.395Z"
}