> ## 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.

# Visão geral da API v1

> Use a API REST da levios v1 para gerenciar automações do Instagram, contatos, tags e métricas de conta com uma única chave de API e JSON.

A API v1 expõe endpoints JSON neste caminho base:

```text theme={null}
https://levios.app/api/v1
```

Use a API para:

* Listar as contas do Instagram disponíveis para sua chave de API.
* Listar os posts e os stories de uma conta para vincular um gatilho a uma
  publicação.
* Criar, configurar, ler, ativar, pausar e excluir automações.
* Ler registros completos de contatos e filtrá-los pelo username do Instagram.
* Criar tags de contato e gerenciar as tags associadas a um contato.
* Ler métricas da conta e de uma automação.

## Fundamentos das requisições

* Envie uma chave de API da levios como credencial Bearer. A API v1 recusa
  tokens de acesso OAuth e sessões do navegador.
* Envie JSON nos endpoints que aceitam um body.
* Leia `X-Correlation-ID` em cada resposta quando precisar rastrear uma
  requisição.
* Use `expected_updated_at` quando exigido para não sobrescrever uma alteração
  mais recente da automação.
* Consulte a referência do endpoint para ver todos os campos, enums, padrões e
  respostas aceitos.

O [documento OpenAPI](/openapi/v1.json) vem dos schemas que validam a API em
produção. A `configuration` tipada e completa da automação, com todos os
gatilhos, mensagens de abertura e ações de acompanhamento, é definida nesse
documento. Leia o documento direto quando precisar de um campo, de um enum ou
de um limite que a referência do endpoint não detalha.

## Antes de integrar

* [Autenticação](/pt-BR/guides/authentication) explica chaves de API, escopos e
  acesso às contas.
* [Paginação](/pt-BR/guides/pagination) explica `cursor`, `limit` e
  `next_cursor`.
* [Erros](/pt-BR/guides/errors) explica o envelope JSON compartilhado.
* [Limites de requisição](/pt-BR/guides/rate-limits) explica `429` e
  `Retry-After`.

## Mensagens em carrossel

Consulte [Enviar mensagens em carrossel](/pt-BR/guides/carousels) para cards
com imagens, botões de link, uma requisição completa e uma mensagem posterior
separada.

## Guias de criação

* [Criação e edição](/pt-BR/guides/automation-workflow)
* [Configuração](/pt-BR/guides/automation-configuration)
* [Triggers](/pt-BR/guides/automation-triggers)
* [Actions](/pt-BR/guides/automation-actions)
* [Criação pelo MCP](/pt-BR/mcp/automation-authoring)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.