> ## Documentation Index > Fetch the complete documentation index at: https://docs.levios.app/llms.txt > Use this file to discover all available pages before exploring further. # Listar automações > Liste resumos leves de automações do Instagram de uma conta com paginação por cursor, incluindo nome, tipo de gatilho, status e o carimbo de tempo updated_at. Use este endpoint para encontrar as automações de uma conta do Instagram. Envie o UUID de uma conta acessível como `account_id`. Sua chave de API precisa do escopo `automations:read`. Cada item contém `id`, `account_id`, `name`, `status`, `trigger_type`, `has_unpublished_changes`, `authoring_compatibility` e `updated_at` da automação. A lista nunca traz a configuração. Use [Consultar uma automação](/pt-BR/api/v1/automations/get) quando também precisar da configuração completa e dos metadados do rascunho. `status` é `draft`, `live` ou `paused`. `authoring_compatibility` é `public_v1` para as automações que podem ser editadas pelo contrato público e `read_only_legacy` para as automações anteriores a ele. ## Percorra os resultados Defina `limit` como um inteiro de 1 a 50. Quando `next_cursor` for uma string, envie o valor sem alterações como `cursor` para pedir a próxima página. Um `next_cursor` igual a `null` indica o fim da lista. Esta leitura não altera o estado das automações, então pode ser repetida com segurança. ## Exemplo de requisição ```bash theme={null} 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' ``` ## Exemplo de resposta de sucesso IDs, horários e conteúdo ilustrativos. HTTP `200`. ```json theme={null} { "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 } ``` ## OpenAPI ````yaml openapi/v1.json GET /api/v1/automations openapi: 3.1.0 info: title: levios public API version: '1' servers: - url: https://levios.app security: - bearerAuth: [] paths: /api/v1/automations: get: tags: - automation summary: List automations description: >- Returns a cursor-paginated list of automations for one Instagram account. operationId: automations.list parameters: - name: account_id in: query required: true schema: type: string format: uuid - name: cursor in: query required: false schema: type: string minLength: 1 maxLength: 1024 - name: limit in: query required: false schema: type: string responses: '200': description: Successful response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: $ref: '#/components/schemas/PublicAutomationListResponseV1' '400': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_content_length correlation_id: type: string message: type: string enum: - Invalid Content-Length. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_json correlation_id: type: string message: type: string enum: - The request body is not valid JSON. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_request_url correlation_id: type: string message: type: string enum: - The request URL is invalid. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_utf8 correlation_id: type: string message: type: string enum: - The request body is not valid UTF-8. required: - code - message additionalProperties: false required: - error additionalProperties: false '401': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ WWW-Authenticate: description: API key Bearer challenge. schema: type: string enum: - Bearer content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - api_unauthorized correlation_id: type: string message: type: string enum: - Authentication required. required: - code - message additionalProperties: false required: - error additionalProperties: false '403': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_account_not_granted correlation_id: type: string message: type: string enum: - >- This credential is not authorized for the request. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_forbidden correlation_id: type: string message: type: string enum: - >- This credential is not authorized for the request. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_scope_denied correlation_id: type: string message: type: string enum: - >- This credential is not authorized for the request. required: - code - message additionalProperties: false required: - error additionalProperties: false '413': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_body_too_large correlation_id: type: string message: type: string enum: - The JSON request body exceeds 1 MiB. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_json_too_deep correlation_id: type: string message: type: string enum: - The JSON request body exceeds maximum depth. required: - code - message additionalProperties: false required: - error additionalProperties: false '415': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - api_unsupported_media_type correlation_id: type: string message: type: string enum: - Content-Type must be application/json. required: - code - message additionalProperties: false required: - error additionalProperties: false '422': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_cursor correlation_id: type: string message: type: string enum: - >- The projection cursor is invalid for this resource. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_limit correlation_id: type: string message: type: string enum: - >- The page limit must be an integer between 1 and 50. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_validation_error correlation_id: type: string details: type: object properties: issues: type: array items: type: object properties: code: type: string minLength: 1 maxLength: 64 path: type: array items: type: integer minimum: 0 maxItems: 16 required: - code - path additionalProperties: false maxItems: 32 required: - issues additionalProperties: false message: type: string enum: - The request does not match the declared schema. required: - code - message additionalProperties: false required: - error additionalProperties: false '429': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ Retry-After: description: Seconds to wait before retrying. schema: type: integer minimum: 1 content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - rate_limited correlation_id: type: string message: type: string enum: - Rate limit exceeded. required: - code - message additionalProperties: false required: - error additionalProperties: false '500': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_internal_error correlation_id: type: string message: type: string enum: - The request could not be completed. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_invalid_projection correlation_id: type: string message: type: string enum: - The projected list contains an invalid item key. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_projection_too_large correlation_id: type: string message: type: string enum: - >- The first projected item exceeds the result byte limit. required: - code - message additionalProperties: false required: - error additionalProperties: false '503': description: Error response. headers: X-Correlation-ID: description: Correlation identifier for this request. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ content: application/json: schema: oneOf: - type: object properties: error: type: object properties: code: type: string enum: - api_account_resolution_unavailable correlation_id: type: string message: type: string enum: - The reachable account set could not be read. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - api_automation_authoring_unavailable correlation_id: type: string message: type: string enum: - The automation could not be authored. required: - code - message additionalProperties: false required: - error additionalProperties: false - type: object properties: error: type: object properties: code: type: string enum: - rate_limiter_unavailable correlation_id: type: string message: type: string enum: - Rate limiter unavailable. required: - code - message additionalProperties: false required: - error additionalProperties: false components: schemas: PublicAutomationListResponseV1: $ref: 668c3522-f287-4d7e-9912-fe801c742372 $defs: PublicAutomationListResponseV1: additionalProperties: false properties: items: items: anyOf: - additionalProperties: false properties: account_id: format: uuid type: string authoring_compatibility: const: public_v1 type: string has_unpublished_changes: type: boolean id: format: uuid type: string name: description: >- Automation name. Use 1 through 120 Unicode scalar values, without surrounding whitespace or control characters. pattern: >- ^(?!\s)(?![\s\S]*\s$)(?:(?:[\uD800-\uDBFF][\uDC00-\uDFFF]|[^\u0000-\u001F\u007F-\u009F\uD800-\uDFFF])){1,120}$ type: string status: description: >- Values: `draft`: saved but not processing new triggers; `live`: active and able to process matching triggers; `paused`: inactive until it is activated again. enum: - draft - live - paused type: string trigger_type: description: >- Values: `comment`: a comment on an Instagram post; `dm_keyword`: a direct message that matches configured keywords; `story_mention`: a mention of the Instagram account in a story; `story_reply`: a reply to an Instagram story. enum: - comment - story_reply - dm_keyword - story_mention type: string updated_at: maxLength: 32 minLength: 20 pattern: >- ^(?:(?:(?!0000)\d{4})-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?!0000)(?:\d{2}(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00))-02-29)T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$ type: string required: - id - account_id - name - status - has_unpublished_changes - updated_at - trigger_type - authoring_compatibility type: object - additionalProperties: false properties: account_id: format: uuid type: string authoring_compatibility: const: read_only_legacy type: string has_unpublished_changes: type: boolean id: format: uuid type: string name: description: >- Automation name. Use 1 through 120 Unicode scalar values, without surrounding whitespace or control characters. pattern: >- ^(?!\s)(?![\s\S]*\s$)(?:(?:[\uD800-\uDBFF][\uDC00-\uDFFF]|[^\u0000-\u001F\u007F-\u009F\uD800-\uDFFF])){1,120}$ type: string status: description: >- Values: `draft`: saved but not processing new triggers; `live`: active and able to process matching triggers; `paused`: inactive until it is activated again. enum: - draft - live - paused type: string trigger_type: enum: - comment - story_reply - dm_keyword - story_mention - any_dm - live_comment - instagram_ad - legacy type: string updated_at: maxLength: 32 minLength: 20 pattern: >- ^(?:(?:(?!0000)\d{4})-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?!0000)(?:\d{2}(?:0[48]|[2468][048]|[13579][26])|(?:[02468][048]|[13579][26])00))-02-29)T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,6})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$ type: string required: - id - account_id - name - status - has_unpublished_changes - updated_at - trigger_type - authoring_compatibility type: object maxItems: 50 type: array next_cursor: anyOf: - maxLength: 1024 type: string - type: 'null' required: - items - next_cursor type: object $id: https://levios.app/schemas/public-automation-list-response-v1 $schema: https://json-schema.org/draft/2019-09/schema# title: PublicAutomationListResponseV1 x-levios-schema-version: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: Levios API key sent as a Bearer token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.