Ask a member to take the project into a company they own
const url = 'https://beta-api.plune.ai/v1/projects/example/move';const options = { method: 'POST', headers: { cookie: 'plune_session=<plune_session>', 'Content-Type': 'application/json' }, body: '{"toUserId":"6f1c2b3a-0000-4000-8000-0000000000a2"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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).
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”An id from GET /v1/projects
Request Body required
Section titled “Request Body required ”object
A member of the project and of its company, as GET /v1/members names them
Example
{ "toUserId": "6f1c2b3a-0000-4000-8000-0000000000a2"}Responses
Section titled “ Responses ”Asked — waiting for the answer
object
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
When it closed; for expired, the moment it ran out
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
The project
object
The company the project is in, or was in
object
The company it went to; null until accepted
object
The owner who asked
object
The display name, or the address when the person has none
The person asked
object
The display name, or the address when the person has none
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
object
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
object
Examples
{ "error": "project owner only", "code": "owner_only"}{ "error": "company owner only — a project moves when the owner of the project owns its company too", "code": "owner_only"}{ "error": "a project move takes the signed-in session — an API token neither asks for, answers nor reads one", "code": "session_required"}No such project among yours, or nobody of that id in the project and its company
object
Example
{ "error": "member '6f1c2b3a-0000-4000-8000-0000000000a2' not found"}A personal project, or a request of it waiting for an answer already
object
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"}{ "error": "a move of this project is waiting for an answer already — withdraw it first", "code": "move_pending"}{ "error": "a handover of this project is waiting for an answer — withdraw it first", "code": "handover_pending"}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.
object
Example generated
{ "error": "example"}Headers
Section titled “Headers ”Seconds until the window rolls over