Activer ou désactiver une application dans une organisation

PUT /v1/organizations/{org_id}/applications/{application_id} · permission organizations:write

Définit le statut de l'application dans l'organisation. Réécrire le statut actuel est sans effet et conserve la version. If-Match est facultatif ; s'il est fourni, il doit correspondre à l'ETag actuel. La désactivation conserve les affectations ; elles s'appliquent de nouveau lorsque l'application est réactivée. Les écritures sont consignées dans le journal d'audit de gestion sous organization_application.enabled ou organization_application.disabled.

Requête

Champ Type Obligatoire Description
org_id path oui Identifiant de l'organisation (org_…).
application_id path oui Identifiant de l'application (app_…).
If-Match header non Facultatif. L'ETag actuel ("0" pour une ligne jamais écrite) ; en cas de différence, 412.
status string oui enabled ou disabled.

Réponse

200 OK avec la ligne d'accès et son nouvel ETag.

{
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "application_id": "app_01j9xm4n8r9s3t5v7w9x1y3z5b",
  "status": "enabled",
  "enabled_at": "2026-10-12T09:30:00.123456Z",
  "updated_at": "2026-10-12T09:30:00.123456Z",
  "version": 1
}

Erreurs

HTTP code Quand
404 not_found L'organisation ou l'application n'existe pas dans cet environnement.
409 organization_pending_deletion Activation dans une organisation en attente de suppression.
412 precondition_failed If-Match ne correspond pas à la version actuelle ; avec "0", une autre requête a d'abord écrit la ligne.
422 validation_failed status est absent ou ni enabled ni disabled.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de la permission requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période Retry-After.

Exemple

curl -i -X PUT "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/applications/app_01j9xm4n8r9s3t5v7w9x1y3z5b" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "0"' \
  -d '{"status":"enabled"}'