Retrieve an Organization's AI Conversation

GET /api/0/organizations/{organization_id_or_slug}/agents/conversations/{conversation_id}/

Return spans recorded for one AI conversation in start-time order.

Experimental: This API is under active development and may change.

Message, tool, and response attributes contain their recorded string values. Without an explicit range, Sentry widens the search across available retention. A missing conversation returns an empty spans list.

Path Parameters

organization_id_or_slug (string)
REQUIRED

The ID or slug of the organization the resource belongs to.

conversation_id (string)
REQUIRED

Conversation ID recorded in gen_ai.conversation.id.

Query Parameters:

project (array(undefined))

The IDs or slugs of projects to filter by. Project slugs are unique within each organization. Omit this parameter to include all accessible projects. -1 is also accepted to include all accessible projects. For example, the following are valid parameters:

  • /?project=1234&project=56789
  • /?project=android&project=javascript-react
  • /?project=-1
environment (array(string))

The name of environments to filter by.

statsPeriod (string)

The period of time for the query, will override the start & end parameters, a number followed by one of:

  • d for days
  • h for hours
  • m for minutes
  • s for seconds
  • w for weeks

For example, 24h, to mean query data starting from 24 hours ago to now.

start (string)

The start of the period of time for the query, expected in ISO-8601 format. For example, 2001-12-14T12:34:56.7890.

end (string)

The end of the period of time for the query, expected in ISO-8601 format. For example, 2001-12-14T12:34:56.7890.

cursor (string)

A pointer to the last object fetched and its sort order; used to retrieve the next or previous results.

per_page (integer)

Number of spans to return per page. Defaults to 100; maximum is 1,000.

Scopes

<auth_token> requires one of the following scopes:
  • org:admin
  • org:read
  • org:write
Copied
curl https://sentry.io/api/0/organizations/{organization_id_or_slug}/agents/conversations/{conversation_id}/ \
 -H 'Authorization: Bearer <auth_token>'
RESPONSESCHEMA
Copied
.
Was this helpful?