Create OAuth2 client

​

Registers a new OAuth2 client. Requires clientName and redirectUris (HTTPS only, max 5, localhost allowed). Returns auto-generated clientId and clientSecret (secret shown only once).

Body
required
application/json
  • clientName
    Type: string
    required

    Client application name

  • redirectUris
    Type: array string[]
    required

    Allowed redirect URIs (HTTPS required except localhost, max 5)

  • grantTypes
    Type: array string[] enum

    Defaults to both if not provided

    values
    • authorization_code
    • refresh_token
  • scope
    Type: string

    Space-delimited scopes per RFC 7591, e.g. 'user:read todo:write'

Responses
  • application/json
  • 400

    Invalid request data

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/auth/oauth/client
curl https://test.boost.space/api/auth/oauth/client \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "clientName": "",
  "redirectUris": [
    ""
  ],
  "scope": "",
  "grantTypes": [
    "authorization_code"
  ]
}'

{
  "id": 42,
  "created": "2026-01-15T09:30:00Z",
  "createdUserId": 42,
  "updated": "2026-01-15T09:30:00Z",
  "updatedUserId": 42,
  "clientId": "string",
  "clientName": "Sample clientName",
  "redirectUris": [
    "https://acme.boost.space"
  ],
  "scopes": [
    "string"
  ],
  "tokenId": 42
}

OAuth2 client created