Comptes de service bêta

(beta) API des comptes de service.

Lister les comptes de service

GET /v1/service-accounts#

Lister les comptes de service dans un espace de travail.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

200

Réponse réussie

items#

*array<ServiceAccount>

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/service-accounts \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "items": [
    {
      "created_at": "2025-12-17T10:25:07.818693Z",
      "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "deleted_at": null,
      "description": null,
      "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "name": "My resource",
      "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "updated_at": "2025-12-17T10:41:03.469341Z",
      "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

{
  "items": [
    {
      "created_at": "2025-12-17T10:25:07.818693Z",
      "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "deleted_at": null,
      "description": null,
      "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "name": "My resource",
      "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "updated_at": "2025-12-17T10:41:03.469341Z",
      "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

Créer un compte de service

POST /v1/service-accounts#

Créer un compte de service dans un espace de travail. Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

201

Réponse réussie

created_at#

*date-time

customer_id#

*string

deleted_at#

*date-time|null

description#

*string|null

id#

*string

name#

*string

organization_id#

*string

updated_at#

*date-time

workspace_id#

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}'

curl https://api.mistral.ai/v1/service-accounts \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}'

201

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "description": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "description": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

Lister les rôles attribuables aux comptes de service

GET /v1/service-accounts/assignable-roles#

Lister les rôles d'espace de travail qui peuvent être attribués à un compte de service.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

200

Réponse réussie

items#

*array<AssignableServiceAccountRole>

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts/assignable-roles \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/service-accounts/assignable-roles \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "items": [
    {
      "description": "My resource description.",
      "is_custom_role": false,
      "name": "My resource",
      "uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

{
  "items": [
    {
      "description": "My resource description.",
      "is_custom_role": false,
      "name": "My resource",
      "uuid": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

Récupérer un compte de service

GET /v1/service-accounts/{service_account_id}#

Récupérer un compte de service.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

200

Réponse réussie

created_at#

*date-time

customer_id#

*string

deleted_at#

*date-time|null

description#

*string|null

id#

*string

name#

*string

organization_id#

*string

updated_at#

*date-time

workspace_id#

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts/{service_account_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/service-accounts/{service_account_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "description": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "description": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

Supprimer un compte de service

DELETE /v1/service-accounts/{service_account_id}#

Supprimer un compte de service.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts/{service_account_id} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/service-accounts/{service_account_id} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

Mettre à jour un compte de service

PATCH /v1/service-accounts/{service_account_id}#

Mettre à jour un compte de service.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

200

Réponse réussie

created_at#

*date-time

customer_id#

*string

deleted_at#

*date-time|null

description#

*string|null

id#

*string

name#

*string

organization_id#

*string

updated_at#

*date-time

workspace_id#

*string

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts/{service_account_id} \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/service-accounts/{service_account_id} \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "description": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "customer_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "description": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "organization_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "updated_at": "2025-12-17T10:41:03.469341Z",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

Lister les rôles d'un compte de service

GET /v1/service-accounts/{service_account_id}/roles#

Lister les rôles d'espace de travail attribués à un compte de service.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

200

Réponse réussie

items#

*array<ServiceAccountRole>

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts/{service_account_id}/roles \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/service-accounts/{service_account_id}/roles \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "items": [
    {
      "role_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

{
  "items": [
    {
      "role_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

Définir les rôles d'un compte de service

PUT /v1/service-accounts/{service_account_id}/roles#

Remplacer les rôles d'espace de travail attribués à un compte de service.

Nécessite le rôle Administrateur de l'espace de travail (workspace_admin).

200

Réponse réussie

items#

*array<ServiceAccountRole>

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/service-accounts/{service_account_id}/roles \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/service-accounts/{service_account_id}/roles \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "items": [
    {
      "role_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

{
  "items": [
    {
      "role_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
    }
  ]
}

Comptes de service bêta

Exemples

GET /v1/service-accounts#

Parameters#

workspace_id#

include_deleted#

offset#

limit#

items#

Playground

POST /v1/service-accounts#

Request Body#

description#

name#

workspace_id#

created_at#

customer_id#

deleted_at#

description#

id#

name#

organization_id#

updated_at#

workspace_id#

Playground

GET /v1/service-accounts/assignable-roles#

Parameters#

workspace_id#

items#

Playground

GET /v1/service-accounts/{service_account_id}#

Parameters#

service_account_id#

created_at#

customer_id#

deleted_at#

description#

id#

name#

organization_id#

updated_at#

workspace_id#

Playground

DELETE /v1/service-accounts/{service_account_id}#

Parameters#

service_account_id#

Playground

PATCH /v1/service-accounts/{service_account_id}#

Parameters#

service_account_id#

Request Body#

description#

created_at#

customer_id#

deleted_at#

description#

id#

name#

organization_id#

updated_at#

workspace_id#

Playground

GET /v1/service-accounts/{service_account_id}/roles#

Parameters#

service_account_id#

items#

Playground

PUT /v1/service-accounts/{service_account_id}/roles#

Parameters#

service_account_id#

Request Body#

role_ids#

items#

Playground