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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Vendasta

Vendasta AI Knowledge API

The knowledge (embeddings) API that grounds Vendasta AI Employees: upsert a knowledge source into an account or partner knowledge base, request a signed URL for direct file upload, remove a source, and link sources to specific AI Employees. This is the ONLY Vendasta API with a published rate limit — 10 writes per minute per account group against a 100/minute partner-wide ceiling, HTTP 429 on exhaustion.

Documentation Provider Profile APIs.io OpenAPI GitHub

Vendasta AI Knowledge API is one of 38 APIs that Vendasta publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Artificial Intelligence, Knowledge, Embeddings, RAG, and gRPC. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 5 paths, and defines 24 schemas. It is described by OpenAPI 3.0.0, at version 2.0.0.

Requests are made against a single base URL, https://prod.apigateway.co/grpc.

5 operations 5 paths 24 schemas 5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.0.0
Base URL
https://prod.apigateway.co/grpc
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Vendasta AI Knowledge API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes.

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 POST. Each is listed below with its method, path, parameters, and response codes.

Knowledge 5
POST
/v1/knowledge/file-upload
Create Knowledge File Upload
Knowledge_CreateKnowledgeFileUpload body → 200default
POST
/v1/knowledge/list
List Knowledge
Knowledge_ListKnowledge body → 200default
POST
/v1/knowledge/remove
Remove Knowledge
Knowledge_RemoveKnowledge body → 200default
POST
/v1/knowledge/status
Get Knowledge Status
Knowledge_GetKnowledgeStatus body → 200default
POST
/v1/knowledge/upsert
Upsert Knowledge
Knowledge_UpsertKnowledge body → 200default

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are v2KnowledgeSourceSummary (7 properties), v2UpsertKnowledgeRequest (7 properties), v2RemoveKnowledgeRequest (5 properties), v2CreateKnowledgeFileUploadRequest (4 properties). Each schema is shown below with its type and property counts.

protobufAny
object
1 property
rpcStatus
object
3 properties
v2CreateKnowledgeFileUploadRequest
object
Request to issue a signed URL and handle for uploading a single knowledge file directly to storage.
4 properties 2 required
v2CreateKnowledgeFileUploadResponse
object
The signed URL and handle for uploading a single knowledge file.
4 properties
v2DeleteMode
object
Selects the deletion of the knowledge source. This message has no fields. Its presence in the mode oneof is the instruction to delete.
v2FileContent
object
A file to process into knowledge. Do not send the bytes in this message. Supply the uploadhandle from the file-upload flow.
3 properties 1 required
v2GetKnowledgeStatusRequest
object
Request to look up the processing status of a single knowledge source.
3 properties 1 required
v2GetKnowledgeStatusResponse
object
The processing status of the requested knowledge source.
1 property
v2KnowledgeConfigType
string
The kind of content backing a knowledge source. - KNOWLEDGECONFIGTYPEBUSINESSPROFILE: Structured business-profile data that the platform manages, such as the w…
v2KnowledgeContent
object
The content to store for a knowledge source on create or update. Exactly one variant must be set. The variant determines the configtype of the source. On updat…
2 properties
v2KnowledgeSourceSummary
object
A summary of one knowledge source in an account's knowledge base: identity, content type, processing status, and timestamps.
7 properties
v2ListKnowledgeRequest
object
Request to list the knowledge sources in a namespace's knowledge base, optionally filtered to one AI Employee.
4 properties
v2ListKnowledgeResponse
object
A page of knowledge sources with pagination metadata.
2 properties
v2RemoveKnowledgeRequest
object
Request to remove a knowledge source from a namespace's knowledge base, either by deleting it or by unlinking it from specific AI Employees.
5 properties 1 required
v2RemoveKnowledgeResponse
object
The result of a RemoveKnowledge call.
v2TextContent
object
Free-form text content that an integration supplies directly.
1 property 1 required
v2TrainingErrorCode
string
Machine-readable reason a knowledge source failed processing. - TRAININGERRORCODEINVALID: No error is recorded. This is the value when the processing of the so…
v2TrainingState
string
The processing state of a knowledge source's content. - TRAININGSTATEQUEUED: The content is queued for processing. It is not yet available to AI Employees. - T…
v2TrainingStatus
object
The processing status of a knowledge source, including progress counters and any terminal error.
4 properties
v2UnlinkMode
object
Selects unlinking the knowledge source from specific AI Employees without deleting it.
1 property 1 required
v2UpsertKnowledgeRequest
object
Request to create or update a knowledge source and optionally link it to an AI Employee.
7 properties
v2UpsertKnowledgeResponse
object
The result of an UpsertKnowledge call.
1 property
vendastatypesPagedRequestOptions
object
2 properties
vendastatypesPagedResponseMetadata
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vendasta-ai-knowledge-openapi.json Raw ↑

Other APIs Vendasta publishes across the network.

Vendasta account API
AE Profile APIs.io
Vendasta activity API
AE Profile APIs.io
Vendasta change_spend API
AE Profile APIs.io
Vendasta customer API
AE Profile APIs.io
Vendasta executive_report API
AE Profile APIs.io
Vendasta marketplace_app API
AE Profile APIs.io
Vendasta oauth API
AE Profile APIs.io
Vendasta user API
AE Profile APIs.io
Vendasta Platform REST API
AE Profile APIs.io
Vendasta SCIM 2.0 User Management API
AE Profile APIs.io
Vendasta CRM REST API
AE Profile APIs.io
Vendasta CRM API (gRPC gateway)
AE Profile APIs.io
#Artificial Intelligence#Knowledge#Embeddings#RAG#gRPC
← Back to V APIs
API Details
ID
vendasta:vendasta-ai-knowledge-api
Base URL
https://prod.apigateway.co/grpc
Docs
https://developers.vendasta.com/platform
Provider
Vendasta
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=vendasta-ai-knowledge-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/vendasta-ai-knowledge-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Vendasta AI Knowledge 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.