v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

LLM Observability

Add annotation queue interactions

Add one or more interactions to an annotation queue. At least one interaction must be provided. Each interaction has a type:

trace, experiment_trace, session: content_id references the upstream entity; the server fetches the actual content.
display_block: omit content_id and provide the rendered content in display_block. The server generates content_id as a deterministic hash of the block list.

Items of different types can be mixed in a single request.

post/api/v2/llm-obs/v1/annotation-queues/{queue_id}/interactions

Path parameters

queue_idstring required

The ID of the LLM Observability annotation queue.

Request body

Example request

{
  "data": {
    "attributes": {
      "interactions": [
        {
          "content_id": "trace-abc-123",
          "type": "trace"
        }
      ]
    },
    "type": "interactions"
  }
}

Response

Created

Example response

{
  "data": {
    "attributes": {
      "interactions": [
        {
          "already_existed": false,
          "content_id": "trace-abc-123",
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "trace"
        }
      ]
    },
    "id": "00000000-0000-0000-0000-000000000001",
    "type": "interactions"
  }
}