Skip to content
Plune Plune Plune Docs

Read a handover: the page of «Accept / Decline»

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

What the page the mail leads to shows (ADR 0050 §3): the request, the project or the company by name, and the two people by name. For the member asked and for the owner who asked; anybody else gets the 404 an id nobody has. A request that ran out reads expired — nothing marks it on time, the read decides. 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.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string format: uuid

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

Responses

Section titled “ Responses ”

200

Section titled “200 ”

The request

Media type application/json
object
handover
required

A handover as its page shows it (GET /v1/handovers/{id}): the request, the place and the two people by name.

object
id
required
string format: uuid
toUserId
required

The member asked, as GET /v1/members (or the company page) lists them

string
state
required
string
Allowed values: pending accepted declined cancelled expired
expiresAt
required
string format: date-time
scope
required
object
kind
required
string
Allowed values: project company
id
required
string
name
required
string
from
required

The owner who asked: the display name, or the address when there is none.

object
name
required
string
to
required

The member asked, the same way.

object
name
required
string
Example 
{
  "handover": {
    "id": "6f1c2b3a-0000-4000-8000-0000000000b9",
    "toUserId": "6f1c2b3a-0000-4000-8000-0000000000a2",
    "state": "pending",
    "expiresAt": "2026-08-04T09:00:00.000Z",
    "scope": {
      "kind": "project",
      "id": "u-shop::default",
      "name": "Checkout"
    },
    "from": {
      "name": "Olena Kovalenko"
    },
    "to": {
      "name": "[email protected]"
    }
  }
}

401

Section titled “401 ”

No / invalid session

403

Section titled “403 ”

An API token

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

404

Section titled “404 ”

Not a request to you or by you

Media type application/json
object
error
required
string
Example 
{
  "error": "handover '6f1c2b3a-0000-4000-8000-0000000000b9' not found"
}