Skip to content
OTA-Pulse Docs

Deny a pending shell session (peer approval)

POST
/api/sessions/{session_id}/deny

Deny a pending shell session approval request.

The caller must hold device.shell.approve in this organisation. A non-empty reason is required.

Errors

400 — self-denial attempt. 403 — caller lacks device.shell.approve. 404 — no pending approval for this session in this org. 409 — approval already decided. 422 — missing or invalid reason.

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}/deny.

object
reason
required

Required explanation for the denial (1–1000 chars).

string
>= 1 characters <= 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