Skip to main content
POST
/
trace
Ingest trace spans
curl --request POST \
  --url https://api.example.com/trace

​
Request

Authenticated with bootstrap token or API key. Accepts a batch of spans. 
{
  "action": "ingest",
  "spans": [
    {
      "trace_type": "before",
      "span_id": "span_abc123",
      "tool_name": "gmail_send",
      "tool_args_summary": "to: team@celerflow.ai",
      "category": "outbound_write",
      "service_name": "gmail",
      "task_name": "Write weekly report",
      "task_group_id": "session_xyz"
    },
    {
      "trace_type": "after",
      "span_id": "span_abc123",
      "tool_name": "gmail_send",
      "status": "allowed",
      "result_summary": "Email sent to team@celerflow.ai",
      "duration_ms": 1200,
      "category": "outbound_write",
      "service_name": "gmail",
      "task_name": "Write weekly report",
      "task_group_id": "session_xyz"
    }
  ]
}

​
Response

{
  "ingested": 2
}
The plugin buffers spans locally and flushes in batches every 300 seconds to minimize API calls. A flush also happens on agent shutdown.

​
Errors

CodeHTTPMeaning
AUTH_REQUIRED401Missing or invalid bootstrap token.
BOOTSTRAP_TOKEN_EXPIRED401Token expired. Run celerflow connect again.
RATE_LIMITED429Trace ingestion is limited to 3 requests per 60 seconds per agent.
BAD_REQUEST400Invalid span format. Check required fields.

​
Daily limits

PlanTraces per day
Free1,000
Pro50,000
Team200,000
EnterpriseUnlimited