Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Create a new workspace

Create a new workspace

Creates a new workspace (space) in the user's vault with optional name, description, color, and playground flag.

POST/api/workspaces
Body
namestringrequired
descriptionstring
colorobject
playgroundboolean

Request

curl
curl -X POST https://trickest.io/api/workspaces \
  -H "Authorization: Bearer $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

201Created workspace
idstringrequired
namestringrequired
descriptionstring
vault_infoobject
colorstring
playgroundboolean
authorstring
author_infoobject
projects_countnumber
workflows_countnumber
created_datestringrequired
modified_datestringrequired
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousWorkspacesList workspaces for the current user's vaultWorkspacesNextGet a workspace by ID