Platform API reference

Platform API · Oauth-Authorization-Server

post/v1/oauth/delegated/authorize-batchAuth

Decide many actions for a delegated access token

Evaluates a list of actions against the same live effective policy as `POST /authorize`, in one pass. Exists so an MCP server can filter a several-hundred-tool catalog down to what the session actually permits without a round trip per tool. It is a **listing** aid: a tool invocation is still decided on its own, per call.

Request body

actions*array

Actions to decide, in `<service>.<resource>.<verb>` form. Duplicates are evaluated once and echoed per entry.

Example: ["mail.send","mail.list"]

resourcestring

Resource URN every action is decided against. Omitted means `*`, which the human’s URN-narrowed denies still constrain.

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

Response · 200

decisions*array

One decision per requested action, in the order they were requested.

reason*string

Machine-readable outcome for the token as a whole: `evaluated`, `token_inactive`, `token_expired`, `grant_revoked`, `granter_not_a_member`, or `granter_account_inactive`. Anything but `evaluated` means every decision is `false`.

Example: "evaluated"

Example

Request

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

{
  "actions": [
    "mail.send",
    "mail.list"
  ],
  "resource": "pcft:envoi:domain/8f14e45f-ceea-467a-9c1a-2b8a4f2a11c3"
}

Response

{
  "decisions": [
    {
      "action": "mail.send",
      "allowed": false
    }
  ],
  "reason": "evaluated"
}