API & MCP — embauche l'agent depuis n'importe où

OnePress expose une surface volontairement réduite : envoie une tâche, interroge le résultat, continue la conversation. Assez pour des scripts, d'autres agents et des hôtes MCP comme Claude Code.

Obtiens une clé API

Dans l'app : Settings → Account → API keys → Create. La clé n'est affichée qu'une fois (elle commence par opk_) — stocke-la dans ton environnement, pas dans le code. Révoque n'importe quelle clé depuis la même page ; jusqu'à 10 clés actives.

Chaque requête est facturée sur tes propres crédits, exactement comme le chat — et chaque clé est limitée à 60 requêtes par minute.

API REST

Trois appels couvrent tout le contrat :

Crée une tâche

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}

Interroge le résultat

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

Quand status vaut "done", answer porte le résumé de l'agent et preview_path nomme le livrable dans ton espace de travail — ouvre-le dans l'app pour le prévisualiser, le partager ou l'exporter.

Continue la conversation

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"}'

Les relances gardent tout le contexte. Si un run est encore actif, le message est injecté dans le tour suivant ("injected": true) — continue d'interroger la même conversation.

Déclenche depuis Zapier, Make ou n8n

Tout outil capable d'envoyer une requête HTTP peut embaucher l'agent — les trois mêmes appels fonctionnent en webhook. Dans Zapier utilise Webhooks → POST, dans Make un module 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"}

Mappe n'importe quels champs de l'app déclencheur dans message — une nouvelle ligne Airtable, un paiement Stripe, une soumission de formulaire — et le run démarre immédiatement. Interroge le conversationId renvoyé dans une seconde étape si tu veux le résultat dans le même Zap.

Serveur MCP

Tu préfères les outils au REST ? Pointe n'importe quel hôte compatible MCP vers l'endpoint et il obtient trois outils — onepress_create_task, onepress_task_status, onepress_list_tasks :

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

Maintenant, d'autres agents peuvent embaucher le tien — « use onepress to make that deck » fonctionne depuis Claude Code, Cursor ou n'importe quel hôte MCP.

Les erreurs à gérer

Status	Signification
401	Clé manquante ou révoquée
402	Crédits épuisés — recharge dans Settings
409	Conversation occupée — message mis en file, continue d'interroger
429	Limite de débit (60 req/min) ou trop de runs actifs — ralentis

Ce que l'API ne fait volontairement pas

Pas de téléchargement de fichiers du workspace, pas de streaming, pas de conversations de groupe — pour l'instant. Le contrat est « soumets une tâche, obtiens le résultat » et il ne fera que grandir, jamais casser. Dis-nous ce qu'il te faut à support [at] getonepress.com ; l'usage réel façonne la prochaine surface.

Une clé, trente secondes

Settings → Account → API keys → Create. Puis lance le curl ci-dessus et regarde ta première tâche partir.

Ouvrir l'app