Messages

Get Conversation Messages

get

Get all messages for a specific conversation branch.

The branch is determined by the conversation's last_message_id.

Authorizations

APIKeyHeader

X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters

conversation_idstringRequired

project_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/projects/{project_id}/conversations/{conversation_id}/messages

HTTPcURLJavaScriptPython

GET /projects/{project_id}/conversations/{conversation_id}/messages HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "text",
      "type": "message",
      "created_at": 1,
      "parent_id": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "conversation_id": "text",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "text"
        }
      ],
      "attachments": [
        {
          "id": "text",
          "type": "image",
          "name": "text",
          "content_type": "text",
          "url": "text"
        }
      ]
    }
  ],
  "has_more": true,
  "first_id": "text",
  "last_id": "text"
}

Append Messages Sso

post

Append multiple messages to a given conversation.

If the conversation does not exist, it will be created with the first messages.

Args: conversation_id: ID of the conversation to append messages to project_id: ID of the project the conversation belongs to body: AppendMessagesBody message_service: Message service dependency conversation_service: Conversation service dependency

Returns: The list of appended messages

Authorizations

APIKeyHeader

X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters

conversation_idstring · uuidRequired

project_idstringRequired

Body

application/json

user_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/projects/{project_id}/conversations/{conversation_id}/messages

HTTPcURLJavaScriptPython

POST /projects/{project_id}/conversations/{conversation_id}/messages HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 346

{
  "messages": [
    {
      "id": "text",
      "type": "message",
      "created_at": "2026-01-29T16:14:26.930Z",
      "parent_id": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "conversation_id": "text",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "text"
        }
      ],
      "attachments": [
        {
          "id": "text",
          "type": "image",
          "name": "text",
          "content_type": "text",
          "url": "text"
        }
      ]
    }
  ],
  "user_id": "text"
}

[
  {
    "id": "text",
    "type": "message",
    "created_at": 1,
    "parent_id": "text",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "conversation_id": "text",
    "role": "user",
    "content": [
      {
        "type": "text",
        "text": "text"
      }
    ],
    "attachments": [
      {
        "id": "text",
        "type": "image",
        "name": "text",
        "content_type": "text",
        "url": "text"
      }
    ]
  }
]

Get Conversation Messages Sso

get

Get all messages for a specific conversation branch.

The branch is determined by the conversation's last_message_id.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

Path parameters

conversation_idstringRequired

project_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/projects/{project_id}/conversations/sso/{conversation_id}/messages

HTTPcURLJavaScriptPython

GET /projects/{project_id}/conversations/sso/{conversation_id}/messages HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "text",
      "type": "message",
      "created_at": 1,
      "parent_id": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "conversation_id": "text",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "text"
        }
      ],
      "attachments": [
        {
          "id": "text",
          "type": "image",
          "name": "text",
          "content_type": "text",
          "url": "text"
        }
      ]
    }
  ],
  "has_more": true,
  "first_id": "text",
  "last_id": "text"
}

Append Messages

post

Append multiple messages to a given conversation.

If the conversation does not exist, it will be created with the first messages.

Args: conversation_id: ID of the conversation to append messages to project_id: ID of the project the conversation belongs to body: AppendMessagesBody message_service: Message service dependency conversation_service: Conversation service dependency

Returns: The list of appended messages

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

conversation_idstring · uuidRequired

project_idstringRequired

Body

application/json

user_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/projects/{project_id}/conversations/sso/{conversation_id}/messages

HTTPcURLJavaScriptPython

POST /projects/{project_id}/conversations/sso/{conversation_id}/messages HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 346

{
  "messages": [
    {
      "id": "text",
      "type": "message",
      "created_at": "2026-01-29T16:14:26.930Z",
      "parent_id": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "conversation_id": "text",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "text"
        }
      ],
      "attachments": [
        {
          "id": "text",
          "type": "image",
          "name": "text",
          "content_type": "text",
          "url": "text"
        }
      ]
    }
  ],
  "user_id": "text"
}

[
  {
    "id": "text",
    "type": "message",
    "created_at": 1,
    "parent_id": "text",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "conversation_id": "text",
    "role": "user",
    "content": [
      {
        "type": "text",
        "text": "text"
      }
    ],
    "attachments": [
      {
        "id": "text",
        "type": "image",
        "name": "text",
        "content_type": "text",
        "url": "text"
      }
    ]
  }
]

Update Message Feedback

patch

Authorizations

APIKeyHeader

X-API-KeystringRequired

API Key. Learn how to get it.

Path parameters

project_idstringRequired

message_idstringRequired

Body

application/json

typestring · enumRequiredPossible values:

commentany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Responseany of

or

422

Validation Error

application/json

patch

/projects/{project_id}/messages/{message_id}/feedback

HTTPcURLJavaScriptPython

PATCH /projects/{project_id}/messages/{message_id}/feedback HTTP/1.1
Host: api.stack-ai.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "type": "positive",
  "comment": "text"
}

{
  "id": "text",
  "type": "message",
  "created_at": 1,
  "parent_id": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "conversation_id": "text",
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ],
  "attachments": [
    {
      "id": "text",
      "type": "image",
      "name": "text",
      "content_type": "text",
      "url": "text"
    }
  ]
}

Update Message Feedback Sso

patch

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_idstringRequired

message_idstringRequired

Query parameters

tokenstringRequired

Token for authorization

Body

application/json

typestring · enumRequiredPossible values:

commentany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Responseany of

or

422

Validation Error

application/json

patch

/projects/{project_id}/messages/sso/{message_id}/feedback

HTTPcURLJavaScriptPython

PATCH /projects/{project_id}/messages/sso/{message_id}/feedback?token=text HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "type": "positive",
  "comment": "text"
}

{
  "id": "text",
  "type": "message",
  "created_at": 1,
  "parent_id": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "conversation_id": "text",
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ],
  "attachments": [
    {
      "id": "text",
      "type": "image",
      "name": "text",
      "content_type": "text",
      "url": "text"
    }
  ]
}