Elenca le assegnazioni di un'applicazione in un'organizzazione

GET /v1/organizations/{org_id}/applications/{application_id}/assignments · permesso organizations:write

Elenca i membership e i gruppi di directory ai quali l'applicazione è assegnata nell'organizzazione, dal più vecchio. È supportata solo la paginazione in avanti: before e un order diverso da asc restituiscono 422. Il cursore è vincolato a questa organizzazione e a questa applicazione. Non esiste un endpoint per leggere una singola assegnazione; le assegnazioni sono immutabili e possono solo essere eliminate.

Richiesta

Campo Tipo Obbligatorio Descrizione
org_id path sì ID dell'organizzazione (org_…).
application_id path sì ID dell'applicazione (app_…).
limit query no Da 1 a 100, predefinito 20.
after query no Cursore da list_metadata.after.

Nessun corpo della richiesta.

Risposta

200 OK con una pagina di assegnazioni.

{
  "data": [
    {
      "id": "aas_01j9xq6r0t1v5w7x9y1z3a5b7d",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "application_id": "app_01j9xm4n8r9s3t5v7w9x1y3z5b",
      "target_type": "membership",
      "target_id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
      "created_at": "2026-10-12T09:31:00.123456Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errori

HTTP code Quando
400 invalid_cursor Il cursore non è valido oppure appartiene a un'altra organizzazione o applicazione.
404 not_found L'organizzazione o l'applicazione non esiste in questo ambiente.
422 validation_failed limit è fuori intervallo, oppure è stato fornito before o un order diverso da asc.
401 unauthenticated La credenziale è mancante, non valida o revocata.
403 insufficient_permissions La credenziale non ha il permesso richiesto.
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo Retry-After.
503 service_unavailable Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo Retry-After.

Esempio

curl -i "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/applications/app_01j9xm4n8r9s3t5v7w9x1y3z5b/assignments?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"