Skip to content

Accept a request: the project moves into your company

POST
/v1/project-moves/{id}/accept
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.

id
required
string format: uuid

The move.id of the request, as the mail’s page names it

Media type application/json
object
companyId
required

A company the person asked owns, as GET /v1/companies names it — not the one the project is in

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

Accepted — the project is in your company, and you own it

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": "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

Media type application/json
object
error
required
string
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

Media type application/json
object
error
required
string
Examples
{
"error": "a project move takes the signed-in session — an API token neither asks for, answers nor reads one",
"code": "session_required"
}

Not a request to you, no longer open, or no company of that id among yours

Media type application/json
object
error
required
string
Examples
{
"error": "project move '6f1c2b3a-0000-4000-8000-0000000000ba' 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

Media type application/json
object
error
required
string
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"
}

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.

Media type application/json
One of:
object
error
required
string
Examples

A throttle: no `quota`; wait `Retry-After`

{
"error": "rate limit exceeded — slow down"
}
Retry-After
integer

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

Media type application/json
object
error
required
string
Example
{
"error": "people kept joining the project while it moved - try again"
}
Retry-After
integer

Always 1