Platform API reference

Platform API · Oauth-Authorization-Server

post/v1/oauth/delegated/downstream-assertionAuth

Mint a short-lived assertion for one downstream service

Exchanges a delegated access token for a ~60s assertion audienced at ONE named service, so that service can verify the caller offline without calling back (`docs/mcp.md` §5b). The assertion carries identity — account, workspace, client, grant — and deliberately no policy: the target resolves the delegated effective policy per request through `/v1/introspect`, so a revoked grant or a demoted human is refused on the next call rather than at this assertion’s expiry.

Request body

audience*string

Hostname of the service the assertion is for, e.g. `api.mail.productcraft.co`. Must be one we issue for; anything else is 400. This is an allowlist and not a free-text audience, because the audience string is what separates this family from the session lane.

Example: "api.mail.productcraft.co"

Response · 200

assertion*string

The signed assertion. Verifies offline against the platform JWKS. Carries identity only — no policy.

expires_in*number

Seconds until it expires. Deliberately short.

Example: 60

audience*string

The audience it was minted for, echoed back.

Example: "api.mail.productcraft.co"

Example

Request

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

{
  "audience": "api.mail.productcraft.co"
}

Response

{
  "assertion": "string",
  "expires_in": 60,
  "audience": "api.mail.productcraft.co"
}