Skip to content
LogoLogo

Move a Project in the Workspace's shared manual order

Move a Project in the Workspace's shared manual order

POST/api/v1/projects/{project_id}/move

Places the Project between its optional neighbour anchors. Clients never send or receive a mutable position or rank. expected_revision is the Project revision being moved; a stale revision returns 409 revision_conflict. A missing, archived, or out-of-Workspace anchor returns 409 anchor_not_found.

Path Parameters

project_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-TokenRequired
string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

Idempotency-KeyRequired
string·min 16·max 200

Opaque client-generated key for safely retrying this operation.

Request Body

application/json
after_id
string <uuid>

The Project that must immediately precede the moved Project.

Example0198ac5e-f9b7-7000-8000-000000000001
before_id
string <uuid>

The Project that must immediately follow the moved Project.

Example0198ac5e-f9b7-7000-8000-000000000001
expected_revisionRequired
integer·min 1

Responses