Space fields

​
Set or clear a Space item field value

Requires files:write for file/folder items or doc:update for document/sheet items. Validates the value against the effective field type and config. Null deletes the stored value, including required fields; required is definition metadata. Invalid values return 400 without writing. Field values are customer data and must not be logged.

PUT
/v1/space/items/{kind}/{id}/fields/{field_id}
curl -X PUT "https://api.orchestor.io/v1/space/items/document/%3Cid%3E/fields/%3Cfield_id%3E" \  -H "Authorization: Bearer $API_KEY" \  -H "X-Workspace-ID: wks_abc123" \  -H "Content-Type: application/json" \  -d '{  "source": "user",  "value": "string"}'
{  "data": {    "field_id": "<string>",    "source": "user",    "updated_at": "2026-01-01T00:00:00Z",    "updated_by": "<string>"  }}

Get your Orchestor API key

Create an API key in your workspace settings.

Authorizations

Satisfy one of these options:

  • Session cookie
  • API key

Authentication details

cookie
wos-session

Browser session established by signing in to the web app. The server checks your workspace membership and permissions. Supply X-Workspace-ID for workspace-scoped operations. For server-to-server requests, use an API key when the operation supports it.

Path Parameters

kindstringenum<string>pathrequired
Allowed
documentsheetfilefolder
idstringpathrequired
String length
≥ 1
field_idstringpathrequired
String length
≥ 1

Headers

X-Workspace-IDstringheader

Workspace to access. With a workspace-scoped API key, the server derives this value from the key, so the header is optional. If supplied, it must match the credential workspace or the request returns 403 workspace_mismatch. For interactive session requests, supply this header to select a workspace where you are a member. A project ID cannot be used as a workspace ID.

Example"wks_abc123"

Bodyapplication/jsonrequired

Additional properties
Not allowed
sourcestringenum<string>bodydefault:user
Allowed
useraisystem
valueanybodyrequired

Any JSON value; null clears the stored value.

Response

application/json

Space resource

dataobjectrequired
data.field_idstringrequired
data.sourcestringenum<string>
Allowed
useraisystem
data.updated_atstringformat:date-time
data.updated_bystring | null
data.valueanyrequired

Any JSON value; null clears the stored value.