Platform API reference

Platform API · Oauth-Authorization-Server

get/.well-known/oauth-authorization-server

OAuth 2.1 authorization server metadata (RFC 8414)

Discovery document for third-party clients (Claude Desktop, Cursor, the ProductCraft MCP server). PKCE with `S256` is mandatory; no other code-challenge method is advertised or accepted. `scopes_supported` lists **presets**, not scopes: authority is the policy document on the grant (`authority_model`).

Response · 200

issuer*string

Issuer identifier. Matches the `iss` claim on every access token this server mints.

Example: "https://api.platform-auth.productcraft.co"

authorization_endpoint*string

RFC 6749 authorization endpoint.

token_endpoint*string

RFC 6749 token endpoint.

registration_endpoint*string

RFC 7591 dynamic client registration endpoint.

revocation_endpoint*string

RFC 7009 token revocation endpoint.

introspection_endpoint*string

RFC 7662 token introspection endpoint.

jwks_uri*string

JWKS the access-token signature verifies against.

response_types_supported*array

Only `code` — the implicit and password grants do not exist here.

Example: ["code"]

grant_types_supported*array

OAuth grant types the token endpoint accepts (RFC 8414).

Example: ["authorization_code","refresh_token"]

code_challenge_methods_supported*array

S256 only. `plain` is rejected, and an authorization request without a challenge is rejected.

Example: ["S256"]

token_endpoint_auth_methods_supported*array

Client authentication methods the token endpoint accepts (RFC 8414).

Example: ["none","client_secret_basic","client_secret_post"]

scopes_supported*array

Preset names accepted in the `scope` parameter. A preset is a policy *template*, never authority in itself — see `authority_model`. Ordinary OAuth scopes do not exist on this server.

Example: ["readonly","mail","support","full"]

scope_descriptions*object

Plain-language description per preset. Non-standard, published so a client can render the same wording the consent screen uses.

scope_labels*object

Non-standard. Display name per preset (`readonly` is shown as "Read-only"), the same names the consent screen uses.

Example: {"readonly":"Read-only","mail":"Email","support":"Support assistant","full":"Full access"}

authority_model*string

Non-standard. Declares that authority on this server is an IAM policy document stored on the grant, intersected per request with the authorizing human’s current workspace policy — so a demotion or an offboarding takes effect on the next call rather than at token expiry. The `scope` parameter only names a preset the human then narrows.

Example: "policy"

resource_indicators_supported*array

RFC 8707 resource indicators this server will mint an audience for.

service_documentation*string

Human-readable documentation for this authorization server.

Example

Request

GET https://api.platform-auth.productcraft.co/.well-known/oauth-authorization-server

Response

{
  "issuer": "https://api.platform-auth.productcraft.co",
  "authorization_endpoint": "string",
  "token_endpoint": "string",
  "registration_endpoint": "string",
  "revocation_endpoint": "string",
  "introspection_endpoint": "string",
  "jwks_uri": "string",
  "response_types_supported": [
    "code"
  ],
  "grant_types_supported": [
    "authorization_code",
    "refresh_token"
  ],
  "code_challenge_methods_supported": [
    "S256"
  ],
  "token_endpoint_auth_methods_supported": [
    "none",
    "client_secret_basic",
    "client_secret_post"
  ],
  "scopes_supported": [
    "readonly",
    "mail",
    "support",
    "full"
  ],
  "scope_descriptions": {},
  "scope_labels": {
    "readonly": "Read-only",
    "mail": "Email",
    "support": "Support assistant",
    "full": "Full access"
  },
  "authority_model": "policy",
  "resource_indicators_supported": [
    "string"
  ],
  "service_documentation": "string"
}