Register a client (once per origin)

POST

/oauth/register

curl --request POST \
  --url https://api.harperharbor.com/oauth/register \
  --header 'Content-Type: application/json' \
  --data '{ "client_name": "Your app", "redirect_uris": [ "https://app.example.com/oauth/callback" ], "grant_types": [ "authorization_code", "refresh_token" ] }'

Dynamic client registration. Redirect URIs must be https (http://localhost and loopback IPs are accepted for development) and must not contain a fragment. Persist the returned client_id, keyed by origin.

Request Body^required

Media typeapplication/json

object

client_name

required

string

redirect_uris

required

Array<string>

grant_types

required

Array<string>

Allowed values: authorization_code refresh_token

Example

{
  "client_name": "Your app",
  "redirect_uris": [
    "https://app.example.com/oauth/callback"
  ],
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ]
}

Responses

201

Registered.

Media typeapplication/json

object

client_id

string

key

additional properties

any

Example^generated

{
  "client_id": "example"
}