Skip to main content
POST
/
1
/
agents
/
{agentId}
/
publish
curl
curl --request POST \
  --url https://example.algolia.net/agent-studio/1/agents/lorem/publish \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID'
{
  "config": {},
  "createdAt": "<string>",
  "description": "<string>",
  "id": "<string>",
  "instructions": "<string>",
  "lastUsedAt": "<string>",
  "name": "<string>",
  "providerId": "<string>",
  "updatedAt": "<string>",
  "model": "<string>",
  "systemPrompt": "<string>",
  "templateType": "<string>",
  "tools": [
    {
      "description": "<string>",
      "inputSchema": {
        "properties": {},
        "required": [
          "<string>"
        ],
        "type": "object"
      },
      "name": "<string>",
      "type": "client_side"
    }
  ]
}
Required ACL: editSettings

Authorizations

x-algolia-application-id
string
header
required

Your Algolia application ID.

x-algolia-api-key
string
header
required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Path Parameters

agentId
string
required

The agentId.

Response

Successful Response.

config
config · object
required
createdAt
string
required
description
string | null
required
id
string
required
instructions
string
required
lastUsedAt
string | null
required
name
string
required
providerId
string | null
required
status
enum<string>
required
Available options:
draft,
published
updatedAt
string | null
required
model
string | null
systemPrompt
string | null
templateType
string | null
tools
(clientSideToolConfig · object | algoliaSearchToolConfig · object | algoliaRecommendToolConfig · object | algoliaDisplayResultsToolConfig · object | mcpServerToolConfig · object | unknownToolConfig · object)[]
Last modified on June 11, 2026