Send Message to Agent

This endpoint sends a message to the specified agent to start or continue a task. The agent processes the message and returns a response. If the message contains a task ID that matches an ongoing task, the agent will continue that task; otherwise, it will start a new task.

POST /agents/{id}/v1/message:send

cURL

cURL

curl --request POST \
  --url https://api.{environment}.corti.app/agents/{id}/v1/message:send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-Name: <tenant-name>' \
  --data '
{
  "message": {
    "parts": [
      {
        "text": "<string>",
        "metadata": {}
      }
    ],
    "messageId": "<string>",
    "metadata": {},
    "extensions": [
      "<string>"
    ],
    "referenceTaskIds": [
      "<string>"
    ],
    "taskId": "<string>",
    "contextId": "<string>"
  },
  "configuration": {
    "acceptedOutputModes": [
      "<string>"
    ],
    "historyLength": 123,
    "blocking": true
  },
  "metadata": {}
}
'

200

{
  "message": {
    "parts": [
      {
        "text": "<string>",
        "metadata": {}
      }
    ],
    "messageId": "<string>",
    "metadata": {},
    "extensions": [
      "<string>"
    ],
    "referenceTaskIds": [
      "<string>"
    ],
    "taskId": "<string>",
    "contextId": "<string>"
  },
  "task": {
    "id": "<string>",
    "contextId": "<string>",
    "status": {
      "message": {
        "parts": [
          {
            "text": "<string>",
            "metadata": {}
          }
        ],
        "messageId": "<string>",
        "metadata": {},
        "extensions": [
          "<string>"
        ],
        "referenceTaskIds": [
          "<string>"
        ],
        "taskId": "<string>",
        "contextId": "<string>"
      },
      "timestamp": "2023-11-07T05:31:56Z"
    },
    "history": [
      {
        "parts": [
          {
            "text": "<string>",
            "metadata": {}
          }
        ],
        "messageId": "<string>",
        "metadata": {},
        "extensions": [
          "<string>"
        ],
        "referenceTaskIds": [
          "<string>"
        ],
        "taskId": "<string>",
        "contextId": "<string>"
      }
    ],
    "artifacts": [
      {
        "artifactId": "<string>",
        "parts": [
          {
            "text": "<string>",
            "metadata": {}
          }
        ],
        "name": "<string>",
        "description": "<string>",
        "metadata": {},
        "extensions": [
          "<string>"
        ]
      }
    ],
    "metadata": {}
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Tenant-Name · string · required

Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

Example:

"base"

Path Parameters

id · string · required

The identifier of the agent associated with the context.

Example:

"12345678-90ab-cdef-gh12-34567890abc"

Body

application/json

message · object · required

Show child attributes

configuration · object

Show child attributes

metadata · object

Optional metadata that will be associated with the message.

Response

200

application/json

Message processed successfully.

message · object

Show child attributes

task · object

Show child attributes