Skip to content

Read a request to move a project: the page of «Accept / Decline»

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

id
required
string format: uuid

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

companyId
string

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

The request, and with companyId what the move would do there

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
preview

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
company
required
object
id
required
string
name
required
string
tier
required
string
Allowed values: free personal team enterprise
people
required

Everyone in the project, by user id

Array<object>
object
userId
required
string
name
required

The display name, or the address

string
email
required
string
roleNow
required
string
Allowed values: owner manager member reader
roleAfter
required

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

string
nullable
Allowed values: owner manager member reader
seats
required
object
writers
required

The write seats of the company the project goes to

object
used
required

Held now

integer
after
required

Held once the project is in, its people with the roles they would have

integer
limit
required

The plan’s limit; null — none

integer
nullable
readers
required

The reader seats of the company the project goes to

object
used
required

Held now

integer
after
required

Held once the project is in, its people with the roles they would have

integer
limit
required

The plan’s limit; null — none

integer
nullable
newWriters
required

User ids that take a write seat of the company they do not hold now (the old owner, a reader there, becoming a member)

Array<string>
fits
required

Both pools within their limits after the move, or no fuller than now

boolean
storage
required
object
projectBytes
required

The project’s files kept in the database (not those in a bucket)

integer
countedBytes
required

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

integer
limit
required
integer
per
required
string
Allowed values: project company
fits
required
boolean
history
required

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
keepsDays
required

Days of runs the plan keeps; null — every run

integer
nullable
runs
required

Runs of the project it would delete, by age and by the results limit together

integer
byAge
required
integer
byLimit
required
integer
at
required

The day of that clean-up; null when it clears nothing

string format: date-time
nullable
before
required

A run that finished before this is too old on it

string format: date-time
nullable
disconnects
required

What stays behind (ADR 0075 §8): whether each connection is there, and how many tokens, public reports and invitations go

object
ai
required

The AI keys and the monthly limit

boolean
bucket
required

The storage bucket

boolean
ci
required
boolean
testrail
required
boolean
jira
required

The Jira token goes; the connection’s row stays, disconnected

boolean
github
required

The GitHub Issues token goes; the connection’s row stays, disconnected

boolean
apiTokens
required

API tokens tied to the project, of everyone

integer
publicReports
required

Public links of its runs

integer
testDocsLink
required

The public link of its test documentation (#2750): deleted with its snapshot

boolean
notificationChannels
required

Its notification channels (#2754, a Slack webhook): deleted - a channel is the old team’s

boolean
invitations
required

Open invitations into the project

integer
bucketFiles
required

The project’s files in the bucket connected to it: the move leaves them there and closed until a bucket is connected again

object
count
required
integer
bytes
required
integer
workInFlight
required

Work started in the company the project is in and not finished; any of it refuses the acceptance (409 work_in_flight)

Array<object>
object
kind
required

A job’s kind (testrail-import, run-export …), ci-launch (a CI run the worker still watches), case-generation or requirement-extraction

string
count
required
integer
>= 1
enforced
required

Whether the plan’s limits refuse (429) and the history refuses (409); off, the same figures only warn in the log

object
limits
required
boolean
history
required
boolean
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

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 of the person asked that they 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 or by you, 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"
}

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