Platform API reference

Platform API · Oauth-Authorization-Server

post/v1/oauth/delegated/authorizeAuth

Decide one action for a delegated access token

Returns the live effective-policy decision for a single `(action, resource)` pair. Evaluated per call against the grant’s policy AND the authorizing human’s current workspace policy — never from a decision cached at consent time. The delegated access token is presented as the bearer.

Request body

action*string

The action to decide, in `<service>.<resource>.<verb>` form — the same catalogue the workspace-role and PAK lanes evaluate against.

Example: "mail.message.send"

resourcestring

Resource URN the action targets. Omitted means `*`, which the human’s URN-narrowed denies still constrain.

Example: "pcft:envoi:domain/8f14e45f-ceea-467a-9c1a-2b8a4f2a11c3"

Response · 200

allowed*boolean

Whether the effective policy — the grant’s policy AND the authorizing human’s current workspace policy — allows this action right now.

reason*string

Machine-readable outcome: `allowed`, `denied_by_effective_policy`, `service_not_enabled` (the workspace switched the product off), `product_not_in_connection` (the human left this product out when connecting), `token_inactive`, `token_expired`, `grant_revoked`, `granter_not_a_member`, or `granter_account_inactive` (the authorizing human’s account is suspended or deactivated).

Example: "allowed"

Example

Request

POST https://api.platform-auth.productcraft.co/v1/oauth/delegated/authorize
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "action": "mail.message.send",
  "resource": "pcft:envoi:domain/8f14e45f-ceea-467a-9c1a-2b8a4f2a11c3"
}

Response

{
  "allowed": false,
  "reason": "allowed"
}