Read a request to move a project: the page of «Accept / Decline»
const url = 'https://beta-api.plune.ai/v1/project-moves/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET', headers: {cookie: 'plune_session=<plune_session>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://beta-api.plune.ai/v1/project-moves/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --cookie plune_session=<plune_session>The request, for its two people: the owner who asked and the person asked; anybody else gets the 404 an id nobody has. A request that ran out reads expired. With ?companyId=, the person asked, while the request is open, also gets preview: what the move would do in that company of theirs — the people with their roles after it, the seats, the files against the plan’s limit, the runs its clean-up would delete, what stays behind, the files left in the bucket and the work still running. It comes from the function that decides the acceptance, so the page and the button never disagree. For anybody else, or a request no longer open, companyId is ignored. 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.
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
Query Parameters
Section titled “Query Parameters ”A company the person asked owns, as GET /v1/companies names it: adds preview. Not theirs is 404, theirs but not owned 403 owner_only, the one the project is in 400 same_company
Responses
Section titled “ Responses ”The request, and with companyId what the move would do there
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
What the move would do in the company named, from the same function that decides the acceptance (ADR 0075 §3): every figure the page shows.
object
object
Everyone in the project, by user id
object
The display name, or the address
The role in the project after the move: the person asked is its owner; the old owner, in that company, a member; the others the role the company gives them. null — they are not in that company and leave the project
object
The write seats of the company the project goes to
object
Held now
Held once the project is in, its people with the roles they would have
The plan’s limit; null — none
The reader seats of the company the project goes to
object
Held now
Held once the project is in, its people with the roles they would have
The plan’s limit; null — none
User ids that take a write seat of the company they do not hold now (the old owner, a reader there, becoming a member)
Both pools within their limits after the move, or no fuller than now
object
The project’s files kept in the database (not those in a bucket)
What is held against the limit after the move: the project’s bytes on a paid plan; all the company’s projects with this one on Free
What the clean-up of the company’s plan would delete of the project’s runs — as of the end of its grace on a lapsed paid plan, as of now on Free
object
Days of runs the plan keeps; null — every run
Runs of the project it would delete, by age and by the results limit together
The day of that clean-up; null when it clears nothing
A run that finished before this is too old on it
What stays behind (ADR 0075 §8): whether each connection is there, and how many tokens, public reports and invitations go
object
The AI keys and the monthly limit
The storage bucket
The Jira token goes; the connection’s row stays, disconnected
The GitHub Issues token goes; the connection’s row stays, disconnected
API tokens tied to the project, of everyone
Public links of its runs
The public link of its test documentation (#2750): deleted with its snapshot
Its notification channels (#2754, a Slack webhook): deleted - a channel is the old team’s
Open invitations into the project
The project’s files in the bucket connected to it: the move leaves them there and closed until a bucket is connected again
object
Work started in the company the project is in and not finished; any of it refuses the acceptance (409 work_in_flight)
object
A job’s kind (testrail-import, run-export …), ci-launch (a CI run the worker still watches), case-generation or requirement-extraction
Whether the plan’s limits refuse (429) and the history refuses (409); off, the same figures only warn in the log
object
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" } }, "preview": { "company": { "id": "6f1c2b3a-0000-4000-8000-0000000000a5", "name": "Acme", "tier": "team" }, "people": [ { "userId": "6f1c2b3a-0000-4000-8000-0000000000a2", "name": "colleague@example.com", "email": "colleague@example.com", "roleNow": "member", "roleAfter": "owner" }, { "userId": "u-qa", "name": "Taras Melnyk", "email": "qa@example.com", "roleNow": "member", "roleAfter": null }, { "userId": "u-shop", "name": "Olena Kovalenko", "email": "owner@example.com", "roleNow": "owner", "roleAfter": "member" } ], "seats": { "writers": { "used": 1, "after": 2, "limit": 50 }, "readers": { "used": 0, "after": 0, "limit": 5 }, "newWriters": [ "u-shop" ], "fits": true }, "storage": { "projectBytes": 18874368, "countedBytes": 18874368, "limit": 10737418240, "per": "project", "fits": true }, "history": { "keepsDays": null, "runs": 0, "byAge": 0, "byLimit": 0, "at": null, "before": null }, "disconnects": { "ai": true, "bucket": true, "ci": true, "testrail": false, "jira": false, "github": false, "apiTokens": 2, "publicReports": 1, "testDocsLink": false, "notificationChannels": true, "invitations": 1 }, "bucketFiles": { "count": 312, "bytes": 1288490188 }, "workInFlight": [], "enforced": { "limits": true, "history": false } }}The company named is the one 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 of the person asked that they 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 or by you, 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"}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