OAuth apps to review

GET/admin/oauth-apps

AdminBeta: may change

Admin → OAuth apps: apps waiting for review (oldest first), or every app. Signed-in admins only: no key can review apps.

SDK method: collector.listOAuthAppsForReview()
Headers: X-Request-Id

Query parameters

statusenum
pending: waiting for review, oldest first. all: every app, newest first.
default "pending"
One ofpendingall

Responses

200OKThe apps.

AdminOAuthAppList

dataarray of AdminOAuthApprequired

4Errors400 · 404 · 429 · 500

400
invalid_request
invalid_request: The query or body doesn’t match the schema (see errors[]).
404
not_found
not_found: Not an admin (moderator): the same 404 as a missing route.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).

curl 'https://api.collection.id/v1/admin/oauth-apps?status=pending' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

{
  "data": [
    {
      "id": "5e7a9c1b-3d2f-4a6e-8b0c-1d3f5a7b9c2e",
      "clientId": "app_k3v9q2m7x1c8d4f6h0j5",
      "clientType": "confidential",
      "name": "Shelfie",
      "description": "Your collection on a shelf you can share.",
      "homepageUrl": "https://shelfie.example",
      "privacyUrl": "https://shelfie.example/privacy",
      "termsUrl": null,
      "logoPath": "6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/app-3f2a9c.webp",
      "logoUrl": "https://example.supabase.co/storage/v1/object/public/avatars/6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/app-3f2a9c.webp",
      "redirectUris": [
        "https://shelfie.example/callback",
        "http://127.0.0.1/callback"
      ],
      "scopes": [
        "catalog:read",
        "collection:read",
        "collection:write"
      ],
      "secret": {
        "display": "ccs_live_Xq3b…",
        "createdAt": "2026-10-13T06:47:11.610Z",
        "previousExpiresAt": null
      },
      "review": {
        "status": "pending",
        "approvedScopes": [],
        "awaitingScopes": [
          "collection:write"
        ],
        "note": null,
        "requestedAt": "2026-10-13T06:47:11.610Z",
        "reviewedAt": null
      },
      "suspendedAt": null,
      "suspendedReason": null,
      "connections": 0,
      "createdAt": "2026-10-13T06:47:11.610Z",
      "updatedAt": "2026-10-13T06:47:11.610Z",
      "developer": {
        "id": "6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90",
        "label": "A Developer"
      }
    }
  ]
}

Responses

200OKThe apps.

AdminOAuthAppList

dataarray of AdminOAuthApprequired

4Errors400 · 404 · 429 · 500

400
invalid_request
invalid_request: The query or body doesn’t match the schema (see errors[]).
404
not_found
not_found: Not an admin (moderator): the same 404 as a missing route.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).

{ "data": [ { "id": "5e7a9c1b-3d2f-4a6e-8b0c-1d3f5a7b9c2e", "clientId": "app_k3v9q2m7x1c8d4f6h0j5", "clientType": "confidential", "name": "Shelfie", "description": "Your collection on a shelf you can share.", "homepageUrl": "https://shelfie.example", "privacyUrl": "https://shelfie.example/privacy", "termsUrl": null, "logoPath": "6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/app-3f2a9c.webp", "logoUrl": "https://example.supabase.co/storage/v1/object/public/avatars/6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/app-3f2a9c.webp", "redirectUris": [ "https://shelfie.example/callback", "http://127.0.0.1/callback" ], "scopes": [ "catalog:read", "collection:read", "collection:write" ], "secret": { "display": "ccs_live_Xq3b…", "createdAt": "2026-10-13T06:47:11.610Z", "previousExpiresAt": null }, "review": { "status": "pending", "approvedScopes": [], "awaitingScopes": [ "collection:write" ], "note": null, "requestedAt": "2026-10-13T06:47:11.610Z", "reviewedAt": null }, "suspendedAt": null, "suspendedReason": null, "connections": 0, "createdAt": "2026-10-13T06:47:11.610Z", "updatedAt": "2026-10-13T06:47:11.610Z", "developer": { "id": "6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90", "label": "A Developer" } } ] }