API & MCP — contrate o agente de qualquer lugar

O OnePress expõe uma superfície deliberadamente pequena: envie uma tarefa, consulte o resultado, continue a conversa. Suficiente para scripts, outros agentes e hosts MCP como o Claude Code.

Obtenha uma chave de API

No app: Settings → Account → API keys → Create. A chave é exibida uma vez (ela começa com opk_) — guarde-a no seu ambiente, não no código. Revogue qualquer chave na mesma página; até 10 chaves ativas.

Toda requisição é cobrada dos seus próprios créditos, exatamente como no chat — e cada chave é limitada a 60 requisições por minuto.

REST API

Três chamadas cobrem o contrato inteiro:

Criar uma tarefa

curl -X POST https://www.getonepress.com/api/v1/conversations \
  -H "Authorization: Bearer $ONEPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Research the AI coding-agent market and draft a one-page brief"}'
# → 202 {"conversationId": "conv_…", "injected": false}

Consultar o resultado

curl https://www.getonepress.com/api/v1/conversations/conv_… \
  -H "Authorization: Bearer $ONEPRESS_API_KEY"
# → {"status": "running"|"done", "answer": "…", "preview_path": "…"}

Quando o status é "done", answer carrega o resumo do agente e preview_path aponta a entrega no seu workspace — abra-a no app para visualizar, compartilhar ou exportar.

Continuar a conversa

curl -X POST https://www.getonepress.com/api/v1/conversations/conv_… \
  -H "Authorization: Bearer $ONEPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "make the brief punchier"}'

Os follow-ups mantêm o contexto completo. Se uma execução ainda estiver ativa, a mensagem é injetada no próximo turno ("injected": true) — continue consultando a mesma conversa.

Dispare a partir do Zapier, Make ou n8n

Qualquer ferramenta que consiga mandar uma requisição HTTP consegue contratar o agente — as mesmas três chamadas funcionam como webhook. No Zapier use Webhooks → POST, no Make um módulo HTTP → Make a request:

URL	https://www.getonepress.com/api/v1/conversations
Method	POST
Headers	Authorization: Bearer opk_… Content-Type: application/json
Body	{"message": "Summarize this new row: {{fields}}", "title": "from Zapier"}

Mapeie quaisquer campos do app que dispara para dentro de message — uma nova linha no Airtable, um pagamento no Stripe, um formulário enviado — e a execução começa na hora. Consulte o conversationId retornado num segundo passo se você precisar do resultado de volta no mesmo Zap.

Servidor MCP

Prefere ferramentas a REST? Aponte qualquer host compatível com MCP para o endpoint e ele ganha três ferramentas — onepress_create_task, onepress_task_status, onepress_list_tasks:

{
  "mcpServers": {
    "onepress": {
      "url": "https://www.getonepress.com/api/mcp",
      "headers": { "Authorization": "Bearer opk_..." }
    }
  }
}

Agora outros agentes podem contratar o seu — "use onepress to make that deck" funciona no Claude Code, Cursor ou qualquer host MCP.

Erros que valem tratamento

Status	Significado
401	Chave ausente ou revogada
402	Sem créditos — recarregue em Settings
409	Conversa ocupada — mensagem enfileirada, continue consultando
429	Limite de taxa (60 req/min) ou execuções ativas demais — diminua o ritmo

O que a API deliberadamente não faz

Sem download de arquivos do workspace, sem streaming, sem conversas de grupo — ainda. O contrato é "envie uma tarefa, receba o resultado" e ele só vai crescer, nunca quebrar. Conte o que você precisa em support [at] getonepress.com; o uso real molda a próxima superfície.

Uma chave, trinta segundos

Settings → Account → API keys → Create. Depois rode o curl acima e veja sua primeira tarefa sair.

Abrir o app