Skip to content

Ask a member to take the project into a company they own

POST
/v1/projects/{id}/move
curl --request POST \
--url https://beta-api.plune.ai/v1/projects/example/move \
--header 'Content-Type: application/json' \
--cookie plune_session=<plune_session> \
--data '{ "toUserId": "6f1c2b3a-0000-4000-8000-0000000000a2" }'

The owner of the project who owns its company too (ADR 0075 §2). Asks a member of both to take the project, with its history, into a company that member owns; nothing changes until they accept (POST /v1/project-moves/{id}/accept), and they are told by mail, in the language of their profile, with the page to answer on — no token in it. 7 days to answer. One open request a project, and never beside an open handover of it (409 move_pending, handover_pending). The refusals in this order, so a stranger learns nothing from it: somebody outside the project gets the 404 an id nobody has; anybody else in it, 403 owner_only; a personal project, 409 not_in_company (it moves into a company by POST /v1/projects/{id}/transfer); the owner of the project who does not own the company, 403 owner_only; then the open requests; then 404 for nobody of that id in the project and the company. The signed-in session alone: an API token gets 403 session_required — the move takes the project’s secrets away and changes who owns it, so a token (a CI’s) neither asks for, answers nor reads one. Recorded in the project’s feed and in the company’s log (project.move_requested).

id
required
string

An id from GET /v1/projects

Media type application/json
object
toUserId
required

A member of the project and of its company, as GET /v1/members names them

string
>= 1 characters <= 200 characters
Example
{
"toUserId": "6f1c2b3a-0000-4000-8000-0000000000a2"
}

Asked — waiting for the answer

Media type application/json
object
move
required

A request to move a project to another company (ADR 0075). 7 days to answer, then expired. While it is open the names are today’s; once closed they are those of the moment it closed.

object
id
required
string format: uuid
projectId
required
string
state
required
string
Allowed values: pending accepted declined cancelled expired
createdAt
required
string format: date-time
expiresAt
required
string format: date-time
decidedAt
required

When it closed; for expired, the moment it ran out

string format: date-time
nullable
decidedBy
required

Who closed it: the one who asked (withdrawn), the one asked (accepted, declined); null when nobody did — cancelled as no longer holding, or run out

string
nullable
project
required

The project

object
name
required
string
fromCompany
required

The company the project is in, or was in

object
id
required
string
name
required
string
toCompany
required

The company it went to; null until accepted

object
id
required
string
name
required
string
from
required

The owner who asked

object
userId
required
string
name
required

The display name, or the address when the person has none

string
to
required

The person asked

object
userId
required
string
name
required

The display name, or the address when the person has none

string
Example
{
"move": {
"id": "6f1c2b3a-0000-4000-8000-0000000000ba",
"projectId": "u-shop::default",
"state": "pending",
"createdAt": "2026-11-04T09:00:00.000Z",
"expiresAt": "2026-11-11T09:00:00.000Z",
"decidedAt": null,
"decidedBy": null,
"project": {
"name": "Checkout"
},
"fromCompany": {
"id": "6f1c2b3a-0000-4000-8000-0000000000bb",
"name": "Northwind Studio"
},
"toCompany": null,
"from": {
"userId": "u-shop",
"name": "Olena Kovalenko"
},
"to": {
"userId": "6f1c2b3a-0000-4000-8000-0000000000a2",
"name": "colleague@example.com"
}
}
}

Invalid body — a toUserId

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid session

Somebody in the project who is not its owner, its owner who does not own the company, or an API token

Media type application/json
object
error
required
string
Examples
{
"error": "project owner only",
"code": "owner_only"
}

No such project among yours, or nobody of that id in the project and its company

Media type application/json
object
error
required
string
Example
{
"error": "member '6f1c2b3a-0000-4000-8000-0000000000a2' not found"
}

A personal project, or a request of it waiting for an answer already

Media type application/json
object
error
required
string
Examples
{
"error": "this project is not in a company — a personal project moves into one by POST /v1/projects/{id}/transfer",
"code": "not_in_company"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over