POST
/
v0
/
ingest
curl --request POST \
  --url https://api.avidoai.com/v0/ingest \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "events": [
    {
      "type": "trace",
      "timestamp": "2025-01-01T12:00:00Z",
      "referenceId": "123e4567-e89b-12d3-a456-426614174000",
      "metadata": {
        "source": "chatbot"
      }
    },
    {
      "type": "llm",
      "event": "start",
      "traceId": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": "2025-01-01T12:01:00Z",
      "modelId": "gpt-4o-2024-08-06",
      "params": {
        "temperature": 1.2
      },
      "input": [
        {
          "role": "user",
          "content": "Tell me a joke."
        }
      ]
    }
  ]
}'
{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "success": true,
      "error": "Failed to write to database"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Your unique Avido API key

Body

application/json

Request schema for ingesting events into the system.

Response

200
application/json

Successfully ingested events.

Response schema for successful event ingestion.