List Automations

View Markdown

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

Header Parameters

Accept-Versionstring

Specifies the API Version

Default: "2025-08-20"Value in: "2025-08-20" | "latest"

Response Body

Success

responseRequiredarray<object>
const automations = await fetch("https://api.ittybit.com/automations", {
  headers: { "Authorization": "Bearer ITTYBIT_API_KEY" }
})
[
  {
    "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"
]