Skip to main content
POST
/
oauth
/
register
Register OAuth Client
curl --request POST \
  --url https://api.hyperline.co/oauth/register \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "redirect_uris": [
    "http://localhost:3000/callback"
  ],
  "client_name": "Claude Desktop",
  "client_uri": "<string>",
  "logo_uri": "<string>",
  "scope": "read write",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "response_types": [
    "code"
  ],
  "token_endpoint_auth_method": "none",
  "software_id": "<string>",
  "software_version": "<string>",
  "contacts": [
    "[email protected]"
  ],
  "tos_uri": "<string>",
  "policy_uri": "<string>"
}
'
{
  "client_id": "dyn_abc123xyz789",
  "client_id_issued_at": 123,
  "redirect_uris": [
    "<string>"
  ],
  "grant_types": [
    "<string>"
  ],
  "response_types": [
    "<string>"
  ],
  "token_endpoint_auth_method": "none",
  "client_name": "<string>",
  "client_uri": "<string>",
  "logo_uri": "<string>",
  "scope": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
redirect_uris
string<uri>[]
required

Array of redirect URIs for the client.

Minimum array length: 1
Example:
["http://localhost:3000/callback"]
​
client_name
string

Human-readable name of the client.

Example:

"Claude Desktop"

​
client_uri
string<uri>

URL of the client's home page.

​
logo_uri
string<uri>

URL of the client's logo.

​
scope
string

Space-separated list of requested scopes.

Example:

"read write"

​
grant_types
enum<string>[]

Grant types the client will use.

Available options:
authorization_code,
refresh_token
Example:
["authorization_code", "refresh_token"]
​
response_types
enum<string>[]

Response types the client will use.

Available options:
code
Example:
["code"]
​
token_endpoint_auth_method
enum<string>

Authentication method for token endpoint. Only 'none' is supported for public clients.

Available options:
none
​
software_id
string

Unique identifier for the client software.

​
software_version
string

Version of the client software.

​
contacts
string<email>[]

Contact emails for the client developers.

​
tos_uri
string<uri>

URL to the client's terms of service.

​
policy_uri
string<uri>

URL to the client's privacy policy.

Response

201 - application/json
​
client_id
string
required

Unique client identifier.

Example:

"dyn_abc123xyz789"

​
client_id_issued_at
number
required

Unix timestamp when client_id was issued.

​
redirect_uris
string[]
required

Registered redirect URIs.

​
grant_types
string[]
required

Grant types the client can use.

​
response_types
string[]
required

Response types the client can use.

​
token_endpoint_auth_method
enum<string>
required

Authentication method for token endpoint.

Available options:
none
​
client_name
string

Human-readable name of the client.

​
client_uri
string

URL of the client's home page.

​
logo_uri
string

URL of the client's logo.

​
scope
string

Space-separated list of granted scopes.