> ## Documentation Index > Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get trace details > Get detailed trace information with all spans in tree structure ## OpenAPI ````yaml https://control-plane.kubiya.ai/api/openapi.json get /api/v1/traces/{trace_id} openapi: 3.1.0 info: title: Agent Control Plane API description: Multi-tenant agent orchestration with Temporal workflows version: 1.0.0 servers: [] security: - BearerAuth: [] tags: - name: health description: πŸ₯ **Health & Status** - Check API health and availability - name: authentication description: πŸ” **Authentication** - Token validation and auth management - name: agents description: πŸ€– **Agents** - Create and manage AI agents with custom capabilities - name: skills description: πŸ› οΈ **Tool Sets** - Manage agent skills and tool configurations - name: integrations description: πŸ”Œ **Integrations** - Connect to external services (Kubiya managed) - name: custom-integrations description: >- βš™οΈ **Custom Integrations** - User-defined integration instances with env vars, secrets, and files - name: integration-templates description: >- πŸ“¦ **Integration Templates** - Pre-configured templates for common services (PostgreSQL, Redis, MongoDB, etc.) - name: secrets description: πŸ”‘ **Secrets** - Secure credential storage and retrieval - name: teams description: πŸ‘₯ **Teams** - Team management and collaboration - name: workflows description: πŸ“Š **Workflows** - Multi-step automation and orchestration - name: executions description: ▢️ **Executions** - Track and monitor workflow runs - name: jobs description: ⏰ **Jobs** - Scheduled and webhook-triggered tasks - name: policies description: πŸ›‘οΈ **Policies** - Access control and security policies - name: analytics description: πŸ“ˆ **Analytics** - Usage metrics and performance monitoring - name: projects description: πŸ“ **Projects** - Project organization and management - name: environments description: 🌍 **Environments** - Environment configuration (dev, staging, prod) - name: models description: 🧠 **Models** - LLM model configuration and management - name: runtimes description: ⚑ **Runtimes** - Agent execution runtime environments - name: workers description: πŸ‘· **Workers** - Worker registration and heartbeat monitoring - name: storage description: πŸ’Ύ **Storage** - File storage and cloud integration - name: context-graph description: πŸ•ΈοΈ **Context Graph** - Knowledge graph and context management - name: temporal-workflows description: >- βš™οΈ **Temporal Workflows** - Background workflows for context graph ingestion, connector operations, and scheduled jobs - name: templates description: πŸ“ **Templates** - Reusable configuration templates paths: /api/v1/traces/{trace_id}: get: summary: Get trace details description: Get detailed trace information with all spans in tree structure operationId: get_trace_api_v1_traces__trace_id__get parameters: - name: trace_id in: path required: true schema: type: string title: Trace Id - name: flat in: query required: false schema: type: boolean description: Return spans as flat list instead of tree default: false title: Flat description: Return spans as flat list instead of tree responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TraceDetailResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: TraceDetailResponse: properties: id: type: string title: Id trace_id: type: string title: Trace Id organization_id: type: string title: Organization Id name: type: string title: Name service_name: anyOf: - type: string - type: 'null' title: Service Name status: $ref: '#/components/schemas/TraceStatus' execution_id: anyOf: - type: string - type: 'null' title: Execution Id execution_type: anyOf: - type: string - type: 'null' title: Execution Type user_id: anyOf: - type: string - type: 'null' title: User Id user_email: anyOf: - type: string - type: 'null' title: User Email user_name: anyOf: - type: string - type: 'null' title: User Name user_avatar: anyOf: - type: string - type: 'null' title: User Avatar started_at: type: string format: date-time title: Started At ended_at: anyOf: - type: string format: date-time - type: 'null' title: Ended At duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms span_count: type: integer title: Span Count default: 0 error_count: type: integer title: Error Count default: 0 created_at: type: string format: date-time title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At spans: items: $ref: '#/components/schemas/SpanResponse' type: array title: Spans type: object required: - id - trace_id - organization_id - name - status - started_at - created_at title: TraceDetailResponse description: Detailed trace response with spans HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TraceStatus: type: string enum: - success - error - running title: TraceStatus description: Trace status enum SpanResponse: properties: id: type: string title: Id trace_id: type: string title: Trace Id span_id: type: string title: Span Id parent_span_id: anyOf: - type: string - type: 'null' title: Parent Span Id organization_id: type: string title: Organization Id name: type: string title: Name kind: $ref: '#/components/schemas/SpanKind' status_code: $ref: '#/components/schemas/SpanStatusCode' status_message: anyOf: - type: string - type: 'null' title: Status Message start_time_unix_nano: type: integer title: Start Time Unix Nano end_time_unix_nano: anyOf: - type: integer - type: 'null' title: End Time Unix Nano duration_ns: anyOf: - type: integer - type: 'null' title: Duration Ns duration_ms: anyOf: - type: number - type: 'null' title: Duration Ms attributes: additionalProperties: true type: object title: Attributes resource_attributes: additionalProperties: true type: object title: Resource Attributes events: items: additionalProperties: true type: object type: array title: Events links: items: additionalProperties: true type: object type: array title: Links created_at: type: string format: date-time title: Created At children: items: $ref: '#/components/schemas/SpanResponse' type: array title: Children type: object required: - id - trace_id - span_id - organization_id - name - kind - status_code - start_time_unix_nano - created_at title: SpanResponse description: Span response schema ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError SpanKind: type: string enum: - INTERNAL - SERVER - CLIENT - PRODUCER - CONSUMER title: SpanKind description: OTEL span kind enum SpanStatusCode: type: string enum: - UNSET - OK - ERROR title: SpanStatusCode description: OTEL span status code enum securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Enter your Kubiya API token (format: Bearer )' ````