Skip to content
OTA-Pulse Docs

Approve a pending shell session (peer approval)

POST
/api/sessions/{session_id}/approve

Approve a pending shell session approval request.

The caller must hold device.shell.approve in this organisation. Self-approval (approver == requestor) is always rejected.

Errors

400 — self-approval attempt. 403 — caller lacks device.shell.approve. 404 — no pending approval for this session in this org. 409 — approval already decided. 422 — validation error.

Authorizations

Parameters

Path Parameters

session_id
required
string format: uuid

Query Parameters

organization_id
required
string format: uuid

Request Body required

Request body for POST /sessions/{id}/approve.

object
reason
Any of:
string
<= 1000 characters

Responses

200

Successful Response

Public representation of an approval decision (S19-002).

Returned by POST /sessions/{id}/approve and POST /sessions/{id}/deny.

object
approver_id
required
Any of:
string format: uuid
decided_at
required
Any of:
string format: date-time
decision
required
string
id
required
string format: uuid

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string