List Automations

Get a paginated list of your automations.


GET
/automations

Authorization

AuthorizationRequiredBearer <token>

See API Security for more details.

In: header

Query Parameters

pageinteger
Default: 1Minimum: 1
limitinteger
Default: 10Minimum: 1Maximum: 100

Response Body

Success

TypeScript Definitions

Use the response body type in TypeScript.

metaobject
dataarray<object>
errorobject | null | null
linksobject
fetch("https://api.ittybit.com/automations?page=1&limit=10", {
  headers: {
    "Authorization": "Bearer <token>"
  }
})
{
  "meta": {
    "request_id": "req_abcdefghij1234567890",
    "org_id": "org_abcdefgh1234",
    "project_id": "prj_abcdefgh1234",
    "version": "2025-01-01",
    "type": "list",
    "limit": 10,
    "total": 5,
    "page": 1,
    "pages": 1
  },
  "data": [
    {
      "id": "auto_abcdefgh1234",
      "object": "automation",
      "name": "My Example Automation",
      "description": "This workflow will run whenever new media is created.",
      "trigger": {
        "kind": "event",
        "event": "media.created"
      },
      "workflow": [
        {
          "kind": "description"
        },
        {
          "kind": "image",
          "width": 320,
          "format": "png",
          "ref": "thumbnail"
        },
        {
          "kind": "conditions",
          "conditions": [
            {
              "prop": "kind",
              "value": "video"
            }
          ],
          "next": [
            {
              "kind": "subtitle",
              "ref": "subtitle"
            }
          ]
        }
      ],
      "created": "2025-01-01T01:23:45Z",
      "updated": "2025-01-01T01:23:45Z",
      "status": "active"
    },
    "… 4 more automation objects"
  ],
  "error": null,
  "links": {
    "self": "https://api.ittybit.com/automations?page=1",
    "first": "https://api.ittybit.com/automations?page=1",
    "prev": null,
    "next": null,
    "last": "https://api.ittybit.com/automations?page=1"
  }
}