Skip to content

Decline a request to move a project

POST
/v1/project-moves/{id}/decline
curl --request POST \
--url https://beta-api.plune.ai/v1/project-moves/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/decline \
--cookie plune_session=<plune_session>

The person asked says no: the request becomes declined, nothing else changes, and the owner may ask again; they are told by mail. Anybody else, and a request no longer open, get the 404 an id nobody has. 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 the company’s log (project.move_declined).

id
required
string format: uuid

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

Declined

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": "declined",
"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": null,
"from": {
"userId": "u-shop",
"name": "Olena Kovalenko"
},
"to": {
"userId": "6f1c2b3a-0000-4000-8000-0000000000a2",
"name": "colleague@example.com"
}
}
}

No / invalid session

An API token

Media type application/json
object
error
required
string
Example
{
"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 longer open

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