---
title: "Request Authorization"
method: POST
path: "/model/{env}/processes/{pid}/request_authorization"
---

# Request Authorization

`POST /model/{env}/processes/{pid}/request_authorization`

## Request

- Base URL: `https://api-docs.session-exchange.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.session-exchange.com/model/{env}/processes/{pid}/request_authorization`
- Auth: none declared

The loop records that a process's SHADOW champion (a generated automation
that met its target) awaits human live-authorization — it lands in the
inbox. The loop requests; only a human (admin) authorizes.

## Path parameters

- `env` string, required
- `pid` string, required

## Request body

- AuthorizationRequest: A request to put a process's shadow champion through the human-gated live-authorization (environment-model + codegen authorize_live).
  - `candidate_id` string, nullable
  - `artifact_ref` string, nullable
  - `artifact_summary` string, nullable
  - `score` number, nullable
  - `threshold` number, nullable
  - `artifact` object, nullable
  - `oracle_receipt` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/session-exchange/apis/a4sx.md) · [All operations](https://skmtc.dev/session-exchange/apis/a4sx/llms.txt) · [OpenAPI document](https://skmtc.dev/session-exchange/apis/a4sx/revisions/abaefc33dfc7?raw)