Korely OAuth API
The oauth API from Korely — 3 operation(s) for oauth.
The oauth API from Korely — 3 operation(s) for oauth.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/korely-ai:korely-ai-oauth-api"
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.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Korely Agent OAuth API
description: Memory for AI agents that knows what was true when.
version: 1.0.21
tags:
- name: OAuth
paths:
/admin/oauth/requests/{request_id}:
get:
tags:
- OAuth
summary: Show Request
description: 'What an app connecting over OAuth asks for, for the consent page of
the person signed in: the app''s name, where it sends the browser back
to, the scopes. 404 once it expired or was answered.'
operationId: show_request_admin_oauth_requests__request_id__get
security:
- HTTPBearer: []
parameters:
- name: request_id
in: path
required: true
schema:
type: string
title: Request Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Show Request Admin Oauth Requests Request Id Get
'401':
description: '`invalid_key`: no operator session or API key, or one that is unknown, revoked or expired. On `POST /admin/session`, `invalid_credentials`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: '`forbidden`: an API key without the `admin` scope.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'422':
description: '`invalid_request`: the body or a parameter is malformed (`detail` lists the first 20 fields that failed, `message` names the first and counts them all), or is not a value the route takes, as on /v1: an unknown scope or event name, an empty list, end users a key cannot hold (`detail` is a sentence).'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: '`rate_limit_exceeded` (see `Retry-After`); on `POST /admin/session`, `too_many_attempts`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: '`internal_error`: the server failed on this request; `message` holds no detail of it.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'503':
description: '`unavailable`: a dependency is missing or did not answer, the database included while the credential was checked (see `Retry-After`); `message` says which. Also `unavailable` when the request waited more than 5 s for another change to the same records (an erasure under way, for example) or its statement ran past 60 s; see `Retry-After`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: '`not_found`: nothing with that id in this account, whether the id is in the path or in the body (a `project_id`), malformed or another account''s.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/admin/oauth/requests/{request_id}/approve:
post:
tags:
- OAuth
summary: Approve
description: 'The person''s yes: an authorization code for the chosen project only,
with the scopes and end users chosen here, which the app exchanges for
its key; the answer is the address to send the browser back to. 404 for
a project that is not this account''s and 409 `project_archived` for an
archived one, as when a key is made by hand (POST /admin/keys); 409 when
the request expired or was already answered; 422 with no permission
chosen, or end users a key cannot hold.'
operationId: approve_admin_oauth_requests__request_id__approve_post
security:
- HTTPBearer: []
parameters:
- name: request_id
in: path
required: true
schema:
type: string
title: Request Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Consent'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Redirect'
'401':
description: '`invalid_key`: no operator session or API key, or one that is unknown, revoked or expired. On `POST /admin/session`, `invalid_credentials`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: '`forbidden`: an API key without the `admin` scope. `account_not_adopted`: the account was made by POST /v1/agents/init and nobody has adopted it yet, so it makes no keys: sign in to the dashboard with its key to adopt it, then make keys there.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'422':
description: '`invalid_request`: the body or a parameter is malformed (`detail` lists the first 20 fields that failed, `message` names the first and counts them all), or is not a value the route takes, as on /v1: an unknown scope or event name, an empty list, end users a key cannot hold (`detail` is a sentence).'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: '`rate_limit_exceeded` (see `Retry-After`); on `POST /admin/session`, `too_many_attempts`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: '`internal_error`: the server failed on this request; `message` holds no detail of it.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'503':
description: '`unavailable`: a dependency is missing or did not answer, the database included while the credential was checked (see `Retry-After`); `message` says which. Also `unavailable` when the request waited more than 5 s for another change to the same records (an erasure under way, for example) or its statement ran past 60 s; see `Retry-After`. Or `unavailable`: the server holds as many request bodies as it reads at once; retry after `Retry-After` (5 s). Nothing was done.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: '`not_found`: nothing with that id in this account, whether the id is in the path or in the body (a `project_id`), malformed or another account''s.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'409':
description: 'The change is refused as the account stands; `code` names the case where the route has one: `project_name_taken`, `project_archived`, `cannot_archive_default`, `project_has_live_keys`, `cannot_delete_default`, `connected_app_key`, `too_many_endpoints`, `too_many_keys`, `too_many_names`, `too_many_projects`, `endpoint_disabled`, `fact_not_current` (with `current_fact_id`), and otherwise `conflict` (a name already taken, a consent already answered); `message` says why.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'413':
description: '`payload_too_large`: the body is larger than 2,097,152 bytes, the most this route takes. Refused before it is read; nothing was done. Also a body that holds more JSON strings (36,930), values (72,433) or characters (342,092) than lawful items of its size can, whose text decodes to more than it weighs and more than 4,077,000 bytes, or that would take more than 8,388,608 bytes once decoded: refused before it is decoded; nothing was done.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'408':
description: '`request_timeout`: the body did not arrive whole within 30 s. Nothing was done; send it again.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'400':
description: '`bad_request`: the body is not well formed. A JSON body not in UTF-8 (RFC 8259) is refused before it is decoded.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/admin/oauth/requests/{request_id}/deny:
post:
tags:
- OAuth
summary: Deny
description: 'The person''s no: the app gets an `access_denied`, and the answer is the
address to send the browser back to. 409 when the request expired or was
already answered.'
operationId: deny_admin_oauth_requests__request_id__deny_post
security:
- HTTPBearer: []
parameters:
- name: request_id
in: path
required: true
schema:
type: string
title: Request Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Redirect'
'401':
description: '`invalid_key`: no operator session or API key, or one that is unknown, revoked or expired. On `POST /admin/session`, `invalid_credentials`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: '`forbidden`: an API key without the `admin` scope.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'422':
description: '`invalid_request`: the body or a parameter is malformed (`detail` lists the first 20 fields that failed, `message` names the first and counts them all), or is not a value the route takes, as on /v1: an unknown scope or event name, an empty list, end users a key cannot hold (`detail` is a sentence).'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: '`rate_limit_exceeded` (see `Retry-After`); on `POST /admin/session`, `too_many_attempts`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: '`internal_error`: the server failed on this request; `message` holds no detail of it.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'503':
description: '`unavailable`: a dependency is missing or did not answer, the database included while the credential was checked (see `Retry-After`); `message` says which. Also `unavailable` when the request waited more than 5 s for another change to the same records (an erasure under way, for example) or its statement ran past 60 s; see `Retry-After`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'409':
description: 'The change is refused as the account stands; `code` names the case where the route has one: `project_name_taken`, `project_archived`, `cannot_archive_default`, `project_has_live_keys`, `cannot_delete_default`, `connected_app_key`, `too_many_endpoints`, `too_many_keys`, `too_many_names`, `too_many_projects`, `endpoint_disabled`, `fact_not_current` (with `current_fact_id`), and otherwise `conflict` (a name already taken, a consent already answered); `message` says why.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
components:
schemas:
ErrorCode:
properties:
code:
type: string
title: Code
description: Stable, machine-readable reason, e.g. `not_found`, `stale_write`, `invalid_request`, `search_unavailable`. Branch on this, never on `message`.
examples:
- not_found
message:
type: string
title: Message
description: What went wrong, for a person to read. Wording may change.
type: object
required:
- code
- message
title: ErrorCode
description: A refusal with a stable reason.
Redirect:
properties:
redirect:
type: string
title: Redirect
description: 'Where the browser goes next: back to the app.'
type: object
required:
- redirect
title: Redirect
ApiError:
properties:
detail:
anyOf:
- type: string
- $ref: '#/components/schemas/ErrorCode'
- items:
$ref: '#/components/schemas/ValidationIssue'
type: array
title: Detail
description: 'As this install has always sent it: a sentence; or `{code, message}` where the endpoint names the reason; or, on a 422 from validation, the list of fields that failed.'
code:
type: string
title: Code
description: 'Stable, machine-readable reason, the same names as the hosted API: `invalid_key`, `forbidden`, `not_found`, `stale_write`, `invalid_request`, `identity_required` (a write with neither user_id nor agent_id), `rate_limit_exceeded`, `search_unavailable`, `model_unavailable`, `service_paused`, `internal_error`... When `detail` is `{code, message}` it is that code. Branch on this, never on `message`.'
examples:
- not_found
message:
type: string
title: Message
description: 'What went wrong, for a person to read: the sentence, the message of `detail`, or the first field that failed validation. Wording may change.'
current_fact_id:
anyOf:
- type: string
- type: 'null'
title: Current Fact Id
description: '`fact_not_current`: the fact in force to correct instead, null when nothing took the fact''s place. Absent on every other refusal.'
type: object
required:
- detail
- code
- message
title: ApiError
description: The body of every answer that is not a success, whatever the status.
ValidationIssue:
properties:
type:
type: string
title: Type
description: What kind of failure, e.g. `missing`, `extra_forbidden`, `string_too_long`, `invalid_namespace_id`.
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Loc
description: 'Where: `body`, `query` or `path`, then the field, e.g. ["body", "memories", 0, "user_id"].'
msg:
type: string
title: Msg
description: What is wrong with it, for a person to read.
ctx:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Ctx
description: The limit that was crossed, when there is one.
type: object
required:
- type
- loc
- msg
title: ValidationIssue
description: One field that failed validation. The value sent is never echoed back.
Consent:
properties:
project_id:
type: string
minLength: 1
title: Project Id
description: The project the app may read and write.
scopes:
items:
type: string
type: array
maxItems: 64
title: Scopes
users:
anyOf:
- items:
type: string
type: array
maxItems: 50
- type: 'null'
title: Users
description: 'Confine the app to these end users of the project: exact user_ids and prefixes ending in ''*''. Omitted or null: the whole project.'
type: object
required:
- project_id
title: Consent
securitySchemes:
HTTPBearer:
type: http
scheme: bearer