Resolve a shared item and the caller's access to it
Given an item id — or the id of the underlying resource, which is what deep links carry — returns the owning workspace, its name, the item summary, and the caller's effective access level, so the client can route a bare link to the right workspace. Requires an authenticated caller with at least `view` on the item. Archived items and ids that match nothing are 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
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/me/shared-items/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}Replace the caller's mobile home layout
Overwrites the caller's saved mobile home layout for this workspace, and clears a stored desktop layout that was only ever a legacy mobile stand-in. Requires `workspace:read`. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Read the access list for an item
Returns the item's direct and inherited grants across its folder ancestry, pending guest invites, whether an active share link exists, the nearest ancestor that restricts inheritance, and what the caller themselves may change. Requires at least `view` on the item, and an API key additionally needs the `resources:read` scope. An unknown or malformed item id is not found.