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

Ada knowledge > articles API

The knowledge > articles API from Ada — 3 operation(s) for knowledge > articles.

Ada knowledge > articles API is one of 29 APIs that Ada publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Knowledge Articles. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 3 paths, and defines 21 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://example.ada.support/api.

5 operations 3 paths 21 schemas 2 DELETE2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://example.ada.support
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Ada knowledge > articles API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth).

Paths & Operations 5

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

knowledge > articles 5
GET
/v2/knowledge/articles/
Get knowledge articles
list 8 params → 200400401404429500
DELETE
/v2/knowledge/articles/
Delete multiple articles
delete 6 params → 204400401404429500
GET
/v2/knowledge/articles/{id}
Get a single knowledge article
get 2 params → 200401404429500
DELETE
/v2/knowledge/articles/{id}
Delete a single article
delete-by-id 2 params → 204400401404429500
POST
/v2/knowledge/bulk/articles/
Upsert multiple articles
bulk-upsert 1 param body → 200400401429500

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are KnowledgeArticleResponse (14 properties), KnowledgeArticleUpsertRequest (12 properties), AvailabilityRuleCondition (4 properties), KnowledgeArticleUpsertResponse (3 properties). Each schema is shown below with its type and property counts.

AvailabilityRuleCondition
object
A single condition comparing a variable to a value.
4 properties 2 required
KnowledgeArticleResponseMetadata
object
A dictionary of arbitrary key,value pairs. This data is not used by Ada, but can be used by the client to store additional information about the article.
knowledge_articles_deleteById_Response_204
object
Empty response body
AvailabilityRuleConditionsItems
ErrorsErrorsItems
object
3 properties 2 required
ArticleLanguage
string
The ISO 639-1 language code of the article, defaults to en
KnowledgeArticleResponse
object
14 properties 3 required
AvailabilityRuleConditionVariable
object
The variable to test, referenced by id. Look up the ids for your Agent through the variables endpoint. Not every variable can be used in a rule; referencing on…
1 property 1 required
AvailabilityRuleConditionGroup
object
A nested group of conditions inside a rule's top-level conditions list. Condition groups may contain only Condition objects — further nesting is not supported.
2 properties 2 required
AvailabilityRuleConditionValue
The value to compare against. Omit for unary operators (isset, isnotset).
knowledge_articles_delete_Response_204
object
Empty response body
AvailabilityRuleMatch
string
Whether all conditions must pass (all) or any one condition must pass (any).
AvailabilityRuleConditionOperator
string
The comparison operator. Unary operators (isset, isnotset) must not include a value field.
KnowledgeArticleUpsertRequestMetadata
object
A dictionary of arbitrary key,value pairs. This data is not used by Ada, but can be used by the client to store additional information about the article.
KnowledgeArticleUpsertRequest
object
12 properties 4 required
KnowledgeArticleUpsertResponse
object
3 properties 1 required
AvailabilityRuleConditionGroupMatch
string
Whether all conditions must pass (all) or any one condition must pass (any).
AvailabilityRule
object
A two-level tree of conditions that determines availability based on variable values during a conversation. The root group has a match combinator and a list of…
2 properties 2 required
PaginationMetadata
object
1 property
knowledge_articles_list_Response_200
object
2 properties
Errors
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ada-knowledge-articles-api-openapi.yml Raw ↑

Other APIs Ada publishes across the network.

Ada End Users API
Ada Conversations API
Ada Integrations API
Ada MCP Server
Ada Audit Log API
Ada Channels API
Ada Conversations API
Ada Custom Instructions API
Ada Delete Chatter Data API
Ada End Users API
Ada Get Deletion Job API
Ada Knowledge API
Where this information came from

This is an independent, third-party profile of Ada knowledge > articles 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.