Korely OAuth API

The oauth API from Korely — 3 operation(s) for oauth.

GitHub OpenAPI

Operations 3

GET /admin/oauth/requests/{request_id} Show Request #
POST /admin/oauth/requests/{request_id}/approve Approve #
POST /admin/oauth/requests/{request_id}/deny Deny #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/korely-ai:korely-ai-oauth-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. 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 Specification

korely-ai-oauth-api-openapi.yml Raw ↑
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