Skip to content
adversarial

list_oauth_clients

GET
/v1/oauth/clients
curl --request GET \
  --url 'https://api.adversarial.com/api/v1/oauth/clients?page=1&page_size=25' \
  --cookie arm-session=<arm-session>

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
user_id
string | null format: uuid
page
integer format: int64
default: 1 >= 1 <= 1000000

1-indexed page number. Defaults to 1; zero is rejected.

page_size
integer format: int64
default: 25 >= 1 <= 100

Rows per page. Defaults to 25, max 100; zero is rejected.

Responses

Section titled “Responses”

200

Section titled “200”

Paginated list of OAuth clients

Media typeapplication/json

Paginated list envelope: { "results": [...], "pagination": {...} }.

object
pagination
required

Pagination metadata describing the slice.

object
page
required

1-indexed page number of this result slice.

integer format: int64
page_size
required

Number of items requested per page.

integer format: int64
total_items
required

Total number of matching items across all pages.

integer format: int64
total_pages
required

Total number of pages at this page size.

integer format: int64
results
required

The items on this page.

Array<object>
object
allowed_ips
Array<string> | null
client_id
required
string
client_name
required
string
client_secret
string | null
created_by
string | null format: uuid
created_date
required
string format: date-time
expires_at
string | null format: date-time
id
required
string format: uuid
last_used
string | null format: date-time
org_id
required
string format: uuid
revoked_at
string | null format: date-time
roles
required
Array<string>
user
required

The service-account user this key authenticates as — one user per key.

object
email
required
string
first_name
required
string
icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null
id
required
string format: uuid
last_name
required
string
user_id
required
string format: uuid
Examplegenerated
{
  "pagination": {
    "page": 1,
    "page_size": 1,
    "total_items": 1,
    "total_pages": 1
  },
  "results": [
    {
      "allowed_ips": [
        "example"
      ],
      "client_id": "example",
      "client_name": "example",
      "client_secret": "example",
      "created_by": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "created_date": "2026-04-15T12:00:00Z",
      "expires_at": "2026-04-15T12:00:00Z",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "last_used": "2026-04-15T12:00:00Z",
      "org_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "revoked_at": "2026-04-15T12:00:00Z",
      "roles": [
        "example"
      ],
      "user": {
        "email": "example",
        "first_name": "example",
        "icon": "example",
        "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
        "last_name": "example"
      },
      "user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    }
  ]
}

401

Section titled “401”

Unauthorized