Gallery Platform API
Reference

List a drop's allocation queue

Returns the drop's ranked claim queue (the selection outcome) in position order — the gallerist review read-back. Each row is one entrant: their rank and claim state. Empty until the selection engine has run at `closes_at`.

GET
/gallery/drops/{dropId}/allocations

Returns the drop's ranked claim queue (the selection outcome) in position order — the gallerist review read-back. Each row is one entrant: their rank and claim state. Empty until the selection engine has run at closes_at.

Authorization

bearerAuth drops:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: drops:read

Path Parameters

dropId*string

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "id": "string",      "contact_id": "string",      "position": -9007199254740991,      "state": "queued",      "offered_at": "string",      "claim_expires_at": "string",      "resolved_at": "string",      "override_reason": "string"    }  ]}

Verify and provision a custom domain POST

Re-checks the verification TXT record, attaches the host to Vercel, and advances the domain's status (pending_dns → verifying → active). Returns the updated domain.

Cancel a drop POST

Cancels a drop (the one member-driven state transition). A fulfilled or already-canceled drop cannot be canceled.