Log Traces

POST

projects

{project_id}

traces

curl --request POST \
  --url https://api.acme.rungalileo.io/v2/projects/{project_id}/traces \
  --header 'Content-Type: application/json' \
  --header 'Galileo-API-Key: <api-key>' \
  --data '{
  "log_stream_id": "00000000-0000-0000-0000-000000000000",
  "traces": [
    {
      "created_at": "2025-04-16T18:15:38.893846Z",
      "input": "who is a smart LLM?",
      "metrics": {},
      "name": "",
      "output": "I am!",
      "spans": [
        {
          "created_at": "2025-04-16T18:15:38.893795Z",
          "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": {}
    }
  ]
}'

{
  "log_stream_id": "<string>",
  "experiment_id": "<string>",
  "project_id": "<string>",
  "project_name": "<string>",
  "traces_count": 123,
  "records_count": 123
}

Authorizations

Galileo-API-Key

string

header

required

Path Parameters

project_id

string

required

Body

application/json

traces

object[]

required

List of traces to log.

traces.input

string

required

Input to the trace or span.

traces.type

string

default:trace

Type of the trace or span.

Allowed value: "trace"

traces.output

string | null

Output of the trace or span.

traces.name

string

default:

Name of the trace or span.

traces.created_at

string

Timestamp of the trace or span's creation.

traces.user_metadata

object

Metadata associated with this trace or span.

traces.tags

string[]

Tags associated with this trace or span.

traces.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

traces.metrics

object

Metrics associated with this trace or span.

traces.spans

object[]

Child spans.

traces.spans.input

required

Input to the trace or span.

traces.spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

traces.spans.output

Output of the trace or span.

traces.spans.name

string

default:

Name of the trace or span.

traces.spans.created_at

string

Timestamp of the trace or span's creation.

traces.spans.user_metadata

object

Metadata associated with this trace or span.

traces.spans.tags

string[]

Tags associated with this trace or span.

traces.spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

traces.spans.metrics

object

Metrics associated with this trace or span.

traces.spans.spans

object[]

Child spans.

traces.spans.spans.input

required

Input to the trace or span.

traces.spans.spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

traces.spans.spans.output

Output of the trace or span.

traces.spans.spans.name

string

default:

Name of the trace or span.

traces.spans.spans.created_at

string

Timestamp of the trace or span's creation.

traces.spans.spans.user_metadata

object

Metadata associated with this trace or span.

traces.spans.spans.tags

string[]

Tags associated with this trace or span.

traces.spans.spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

traces.spans.spans.metrics

object

Metrics associated with this trace or span.

traces.spans.spans.spans

object[]

Child spans.

log_stream_id

string | null

Log stream id associated with the traces.

experiment_id

string | null

Experiment id associated with the traces.

logging_method

enum<string>

Available options:

playground,

python_client,

typescript_client,

api_direct

client_version

string | null

reliable

boolean

default:false

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.

Response

200

application/json

Successful Response

project_id

string

required

Project id associated with the traces.

project_name

string

required

Project name associated with the traces.

traces_count

integer

required

total number of traces ingested

records_count

integer

required

total number of records (traces & spans) ingested

log_stream_id

string | null

Log stream id associated with the traces.

experiment_id

string | null

Experiment id associated with the traces.

Was this page helpful?

Suggest edits Raise issue

Invoke Traces Available Columns

curl --request POST \
  --url https://api.acme.rungalileo.io/v2/projects/{project_id}/traces \
  --header 'Content-Type: application/json' \
  --header 'Galileo-API-Key: <api-key>' \
  --data '{
  "log_stream_id": "00000000-0000-0000-0000-000000000000",
  "traces": [
    {
      "created_at": "2025-04-16T18:15:38.893846Z",
      "input": "who is a smart LLM?",
      "metrics": {},
      "name": "",
      "output": "I am!",
      "spans": [
        {
          "created_at": "2025-04-16T18:15:38.893795Z",
          "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": {}
    }
  ]
}'

{
  "log_stream_id": "<string>",
  "experiment_id": "<string>",
  "project_id": "<string>",
  "project_name": "<string>",
  "traces_count": 123,
  "records_count": 123
}

API Reference

health

auth

evaluate

observe

protect

trace

log_stream

experiment

Webhooks

Authorizations

Path Parameters

Body

Response