IntegrationOS OAuth Clients API

The OAuth Clients API from IntegrationOS — 7 operation(s) for oauth clients.

Documentation GitHub OpenAPI

Business capability

Developer Identity & Credential Management BC-4270.40

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/oauth-clients List the OAuth clients I've registered · List oauth clients #

Ask an LLM

“Which OAuth client applications have I registered so far?”

“Can I page through my registered OAuth clients?”

Tell an agent

List my registered OAuth clients.

Show page {page} of my OAuth client registrations.

POST /v1/oauth-clients Register a new OAuth client app · Create oauth client #

Ask an LLM

“How do I register an app so it can request OAuth access on behalf of users?”

“Can I choose the access-token lifetime when I register a new OAuth client?”

Tell an agent

Register a {clientType} OAuth client named {name} redirecting to {redirectUris}.

Create OAuth app {name} ({clientType}) with redirects {redirectUris} and token lifetime {accessTokenTtl} seconds.

DELETE /v1/oauth-clients/{client_id} Delete a registered OAuth client · Delete oauth client #

Ask an LLM

“How do I delete an OAuth client app I no longer use?”

“Can I unregister an OAuth app completely rather than just deactivating it?”

Tell an agent destructive · confirm first

Delete OAuth client {client_id}.

Unregister OAuth app {client_id} permanently.

GET /v1/oauth-clients/{client_id} Get an OAuth client's settings · Retrieve oauth client #

Ask an LLM

“What redirect URIs and token lifetime are configured on one of my OAuth clients?”

“Can I look up a registered OAuth app by its public client ID?”

Tell an agent

Get OAuth client {client_id}.

Show the registration settings of OAuth app {client_id}.

PATCH /v1/oauth-clients/{client_id} Update an OAuth client's settings · Update oauth client #

Ask an LLM

“Can I change the redirect URIs on an OAuth app I already registered?”

“How do I deactivate an OAuth client without deleting it?”

Tell an agent

Set the redirect URIs of OAuth client {client_id} to {redirectUris}.

Mark OAuth app {client_id} active = {isActive}.

GET /v1/oauth-clients/{client_id}/permission-sets List an OAuth client's permission sets · List permission sets #

Ask an LLM

“Which permission sets are defined for one of my OAuth clients?”

“Can I see every connector grant bundle an OAuth app offers?”

Tell an agent

List the permission sets on OAuth client {client_id}.

Show page {page} of OAuth app {client_id}'s permission sets.

POST /v1/oauth-clients/{client_id}/permission-sets Create a permission set for an OAuth client · Create permission set #

Ask an LLM

“How do I define which connectors an OAuth app may request access to?”

“What happens if I create a permission set without any connector rules?”

Tell an agent

Create permission set {name} on OAuth client {client_id}.

Add a permission set {name} to app {client_id} granting connectors {connectorRules}.

DELETE /v1/oauth-clients/{client_id}/permission-sets/{id} Delete a permission set from an OAuth client · Delete permission set #

Ask an LLM

“How do I remove a permission set an OAuth app no longer needs?”

“Can I delete one connector grant bundle without affecting the client's others?”

Tell an agent destructive · confirm first

Delete permission set {id} from OAuth client {client_id}.

Remove the permission set {id} on app {client_id}.

GET /v1/oauth-clients/{client_id}/permission-sets/{id} Get one permission set of an OAuth client · Retrieve permission set #

Ask an LLM

“Which connectors does a particular permission set grant?”

“Can I fetch a single permission set by ID for an OAuth client?”

Tell an agent

Get permission set {id} on OAuth client {client_id}.

Show the connector rules in set {id} for app {client_id}.

PATCH /v1/oauth-clients/{client_id}/permission-sets/{id} Change a permission set's connectors · Update permission set #

Ask an LLM

“Can I change which connectors an existing permission set grants?”

“How do I rename a permission set on an OAuth client?”

Tell an agent

Rename permission set {id} on OAuth client {client_id} to {name}.

Update set {id} of app {client_id}, named {name}, to grant {connectorRules}.

POST /v1/oauth-clients/{client_id}/secret Regenerate an OAuth client's secret · Regenerate oauth client secret #

Ask an LLM

“How do I rotate the client secret on an OAuth app if it has leaked?”

“Does generating a new client secret invalidate the old one?”

Tell an agent destructive · confirm first

Regenerate the client secret for OAuth client {client_id}.

Rotate app {client_id}'s secret and give me the new value.

GET /v1/oauth-clients/{client_id}/users List users who authorized an OAuth client · List oauth client users #

Ask an LLM

“Which users have granted access to one of my OAuth apps?”

“Can I page through everyone who authorized a given OAuth client?”

Tell an agent

List the users who authorized OAuth client {client_id}.

Show page {page} of app {client_id}'s authorized users.

DELETE /v1/oauth-clients/{client_id}/users/{user_id} Revoke one user's access to an OAuth client · Revoke oauth client user #

Ask an LLM

“How do I cut off a single user's access to my OAuth app?”

“Can I revoke one person's authorization without affecting other users of the client?”

Tell an agent destructive · confirm first

Revoke user {user_id}'s access to OAuth client {client_id}.

Remove {user_id} from the authorized users of app {client_id}.

IntegrationOS OAuth Clients API

Operations 13

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification