Knowledge Bases

A knowledge base groups the documents, prompt configuration, and agents that answer questions for a tenant. All endpoints are served under /knowledge-bases and accept either an API key or a user session.

All endpoints on this page are [User+Key] — call them with Authorization: Bearer sk_... or a signed-in session.

Endpoints

Method	Path	Description	Auth
`GET`	`/knowledge-bases`	List knowledge bases for a tenant	[User+Key]
`GET`	`/knowledge-bases/:id`	Get a knowledge base	[User+Key]
`GET`	`/knowledge-bases/:id/prompt`	Get prompt settings	[User+Key]
`POST`	`/knowledge-bases`	Create a knowledge base	[User+Key]
`PATCH`	`/knowledge-bases/:id`	Update a knowledge base	[User+Key]
`DELETE`	`/knowledge-bases/:id`	Delete a knowledge base	[User+Key]
`GET`	`/knowledge-bases/:id/a2a-agents`	List registered external agents	[User+Key]
`POST`	`/knowledge-bases/:id/a2a-agents`	Register an external agent	[User+Key]
`GET`	`/knowledge-bases/:id/a2a-agents/:agentId`	Get a registered external agent	[User+Key]
`PATCH`	`/knowledge-bases/:id/a2a-agents/:agentId`	Update a registered external agent	[User+Key]
`DELETE`	`/knowledge-bases/:id/a2a-agents/:agentId`	Remove a registered external agent	[User+Key]
`GET`	`/knowledge-bases/:id/memories`	List knowledge base memories	[User+Key]
`GET`	`/knowledge-bases/:id/memories/graph`	Get the memory graph	[User+Key]
`DELETE`	`/knowledge-bases/:id/memories/:memoryId`	Delete a memory	[User+Key]

List knowledge bases

GET /knowledge-bases Returns the knowledge bases in a tenant.

string

required

The tenant whose knowledge bases to list.

curl "https://api.autosage.ai/api/v1/knowledge-bases?tenant_id=TENANT_ID" \
  -H "Authorization: Bearer sk_live_your_key_here"

Get a knowledge base

GET /knowledge-bases/:id Returns a single knowledge base, including its name, description, status, and memory mode.

curl "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID" \
  -H "Authorization: Bearer sk_live_your_key_here"

Get prompt settings

GET /knowledge-bases/:id/prompt Returns the prompt configuration that shapes how answers are generated: persona, instructions, customPrompt, mainCustomPrompt, sqlCustomPrompt, sqlAgentInstructions, sqlAnsweringInstructions, and chartInstructions. See Prompts for how these combine.

curl "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID/prompt" \
  -H "Authorization: Bearer sk_live_your_key_here"

Create a knowledge base

POST /knowledge-bases Creates a knowledge base in a tenant. Creation is subject to the tenant’s knowledge base quota.

string

required

The tenant that will own the knowledge base.

string

required

Human-readable name.

string

Short description of the content.

string

Optional prompt field describing the assistant’s voice and role.

string

Optional additional answering instructions.

string

Optional prompt override. See Prompts for precedence.

string

Optional full prompt override for Deep mode.

Creation also accepts sqlCustomPrompt, sqlAgentInstructions, sqlAnsweringInstructions, and chartInstructions for connected-data behavior. Use /swagger for their complete constraints.

curl -X POST "https://api.autosage.ai/api/v1/knowledge-bases" \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "TENANT_ID",
    "name": "Support docs",
    "description": "Product help center content"
  }'

Update a knowledge base

PATCH /knowledge-bases/:id Updates metadata, status, memory behavior, agent sharing, and prompt fields. Send only the fields you want to change.

string

Human-readable name.

string

Short description of the content.

string

Lifecycle status of the knowledge base.

string

One of disabled, subject, or kb_restricted. Controls how durable memory is scoped. See Memory modes.

Agent sharing configuration, e.g. { "inbound_delegation_enabled": true }. See Agent sharing.

string

Prompt persona field.

string

Additional answering instructions.

string

Prompt override field.

string

Deep-mode prompt override field.

The connected-data prompt fields accepted during creation can also be updated here. Send null to clear a nullable prompt field.

curl -X PATCH "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID" \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated help center content",
    "kbMemoryMode": "kb_restricted"
  }'

Delete a knowledge base

DELETE /knowledge-bases/:id Deletes the knowledge base. This removes its documents and associated data, and archives any agents built on it.

Deletion is destructive and cannot be undone. Documents and derived data are removed, and dependent agents are archived.

curl -X DELETE "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID" \
  -H "Authorization: Bearer sk_live_your_key_here"

External (A2A) agents

Register external agents so agents in this knowledge base can delegate to them. This outbound delegation setup is independent of agent_sharing, which controls whether other knowledge bases can delegate into this one.

List external agents

GET /knowledge-bases/:id/a2a-agents

curl "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID/a2a-agents" \
  -H "Authorization: Bearer sk_live_your_key_here"

Register an external agent

POST /knowledge-bases/:id/a2a-agents

string

required

Display name for the external agent.

string

required

URL of the external agent’s capability card.

string

What the agent does.

string

Optional serialized request-header configuration. Stored encrypted.

string

Optional serialized metadata attached to the registration. Stored encrypted.

headers and metadata are stored encrypted at rest. Authorized reads return their decrypted values, so treat registration responses as sensitive.

curl -X POST "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID/a2a-agents" \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Billing specialist",
    "cardUrl": "https://partner.example.com/agent-card.json",
    "description": "Answers billing and invoicing questions"
  }'

Get, update, or remove an external agent

GET, PATCH, and DELETE /knowledge-bases/:id/a2a-agents/:agentId read, modify, and remove a single registration. PATCH accepts the same fields as registration; send only what changes.

Memories

Knowledge base memory-management endpoints return isolated data only when kbMemoryMode is set to kb_restricted. See Memory modes.

List memories

GET /knowledge-bases/:id/memories Supports optional limit, offset, and q query parameters. Other memory modes return memories: null rather than tenant-wide memory.

curl "https://api.autosage.ai/api/v1/knowledge-bases/KB_ID/memories" \
  -H "Authorization: Bearer sk_live_your_key_here"

Get the memory graph

GET /knowledge-bases/:id/memories/graph Returns memories as a graph of entities and relationships.

Delete a memory

DELETE /knowledge-bases/:id/memories/:memoryId Removes a single memory.

Full request and response schemas for every field are available in the interactive explorer at /swagger.

Next steps

What a knowledge base is and how to structure content.

Prompts

Shape persona, instructions, and answering behavior.

RAG lifecycle

How retrieval and grounded answers work end to end.

Get started

Core concepts

Lifecycles

Guides

API reference

Knowledge Bases

Endpoints

List knowledge bases

Get a knowledge base

Get prompt settings

Create a knowledge base

Update a knowledge base

Delete a knowledge base

External (A2A) agents

List external agents

Register an external agent

Get, update, or remove an external agent

Memories

List memories

Get the memory graph

Delete a memory

Next steps

Knowledge bases

Prompts

RAG lifecycle

​Endpoints

​List knowledge bases

​Get a knowledge base

​Get prompt settings

​Create a knowledge base

​Update a knowledge base

​Delete a knowledge base

​External (A2A) agents

​List external agents

​Register an external agent

​Get, update, or remove an external agent

​Memories

​List memories

​Get the memory graph

​Delete a memory

​Next steps

Knowledge bases

Prompts

RAG lifecycle

Endpoints

List knowledge bases

Get a knowledge base

Get prompt settings

Create a knowledge base

Update a knowledge base

Delete a knowledge base

External (A2A) agents

List external agents

Register an external agent

Get, update, or remove an external agent

Memories

List memories

Get the memory graph

Delete a memory

Next steps