Register a client (RFC 7591)

​

Dynamic Client Registration. A public client (token_endpoint_auth_method absent or none) receives a client_id only; a confidential client (client_secret_post or client_secret_basic) also receives a client_secret, shown once. Either kind must use PKCE, is shown as unverified on the consent screen, and may request only the self-service scope set. Redirect URIs must be HTTPS or loopback addresses. Unknown metadata fields are ignored. Rate-limited per caller; a registered client that never completes a connection is removed after thirty days. Most MCP clients use a Client ID Metadata Document instead and never call this.

Body·

required
application/json

RFC 7591 registration request. token_endpoint_auth_method absent or none registers a public client; client_secret_post or client_secret_basic registers a confidential client and returns a secret. Unknown metadata fields are ignored.

  • HTTPS URIs, or loopback http://localhost, http://127.0.0.1, http://[::1] URIs (matched without their port).

  • Absent means none.

Responses

  • application/json
  • application/json
  • Too many registrations from this address; Retry-After says when to retry.

Request Example for post/v1/oauth/register
curl https://api.signstack.ai/v1/oauth/register \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "client_name": "My assistant",
  "redirect_uris": [
    "https://assistant.example.com/oauth/callback"
  ],
  "token_endpoint_auth_method": "none",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "response_types": [
    "code"
  ]
}'
{
  "client_id": "oc_01jv8m7qfj6xj9gkz7a4s2h8e",
  "client_id_issued_at": 1792396800,
  "client_name": "My assistant",
  "redirect_uris": [
    "https://assistant.example.com/oauth/callback"
  ],
  "token_endpoint_auth_method": "none",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "response_types": [
    "code"
  ],
  "scope": "workflow:read workflow:create workflow:update resource:read resource:create resource:update scenario:read scenario:create scenario:update shareable-link:read shareable-link:create shareable-link:update"
}