Skip to content

Withdraw the open request

DELETE
/v1/companies/{id}/handover
curl --request DELETE \
--url https://beta-api.plune.ai/v1/companies/example/handover \
--cookie plune_session=<plune_session>

The owner only: the open handover of the company becomes cancelled, and the member asked can no longer accept it; both are told by mail. Nothing waiting is 404. The signed-in session alone: an API token gets 403 session_required — the owner holds the secrets, and a CI token neither asks for, answers nor reads a handover. Recorded as the request is.

id
required
string

An id from GET /v1/companies

Withdrawn

No / invalid session

Somebody in the company who is not its owner, or an API token

Media type application/json
object
error
required
string
Examples
{
"error": "company owner only",
"code": "owner_only"
}

No such company among yours, or no request of it waiting

Media type application/json
object
error
required
string
Example
{
"error": "no handover of this company is waiting for an answer"
}

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