Events

Overview

Events are a record of things that happen in your Ittybit project. Every time a task or run is created, updated, or finishes, an event is generated.

Events power the Webhooks system and provide an audit trail of all activity in your project.

Event object

{
  "id": "evt_abcdefgh12345678",
  "object": "event",
  "kind": "task.succeeded",
  "data": {
    "id": "task_abcdefgh12345678",
    "object": "task",
    "kind": "video",
    "status": "succeeded"
  },
  "created_at": 1735689886
}

Event kinds

Listing events

Retrieve recent events for your project:

curl "https://api.ittybit.com/events?limit=10" \
-H "Authorization: Bearer ITTYBIT_API_KEY"

Supports cursor-based pagination with after, before, and limit parameters.

Getting a single event

curl "https://api.ittybit.com/events/evt_abcdefgh12345678" \
-H "Authorization: Bearer ITTYBIT_API_KEY"

Events and Webhooks

Events are the data source for Webhook deliveries. When you create a webhook endpoint and subscribe to specific topics (like task.succeeded), the corresponding event data is sent to your endpoint URL as a POST request.

API Reference

See the API Reference for the full list of event endpoints.