cURL

curl --request POST \
  --url https://api.bedrock.orinlabs.org/api/tracing/traces/{trace_id}/end/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ended_at": "2023-11-07T05:31:56Z",
  "error": "<string>",
  "metadata": "<unknown>"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ended_at": "2023-11-07T05:31:56Z",
  "error": "<string>",
  "metadata": "<unknown>"
}

Tracing

End Trace

ViewSet for Trace operations.

IMPORTANT — Memory safety: Traces can have hundreds of spans, each with metadata containing base64 screenshots (1MB+). Never use TraceSerializer or prefetch_related(“spans”) here — that eagerly loads ALL span data and WILL OOM on 2GB instances.

Safe patterns:

list: TraceListSerializer (no spans, just trace metadata + annotated count)
retrieve: SpanTreeSerializer with .only() (minimal columns, no metadata)
create/end: TraceDetailSerializer (no spans at all)
Individual span detail: fetched separately via SpanViewSet

POST

api

tracing

traces

{trace_id}

end

cURL

curl --request POST \
  --url https://api.bedrock.orinlabs.org/api/tracing/traces/{trace_id}/end/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ended_at": "2023-11-07T05:31:56Z",
  "error": "<string>",
  "metadata": "<unknown>"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ended_at": "2023-11-07T05:31:56Z",
  "error": "<string>",
  "metadata": "<unknown>"
}

Authorizations

Authorization

string

header

required

Token-based authentication with required prefix "Token"

Path Parameters

trace_id

string<uuid>

required

A UUID string identifying this trace.

Body

Trace serializer without nested spans (spans handled separately for pagination).

name

string

required

Required string length: 1 - 255

agent

string<uuid> | null

ended_at

string<date-time> | null

error

string

metadata

any

Response

200 - application/json

Trace serializer without nested spans (spans handled separately for pagination).

string<uuid>

required

read-only

name

string

required

Maximum string length: 255

started_at

string<date-time>

required

read-only

agent

string<uuid> | null

ended_at

string<date-time> | null

error

string

metadata

any

Create Trace