/v1/oauth/consent/{request_id}AuthRead a pending consent request
Backs the consent screen (task 002). Readable only by the signed-in human the request was created for; anyone else gets the same 404 a nonexistent request gets.
Path parameters
request_id*string · uuidId of the request.
Response · 200
request_id*string · uuidclient_id*stringclient_name*stringDisplay name the client registered with.
client_uri*stringis_verified*booleanFalse for every dynamically registered client. The screen must show this prominently.
presets*arrayPresets the client requested. The consent screen renders these in one line each.
requested_policy*arrayThe policy the presets resolve to — the starting point the human narrows. Authority is whatever they approve.
escalation_actions*arrayEscalation actions (credential minting, role/policy editing, m2m issuance) the requested policy would grant. Always empty for a preset; the consent screen must surface any entry here in its own section, not among ordinary permissions.
Example: []
resource*stringRFC 8707 resource the token will be audience-bound to.
workspaces*arrayWorkspaces the human may pick from. Access is scoped to exactly one.
products*arrayEvery product a connection can be limited to, in display order. The assistant is offered only the tools of the products the human ticks, plus the workspace basics.
requested_products*arrayProducts the connect link asked to pre-select (`/mcp?products=mail,waitlist`, or `products=` on `/authorize`). Null when it named none; the screen then pre-selects the workspace’s enabled products.
Example: ["mail"]
expires_at*string · date-timeExample
Request
GET https://api.platform-auth.productcraft.co/v1/oauth/consent/{request_id}
Authorization: Bearer YOUR_TOKENResponse
{
"request_id": "00000000-0000-0000-0000-000000000000",
"client_id": "string",
"client_name": "string",
"client_uri": "string",
"is_verified": false,
"presets": [
{
"preset": "mail",
"label": "Email",
"description": "Read and send email from your verified domains."
}
],
"requested_policy": [
{
"effect": "allow",
"actions": [
"social.read",
"social.list"
],
"resources": [
"*"
]
}
],
"escalation_actions": [],
"resource": "string",
"workspaces": [
{
"id": "00000000-0000-0000-0000-000000000000",
"slug": "string",
"display_name": "string",
"role": "owner",
"enabled_products": [
"mail",
"waitlist"
]
}
],
"products": [
{
"product": "mail",
"label": "Mail"
}
],
"requested_products": [
"mail"
],
"expires_at": "2026-01-01T00:00:00.000Z"
}