Kaeso Stored Responses API

Responses kept at providers for `previous_response_id`: who may keep them

GitHub OpenAPI

Operations 4

GET /platform/v1/orgs/{org}/projects/{project}/stored-responses Whether the project keeps responses at providers #
PATCH /platform/v1/orgs/{org}/projects/{project}/stored-responses Turns responses kept at providers on or off for the project #
GET /platform/v1/orgs/{org}/stored-responses Whether the organization's projects may keep responses at providers #
PATCH /platform/v1/orgs/{org}/stored-responses Allows or forbids the organization's projects to keep responses at providers #

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/kaeso-app:kaeso-app-stored-responses-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

kaeso-app-stored-responses-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kaeso Platform Stored Responses API
  description: 'Manage a Kaeso install: organizations, projects, members, keys, provider credentials, models, limits, usage and logs. Every operation names the single right it checks. Errors are `{"error": {"type", "message", "param"}}`. Lists are paginated with `limit` and `after`.'
  license:
    name: MIT
    identifier: MIT
  version: 0.6.0
tags:
- name: stored-responses
  description: 'Responses kept at providers for `previous_response_id`: who may keep them'
paths:
  /platform/v1/orgs/{org}/projects/{project}/stored-responses:
    get:
      tags:
      - stored-responses
      summary: Whether the project keeps responses at providers
      description: '**Right:** `project.view` on the project in the path.'
      operationId: getOrgsOrgProjectsProjectStoredResponses
      parameters:
      - name: org
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/OrgId'
      - name: project
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ProjectId'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectStoredResponses'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/Internal'
        '503':
          $ref: '#/components/responses/Unavailable'
      security:
      - session: []
      - api_key: []
      - agent: []
      x-kaeso-access: right:project.view
    patch:
      tags:
      - stored-responses
      summary: Turns responses kept at providers on or off for the project
      description: 'It cannot be turned on while the organization forbids it.


        **Right:** `project.update` on the project in the path.'
      operationId: patchOrgsOrgProjectsProjectStoredResponses
      parameters:
      - name: org
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/OrgId'
      - name: project
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ProjectId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectStoredResponsesUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectStoredResponses'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '413':
          $ref: '#/components/responses/TooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/Internal'
        '503':
          $ref: '#/components/responses/Unavailable'
      security:
      - session: []
      - api_key: []
      - agent: []
      x-kaeso-access: right:project.update
  /platform/v1/orgs/{org}/stored-responses:
    get:
      tags:
      - stored-responses
      summary: Whether the organization's projects may keep responses at providers
      description: '**Right:** `org.view` on the organization in the path.'
      operationId: getOrgsOrgStoredResponses
      parameters:
      - name: org
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/OrgId'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrgStoredResponses'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/Internal'
        '503':
          $ref: '#/components/responses/Unavailable'
      security:
      - session: []
      - api_key: []
      - agent: []
      x-kaeso-access: right:org.view
    patch:
      tags:
      - stored-responses
      summary: Allows or forbids the organization's projects to keep responses at providers
      description: '**Right:** `org.update` on the organization in the path.'
      operationId: patchOrgsOrgStoredResponses
      parameters:
      - name: org
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/OrgId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrgStoredResponsesUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrgStoredResponses'
        '400':
          $ref: '#/components/responses/InvalidRequest'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '413':
          $ref: '#/components/responses/TooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/Internal'
        '503':
          $ref: '#/components/responses/Unavailable'
      security:
      - session: []
      - api_key: []
      - agent: []
      x-kaeso-access: right:org.update
components:
  responses:
    RateLimited:
      description: Too many attempts; see `Retry-After` (`rate_limited`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    InvalidRequest:
      description: The request is malformed or a value is invalid (`invalid_request`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthenticated:
      description: Missing or invalid credentials (`authentication`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    NotFound:
      description: The resource does not exist or is not visible to the caller (`not_found`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Forbidden:
      description: The caller lacks the right, the org requires 2FA or SSO, a recent sign-in is needed, or a session from the SSO of an organization that doesn't manage the account can't do this (`permission_denied`, `recent_sign_in_required`, `other_sign_in_required`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unavailable:
      description: A dependency is unreachable, for example ClickHouse for request logs (`unavailable`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Internal:
      description: An unexpected error; the message names the request id (`internal`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    TooLarge:
      description: The request body is larger than the Platform API allows (`request_too_large`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Conflict:
      description: The request conflicts with the current state (`conflict`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  schemas:
    ErrorBody:
      type: object
      description: An error.
      required:
      - type
      - message
      properties:
        message:
          type: string
          description: What went wrong and what to do, for the person reading it.
          example: No such project, or you cannot see it.
        param:
          type:
          - string
          - 'null'
          description: The request field at fault, when there is one.
        right:
          type:
          - string
          - 'null'
          description: 'For `permission_denied`: the right the caller lacks, when one right

            would allow the request (`orgs/{org}/rights/{right}/grantors` names

            who can grant it).'
          example: logs.export
        type:
          type: string
          description: 'One of `invalid_request`, `authentication`, `permission_denied`,

            `recent_sign_in_required`, `other_sign_in_required` (a session from the

            SSO of an organization that doesn''t manage the account, or an SSO

            session for instance administration other than one from the org chosen

            for instance admins, can''t do this; sign in another way), `not_found`,

            `conflict`,

            `org_scheduled_for_deletion`, `request_too_large`, `rate_limited`,

            `unavailable`, `provider_error` (only the Playground''s model

            requests), `internal`.'
          example: not_found
    ProjectStoredResponsesUpdate:
      type: object
      description: A change to whether a project keeps responses at providers.
      required:
      - enabled
      properties:
        enabled:
          type: boolean
          description: 'Let providers keep this project''s responses so apps can continue them with

            `previous_response_id`. Off refuses `store: true` and continuations; responses

            already kept stay at their providers until they expire.'
      additionalProperties: false
    ErrorEnvelope:
      type: object
      description: The error envelope.
      required:
      - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorBody'
          description: The error.
    OrgStoredResponses:
      type: object
      description: Whether the organization's projects may keep responses at providers.
      required:
      - allowed
      properties:
        allowed:
          type: boolean
          description: Whether projects may let providers keep responses for `previous_response_id`.
    ProjectStoredResponses:
      type: object
      description: Whether a project keeps responses at providers.
      required:
      - enabled
      - org_allowed
      - effective
      properties:
        effective:
          type: boolean
          description: 'Whether requests may keep and continue responses at providers: the

            organization allows it and the project''s switch is on.'
        enabled:
          type: boolean
          description: The project's own switch.
        org_allowed:
          type: boolean
          description: Whether the organization allows it.
    OrgStoredResponsesUpdate:
      type: object
      description: A change to whether the organization's projects may keep responses at providers.
      required:
      - allowed
      properties:
        allowed:
          type: boolean
          description: 'Let projects keep responses at providers. Off stops it in every project;

            responses already kept stay at their providers until they expire.'
      additionalProperties: false
    OrgId:
      type: string
      examples:
      - org_01k7a3f8m2xq4v9c5r6t8w0yz1
      pattern: ^org_[0-9a-hjkmnp-tv-z]{26}$
    ProjectId:
      type: string
      examples:
      - proj_01k7a3f8m2xq4v9c5r6t8w0yz1
      pattern: ^proj_[0-9a-hjkmnp-tv-z]{26}$
  securitySchemes:
    agent:
      type: http
      scheme: bearer
      description: An agent's access token (`kso_at_…`) from the OAuth sign-in of the MCP server at `/mcp`. The agent acts for its user with the rights both hold, within the instance's and each org's agent policies.
    api_key:
      type: http
      scheme: bearer
      description: An API key with platform access (`sk-kso-…`, acting as its principal inside its project) or an org platform key (`sk-kso-org-…`).
    session:
      type: apiKey
      in: cookie
      name: __Host-kaeso_session
      description: The console session cookie, set by the sign-in endpoints. Every request other than `GET`, `HEAD` and `OPTIONS` that carries it, and every such request to a public `auth/*` endpoint, must also send `Origin` with the origin of the install's public URL; `orgs/{org}/*` requests with an API key need none.