Skip to main content
A API da Leme permite que seus sistemas façam o que você já faz no dashboard: colocar um agent para trabalhar. Você envia uma instrução, o agent executa com as mesmas permissões, aprovações e ferramentas de sempre, e você coleta o resultado — consultando o status ou recebendo um webhook. Existem duas formas de ativar um agent de fora:

API de runs

Controle programático completo: crie um run por chamada, escolha a instrução, acompanhe o status, cancele e receba webhooks de conclusão.

Trigger webhook

Uma URL dedicada para ferramentas externas. A instrução é fixa no trigger; cada evento aceito vira um run.
Use a API de runs quando o seu código decide o que o agent deve fazer a cada chamada. Use um trigger webhook quando quem envia é uma ferramenta externa (um formulário, Stripe, Zapier) e a instrução nunca muda.

​
Autenticação

Toda requisição é autenticada com um token de API. Crie o seu no dashboard da Leme em Settings → API tokens.
Tokens pertencem a um projeto e têm um modo: tokens read_only consultam status e listam runs; criar ou cancelar runs exige um token read_write. O token é exibido uma única vez na criação — guarde-o no seu gerenciador de secrets.
Trate o token como uma senha. Quem o possuir pode agir no seu projeto dentro do modo do token. Se vazar, revogue-o no dashboard.

​
Runs são assíncronos

O trabalho de um agent leva de segundos a minutos, então a API nunca bloqueia esperando. Criar um run retorna 202 Accepted imediatamente, com um recurso que você pode acompanhar:
Acompanhe consultando GET /api/v1/runs/:id, ou registre um callbackUrl e deixe a Leme avisar você — veja Webhooks de conclusão.

​
Idempotência

Chamadas de rede falham e são repetidas. Para tornar retentativas seguras, envie um header Idempotency-Key em todo POST:
Repetir a mesma chave com o mesmo corpo devolve a resposta original em vez de criar um segundo run. A mesma chave com corpo diferente retorna 409 idempotency_conflict. As chaves são lembradas por 24 horas.

​
Erros

Erros usam sempre o mesmo envelope, com um code estável e legível por máquina:
Trate erros pelo code, não pela mensagem — mensagens podem mudar, códigos não.

​
Limites de requisição

Requisições acima de um limite retornam 429 com um header retry-after indicando quanto esperar.

​
OpenAPI

A especificação completa, legível por máquina, está disponível em GET https://app.leme.ai/api/openapi — use-a para gerar clients ou importar a API nas suas ferramentas.