Post apiv1projects aiagents threads messages

POST /api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads/{threadUuid}/messages

Error

A valid request URL is required to generate request examples

200

{
  "results": {
    "hidden": true,
    "steers": [
      {
        "consumedStep": 123,
        "consumedAt": "<string>",
        "createdAt": "<string>",
        "message": "<string>",
        "promptUuid": "<string>",
        "uuid": "<string>"
      }
    ],
    "context": [
      {
        "runtimeOverrides": {
          "dateZoom": {
            "xAxisFieldId": "<string>"
          },
          "dashboardParameters": {},
          "dashboardFilters": {
            "tableCalculations": [
              {
                "id": "<string>",
                "target": {
                  "tableName": "<string>",
                  "fieldId": "<string>",
                  "isSqlColumn": true
                },
                "values": [
                  "<unknown>"
                ],
                "settings": "<unknown>",
                "disabled": true,
                "required": true,
                "caseSensitive": true,
                "lockedTabUuids": [
                  "<string>"
                ],
                "singleValue": true,
                "label": "<string>",
                "tileTargets": {}
              }
            ],
            "metrics": [
              {
                "id": "<string>",
                "target": {
                  "tableName": "<string>",
                  "fieldId": "<string>",
                  "isSqlColumn": true
                },
                "values": [
                  "<unknown>"
                ],
                "settings": "<unknown>",
                "disabled": true,
                "required": true,
                "caseSensitive": true,
                "lockedTabUuids": [
                  "<string>"
                ],
                "singleValue": true,
                "label": "<string>",
                "tileTargets": {}
              }
            ],
            "dimensions": [
              {
                "id": "<string>",
                "target": {
                  "tableName": "<string>",
                  "fieldId": "<string>",
                  "isSqlColumn": true
                },
                "values": [
                  "<unknown>"
                ],
                "settings": "<unknown>",
                "disabled": true,
                "required": true,
                "caseSensitive": true,
                "lockedTabUuids": [
                  "<string>"
                ],
                "singleValue": true,
                "label": "<string>",
                "tileTargets": {}
              }
            ]
          }
        },
        "displayName": "<string>",
        "pinnedVersionUuid": "<string>",
        "chartSlug": "<string>",
        "chartUuid": "<string>",
        "type": "chart"
      }
    ],
    "user": {
      "name": "<string>",
      "uuid": "<string>"
    },
    "createdAt": "<string>",
    "message": "<string>",
    "threadUuid": "<string>",
    "uuid": "<string>",
    "role": "user"
  },
  "status": "ok"
}

Path Parameters

projectUuid · string · required

agentUuid · string · required

threadUuid · string · required

Body

application/json

prompt · string · required

hidden · boolean

Inject the prompt as a hidden turn — the agent responds to it, but the UI does not render the user bubble. Used by the post-merge content-migration prompt sent from the writeback PR card.

modelConfig · object

Show child attributes

context · object[]

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Show child attributes

Response

200

application/json

Success

results · object · required

Show child attributes

status · enum<string> · required

Available options: ok