Accept a request: the project moves into your company
const url = 'https://beta-api.plune.ai/v1/project-moves/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/accept';const options = { method: 'POST', headers: { cookie: 'plune_session=<plune_session>', 'Content-Type': 'application/json' }, body: '{"companyId":"6f1c2b3a-0000-4000-8000-0000000000a5"}'};
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/project-moves/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/accept \ --header 'Content-Type: application/json' \ --cookie plune_session=<plune_session> \ --data '{ "companyId": "6f1c2b3a-0000-4000-8000-0000000000a5" }'The person asked, signed in, into a company they own (ADR 0075 §5) — a button on the page the mail leads to, never the link itself. Before the transaction: anybody else, and a request no longer open, get the 404 an id nobody has; a company not theirs, 404; one they do not own, 403 owner_only; the one the project is in, 400 same_company. In ONE transaction everything is read again — the request, the one who asked still the owner of the project and of its company, the person asked still in both, the project still there: one that changed is 409 stale, and the request is cancelled. Before anything changes, by the figures of preview: work still running is 409 work_in_flight; a plan whose clean-up would delete runs of the project is 409 target_keeps_less_history (with TIER_RETENTION_ENFORCE; otherwise a line in the log); files over the plan’s limit and seats over it are 429 with quota (fileBytes, writeSeats; with TIER_LIMITS_ENFORCE, otherwise a line in the log). These leave the request open. Then the project is in the company, the person asked its owner, the old owner a member when in that company, everyone else with the role the company gives them, and who is not in it leaves the project, as on a removal. Its AI keys, bucket, CI, TestRail and Jira token, API tokens, public links and open invitations stay behind; its history, files and jobs move with it. Somebody who joined the project while it moved makes the transaction start again; three times, and it is 503 with Retry-After: 1 and nothing moved. The one who asked, the new owner and each who left are told by mail. 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 logs of both companies.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The move.id of the request, as the mail’s page names it
Request Body required
Section titled “Request Body required ”object
A company the person asked owns, as GET /v1/companies names it — not the one the project is in
Example
{ "companyId": "6f1c2b3a-0000-4000-8000-0000000000a5"}Responses
Section titled “ Responses ”Accepted — the project is in your company, and you own it
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": "accepted", "createdAt": "2026-11-04T09:00:00.000Z", "expiresAt": "2026-11-11T09:00:00.000Z", "decidedAt": "2026-11-05T10:00:00.000Z", "decidedBy": "6f1c2b3a-0000-4000-8000-0000000000a2", "project": { "name": "Checkout" }, "fromCompany": { "id": "6f1c2b3a-0000-4000-8000-0000000000bb", "name": "Northwind Studio" }, "toCompany": { "id": "6f1c2b3a-0000-4000-8000-0000000000a5", "name": "Acme" }, "from": { "userId": "u-shop", "name": "Olena Kovalenko" }, "to": { "userId": "6f1c2b3a-0000-4000-8000-0000000000a2", "name": "colleague@example.com" } }}Invalid body — a companyId; or the company the project is in
object
Example
{ "error": "the project is in this company already — choose another", "code": "same_company"}No / invalid session
An API token, or a company you are in but do not own
object
Examples
{ "error": "a project move takes the signed-in session — an API token neither asks for, answers nor reads one", "code": "session_required"}{ "error": "company owner only — only the owner of a company takes a project into it", "code": "owner_only"}Not a request to you, no longer open, or no company of that id among yours
object
Examples
{ "error": "project move '6f1c2b3a-0000-4000-8000-0000000000ba' not found"}{ "error": "company '6f1c2b3a-0000-4000-8000-0000000000a5' not found"}The request no longer holds (cancelled), work is still running, or the plan would delete runs of the project — the last two leave it open; work and history carry the figures
object
Examples
{ "error": "this move no longer holds — the owner, you, the project or a company changed since it was asked; it is cancelled", "code": "stale"}{ "error": "work started in the company the project is in is still running in it — wait for it to finish or cancel it, then accept", "code": "work_in_flight", "work": [ { "kind": "testrail-import", "count": 1 } ]}{ "error": "on its plan the company would delete runs of this project — it needs a paid plan first", "code": "target_keeps_less_history", "history": { "keepsDays": 30, "runs": 14, "byAge": 14, "byLimit": 0, "at": "2026-11-05T10:00:00.000Z", "before": "2026-10-06T10:00:00.000Z" }}Two refusals share this status, and what to do about them is opposite. Rate-limited — the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442, #2092): Retry-After carries the seconds until the window rolls over, and waiting that long is the way out. Quota reached — a ceiling on what the project holds (runs in the last 24 hours, test cases, items waiting in the review queue, rules in force in the project’s memory): { error, quota }. A retry straight away frees nothing, so do not loop on it; the message says what makes room — deleting cases, working the queue down, an operator raising the limit — and the run quota, a rolling 24 hours, frees its oldest runs as they age out. Tell the two apart by the body: a 429 whose body has a quota object is a quota, one without it is a throttle. quota carries kind, limit, used, remaining and resetsAt: the figures behind the sentence, and for the run quota the instant its oldest run ages out (#1258). Retry-After is sent on a quota only where there is such an instant (the run quota: the whole seconds, at least 1, until resetsAt); the case, review-queue and project quotas free only by an action, have resetsAt: null, and send no Retry-After. GET /v1/quotas reads the same figures without a refusal.
object
The body of a 429 that is a quota and not a throttle: the sentence, and the figures behind it.
object
What was reached and the way out.
object
The ceiling. A write that would take used past it is refused with 429.
What the project holds now, counted by the same query that refuses a write.
limit - used, never below 0.
When the oldest counted run ages out of the rolling 24 hours and a slot frees on its own. null for the two quotas only an action frees (delete cases, decide queue items), and for a run quota with no runs in the window.
Examples
A throttle: no `quota`; wait `Retry-After`
{ "error": "rate limit exceeded — slow down"}A quota (#2458): the MCP server ceiling; `resetsAt` is null, nothing frees it by waiting
{ "error": "MCP server quota reached — at most 50 servers per project, and a server cannot be removed yet. Ask an operator to raise the limit.", "quota": { "kind": "mcpServersPerProject", "limit": 50, "used": 50, "remaining": 0, "resetsAt": null }}Headers
Section titled “Headers ”Seconds until the window rolls over on a throttle; on a quota, until quota.resetsAt — sent only for the run quota, which has one
People kept joining the project while it moved: three tries, nothing moved — press again
object
Example
{ "error": "people kept joining the project while it moved - try again"}Headers
Section titled “Headers ”Always 1