---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Traces"
description: "The `traces` collection of Sylphx Observability: A Trace is every span sharing one W3C trace id in a project environment."
type: reference
product: monitoring
summary: "A Trace is every span sharing one W3C trace id in a project environment."
updated: 2026-09-28
order: 900
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

A Trace is every span sharing one W3C trace id in a project environment. The id is `t` followed by the 32-hex trace id.

**Service** Sylphx Observability · **Resource type** `observability.sylphx.com/Trace` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/traces/{trace}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/traces/{trace}`. |
| `uid` | `string` | `trc_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `trace_id` | `string` | The W3C trace id (32 hex). Output only. |
| `root_span_name` | `string` | The root span's name. Output only. |
| `root_service_name` | `string` | The root span's service. Output only. |
| `start_time` | `timestamp` | The earliest span start. Output only. |
| `end_time` | `timestamp` | The latest span end. Output only. |
| `has_error` | `bool` | Whether any span has an error status. Output only. |
| `spans` | `Span[]` | Every span, in start order; empty in query results. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/traces#get) | Gets a trace. |
| `POST` | [`write_spans`](/docs/api/traces#write-spans) | Ingests a batch of spans atomically; a span's parent and time invariants are validated. Replay rules are those of WriteLogEntries. |
| `POST` | [`query`](/docs/api/traces#query) | Queries the environment's traces over a bounded interval, returning summaries without spans. |

## get

Gets a trace.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/traces/trace` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/traces/get)

## write_spans

Ingests a batch of spans atomically; a span's parent and time invariants are validated. Replay rules are those of WriteLogEntries.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/traces:writeSpans` · scope `observability:ingest` · effect `write` · [Request, response and examples](/docs/api/traces/write_spans)

## query

Queries the environment's traces over a bounded interval, returning summaries without spans.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/traces:query` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/traces/query)