Skip to main content
PUT
/
api
/
svc
/
v1
/
workspaces
Create or update a workspace
curl --request PUT \
  --url https://{controlPlaneURL}/api/svc/v1/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "manifest": {
    "type": "workspace",
    "cluster_fqn": "<string>",
    "name": "<string>",
    "environment_name": "<string>",
    "labels": {},
    "annotations": {},
    "collaborators": [
      {
        "subject": "<string>",
        "role_id": "<string>"
      }
    ],
    "permissions": [
      {
        "resource_fqn": "<string>",
        "resource_type": "<string>",
        "role_id": "<string>"
      }
    ]
  },
  "dryRun": false
}
'
{
  "data": {
    "id": "<string>",
    "fqn": "<string>",
    "tenantName": "<string>",
    "clusterId": "<string>",
    "createdBySubject": {
      "subjectId": "<string>",
      "subjectType": "user",
      "subjectSlug": "<string>",
      "subjectDisplayName": "<string>",
      "subjectPatName": "<string>",
      "subjectControllerName": "<string>",
      "subjectExternalIdentitySlug": "<string>"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "manifest": {
      "type": "workspace",
      "cluster_fqn": "<string>",
      "name": "<string>",
      "environment_name": "<string>",
      "labels": {},
      "annotations": {},
      "collaborators": [
        {
          "subject": "<string>",
          "role_id": "<string>"
        }
      ],
      "permissions": [
        {
          "resource_fqn": "<string>",
          "resource_type": "<string>",
          "role_id": "<string>"
        }
      ],
      "ownedBy": {
        "account": "<string>"
      }
    },
    "accountId": "<string>",
    "environmentId": "<string>",
    "isSystemWs": true,
    "createdBy": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
manifest
WorkspaceManifest · object
required

Workspace manifest

​
dryRun
boolean
default:false

Dry run the request

Response

The created or updated workspace.

​
data
Workspace · object
required

The workspace object with full details including cluster info.