trace

Log Spans

post/projects/{project_id}/spans

Path parameters

project_idstring uuid4 required

Request body

log_stream_idstring uuid4 nullable

Log stream id associated with the traces.

experiment_idstring uuid4 nullable

Experiment id associated with the traces.

metrics_testing_idstring uuid4 nullable

Metrics testing id associated with the traces.

logging_method'playground' | 'python_client' | 'typescript_client' | 'api_direct'

client_versionstring nullable

reliableboolean

Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure.

trace_idstring uuid4 required

Trace id associated with the spans.

parent_idstring uuid4 required

Parent trace or span id.

Example request

{
  "log_stream_id": "00000000-0000-0000-0000-000000000000",
  "parent_id": "11000011-0000-0000-0000-110000110000",
  "spans": [
    {
      "created_at": "2026-08-24T20:58:23.609159Z",
      "dataset_metadata": {},
      "input": "who is a smart LLM?",
      "metrics": {},
      "name": "",
      "output": "I am!",
      "spans": [
        {
          "created_at": "2026-08-24T20:58:23.598811Z",
          "dataset_metadata": {},
          "id": "22222222-2222-4222-a222-222222222222",
          "input": [
            {
              "content": "Question: who is a smart LLM?",
              "role": "user"
            }
          ],
          "metrics": {},
          "name": "",
          "output": {
            "content": "I am!",
            "role": "user"
          },
          "tags": [],
          "type": "llm",
          "user_metadata": {}
        }
      ],
      "tags": [],
      "type": "workflow",
      "user_metadata": {}
    }
  ],
  "trace_id": "11000011-0000-0000-0000-110000110000"
}

Response

Successful Response

log_stream_idstring uuid4 nullable

Log stream id associated with the traces.

experiment_idstring uuid4 nullable

Experiment id associated with the traces.

metrics_testing_idstring uuid4 nullable

Metrics testing id associated with the traces.

project_idstring uuid4 required

Project id associated with the traces.

project_namestring required

Project name associated with the traces.

session_idstring uuid4 nullable

Session id associated with the traces.

records_countinteger required

Total number of records ingested

trace_idstring uuid4 required

Trace id associated with the spans.

parent_idstring uuid4 required

Parent trace or span id.

Changes

Changed in 3 of the 14 revisions of this API.18

Aug 13, 2026344acdc36dbb16See the full diff
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #2: WorkflowSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #4: RetrieverSpan]/spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
- ○
  added the new optional request property spans/items/oneOf[subschema #5: ToolSpan]/spans/items/oneOf[subschema #3: LlmSpan]/provider
  new-optional-request-property
This revision also has 44 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 5, 20261f7a6a4a81ad1See the full diff
- ○
  added the new optional request property spans/items/oneOf[subschema #1: AgentSpan]/agent_name
  new-optional-request-property
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 26, 202605003e7835a21See the full diff
- ○
  the endpoint scheme security ClassicAPIKeyHeader was added to the API
  api-security-added
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history