curl --request POST \
--url https://api.vela.dev/v1/ingest \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"event": "order.placed",
"data": {
"orderId": "ord_abc123",
"amountCents": 4999
},
"level": "info",
"customer_id": "cust_42",
"metadata": {
"env": "production"
}
}
'{
"accepted": 2,
"events": [
{
"id": "evt-uuid-1",
"appId": "app-uuid",
"event": "order.placed",
"customer_id": null,
"data": {
"orderId": "ord_1"
},
"level": "info",
"metadata": {},
"timestamp": "2024-06-01T12:00:00.000Z",
"ingestedAt": "2024-06-01T12:00:00.123Z"
}
]
}Events
Ingest Events
Send one or more events to Vela. Events are validated against their registered schema. Supports single event or batch of up to 100.
POST
/
ingest
curl --request POST \
--url https://api.vela.dev/v1/ingest \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"event": "order.placed",
"data": {
"orderId": "ord_abc123",
"amountCents": 4999
},
"level": "info",
"customer_id": "cust_42",
"metadata": {
"env": "production"
}
}
'{
"accepted": 2,
"events": [
{
"id": "evt-uuid-1",
"appId": "app-uuid",
"event": "order.placed",
"customer_id": null,
"data": {
"orderId": "ord_1"
},
"level": "info",
"metadata": {},
"timestamp": "2024-06-01T12:00:00.000Z",
"ingestedAt": "2024-06-01T12:00:00.123Z"
}
]
}Authorizations
API key for event ingestion. Format: vela_live_...
Body
application/json
- Option 1
- Option 2
Event name (must match a registered schema)
Event payload (validated against schema)
Event severity level
Available options:
info, warning, error, success Customer identifier
Contextual data (validated against metadata fields)
ISO-8601 timestamp (defaults to now)