Messages

Returns a single conversation message by identifier. Requires messages:read and access to the conversation.

get/conversation-messages/{messageId}

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/conversation-messages/{messageId}
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

messageIdstring required

Message identifier.

Response

Message details.

authorWorkspaceMembershipIdstring required

Canonical author workspace membership identifier. Matches legacy author_id during the compatibility window.

author_idstring required

Author workspace member identifier. Deprecated: read authorWorkspaceMembershipId instead.

author_namestring nullable required

Author workspace member display name.

contentstring nullable required

Message markdown content.

conversation_idstring required

Conversation identifier.

conversation_namestring nullable required

Conversation name.

created_atstring date-time required

Message creation timestamp.

idstring required

Message identifier.

image_urlsstring[] required

Image URLs extracted from the message.

replies_countinteger required

Number of thread replies.

thread_root_idstring nullable

Root message identifier when this message is a thread reply; null for a top-level message. Pass it to GET /conversation-messages/{messageId}/replies to read the thread. Absent on older deployments.

Example response

{
  "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
  "created_at": "2026-05-14T08:00:00.000Z",
  "data": {
    "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "created_at": "2026-05-14T08:00:00.000Z",
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "attachments": [
      {
        "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
      }
    ],
    "forward_source": {
      "source_created_at": "2026-05-14T08:00:00.000Z"
    },
    "replied_to": {
      "message_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    }
  },
  "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status