List Conversation Messages

This endpoint returns the messages of a Cortex conversation, oldest first.

Important Notes

  • Requires conversations:read scope.
  • {id} is a conversation of a lead (GET /v3/leads/{id}/conversations). A conversation of another company responds 404, the same as one that does not exist.
  • content is the text exactly as Cortex stores it. It contains the client's personal data, like any conversation in AgendaPro.

Errors Dictionary

StatusErrorDetailDescription
400invalid_formatlimitlimit is not an integer.
400invalid_rangelimitlimit is out of the allowed range.
400invalid_formatcursorcursor is not a cursor returned by this list.
400invalid_paramsparamsAnother parameter is invalid.
401unauthorizedinvalid_api_keyMissing or invalid Bearer token.
401unauthorizedapi_config_inactiveAPI access is inactive for this company.
403forbiddenscope_deniedAPI key lacks conversations:read scope.
403forbiddencompany_not_enabledThe company is not enabled to read Cortex data through this API. Contact AgendaPro to enable it; retrying does not help.
404not_foundconversationConversation not found, or it belongs to another company.
429rate_limitedburst_limit_exceededPer-minute request limit exceeded.
429rate_limiteddaily_quota_exceededDaily request quota exceeded.
502upstream_unavailableThe upstream service is unavailable.
502upstream_unavailableupstream_misconfiguredAgendaPro's internal connection to Cortex is misconfigured. It is not a problem with your API key; retry later or contact support.
502upstream_unavailableupstream_errorCortex answered an error. Retry the same request later.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Conversation unique identifier (Cortex), as returned by GET /v3/leads/{id}/conversations.

Query Params
string

Opaque cursor from pagination.next_cursor of the previous page. Omit it for the first page.

integer
1 to 100
Defaults to 50

Records per page (defaults to 50, max 100).

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json