Référence API/Agents et MCP

Agents et MCP

Laissez un agent logiciel payer des personnes et des fournisseurs selon une politique définie par une personne. Une clé avec budget quotidien, maximum par paiement, canaux autorisés et seuil d’approbation exécute les paiements sous le seuil et place le reste dans la boîte d’approbation. Un numéro de téléphone est un bénéficiaire valide : un agent n’a jamais à collecter de coordonnées bancaires.

La couche de politiques repose sur l’API ; contactez-nous avant de développer dessus.

Create a scoped key

POST/api-keys

Owner only. A key carries an optional policy; anything outside it returns policy_exceeded or waits for approval above the threshold.

Champ	Type	obligatoire	Notes
name	string	obligatoire
policy	object	facultatif

Requête

{
  "name": "support-agent",
  "policy": {
    "daily_budget": "2000.00",
    "per_payout_max": "200.00",
    "channels": [
      "claim_link",
      "spei_mxn"
    ],
    "approval_threshold": "150.00"
  }
}

Réponse 201

{
  "id": "key_7e21",
  "name": "support-agent",
  "key": "dpc_test_9Qa...",
  "policy": {
    "daily_budget": "2000.00",
    "per_payout_max": "200.00",
    "channels": [
      "claim_link",
      "spei_mxn"
    ],
    "approval_threshold": "150.00"
  }
}

Exemples: Create a scoped key

curl -X POST https://sandbox.api.decaf.so/v1/api-keys \
  -H "Authorization: Bearer $DECAF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"support-agent","policy":{"daily_budget":"2000.00","per_payout_max":"200.00","channels":["claim_link","spei_mxn"],"approval_threshold":"150.00"}}'

Obtenir l’accès

Développez sur le sandbox dès cette semaine.

Dites-nous les corridors dont vous avez besoin et qui vous payez. Les clés sandbox sont délivrées par une personne.