Ada knowledge > sources API
The knowledge > sources API from Ada — 2 operation(s) for knowledge > sources.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ada-knowledge-sources-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: knowledge > sources API
version: 1.0.0
servers:
- url: https://example.ada.support/api
description: Production
tags:
- name: knowledge > sources
paths:
/v2/knowledge/sources/:
get:
operationId: list
summary: Get knowledge sources
description: Get knowledge sources
tags:
- knowledge > sources
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Knowledge sources
content:
application/json:
schema:
$ref: '#/components/schemas/knowledge_sources_list_Response_200'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
post:
operationId: create
summary: Create a knowledge source
description: Create a knowledge source
tags:
- knowledge > sources
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Knowledge source created
content:
application/json:
schema:
$ref: '#/components/schemas/KnowledgeSourceResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'409':
description: Duplicate Resource
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/KnowledgeSourceCreateRequest'
/v2/knowledge/sources/{id}:
delete:
operationId: delete
summary: Delete a knowledge source
description: 'Delete a knowledge source, and its related articles
Deletion is asynchronous: a `204` response means the deletion request was accepted and is processed in the background. While deletion is in progress, the source reports a `status` of `deleting`; if deletion fails, the source reports `delete_failed`, and you can re-issue the request to retry. To confirm completion, re-query the knowledge source list until the source no longer appears. A `404` is still returned when the knowledge source does not exist.
'
tags:
- knowledge > sources
parameters:
- name: id
in: path
description: id of the knowledge source to delete
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'204':
description: Knowledge source deletion accepted; the source and its related articles are deleted in the background
content:
application/json:
schema:
$ref: '#/components/schemas/knowledge_sources_delete_Response_204'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
patch:
operationId: update
summary: Update a knowledge source
description: Update a knowledge source
tags:
- knowledge > sources
parameters:
- name: id
in: path
description: id of the knowledge source to update
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Knowledge source updated
content:
application/json:
schema:
$ref: '#/components/schemas/KnowledgeSourceResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/KnowledgeSourceUpdateRequest'
components:
schemas:
KnowledgeSourceResponse:
type: object
properties:
id:
type: string
description: A unique identifier for the knowledge source
external_id:
type:
- string
- 'null'
description: An external identifier for the knowledge source
name:
type: string
description: The name of the knowledge source
metadata:
oneOf:
- $ref: '#/components/schemas/KnowledgeSourceResponseMetadata'
- type: 'null'
description: 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 knowledge source.
created:
type: string
format: date-time
description: The date the knowledge source was created
updated:
type: string
format: date-time
description: The date the knowledge source was last updated
last_sync:
type: string
format: date-time
description: The date the knowledge source was last synchronized
status:
$ref: '#/components/schemas/KnowledgeSourceResponseStatus'
description: 'Deletion lifecycle status of the knowledge source: `deleting` while an asynchronous deletion is in progress, `delete_failed` if the deletion failed. `null` when no deletion is in progress.'
required:
- id
- name
title: KnowledgeSourceResponse
knowledge_sources_delete_Response_204:
type: object
properties: {}
description: Empty response body
title: knowledge_sources_delete_Response_204
KnowledgeSourceUpdateRequest:
type: object
properties:
external_id:
type:
- string
- 'null'
description: A unique identifier for the knowledge source
name:
type: string
description: The name of the knowledge source
metadata:
oneOf:
- $ref: '#/components/schemas/KnowledgeSourceUpdateRequestMetadata'
- type: 'null'
description: 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 knowledge source.
title: KnowledgeSourceUpdateRequest
KnowledgeSourceCreateRequest:
type: object
properties:
id:
type: string
description: A unique identifier for the knowledge source
name:
type: string
description: The name of the knowledge source
metadata:
oneOf:
- $ref: '#/components/schemas/KnowledgeSourceCreateRequestMetadata'
- type: 'null'
description: 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 knowledge source.
required:
- id
- name
title: KnowledgeSourceCreateRequest
ErrorsErrorsItems:
type: object
properties:
type:
type: string
description: The error type
message:
type: string
description: The error message
details:
type:
- string
- 'null'
description: Extra information about the error
required:
- type
- message
title: ErrorsErrorsItems
Errors:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/ErrorsErrorsItems'
description: A list of errors
required:
- errors
title: Errors
KnowledgeSourceResponseMetadata:
type: object
properties: {}
description: 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 knowledge source.
title: KnowledgeSourceResponseMetadata
KnowledgeSourceUpdateRequestMetadata:
type: object
properties: {}
description: 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 knowledge source.
title: KnowledgeSourceUpdateRequestMetadata
KnowledgeSourceResponseStatus:
type: string
enum:
- deleting
- delete_failed
description: 'Deletion lifecycle status of the knowledge source: `deleting` while an asynchronous deletion is in progress, `delete_failed` if the deletion failed. `null` when no deletion is in progress.'
title: KnowledgeSourceResponseStatus
KnowledgeSourceCreateRequestMetadata:
type: object
properties: {}
description: 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 knowledge source.
title: KnowledgeSourceCreateRequestMetadata
knowledge_sources_list_Response_200:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/KnowledgeSourceResponse'
title: knowledge_sources_list_Response_200
securitySchemes:
BearerAuth:
type: http
scheme: bearer