Référence APICréer un token d'upload
POST/v1/api-tokens

Créer un token d'upload

Génère un token d'upload délégué.

1 min de lectureTélécharger en PDF

Requête exemple

{
"name": "Mobile Upload Client",
"scopes": [
"upload"
],
"max_uses": 50,
"expires_in_minutes": 120
}

Réponse exemple

{
"id": "token_def456",
"name": "Mobile Upload Client",
"token": "cof_delegated_x9y8z7w6...full-secret",
"prefix": "cof_delegated_x9y8z7w6",
"scopes": [
"upload"
],
"warning": "Save this token now - it will not be shown again.",
"max_uses": 50,
"created_at": "2026-06-05T14:30:00Z",
"expires_at": "2026-06-05T16:30:00Z"
}

Crée un token d'upload délégué à portée restreinte. Le token en clair n'est renvoyé qu'à la création.

Authentification

Requiert une clé API avec le scope api_tokens:manage.

Corps de la requête

ChampTypeRequisDescription
namestringOuiNom descriptif du token.
expires_in_minutesnumberNonValidité en minutes (1 à 1440, défaut 60).
max_usesnumberNonNombre maximal d'utilisations (défaut 1).
scopesarrayNonScopes accordés (défaut ["upload"]).

Codes de statut

  • 201 Token créé.
  • 400 name manquant.
  • 403 Scope insuffisant.