Gatana Connected Clients API
The connected-clients API from Gatana — 2 operation(s) for connected-clients.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/gatana-ai:gatana-ai-connected-clients-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Gatana Connected Clients API
version: v1.48.6
description: ''
servers:
- url: https://{YOUR_ORG_ID}.gatana.ai/api/v1
description: Gatana Public API
variables:
YOUR_ORG_ID:
default: YOUR_ORG_ID
description: Gatana organization identifier
security:
- Static Bearer Token: []
- OAuth2: []
tags:
- name: connected-clients
paths:
/connected-clients:
get:
responseType:
def:
type: object
shape:
clients:
def:
type: array
element:
def:
type: object
shape:
clientId:
def:
type: string
type: string
name:
def:
type: string
type: string
label:
def:
type: string
type: string
clientInfoName:
def:
type: string
type: string
clientInfoVersion:
def:
type: string
type: string
kind:
def:
type: enum
entries:
cli: cli
native: native
web: web
external: external
unknown: unknown
type: enum
enum:
cli: cli
native: native
web: web
external: external
unknown: unknown
options:
- cli
- native
- web
- external
- unknown
isActive:
def:
type: boolean
type: boolean
profileIds:
def:
type: array
element:
def:
type: string
type: string
type: array
element:
def:
type: string
type: string
firstSeenAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
lastAuthorizedAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
lastUsedAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
type: object
type: array
element:
def:
type: object
shape:
clientId:
def:
type: string
type: string
name:
def:
type: string
type: string
label:
def:
type: string
type: string
clientInfoName:
def:
type: string
type: string
clientInfoVersion:
def:
type: string
type: string
kind:
def:
type: enum
entries:
cli: cli
native: native
web: web
external: external
unknown: unknown
type: enum
enum:
cli: cli
native: native
web: web
external: external
unknown: unknown
options:
- cli
- native
- web
- external
- unknown
isActive:
def:
type: boolean
type: boolean
profileIds:
def:
type: array
element:
def:
type: string
type: string
type: array
element:
def:
type: string
type: string
firstSeenAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
lastAuthorizedAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
lastUsedAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
type: object
type: object
description: List the OAuth clients the signed-in user has authorized
operationId: listConnectedClients
tags:
- connected-clients
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListConnectedClientsResponse'
summary: List connected clients
x-summary-source: derived
/connected-clients/{clientId}:
patch:
requestType:
def:
type: object
shape:
label:
def:
type: optional
innerType:
def:
type: string
checks:
- {}
type: string
type: optional
profileIds:
def:
type: optional
innerType:
def:
type: array
element:
def:
type: string
type: string
type: array
element:
def:
type: string
type: string
type: optional
type: object
responseType:
def:
type: object
shape:
client:
def:
type: object
shape:
clientId:
def:
type: string
type: string
name:
def:
type: string
type: string
label:
def:
type: string
type: string
clientInfoName:
def:
type: string
type: string
clientInfoVersion:
def:
type: string
type: string
kind:
def:
type: enum
entries:
cli: cli
native: native
web: web
external: external
unknown: unknown
type: enum
enum:
cli: cli
native: native
web: web
external: external
unknown: unknown
options:
- cli
- native
- web
- external
- unknown
isActive:
def:
type: boolean
type: boolean
profileIds:
def:
type: array
element:
def:
type: string
type: string
type: array
element:
def:
type: string
type: string
firstSeenAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
lastAuthorizedAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
lastUsedAt:
def:
type: nullable
innerType:
def:
type: date
type: date
type: nullable
type: object
type: object
description: Update the name or the attached profiles of a connected client
operationId: patchConnectedClient
tags:
- connected-clients
parameters:
- in: path
name: clientId
schema:
$ref: '#/components/schemas/__schema343'
required: true
description: OAuth client ID of the connection
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateConnectedClientRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateConnectedClientResponse'
summary: Patch connected client
x-summary-source: derived
delete:
responseType:
def:
type: object
shape: {}
type: object
description: Disconnect a client, revoking its grants and every token issued under them
operationId: deleteConnectedClient
tags:
- connected-clients
parameters:
- in: path
name: clientId
schema:
$ref: '#/components/schemas/__schema343'
required: true
description: OAuth client ID of the connection
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties: {}
additionalProperties: false
summary: Delete connected client
x-summary-source: derived
components:
schemas:
__schema1253:
anyOf:
- $ref: '#/components/schemas/__schema1254'
- type: 'null'
description: When the connection was first recorded; null before it authorizes or is used
__schema1247:
type: string
description: Name the client reported over MCP; empty when it never reported one
UpdateConnectedClientResponse:
type: object
properties:
client:
$ref: '#/components/schemas/__schema1259'
required:
- client
additionalProperties: false
__schema1245:
type: string
description: Best available display name for the client
__schema1256:
type: string
ListConnectedClientsResponse:
type: object
properties:
clients:
$ref: '#/components/schemas/__schema1243'
required:
- clients
additionalProperties: false
__schema1248:
type: string
description: Version the client reported over MCP; empty when unknown
__schema343:
type: string
description: OAuth client ID of the connection
ConnectedClient:
type: object
properties:
clientId:
$ref: '#/components/schemas/__schema1244'
name:
$ref: '#/components/schemas/__schema1245'
label:
$ref: '#/components/schemas/__schema1246'
clientInfoName:
$ref: '#/components/schemas/__schema1247'
clientInfoVersion:
$ref: '#/components/schemas/__schema1248'
kind:
$ref: '#/components/schemas/__schema1249'
isActive:
$ref: '#/components/schemas/__schema1250'
profileIds:
$ref: '#/components/schemas/__schema1251'
firstSeenAt:
$ref: '#/components/schemas/__schema1253'
lastAuthorizedAt:
$ref: '#/components/schemas/__schema1255'
lastUsedAt:
$ref: '#/components/schemas/__schema1257'
required:
- clientId
- name
- label
- clientInfoName
- clientInfoVersion
- kind
- isActive
- profileIds
- firstSeenAt
- lastAuthorizedAt
- lastUsedAt
additionalProperties: false
__schema1259:
description: The connection as it now stands
$ref: '#/components/schemas/ConnectedClient'
__schema1252:
type: string
__schema1258:
type: string
__schema1246:
type: string
description: Name the user gave the connection; empty when unnamed
UpdateConnectedClientRequest:
type: object
properties:
label:
$ref: '#/components/schemas/__schema344'
profileIds:
$ref: '#/components/schemas/__schema346'
__schema347:
type: array
items:
type: string
__schema346:
description: Profiles to attach, replacing whatever was attached before; empty detaches all
$ref: '#/components/schemas/__schema347'
__schema1249:
type: string
enum:
- cli
- native
- web
- external
- unknown
description: How the client registered itself, or external when it did not
__schema1251:
type: array
items:
$ref: '#/components/schemas/__schema1252'
description: Profiles the user attached to this connection
__schema344:
description: Name for the connection; pass an empty string to remove it
$ref: '#/components/schemas/__schema345'
__schema1257:
anyOf:
- $ref: '#/components/schemas/__schema1258'
- type: 'null'
description: When the client last made a request; null when it has not made one
__schema345:
type: string
maxLength: 200
__schema1250:
type: boolean
description: 'Whether the connection can still be used: it holds a renewable refresh token, or for an external client, it made a request recently'
__schema1243:
type: array
items:
$ref: '#/components/schemas/ConnectedClient'
description: Clients the signed-in user has authorized
__schema1254:
type: string
__schema1244:
type: string
description: OAuth client ID the connection authenticates as
__schema1255:
anyOf:
- $ref: '#/components/schemas/__schema1256'
- type: 'null'
description: When the client last completed an authorization; null when not seen since recording began, and always null for an external client
securitySchemes:
Static_Bearer_Token:
type: http
scheme: bearer
OAuth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: /oauth/authorize
tokenUrl: /oauth/token
scopes:
openid: Authentication claims