How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Stacks Ai Knowledge Bases API

The Knowledge Bases API from Stacks Ai — 5 operation(s) for knowledge bases.

Stacks Ai Knowledge Bases API is one of 5 APIs that Stacks Ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Knowledge Bases. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 10 operations across 5 paths, and defines 30 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against 2 base URLs: https://api.stack-ai.com, https://stack-inference.com.

10 operations 5 paths 30 schemas 2 DELETE4 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.stack-ai.com
Authentication
OAuth 2.0, HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 2

Stacks Ai Knowledge Bases API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (OAuth2PasswordBearer) using the password flow. It accepts HTTP bearer tokens (HTTPBearer).

  • OAuth2PasswordBearer — Authorization header. [Learn how to get it](/docs/api-reference/how-to-get-credentials).

Paths & Operations 10

Across 5 paths, the API surfaces 10 operations — 2 DELETE, 4 GET, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Knowledge Bases 10
GET
/v1/knowledge-bases/{knowledge_base_id}/resources
List Resources
listKnowledgeBaseResources 4 params → 200422
POST
/v1/knowledge-bases/{knowledge_base_id}/resources
Create Resource
uploadKnowledgeBaseResource 1 param body → 202422
GET
/v1/knowledge-bases/{knowledge_base_id}/resources/{resource_id}
Get Resource By Id
getKnowledgeBaseResource 2 params → 200422
DELETE
/v1/knowledge-bases/{knowledge_base_id}/resources/{resource_id}
Delete Resource By Id
deleteKnowledgeBaseResource 2 params → 204422
POST
/v1/knowledge-bases/{knowledge_base_id}/sync
Synchronize Knowledge Base
syncKnowledgeBase 1 param → 202422
GET
/v1/knowledge-bases
Get Knowledge Bases
listKnowledgeBases 3 params → 200422
POST
/v1/knowledge-bases
Create Knowledge Base
createKnowledgeBase body → 201422
GET
/v1/knowledge-bases/{knowledge_base_id}
Get Knowledge Base By Id
getKnowledgeBase 1 param → 200422
DELETE
/v1/knowledge-bases/{knowledge_base_id}
Delete Knowledge Base
deleteKnowledgeBase 1 param → 204422
PATCH
/v1/knowledge-bases/{knowledge_base_id}
Update Knowledge Base
updateKnowledgeBase 1 param body → 200422

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are KnowledgeBaseResponse (21 properties), KnowledgeBaseFileResponse (12 properties), CreateKnowledgeBaseRequest (7 properties), UpdateKnowledgeBaseRequest (7 properties). Each schema is shown below with its type and property counts.

PaginationDirection
string
Direction for cursor-based pagination.
StackFileStatusEnum
string
Processing status of a file in a knowledge base.
KnowledgeBaseResponseIndexingParams
object
Indexing configuration of a knowledge base.
3 properties 1 required
SelectedWebsiteSource
object
A set of pages selected for indexing from a website source.
3 properties 2 required
StringSubtypeEnum
string
UpdateKnowledgeBaseRequest
object
Updates to apply to an existing knowledge base.
7 properties
KnowledgeBaseIndexingParamsRequest
object
Parameters that control how documents are indexed into a knowledge base.
3 properties
MetadataSchema
object
1 property 1 required
HTTPValidationError
object
1 property
KnowledgeBaseResourcesResponse
object
ChunkerType
string
ResourceUploadResponse
object
Result of a file upload, including the resource ID for status polling.
2 properties 2 required
KnowledgeBaseResponseEmbeddingParams
object
Embedding configuration of a knowledge base.
2 properties 1 required
NumberProperty
object
3 properties
KnowledgeBaseChunkerParams
object
Chunking strategy for splitting documents during indexing.
3 properties
CreateKnowledgeBaseRequest
object
Payload to create a new knowledge base.
7 properties
KnowledgeBaseResponse
object
A knowledge base.
21 properties 8 required
StringListOption
object
5 properties 1 required
StringListOptionColor
string
Store the different colors that can be used for the string list options.
StringProperty
object
4 properties
SelectedWebsiteSourceType
string
The type of website source.
KnowledgeBaseFileResponse
object
A file stored in a knowledge base.
12 properties 9 required
BooleanProperty
object
3 properties
KnowledgeBaseSyncResponse
object
Result of a knowledge base sync or reindex request.
2 properties 1 required
KnowledgeBaseRole
string
A user's role within a knowledge base.
CreateKnowledgeBaseEmbeddingParams
object
Embedding configuration for a new knowledge base.
2 properties
ValidationError
object
3 properties 3 required
StringListProperty
object
A property that contains a list of strings. Can be used to store tags as well.
4 properties
DateProperty
object
3 properties
Body_uploadKnowledgeBaseResource
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stacks-ai-knowledge-bases-api-openapi.yml Raw ↑

Other APIs Stacks Ai publishes across the network.

Stacks Ai analytics API
Stacks Ai Knowledge Base Resources API
Stacks Ai Knowledge Base Sync API
Stacks Ai Run Flow API
Where this information came from

This is an independent, third-party profile of Stacks Ai Knowledge Bases API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.