v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

LLM Observability

Get annotated interactions by content IDs

Returns annotated interactions across all annotation queues for the given content IDs. Results include queue metadata (ID and name) for each interaction.

get/api/v2/llm-obs/v1/annotated-interactions

Query parameters

contentIdsstring[] required

One or more content IDs to retrieve annotated interactions for. At least one is required.

offsetinteger

Pagination offset. Must be >= 0. Defaults to 0.

limitinteger

Maximum number of results to return. Must be > 0. Defaults to 100.

Response

Example response

{
  "data": {
    "attributes": {
      "annotated_interactions": [
        {
          "annotations": [
            {
              "created_at": "2024-01-15T10:30:00Z",
              "created_by": "00000000-0000-0000-0000-000000000002",
              "id": "annotation-789",
              "interaction_id": "interaction-456",
              "modified_at": "2024-01-15T10:30:00Z",
              "modified_by": "00000000-0000-0000-0000-000000000002"
            }
          ],
          "content_id": "trace-abc-123",
          "created_at": "2025-06-01T12:00:00Z",
          "display_block": [
            {
              "alt": "Example image",
              "content": "## Triage Instructions",
              "height": 240,
              "interactionType": "trace",
              "label": "Triage Instructions",
              "level": "md",
              "tileDef": {
                "requests": [
                  {
                    "queries": [
                      {
                        "data_source": "metrics",
                        "name": "q",
                        "query": "avg:system.cpu.user{*}"
                      }
                    ],
                    "response_format": "timeseries",
                    "type": "line"
                  }
                ],
                "viz": "timeseries"
              },
              "timeFrame": {
                "end": 1705315800000,
                "start": 1705312200000
              },
              "traceId": "69fcc2bb0000000003113989d83069ba",
              "type": "markdown",
              "url": "https://example.com/image.png"
            }
          ],
          "id": "interaction-456",
          "modified_at": "2025-06-01T12:00:00Z",
          "queue_id": "queue-uuid-001",
          "queue_name": "My Annotation Queue",
          "type": "trace"
        }
      ],
      "total_count": 1
    },
    "id": "trace-query",
    "type": "annotated_interactions_by_trace"
  }
}