The knowledge > sources API from Ada — 2 operation(s) for knowledge > sources.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/ada:ada-knowledge-sources-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
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
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
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
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:
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_delete_Response_204:
type: object
properties: {}
description: Empty response body
title: knowledge_sources_delete_Response_204
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
Errors:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/ErrorsErrorsItems'
description: A list of errors
required:
- errors
title: Errors
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
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
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
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_list_Response_200:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/KnowledgeSourceResponse'
title: knowledge_sources_list_Response_200
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
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
securitySchemes:
BearerAuth:
type: http
scheme: bearer