Créer une organisation.¶

Méthode¶

POST https://papi.afi.ai/api/v1/orgs

Description¶

Crée une sous-organisation.

Paramètres de requête¶

parent_org_id string

Identifiant de l’organisation parente existante.

external_id string

Identifiant externe de la nouvelle organisation. Utilisez-le pour assurer l’idempotence et éviter de créer des organisations en double, ainsi que pour faire correspondre l’organisation à celle du système externe intégré à Afi.

name string

Nom de la nouvelle organisation.

admin_email string

Adresse e-mail du compte administrateur. Un e-mail contenant un lien d’invitation est envoyé à cette adresse.

curl

curl -X POST \
    -H 'Authorization: {api-key}' \
    https://papi.afi.ai/api/v1/orgs

Schéma de la réponse en cas de succès (200)¶

object

CreateOrgResult contient le résultat d’une demande de création d’organisation.

org object

Organisation qui vient d’être créée.

object

Org représente une organisation.

id string

Identifiant unique de l’organisation.

external_id string

Identifiant externe unique de l’organisation.

kind string

Type d’organisation (distributor, msp ou basic).

name string

Nom de l’organisation.

invitation_url string

URL permettant à l’utilisateur de se connecter, d’accepter l’invitation et de devenir administrateur de l’organisation.

Exemple de réponse¶

{
  "org": {
    "id": "string",
    "external_id": "string",
    "kind": "string",
    "name": "string"
  },
  "invitation_url": "string"
}