Dynamic Client Registration (RFC 7591)

POSTapi.vdclip.com/oauth2/application

No authentication required

Body

allowed_resourcesstring[]optional

Restrict the client to a subset of resource ids. Omit or send empty to allow all registered resources.

client_namestringrequired

Human-readable client name shown on the consent screen.

client_uristringoptional

Homepage URL of the client. Linked from the consent screen.

grant_typesstring[]optional

OAuth grant types the client will use. Public clients send ["authorization_code"].

logo_uristringoptional

Logo URL shown on the consent screen.

policy_uristringoptional

redirect_urisstring[]required

Required field. Send one or more redirect URIs for authorization_code clients; an empty list is accepted only for refresh_token-only registrations.

response_typesstring[]optional

OAuth response types. Public clients send ["code"].

scopestringoptional

Space-separated scopes the client requests. Must be a subset of what the server advertises.

token_endpoint_auth_methodstringoptionale.g. none

Only "none" is supported. Clients authenticate with PKCE and send client_id at the token endpoint.

tos_uristringoptional

curl -X POST 'https://api.vdclip.com/oauth2/application' \
  -H 'Content-Type: application/json' \
  -d '{
  "client_name": "Example App",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "redirect_uris": [
    "https://app.example.com/oauth/callback"
  ],
  "response_types": [
    "code"
  ],
  "scope": "vdclip:projects:read vdclip:results:read",
  "token_endpoint_auth_method": "none"
}'

{
  "client_id": "dyn_a1b2c3d4e5f6",
  "client_id_issued_at": 1720483200,
  "client_name": "Example App",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "redirect_uris": [
    "https://app.example.com/oauth/callback"
  ],
  "registration_access_token": "rat_8e7d6c5b4a3",
  "registration_client_uri": "https://api.vdclip.com/oauth2/application/dyn_a1b2c3d4e5f6",
  "response_types": [
    "code"
  ],
  "token_endpoint_auth_method": "none"
}