Work

Update Work Project

Rename one project, re-describe it, or move its status.

Field PRESENCE is the contract: an omitted field keeps its stored value and description: null clears it. 403 unless the caller created the project or holds Owner/Admin — the SAME rule deletion uses, and the role half only answers correctly because of with_org_role.

patch/work/projects/{project_id}

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/work/projects/{project_id}
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project id

Headers

Idempotency-Keystring nullable

Retry-safety key. Replaying one returns the ORIGINAL result with duplicate: true instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry.

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring nullable
descriptionstring nullable
status'active' | 'paused' | 'completed' | 'archived' nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.