Claim a guest item invite with its token
Exchanges an item invite token for a real guest grant on that item and returns the resolved item with the caller's access level. The caller must be authenticated with a verified email that matches the invited address; a token that is expired, already used, or addressed to someone else is not found.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/me/item-invites/claim" \ -H "Content-Type: application/json" \ -d '{ "token": "string" }'{ "data": { "workspaceId": "string", "workspaceName": "string", "accessLevel": "view", "item": { "id": "0b6f2e6a-9f2c-4e7a-8d31-2c1e7a9f2c4e", "workspaceId": "4b81aa0c-6d2f-4b19-9f0e-1a7c3d5e8b02", "parentItemId": "d3a7f1b8-5c04-4e62-9a11-7b2e6c0d4f39", "kind": "database", "targetId": "9f2c1e7a-3b58-4d0c-8e27-6a1f9d4b3c85", "title": "Launch tasks", "icon": "rocket", "color": "#2f6f4f", "order": 0, "archived": false, "accessMode": "open", "metadata": {}, "createdAt": "2026-07-01T09:12:44.000Z", "updatedAt": "2026-07-14T16:03:10.000Z" }, "publicFile": { "type": "file", "meta": { "kind": "folder", "title": "string", "icon": "string", "color": "string", "allowDownload": true, "accessLevel": "view", "workspaceName": "string" }, "name": "string", "mimeType": "string", "byteSize": 0, "url": "string" } }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Revoke an item grant or pending invite
Deletes the grant or, when the id refers to a pending item invite instead, revokes that invite and cancels its queued email. Requires `full` on the item, with the `resources:write` scope for API keys. When neither a grant nor a pending invite matches, the request is not found rather than recording a phantom revocation. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
List the databases in a workspace
Returns every database in the workspace as a summary, without its fields or views; read a single database when those are needed. Requires the `databases:read` permission, and the response is cached per caller for a short window.