---
title: "POST /tracer/observation-span/create_otel_span/"
method: POST
path: "/tracer/observation-span/create_otel_span/"
tags: ["tracer"]
---

# POST /tracer/observation-span/create_otel_span/

`POST /tracer/observation-span/create_otel_span/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/observation-span/create_otel_span/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Request body

- ObservationSpan
  - `id` string
  - `project` string, uuid, required
  - `project_version` string, uuid
  - `trace` string, uuid, required
  - `parent_span_id` string, nullable
  - `name` string, required
  - `observation_type` 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'agent' | 'reranker' | 'unknown' | 'guardrail' | 'evaluator' | 'conversation', required
  - `start_time` string, date-time, nullable
  - `end_time` string, date-time, nullable
  - `input` object, nullable
  - `output` object, nullable
  - `model` string, nullable
  - `model_parameters` object, nullable
  - `latency_ms` integer, nullable
  - `org_id` string, uuid, nullable
  - `org_user_id` string, uuid, nullable
  - `prompt_tokens` integer, nullable
  - `completion_tokens` integer, nullable
  - `total_tokens` integer, nullable
  - `response_time` number, nullable
  - `eval_id` string, nullable
  - `cost` number, nullable
  - `status` 'UNSET' | 'OK' | 'ERROR', nullable
  - `status_message` string, nullable
  - `tags` object, nullable
  - `metadata` object, nullable
  - `span_events` object, nullable
  - `provider` string, nullable
  - `provider_logo` string
  - `span_attributes` string
  - `custom_eval_config` string, uuid, nullable
  - `eval_status` 'NotStarted' | 'Queued' | 'Running' | 'Completed' | 'Editing' | 'Inactive' | 'Failed' | 'PartialRun' | 'ExperimentEvaluation' | 'Uploading' | 'PartialExtracted' | 'Processing' | 'Deleting' | 'PartialCompleted' | 'OptimizationEvaluation' | 'Error' | 'Cancelled', nullable
  - `prompt_version` string, uuid, nullable

## Response `201`

Created

- ObservationSpan
  - `id` string
  - `project` string, uuid, required
  - `project_version` string, uuid
  - `trace` string, uuid, required
  - `parent_span_id` string, nullable
  - `name` string, required
  - `observation_type` 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'agent' | 'reranker' | 'unknown' | 'guardrail' | 'evaluator' | 'conversation', required
  - `start_time` string, date-time, nullable
  - `end_time` string, date-time, nullable
  - `input` object, nullable
  - `output` object, nullable
  - `model` string, nullable
  - `model_parameters` object, nullable
  - `latency_ms` integer, nullable
  - `org_id` string, uuid, nullable
  - `org_user_id` string, uuid, nullable
  - `prompt_tokens` integer, nullable
  - `completion_tokens` integer, nullable
  - `total_tokens` integer, nullable
  - `response_time` number, nullable
  - `eval_id` string, nullable
  - `cost` number, nullable
  - `status` 'UNSET' | 'OK' | 'ERROR', nullable
  - `status_message` string, nullable
  - `tags` object, nullable
  - `metadata` object, nullable
  - `span_events` object, nullable
  - `provider` string, nullable
  - `provider_logo` string
  - `span_attributes` string
  - `custom_eval_config` string, uuid, nullable
  - `eval_status` 'NotStarted' | 'Queued' | 'Running' | 'Completed' | 'Editing' | 'Inactive' | 'Failed' | 'PartialRun' | 'ExperimentEvaluation' | 'Uploading' | 'PartialExtracted' | 'Processing' | 'Deleting' | 'PartialCompleted' | 'OptimizationEvaluation' | 'Error' | 'Cancelled', nullable
  - `prompt_version` string, uuid, nullable

## Other responses

- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)