List artist invitations
Lists the gallery's artist studio-claim invitations, newest first, with cursor pagination. Filter with ?status=pending or ?artist_id=artist_….
Lists the gallery's artist studio-claim invitations, newest first, with cursor pagination. Filter with ?status=pending or ?artist_id=artist_….
Authorization
bearerAuth artists:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:read
Query Parameters
1 <= value <= 10020Value in
- "pending"
- "accepted"
- "revoked"
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", "artist_id": "string", "email": "string", "status": "pending", "share_profile": true, "expires_at": "string", "created_at": "string" } ], "next_cursor": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}Revoke an artist invitation DELETE
Revokes a pending artist invitation (soft: flips its status to revoked, freeing the artist for a re-invite). The claim link stops working immediately.
Resend an artist invitation POST
Re-issues a pending artist invitation: mints a fresh claim token, resets the 7-day expiry, and re-emails the artist. Requires an Idempotency-Key header (the email is an irreversible side effect): a retry with the same key replays the original result for 24h instead of emailing again.