Platform API reference

Platform API · Oauth-Authorization-Server

post/v1/oauth/delegated/authorize-assertionAuth

Decide one action for a downstream assertion

The REST-service counterpart of `POST /authorize`. A service holds only the short-lived assertion, never the delegated access token, so it asks here. Evaluated against the grant’s consented policy AND the authorizing human’s current workspace policy, live and uncached — a revoked grant, a demoted human or an offboarded one is refused on the next call.

Request body

action*string

Action to decide, `<service>.<resource>.<verb>`.

resourcestring

URN the action targets. Omitted means `*`, the strict reading.

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-assertion
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "action": "string",
  "resource": "string"
}

Response

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