Lister les liens Admin Portal
GET /v1/admin-portal-links · permission admin-portal-links:read
Liste les liens Admin Portal de l'environnement, du plus récent au plus ancien ; organization_id limite la liste à une organisation. Seule la pagination vers l'avant est prise en charge. Le curseur est lié au filtre. Les URL des liens ne sont jamais listées. consumed_at est renseigné une fois qu'un lien a ouvert sa session de portail ; revoked_at une fois qu'il a été révoqué.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
limit |
query | non | 1 à 100, par défaut 20. |
after |
query | non | Curseur issu de list_metadata.after. |
organization_id |
query | non | Identifiant de l'organisation (org_…). |
Aucun corps de requête.
Réponse
200 OK avec une page de liens.
{
"data": [
{
"id": "apl_01j9xv2c4d6e8f0g2h4j6k8m0n",
"organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
"intents": [
"dsync",
"sso"
],
"delivery": "link",
"return_url": "https://app.example.com/settings/sso",
"expires_at": "2026-10-12T09:36:00.123456Z",
"consumed_at": null,
"revoked_at": null,
"created_at": "2026-10-12T09:31:00.123456Z"
}
],
"list_metadata": {
"before": null,
"after": null
}
}
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 400 | invalid_cursor |
Le curseur est invalide ou appartient à un autre filtre. |
| 422 | validation_failed |
organization_id ou limit est invalide, ou before ou order a été fourni. |
| 401 | unauthenticated |
L'identifiant est manquant, 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 "https://api.eu.keenauth.com/v1/admin-portal-links?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"