Saltar para o conteúdo principal
Todos os endpoints da API Claw exigem autenticação via cabeçalho Authorization: Bearer sk-.... URL Base: https://api.lemondata.cc/v1/claw

​
Listar Instâncias

GET /v1/claw/instances
Retorna todas as instâncias da organização autenticada. 
curl https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key"

{
  "instances": [
    {
      "id": "cm5abc123",
      "subdomain": "mybot",
      "url": "https://claw-mybot.lemondata.cc",
      "defaultModel": "claude-opus-4-6",
      "hasIMConfig": true,
      "status": "RUNNING",
      "paidUntil": "2026-03-10T00:00:00.000Z",
      "canRebuild": true,
      "totalPaid": 20,
      "createdAt": "2026-02-08T00:00:00.000Z"
    }
  ]
}

​
Valores de Status da Instância

StatusDescrição
PENDINGRecém-criada, aguardando provisionamento
PROVISIONINGO container está sendo implantado
RUNNINGA instância está ativa e saudável
STOPPEDInterrompida devido à expiração (dados retidos por 7 dias)
FAILEDFalha na implantação (reembolso automático)
DELETEDRemovida permanentemente

​
Criar Instância

POST /v1/claw/instances
Cria uma nova instância e cobra $20 por 30 dias do saldo da sua organização.
​
subdomain
string
obrigatório
Subdomínio (3-32 caracteres, alfanuméricos minúsculos + hifens). URL da instância: https://claw-{subdomain}.lemondata.cc
​
defaultModel
string
Modelo de IA padrão (ex: claude-opus-4-6, gpt-5.2, gemini-3-pro-preview, minimax-m2.5, kimi-k2.5)
curl -X POST https://api.lemondata.cc/v1/claw/instances \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"subdomain": "mybot", "defaultModel": "claude-opus-4-6"}'

{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "url": "https://claw-mybot.lemondata.cc",
  "status": "PENDING",
  "paidUntil": "2026-03-10T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}
Saldo insuficiente retorna 402 Payment Required. Certifique-se de que sua organização tenha pelo menos $20 antes de criar uma instância.

​
Obter Instância

GET /v1/claw/instances/:id
Retorna detalhes de uma instância específica.

​
Atualizar Instância

PATCH /v1/claw/instances/:id
Atualiza a configuração da instância.
​
defaultModel
string | null
Altera o modelo de IA padrão
​
imConfig
object | null
Atualiza a configuração da plataforma de IM (Telegram, Discord, etc.)
curl -X PATCH https://api.lemondata.cc/v1/claw/instances/cm5abc123 \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"defaultModel": "claude-sonnet-4-5"}'

​
Reconstruir Instância

POST /v1/claw/instances/:id/rebuild
Destrói e recria o container preservando os dados (PVC). Limitado a 10 reconstruções por dia. Retorna 429 Too Many Requests se o limite diário for excedido.

​
Renovar Instância

POST /v1/claw/instances/:id/renew
Estende o período de faturamento em 30 dias ($20). Se a instância foi interrompida devido à expiração, ela será reiniciada automaticamente. 
{
  "id": "cm5abc123",
  "subdomain": "mybot",
  "status": "RUNNING",
  "paidUntil": "2026-04-09T00:00:00.000Z",
  "charged": true,
  "chargedAmount": 20
}

​
Health Check

GET /v1/claw/health
Retorna o status de saúde do serviço Claw. Nenhuma autenticação é necessária. 
{"status": "ok", "timestamp": "2026-02-08T15:00:00.000Z"}