List automations

GET

api

automations

List automations

curl --request GET \
  --url https://levios.app/api/v1/automations \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://levios.app/api/v1/automations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_invalid_cursor",
    "message": "The projection cursor is invalid for this resource.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_internal_error",
    "message": "The request could not be completed.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Use this endpoint to find automations for one Instagram account. Pass an accessible account UUID as account_id. Your API key needs the automations:read scope. Each item contains the automation id, account_id, name, status, trigger_type, has_unpublished_changes, authoring_compatibility, and updated_at. The list never contains the configuration. Use Get an automation when you also need the complete configuration and draft metadata. status is draft, live, or paused. authoring_compatibility is public_v1 for automations that can be edited through the public contract and read_only_legacy for automations that predate it.

Paginate the results

Set limit to an integer from 1 through 50. When next_cursor is a string, pass it back unchanged as cursor to request the next page. A null next_cursor means you reached the end of the list. This read does not change automation state, so it is safe to retry.

Example request

curl --get \
  --url 'https://levios.app/api/v1/automations' \
  --header "Authorization: Bearer ${LEVIOS_API_KEY}" \
  --data-urlencode "account_id=${LEVIOS_ACCOUNT_ID}" \
  --data-urlencode 'limit=25'

Example success response

Illustrative IDs, timestamps, and content. HTTP 200.

{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000002",
      "account_id": "00000000-0000-4000-8000-000000000001",
      "name": "Guide request",
      "status": "draft",
      "has_unpublished_changes": false,
      "updated_at": "2026-09-01T12:00:00.000000Z",
      "trigger_type": "comment",
      "authoring_compatibility": "public_v1"
    }
  ],
  "next_cursor": null
}

Authorizations

Authorization

string

header

required

Levios API key sent as a Bearer token.

Query Parameters

account_id

string<uuid>

required

cursor

string

Required string length: 1 - 1024

limit

string

Response

Successful response.

List automations

curl --request GET \
  --url https://levios.app/api/v1/automations \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://levios.app/api/v1/automations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_invalid_cursor",
    "message": "The projection cursor is invalid for this resource.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_internal_error",
    "message": "The request could not be completed.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Reference

Automations

Accounts

Contacts

Contact tags

Metrics

List automations

Paginate the results

Example request

Example success response

Authorizations

Query Parameters

Response

​Paginate the results

​Example request

​Example success response

Authorizations

Query Parameters

Response

Paginate the results

Example request

Example success response