Organization

Update a unit

Replace all editable unit fields using the current revision.

PUT/v1/organization/units/{unitId}

Administrator or Sandbox developer requiredIntegration key: organization:write; or a user token with the required role.

How it works

Authenticate, set X-Organization-Id, then send the request shown alongside. The response example shows relevant fields; open OpenAPI for the complete schema.

Request body

namestringrequiredmin length 1 · max length 120

externalIdstringrequiredmin length 1 · max length 120 · default null

parentIdstringrequireduuid · default null

activebooleanrequireddefault true

revisionintegerrequiredmin 1 · max 9007199254740991

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

curl -X PUT "https://api.flowg8.io/v1/organization/units/10000000-0000-4000-8000-000000000007" \ -H "authorization: Bearer $FLOWG8_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-update-unit-001" \ -H "content-type: application/json" \ --data-raw '{ "name": "Platform engineering", "externalId": "engineering", "parentId": null, "active": true, "revision": 1 }'

{ "units": [ { "name": "Engineering", "externalId": "engineering", "parentId": null, "active": true, "id": "10000000-0000-4000-8000-000000000007", "revision": 2 } ] }

Organization

Update a unit

Replace all editable unit fields using the current revision.

PUT/v1/organization/units/{unitId}

Administrator or Sandbox developer requiredIntegration key: organization:write; or a user token with the required role.

How it works

Authenticate, set X-Organization-Id, then send the request shown alongside. The response example shows relevant fields; open OpenAPI for the complete schema.

Request body

namestringrequiredmin length 1 · max length 120

externalIdstringrequiredmin length 1 · max length 120 · default null

parentIdstringrequireduuid · default null

activebooleanrequireddefault true

revisionintegerrequiredmin 1 · max 9007199254740991

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Update a unit

How it works

Request body

Request essentials

Ask the docs

Update a unit

How it works

Request body

Request essentials

Ask the docs