Get an automation

GET

api

automations

{automationId}

Get an automation

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

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

fetch('https://levios.app/api/v1/automations/{automationId}', 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_automation_not_found",
    "message": "The requested automation was not found.",
    "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_validation_error",
    "message": "The request does not match the declared schema.",
    "correlation_id": "<string>",
    "details": {
      "issues": [
        {
          "code": "<string>",
          "path": [
            1
          ]
        }
      ]
    }
  }
}

{
  "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>"
  }
}

Pass the automation ID in the path and its account_id in the query string. Your API key needs automations:read and access to that account. The response contains the editable name and the complete configuration, plus status, trigger_type, and timestamps. trigger_type reports the kind of Instagram activity the automation listens to and is derived from the configuration, so you do not set it directly. When a live automation has unpublished edits, has_unpublished_changes is true, draft_updated_at holds the last draft change, and the returned configuration is that draft. Publish it with Activate an automation.

Read the compatibility flag

authoring_compatibility tells you whether the automation can be edited through the public contract:

Value	Meaning
`public_v1`	`configuration` holds the complete typed configuration and can be replaced.
`read_only_legacy`	`configuration` is `null`. The automation predates the public contract.

A read_only_legacy automation still reports its id, name, status, trigger_type, and timestamps, and it still runs. You can rename it, and you can convert it by sending a complete configuration through Update an automation.

Keep the version

Keep the returned updated_at value. You must pass it as expected_updated_at when you update, activate, deactivate, or delete the automation. This prevents one client from overwriting a newer change. This is a safe read operation, so you can retry it without changing the automation.

Example request

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

Example success response

Illustrative IDs, timestamps, and content. HTTP 200.

{
  "automation": {
    "id": "00000000-0000-4000-8000-000000000002",
    "account_id": "00000000-0000-4000-8000-000000000001",
    "name": "Guide request",
    "status": "draft",
    "has_unpublished_changes": false,
    "draft_updated_at": null,
    "created_at": "2026-09-01T12:00:00.000000Z",
    "updated_at": "2026-09-01T12:00:00.000000Z",
    "trigger_type": "comment",
    "configuration": {
      "contact_filter": "anyone",
      "trigger": {
        "type": "comment",
        "publication": {
          "mode": "all"
        },
        "keywords": {
          "mode": "specific",
          "match_mode": "whole_word",
          "values": [
            "guide"
          ]
        }
      },
      "opening": {
        "public_reply": {
          "enabled": false
        },
        "direct_message": {
          "delay_seconds": 0,
          "message": {
            "text": "Here is the guide you asked for.",
            "buttons": [
              {
                "type": "url",
                "title": "Open the guide",
                "url": "https://example.com/guide"
              }
            ]
          }
        }
      },
      "follow_up": null,
      "extras": {
        "cooldown": {
          "mode": "none"
        }
      }
    },
    "authoring_compatibility": "public_v1"
  }
}

Authorizations

Authorization

string

header

required

Levios API key sent as a Bearer token.

Path Parameters

automationId

string<uuid>

required

Query Parameters

account_id

string<uuid>

required

Response

Successful response.

Get an automation

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

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

fetch('https://levios.app/api/v1/automations/{automationId}', 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_automation_not_found",
    "message": "The requested automation was not found.",
    "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_validation_error",
    "message": "The request does not match the declared schema.",
    "correlation_id": "<string>",
    "details": {
      "issues": [
        {
          "code": "<string>",
          "path": [
            1
          ]
        }
      ]
    }
  }
}

{
  "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

Get an automation

Read the compatibility flag

Keep the version

Example request

Example success response

Authorizations

Path Parameters

Query Parameters

Response

​Read the compatibility flag

​Keep the version

​Example request

​Example success response

Authorizations

Path Parameters

Query Parameters

Response

Read the compatibility flag

Keep the version

Example request

Example success response