Skip to content

Organization API: Customers: Oauth clients

The 2 Organization API operations for oauth clients.

View as Markdown

Part of Customers.

Operations

Section titled Operations

Method	Path	Summary
GET	`/api/v1/orgs/{org_slug}/oauth-clients`	List OAuth clients
POST	`/api/v1/orgs/{org_slug}/oauth-clients`	Create OAuth client

List OAuth clients

Section titled List OAuth clients

GET /api/v1/orgs/{org_slug}/oauth-clients

Parameters

Section titled Parameters

Name	In	Type	Required
`org_slug`	path	string	yes

Responses

Section titled Responses

Status	Meaning
`200`	Success.
`422`	The request is not valid. `detail` lists each problem.

A 200 response is a list; each item has these fields:

Field	Type
`[].id`	integer
`[].org_id`	integer
`[].client_id`	string
`[].name`	string
`[].redirect_uris`	array of any
`[].allowed_scopes`	array of any or null
`[].grant_types`	array of any or null
`[].is_active`	boolean
`[].created_at`	string (date-time) or null

Create OAuth client

Section titled Create OAuth client

POST /api/v1/orgs/{org_slug}/oauth-clients

Parameters

Section titled Parameters

Name	In	Type	Required
`org_slug`	path	string	yes

Request body

Section titled Request body

application/json (required)

Field	Type	Required
`name`	string	yes
`redirect_uris`	array of string	yes
`allowed_scopes`	array of string or null	no
`grant_types`	array of string or null	no

Responses

Section titled Responses

Status	Meaning
`201`	Success.
`422`	The request is not valid. `detail` lists each problem.

Fields of a 201 response:

Field	Type
`id`	integer
`org_id`	integer
`client_id`	string
`name`	string
`redirect_uris`	array of any
`allowed_scopes`	array of any or null
`grant_types`	array of any or null
`is_active`	boolean
`created_at`	string (date-time) or null
`client_secret`	string