Create workspace items from a gallery listing
Instantiates any gallery listing into the calling workspace by its provider-qualified `templateId`, which the registry routes to the provider that owns it, filling declared inputs from `answers` and placing the new root under `parentItemId`. Requires `resources:write` in the workspace, and listings that create many records are checked against its record allowance; an id that is malformed or claimed by no provider returns not-found. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
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
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/workspaces/string/template-gallery/instantiate" \ -H "Content-Type: application/json" \ -d '{ "templateId": "string" }'{ "data": { "templateId": "string", "provider": "workspace", "rootItem": { "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" }, "createdItemIds": [ "string" ], "report": { "remappedReferenceCount": 0, "references": [ { "outcome": "remapped", "class": "item", "opType": "item.create", "sourceId": "string", "path": "string", "value": "string", "reason": "string" } ], "degradedPermissions": [ { "opType": "item.create", "sourceId": "string", "setting": "accessMode", "requested": "string", "applied": "string", "reason": "string" } ], "skippedOps": [ { "opType": "item.create", "sourceId": "string", "reason": "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}Describe one template gallery listing
Returns the full detail for a single listing, including its declared inputs and what it will create. `templateId` is provider-qualified, such as `workspace:<uuid>` or `builtin:service-shop`, and travels as a query parameter because it contains a colon. Requires workspace membership; an id that is malformed or claimed by no provider returns not-found.
Read the publish-to-web settings of a database
Returns the database's public configuration: whether it is published, its `/wp` slug, whether search engines may index it, and when it was first published. Reads `enabled: false` for a database that has never been published. Requires a signed-in workspace session with `databases:read` on the database; API keys are not accepted on this surface. An unknown database returns a not-publishable error.