Passer au contenu principal
POST
/
v3beta1
/
organizations
/
{org_id}
/
service-users
Provisionner l’utilisateur de service de l’organisation
curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/service-users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "role_id": "<string>",
  "ttl_seconds": 123
}
'
{
  "service_user": {
    "expires_at": 123,
    "name": "<string>",
    "role_assignments": [
      {
        "role": {
          "role_id": "<string>",
          "role_name": "<string>",
          "role_type": "enterprise"
        },
        "org_id": "<string>"
      }
    ],
    "service_user_id": "<string>"
  },
  "token": "<string>"
}

Autorisations

Nécessite un compte de service disposant de l’autorisation ManageOrgServiceUsers au niveau de l’organisation.

Contraintes de sécurité

Le role_id spécifié doit faire référence à un rôle au niveau de l’organisation.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Corps

application/json
name
string
requis
Required string length: 1 - 256
role_id
string
requis
Minimum string length: 1
ttl_seconds
integer
requis
Plage requise: x <= 31536000

Réponse

Réponse réussie

service_user
ServiceUser · object
requis
token
string
requis

Le jeton d’API pour l’utilisateur de service. Il n’est affiché qu’une seule fois lors de sa création.