Algolia Agent Studio API

Algolia's agent-building runtime: agents, conversations, tools, memory, guardrails and per-turn context, exposed as 42 REST operations. Notably, Agent Studio can itself consume third-party MCP tools, so Algolia is both an MCP server and an MCP client.

Operations 42

GET /1/agents List Agents #
POST /1/agents Create Agent #
GET /1/agents/{agentId} Get Agent #
PATCH /1/agents/{agentId} Update Agent #
DELETE /1/agents/{agentId} Delete Agent #
GET /1/agents/{agentId}/allowed-domains List Allowed Domains #
POST /1/agents/{agentId}/allowed-domains Create Allowed Domain #
POST /1/agents/{agentId}/allowed-domains/bulk Bulk Insert Allowed Domains #
DELETE /1/agents/{agentId}/allowed-domains/bulk Bulk Delete Allowed Domains #
GET /1/agents/{agentId}/allowed-domains/{domainId} Get Allowed Domain #
DELETE /1/agents/{agentId}/allowed-domains/{domainId} Delete Allowed Domain #
DELETE /1/agents/{agentId}/cache Invalidate Agent Cache #
POST /1/agents/{agentId}/completions Create Completion #
GET /1/agents/{agentId}/conversations List Conversations #
DELETE /1/agents/{agentId}/conversations Delete Conversations #
GET /1/agents/{agentId}/conversations/export Export Conversations #
GET /1/agents/{agentId}/conversations/{conversationId} Get Conversation #
DELETE /1/agents/{agentId}/conversations/{conversationId} Delete Conversation #
POST /1/agents/{agentId}/publish Publish Agent #
POST /1/agents/{agentId}/unpublish Unpublish Agent #
GET /1/configuration Get Configuration #
PATCH /1/configuration Patch Configuration #
POST /1/feedback Create Feedback #
GET /1/providers List Providers #
POST /1/providers Create Provider #
GET /1/providers/models Get Provider Models #
GET /1/providers/{providerId} Get Provider #
PATCH /1/providers/{providerId} Update Provider #
DELETE /1/providers/{providerId} Delete Provider #
GET /1/providers/{providerId}/models Get Provider Models By Id #
GET /1/secret-keys List Secret Keys #
POST /1/secret-keys Create Secret Key #
GET /1/secret-keys/{secretKeyId} Get Secret Key #
PATCH /1/secret-keys/{secretKeyId} Patch Secret Key #
DELETE /1/secret-keys/{secretKeyId} Delete Secret Key #
GET /1/user-data/{userToken} Get Data By User Token #
DELETE /1/user-data/{userToken} Delete Data By User Token #
GET /{path} Send requests to the Algolia REST API #
POST /{path} Send requests to the Algolia REST API #
PUT /{path} Send requests to the Algolia REST API #
DELETE /{path} Send requests to the Algolia REST API #
GET /setClientApiKey Switch the API key used to authenticate requests #

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/algolia-agent-studio-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

algolia-agent-studio-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agent Studio API
  description: "The Agent Studio API lets you build and operate generative AI agents that use Algolia data, tools, and your chosen LLM provider.\n\nUse it to create, configure, publish, and update agents, then generate chat completions grounded in live data from your Algolia indices. You can manage LLM providers, Agent Studio tools, conversations, feedback, secret keys, user data, caching, and application settings for your AI experiences.\n\n## Client libraries\n\nUse Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.\n\nFor more information, see [Algolia's ecosystem](https://www.algolia.com/doc/libraries).\n\n## Base URL\n\nBase URL for the Agent Studio API:\n\n- `https://{APPLICATION_ID}.algolia.net/agent-studio`\n\n**All requests must use HTTPS.**\n\n## Authentication\n\nAdd these headers to authenticate requests:\n\n- `x-algolia-application-id`. Your Algolia application ID.\n- `x-algolia-api-key`. An API key with the necessary permissions to make the request.\n  The required access control list (ACL) to make a request is listed in each endpoint's reference.\n\nYou can find your application ID and API key in the [Algolia dashboard](https://dashboard.algolia.com/account/api-keys).\n\n## Request format\n\nRequest bodies must be JSON objects.\n\n## Response status and errors\n\nThe Agent Studio API returns JSON responses. Since JSON doesn't guarantee any specific ordering, don't rely on the order of attributes in the API response.\n\nSuccessful responses return `2xx` statuses. Client errors return `4xx` statuses. Server errors return `5xx` statuses.\nError responses have a `message` property with more information.\n\n## Version\n\nThe current version of the Agent Studio API is version 1, indicated by the `/1/` in each endpoint's URL.\n"
  version: 0.1.0
servers:
- url: https://{APPLICATION_ID}.algolia.net/agent-studio
  description: Agent Studio API.
  variables:
    APPLICATION_ID:
      default: EXAMPLE
      description: Your Algolia application ID.
security:
- appId: []
  apiKey: []
tags:
- name: agent-studio
paths:
  /1/agents:
    get:
      tags:
      - agent-studio
      operationId: listAgents
      x-acl:
      - settings
      summary: List Agents
      description: List all agents with pagination and filtering.
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number.
          default: 1
          title: page
        description: Page number.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Items per page.
          default: 10
          title: limit
        description: Items per page.
      - name: providerId
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: Filter by provider id.
          title: providerid
        description: Filter by provider id.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAgentsResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - agent-studio
      operationId: createAgent
      x-acl:
      - editSettings
      summary: Create Agent
      description: Create a new agent.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentConfigCreate'
      responses:
        '201':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentWithVersionResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}:
    get:
      tags:
      - agent-studio
      operationId: getAgent
      x-acl:
      - settings
      summary: Get Agent
      description: Retrieve details of the specified agent.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentWithVersionResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - agent-studio
      operationId: updateAgent
      x-acl:
      - editSettings
      summary: Update Agent
      description: Update the specified agent.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentConfigUpdate'
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentWithVersionResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - agent-studio
      operationId: deleteAgent
      x-acl:
      - editSettings
      summary: Delete Agent
      description: Delete the specified agent.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '204':
          description: Successful Response.
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/allowed-domains:
    get:
      tags:
      - agent-studio
      operationId: listAgentAllowedDomains
      x-acl:
      - settings
      summary: List Allowed Domains
      description: List all allowed domain patterns for this agent.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllowedDomainListResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - agent-studio
      operationId: createAgentAllowedDomain
      x-acl:
      - editSettings
      summary: Create Allowed Domain
      description: Add a single allowed domain pattern (e.g. https://app.example.com or *.example.com).
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AllowedDomainCreate'
      responses:
        '201':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllowedDomainResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/allowed-domains/bulk:
    post:
      tags:
      - agent-studio
      operationId: bulkCreateAllowedDomains
      x-acl:
      - editSettings
      summary: Bulk Insert Allowed Domains
      description: Add multiple allowed domain patterns. Duplicates are skipped.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AllowedDomainBulkInsert'
      responses:
        '201':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllowedDomainListResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - agent-studio
      operationId: bulkDeleteAllowedDomains
      x-acl:
      - editSettings
      summary: Bulk Delete Allowed Domains
      description: Delete allowed domains by id list.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AllowedDomainBulkDelete'
      responses:
        '204':
          description: Successful Response.
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/allowed-domains/{domainId}:
    get:
      tags:
      - agent-studio
      operationId: getAllowedDomain
      x-acl:
      - settings
      summary: Get Allowed Domain
      description: Get a single allowed domain by id.
      parameters:
      - name: domainId
        in: path
        required: true
        schema:
          type: string
          title: domainId
        description: The domainId.
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllowedDomainResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - agent-studio
      operationId: deleteAllowedDomain
      x-acl:
      - editSettings
      summary: Delete Allowed Domain
      description: Remove an allowed domain by id.
      parameters:
      - name: domainId
        in: path
        required: true
        schema:
          type: string
          title: domainId
        description: The domainId.
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '204':
          description: Successful Response.
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/cache:
    delete:
      tags:
      - agent-studio
      operationId: invalidateAgentCache
      x-acl:
      - editSettings
      summary: Invalidate Agent Cache
      description: Invalidate cached completions for this agent. Filter with `before` (exclusive).
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      - name: before
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: Delete entries strictly before this date (exclusive, YYYY-MM-DD).
          title: before
        description: Delete entries strictly before this date (exclusive, YYYY-MM-DD).
      responses:
        '204':
          description: Successful Response.
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/completions:
    post:
      tags:
      - agent-studio
      operationId: createAgentCompletion
      x-acl:
      - search
      x-streaming: true
      summary: Create Completion
      description: 'Create a completion for the specified agent.


        This endpoint handles two types of requests:

        1. Normal completion request: User message -> Agent response

        2. Tool approval response: User approval -> Execute tool -> Agent response


        Tool Approval Flow (for MCP tools with requiresApproval: true):

        - Request 1: User sends message -> Agent requests tool call -> Return approval request

        - Request 2: User approves -> Execute tool -> Agent continues with result.'
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/AgentIdUnion'
        description: The agentId.
      - name: compatibilityMode
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/CompatibilityMode'
        description: Compatibility mode for the completion API.
      - name: stream
        in: query
        required: false
        schema:
          type: boolean
          description: Whether to stream the response or not.
          default: true
          title: stream
        description: Whether to stream the response or not.
      - name: cache
        in: query
        required: false
        schema:
          type: boolean
          description: Use cached responses if available.
          default: true
          title: cache
        description: Use cached responses if available.
      - name: memory
        in: query
        required: false
        schema:
          oneOf:
          - const: false
            type: boolean
          - type: 'null'
          description: Set to false to disable memory (enabled by default).
          title: memory
        description: Set to false to disable memory (enabled by default).
      - name: analytics
        in: query
        required: false
        schema:
          type: boolean
          description: 'Set to false to skip analytics for this completion (default: true). Disables Agent Studio BigQuery analytics, Algolia search analytics, click analytics, and query-suggestions training. Useful for offline-eval workflows.'
          default: true
          title: analytics
        description: 'Set to false to skip analytics for this completion (default: true). Disables Agent Studio BigQuery analytics, Algolia search analytics, click analytics, and query-suggestions training. Useful for offline-eval workflows.'
      - name: X-Algolia-Secure-User-Token
        in: header
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          title: x-Algolia-Secure-User-Token
        description: The X-Algolia-Secure-User-Token.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentCompletionRequest'
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/conversations:
    get:
      tags:
      - agent-studio
      operationId: listAgentConversations
      x-acl:
      - logs
      summary: List Conversations
      description: Retrieves the conversations for the given agent ID.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/AgentIdUnion'
        description: The agentId.
      - name: startDate
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: 'Filter conversations created after this date (format: YYYY-MM-DD).'
          title: startdate
        description: 'Filter conversations created after this date (format: YYYY-MM-DD).'
      - name: endDate
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: 'Filter conversations created before this date (format: YYYY-MM-DD).'
          title: enddate
        description: 'Filter conversations created before this date (format: YYYY-MM-DD).'
      - name: includeFeedback
        in: query
        required: false
        schema:
          oneOf:
          - type: boolean
          - type: 'null'
          description: Include feedback per conversation.
          default: false
          title: includefeedback
        description: Include feedback per conversation.
      - name: feedbackVote
        in: query
        required: false
        schema:
          oneOf:
          - type: integer
            maximum: 1
            minimum: 0
          - type: 'null'
          description: Filter by feedback value (requires includeFeedback=true).
          title: feedbackvote
        description: Filter by feedback value (requires includeFeedback=true).
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number.
          default: 1
          title: page
        description: Page number.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Items per page.
          default: 20
          title: limit
        description: Items per page.
      - name: X-Algolia-Secure-User-Token
        in: header
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          title: x-Algolia-Secure-User-Token
        description: The X-Algolia-Secure-User-Token.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedConversationsResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - agent-studio
      operationId: deleteAgentConversations
      x-acl:
      - logs
      summary: Delete Conversations
      description: Deletes the conversations matching the given filers.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      - name: startDate
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: 'Filter conversations created after this date (format: YYYY-MM-DD).'
          title: startdate
        description: 'Filter conversations created after this date (format: YYYY-MM-DD).'
      - name: endDate
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: 'Filter conversations created before this date (format: YYYY-MM-DD).'
          title: enddate
        description: 'Filter conversations created before this date (format: YYYY-MM-DD).'
      responses:
        '204':
          description: Successful Response.
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/conversations/export:
    get:
      tags:
      - agent-studio
      operationId: exportConversations
      x-acl:
      - logs
      summary: Export Conversations
      description: Exports all conversations based on the passed filters.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      - name: startDate
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: 'Filter conversations created after this date (format: YYYY-MM-DD).'
          title: startdate
        description: 'Filter conversations created after this date (format: YYYY-MM-DD).'
      - name: endDate
        in: query
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          description: 'Filter conversations created before this date (format: YYYY-MM-DD).'
          title: enddate
        description: 'Filter conversations created before this date (format: YYYY-MM-DD).'
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConversationFullResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/conversations/{conversationId}:
    get:
      tags:
      - agent-studio
      operationId: getConversation
      x-acl:
      - logs
      summary: Get Conversation
      description: Retrieves the conversation and its messages for the given ID.
      parameters:
      - name: conversationId
        in: path
        required: true
        schema:
          type: string
          title: conversationId
        description: The conversationId.
      - name: agentId
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/AgentIdUnion'
        description: The agentId.
      - name: includeFeedback
        in: query
        required: false
        schema:
          type: boolean
          description: Include feedback for the conversation.
          default: false
          title: includefeedback
        description: Include feedback for the conversation.
      - name: X-Algolia-Secure-User-Token
        in: header
        required: false
        schema:
          oneOf:
          - type: string
          - type: 'null'
          title: x-Algolia-Secure-User-Token
        description: The X-Algolia-Secure-User-Token.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationFullResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - agent-studio
      operationId: deleteConversation
      x-acl:
      - logs
      summary: Delete Conversation
      description: Deletes the conversation with the given ID.
      parameters:
      - name: conversationId
        in: path
        required: true
        schema:
          type: string
          title: conversationId
        description: The conversationId.
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '204':
          description: Successful Response.
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/publish:
    post:
      tags:
      - agent-studio
      operationId: publishAgent
      x-acl:
      - editSettings
      summary: Publish Agent
      description: Publish the specified agent.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentWithVersionResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/agents/{agentId}/unpublish:
    post:
      tags:
      - agent-studio
      operationId: unpublishAgent
      x-acl:
      - editSettings
      summary: Unpublish Agent
      description: Unpublish the specified agent.
      parameters:
      - name: agentId
        in: path
        required: true
        schema:
          type: string
          title: agentId
        description: The agentId.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentWithVersionResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/configuration:
    get:
      tags:
      - agent-studio
      operationId: getConfiguration
      x-acl:
      - logs
      summary: Get Configuration
      description: Get Configuration.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationConfigResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - agent-studio
      operationId: updateConfiguration
      x-acl:
      - logs
      summary: Patch Configuration
      description: Patch Configuration.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationConfigPatch'
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationConfigResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/feedback:
    post:
      tags:
      - agent-studio
      operationId: createFeedback
      x-acl:
      - search
      summary: Create Feedback
      description: Create new feedback entry.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackCreationRequest'
      responses:
        '201':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/providers:
    get:
      tags:
      - agent-studio
      operationId: listProviders
      x-acl:
      - settings
      summary: List Providers
      description: List Providers.
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number.
          default: 1
          title: page
        description: Page number.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Items per page.
          default: 10
          title: limit
        description: Items per page.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedProviderAuthenticationsResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - agent-studio
      operationId: createProvider
      x-acl:
      - editSettings
      summary: Create Provider
      description: Create Provider.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProviderAuthenticationCreate'
      responses:
        '201':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderAuthenticationResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/providers/models:
    get:
      tags:
      - agent-studio
      operationId: listModels
      x-acl:
      - settings
      summary: Get Provider Models
      description: Get Provider Models.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
                title: responseGetProviderModels1ProvidersModelsGet
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /1/providers/{providerId}:
    get:
      tags:
      - agent-studio
      operationId: getProvider
      x-acl:
      - settings
      summary: Get Provider
      description: Get Provider.
      parameters:
      - name: providerId
        in: path
        required: true
        schema:
          type: string
          title: providerId
        description: The providerId.
      responses:
        '200':
          description: Successful Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderAuthenticationResponse'
        '422':
          description: Validation Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - agent-studio
      operationId: updateProvider
      x-acl:
      - editSettings
      summary: Update Provider
      description: Update Provider.
      parameters:
      - name: providerId
        in: path
        required: true
        schema:
          type: string
        

# --- truncated at 32 KB (118 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/algolia/refs/heads/main/openapi/algolia-agent-studio-api-openapi.yml