Create Traces

POST 
https://cloud.agenta.ai/api/observability/trace/

Create Traces

Request

application/json

Body

required

trace Trace (string)required
spansobject[]required
Array [
id Id (string)required
app_id App Id (string)required
project_idobject
anyOf
MOD1
string
variant_idobject
anyOf
MOD1
string
variant_nameobject
anyOf
MOD1
string
inputsobject
anyOf
internalsobject
anyOf
outputsobject
anyOf
MOD2
Array [
string
]
configobject
anyOf
environmentobject
anyOf
MOD1
string
tagsobject
anyOf
MOD1
Array [
string
]
token_consumptionobject
anyOf
MOD1
integer
name Name (string)required
parent_span_idobject
anyOf
MOD1
string
attributesobject
anyOf
spankind Spankind (string)required
status Status (string)required
userobject
anyOf
MOD1
string
start_time date-timerequired
end_time date-timerequired
tokensobject
anyOf
LLMTokens
prompt_tokens Prompt Tokens (integer)
Default value: 0
completion_tokens Completion Tokens (integer)
Default value: 0
total_tokens Total Tokens (integer)
Default value: 0
costobject
anyOf
MOD1
number
]

Responses

200

Successful Response

application/json

Schema

Schema

message Message (string)required
data objectrequired

Example (from schema)

{
  "message": "string",
  "data": {}
}

422

Validation Error

application/json

Schema

Schema

detailobject[]

Array [

locobject[]required

Array [

anyOf

MOD1

string

MOD2

integer

]

msg Message (string)required

type Error Type (string)required

]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L 'https://cloud.agenta.ai/api/observability/trace/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>' \
-d '{
  "trace": "string",
  "spans": [
    {
      "id": "string",
      "app_id": "string",
      "project_id": "string",
      "variant_id": "string",
      "variant_name": "string",
      "inputs": {},
      "internals": {},
      "outputs": {},
      "config": {},
      "environment": "string",
      "tags": [
        "string"
      ],
      "token_consumption": 0,
      "name": "string",
      "parent_span_id": "string",
      "attributes": {},
      "spankind": "string",
      "status": "string",
      "user": "string",
      "start_time": "2024-11-22T12:54:53.396Z",
      "end_time": "2024-11-22T12:54:53.397Z",
      "tokens": {
        "prompt_tokens": 0,
        "completion_tokens": 0,
        "total_tokens": 0
      },
      "cost": 0
    }
  ]
}'

Request Collapse all

Base URL

https://cloud.agenta.ai/api

Auth

APIKeyHeader

Body required

{
  "trace": "string",
  "spans": [
    {
      "id": "string",
      "app_id": "string",
      "project_id": "string",
      "variant_id": "string",
      "variant_name": "string",
      "inputs": {},
      "internals": {},
      "outputs": {},
      "config": {},
      "environment": "string",
      "tags": [
        "string"
      ],
      "token_consumption": 0,
      "name": "string",
      "parent_span_id": "string",
      "attributes": {},
      "spankind": "string",
      "status": "string",
      "user": "string",
      "start_time": "2024-11-22T12:54:53.396Z",
      "end_time": "2024-11-22T12:54:53.397Z",
      "tokens": {
        "prompt_tokens": 0,
        "completion_tokens": 0,
        "total_tokens": 0
      },
      "cost": 0
    }
  ]
}

ResponseClear

Click the Send API Request button above and see the response here!