Preview what deleting a workspace item would affect
Returns the dependency impact report for the item, separating dependents that block deletion from ones that are only warnings. Requires read access to the item. Use it before `delete` to decide whether the confirmation flag is needed.
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/workspaces/string/items/string/deletion-impact"{ "data": { "target": { "kind": "workspace_item", "id": "string", "label": "string" }, "status": "safe", "summary": { "blockers": 0, "warnings": 0, "cascades": 0 }, "entries": [ { "id": "string", "kind": "workspace_item", "level": "blocking", "label": "string", "reason": "string", "action": "string", "remediation": { "capability": "actions.delete", "args": { "actionId": "string" } }, "owner": { "id": "string", "kind": "string", "label": "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}Delete a workspace item
Recomputes the deletion impact, refuses while blocking dependents remain, then deletes the item and cascades into a folder's contents, returning the item as it was before removal. Requires write access to the item. When the impact carries warnings the call is rejected until it is repeated with `confirmed=true`.
Get a surface's publish settings
Returns the surface's public-site configuration -- slug, SEO indexing, cover image, icon visibility, and theme -- or a disabled config when it has never been published. Requires view access to the surface and a signed-in session; API keys are not accepted. An unknown surface is reported as a not-publishable error.