Workspaces - Truedy API Documentation

Workspace management requires an account-scoped master API key. Existing workspace-scoped keys continue to work for the single workspace they belong to.

Select a workspace

For resource requests made with a master key, send the target workspace in the X-Truedy-Workspace-Id header. The key must have an explicit grant for that workspace.

curl https://api.truedy.ai/api/public/v1/agents \
  -H "Authorization: Bearer YOUR_MASTER_API_KEY" \
  -H "X-Truedy-Workspace-Id: org_workspace_id"

List granted workspaces

curl https://api.truedy.ai/api/public/v1/workspaces \
  -H "Authorization: Bearer YOUR_MASTER_API_KEY"

Workspace creation and access grants are intentionally dashboard-only. The public master-key surface is limited to listing granted workspaces and updating a workspace the key already controls.

Update a workspace

curl -X PATCH https://api.truedy.ai/api/public/v1/workspaces/org_workspace_id \
  -H "Authorization: Bearer YOUR_MASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Support Europe"}'

Workspace deletion is intentionally not exposed by this first version. Deleting a Clerk Organization and its Truedy data requires an explicit retention and recovery policy.