Skip to main content
POST
/
agents
/
conversations
/
spans
Genai Conversation Spans
curl --request POST \
  --url https://api.example.com/agents/conversations/spans \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "conversation_ids": [
    "<string>"
  ],
  "started_after": "2023-11-07T05:31:56Z",
  "started_before": "2023-11-07T05:31:56Z"
}
'
{
  "conversations": [
    {
      "conversation_id": "<string>",
      "spans": [
        {
          "operation_name": "<string>",
          "trace_id": "<string>",
          "span_id": "<string>",
          "duration_ms": 123
        }
      ],
      "spans_feedback": [
        {
          "trace_id": "<string>",
          "tags": [
            "<string>"
          ],
          "ratings": [
            {
              "name": "<string>",
              "value": 123,
              "reason": "<string>",
              "confidence": 123
            }
          ]
        }
      ]
    }
  ]
}

Body

application/json

Request the span sequences for an explicit set of conversations.

Reads span scalar columns only (no message bodies) for the given conversation_ids. Powers the conversations-list spans minimap.

project_id
string
required
conversation_ids
string[]
Maximum array length: 10000
started_after
string<date-time> | null
started_before
string<date-time> | null

Response

Successful Response

Span sequences + feedback markers, one entry per requested conversation.

conversations
AgentConversationSpans · object[]