trace

Log Traces

Changed on Oct 15, 2026

post/v2/projects/{project_id}/traces

Request

Base URL
https://api.galileo.ai
URL
https://api.galileo.ai/v2/projects/{project_id}/traces
Auth
- API key in header Splunk-AO-API-Key
- or API key in header Galileo-API-Key
- or OAuth 2
  Password
  Token URL: https://api.galileo.ai/login
- or HTTP basic

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 durably accepted or return an error message if there is an ingestion failure. On the streaming write path (kafka_metrics_pipeline) accepted means acknowledged by Kafka; the records become readable after the data-writer flush, about GALILEO_STREAMING_EXPECTED_LAG_SECONDS (default 2.5 s) later, so a read issued immediately after the response can miss them.

session_idstring uuid4 nullable

Session id associated with the traces.

session_external_idstring nullable

External id of the session (e.g., OTEL session.id from span attributes).

is_completeboolean

Whether or not the records in this request are complete.

include_trace_idsboolean

If True, include the list of ingested trace IDs in the response.

Example request

{
  "log_stream_id": "00000000-0000-0000-0000-000000000000",
  "session_id": "00000000-0000-0000-0000-000000000000",
  "traces": [
    {
      "created_at": "2026-10-26T14:47:19.014066Z",
      "dataset_metadata": {},
      "input": "who is a smart LLM?",
      "metrics": {},
      "name": "",
      "output": "I am!",
      "spans": [
        {
          "created_at": "2026-10-26T14:47:19.014013Z",
          "dataset_metadata": {},
          "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": "trace",
      "user_metadata": {}
    }
  ]
}

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

traces_countinteger required

total number of traces ingested

spans_countinteger required

total number of spans ingested

trace_idsstring[] nullable

List of trace IDs that were ingested. Only included if include_trace_ids=True in request.

Changes

Oct 15, 2026cdaf9547c14d Revision changes
- info
  added the new retriever_call enum value to the request property //////////////////
- info
  added the new retriever_call enum value to the request property /////////////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property //////////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property //////////////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property //////////////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property /////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property //////////////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property /////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property ///////////////
- info
  added the new retriever_call enum value to the request property /////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property /////////
- info
  added the new retriever_call enum value to the request property ////////////
- info
  added the new retriever_call enum value to the request property //////
- info
  added the new retriever_call enum value to the request property /////////
- info
  added the new session_call enum value to the request property //////////////////
- info
  added the new session_call enum value to the request property /////////////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property //////////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property //////////////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property //////////////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property /////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property //////////////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property /////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property ///////////////
- info
  added the new session_call enum value to the request property /////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property /////////
- info
  added the new session_call enum value to the request property ////////////
- info
  added the new session_call enum value to the request property //////
- info
  added the new session_call enum value to the request property /////////
- info
  added the new trace_call enum value to the request property //////////////////
- info
  added the new trace_call enum value to the request property /////////////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property //////////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property //////////////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property //////////////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property /////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property //////////////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property /////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property ///////////////
- info
  added the new trace_call enum value to the request property /////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property /////////
- info
  added the new trace_call enum value to the request property ////////////
- info
  added the new trace_call enum value to the request property //////
- info
  added the new trace_call enum value to the request property /////////
Sep 18, 202620760c217c4f Revision changes
- info
  added the new optional request property //

Operation history (6 revisions)