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.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/acoustic-authoring-version-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no email required.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Acoustic Authoring version API
version: 1.0.142
x-ibm-name: ibm-watson-content-hub-api
description: 'Operations tagged Authoring version across 2 of this provider''s published API definitions: acoustic-content-openapi-original.json, acoustic-content-swagger2-original.yaml. Each path carries the servers of the definition it was published in.'
tags:
- name: Authoring version
description: Use the Content version Rest APIs to work with authoring items that have versions. Versioned documents currently includes assets and content items within Content. The version APIs allow you to retrieve versions.
paths:
/authoring/v1/versions/{classification}/{id}:
get:
summary: Retrieve all versions for the specified authoring item.
description: 'Use the /versions/{classification}/{id} endpoint to retrieve all the versions for the specified authoring item.
<br />User roles: admin, manager, editor, viewer'
parameters:
- name: id
in: path
description: Provide the ID of the authoring item that you want to retrieve versions for.
required: true
schema:
type: string
- name: classification
in: path
description: Provide the classification of the authoring item that you want to retrieve versions for.
required: true
schema:
type: string
tags:
- Authoring version
responses:
'200':
description: Successfully retrieved the API representation containing all the versions for the specified item.
content:
application/json:
schema:
type: object
description: All versions for the specified item.
properties:
id:
type: string
description: The id of the item that these versions belong to
example: 913b5e06ade9b2c215dc403e07368acc
classification:
type: string
description: the classification of the item these versions belong to
example: content
deleted:
type: boolean
description: Whether the specified item is currently deleted.
example: false
versions:
type: array
description: The published versions associated to the specified item.
items:
type: object
description: A specific version of an item.
properties:
containerType:
enum:
- deleted
- current
- item
description: This indicates identifies the format of this container object in this API. "deleted" represents a deleted version so it won't have a link to the actual document. "item" represents the standard version and "current" is to collect draft versions
number:
type: string
example: '2.0'
description: The major version number
link:
type: string
example: /authoring/v1/versions/content/2c51c263-cc86-4c76-8146-7b4a12c88cd1/2019-03-26T03:06:42.835Z
description: A link to fetching the actual version, only available for containerType "item"
timestamp:
type: string
format: date-time
description: ISO-8601 timestamp of when the version was created. Also serves as the unique identifier for the version. Not available for containerType "current"
example: '2019-11-02T06:28:47Z'
user:
type: string
description: The display name of the user that created this version
example: Thomas Watson
userId:
type: string
description: The user identifier of the user that created this version
example: a56305e1-201a-4961-a9d8-03fd026c0c19
drafts:
type: array
description: the draft versions that were made leading up to this published ersion.
items:
type: object
description: a Draft version of the specified item
properties:
containerType:
enum:
- deleted
- item
description: This indicates identifies the format of this container object in this API. "deleted" represents a deleted version so it won't have a link to the actual document. "item" represents the standard version
number:
type: string
example: '1.5'
description: The minor version number
link:
type: string
example: /authoring/v1/versions/content/2c51c263-cc86-4c76-8146-7b4a12c88cd1/2019-03-26T03:06:42.835Z
description: A link to fetching the actual version, only available for containerType "item"
timestamp:
type: string
format: date-time
description: ISO-8601 timestamp of when the version was created. Also serves as the unique identifier for the version.
example: '2019-11-02T06:28:47Z'
user:
type: string
description: The display name of the user that created this version
example: Thomas Watson
userId:
type: string
description: The user identifier of the user that created this version
example: a56305e1-201a-4961-a9d8-03fd026c0c19
event:
type: string
enum:
- published
- created
- updated
- retired
- approved
- restored
- deleted
- merged
- moved-source
- moved-target
- review-started
- review-ended
description: "Version Event:\n * `published` - Published, The item was published and the `ready` item was updated\n * `created` - Created, The item was created\n * `updated` - Updated, the item was updated\n * `retired` - Retired, the item was retired\n * `approved` - Approved, the draft item was approved\n * `restored` - Restored, this item update is based off a previous version\n * `deleted` - Deleted, the item was deleted\n * `merged` - Merged, this draft was deleted and its changes was merged into the `ready` item\n * `moved-source` - Deleted by Move, This draft was deleted as it was moved into a project/publishing job\n * `moved-target` - Created by Move, this draft was created in this particular project/publishing job as a result of a move\n * `review-started` - Start Review, a review was started on this item\n * `review-ended` - Review Ended, a review was ended on this item\n"
example: updated
event:
type: string
enum:
- published
- created
- updated
- retired
- approved
- restored
- deleted
- merged
- moved-source
- moved-target
- review-started
- review-ended
description: "Version Event:\n * `published` - Published, The item was published and the `ready` item was updated\n * `created` - Created, The item was created\n * `updated` - Updated, the item was updated\n * `retired` - Retired, the item was retired\n * `approved` - Approved, the draft item was approved\n * `restored` - Restored, this item update is based off a previous version\n * `deleted` - Deleted, the item was deleted\n * `merged` - Merged, this draft was deleted and its changes was merged into the `ready` item\n * `moved-source` - Deleted by Move, This draft was deleted as it was moved into a project/publishing job\n * `moved-target` - Created by Move, this draft was created in this particular project/publishing job as a result of a move\n * `review-started` - Start Review, a review was started on this item\n * `review-ended` - Review Ended, a review was ended on this item\n"
example: updated
required:
- deleted
- id
- classification
- versions
'404':
description: No versions found for item with ID {id} and classification {classification}.
content:
application/json:
schema:
type: object
description: An error response.
properties:
requestId:
type: string
description: The current request ID
service:
type: string
description: The name of the service that produced the error
requestMethod:
type: string
description: The Http method type of the current request
requestUri:
type: string
description: The request uri
errors:
type: array
items:
type: object
description: an individual error, info or warning message.
properties:
code:
type: integer
description: The message code
key:
type: string
description: The message key
message:
type: string
description: The error message
description:
type: string
description: Optional detailed error message
more_info:
type: string
description: Optional additional information for the message
category:
type: string
description: The message category whereby only user messages are designed to be shown to an end user
enum:
- API
- USER
level:
type: string
description: Indicates the message level
enum:
- INFO
- WARNING
- ERROR
parameters:
type: object
description: The message parameters of this message.
field:
type: string
description: Only present on field validation errors, indicates the field in error.
locale:
type: string
description: The current locale used to produce the error message.
required:
- code
- key
- message
- description
- more_info
- category
- level
- parameters
- field
- locale
required:
- requestId
- service
- requestMethod
- requestUri
- errors
'429':
description: Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: Unable to retrieve the specified item's versions from the database as the service is unavailable. Try again later.
content:
application/json:
schema:
type: object
description: An error response.
properties:
requestId:
type: string
description: The current request ID
service:
type: string
description: The name of the service that produced the error
requestMethod:
type: string
description: The Http method type of the current request
requestUri:
type: string
description: The request uri
errors:
type: array
items:
type: object
description: an individual error, info or warning message.
properties:
code:
type: integer
description: The message code
key:
type: string
description: The message key
message:
type: string
description: The error message
description:
type: string
description: Optional detailed error message
more_info:
type: string
description: Optional additional information for the message
category:
type: string
description: The message category whereby only user messages are designed to be shown to an end user
enum:
- API
- USER
level:
type: string
description: Indicates the message level
enum:
- INFO
- WARNING
- ERROR
parameters:
type: object
description: The message parameters of this message.
field:
type: string
description: Only present on field validation errors, indicates the field in error.
locale:
type: string
description: The current locale used to produce the error message.
required:
- code
- key
- message
- description
- more_info
- category
- level
- parameters
- field
- locale
required:
- requestId
- service
- requestMethod
- requestUri
- errors
default:
description: Unexpected error.
content:
application/json:
schema:
type: object
description: An error response.
properties:
requestId:
type: string
description: The current request ID
service:
type: string
description: The name of the service that produced the error
requestMethod:
type: string
description: The Http method type of the current request
requestUri:
type: string
description: The request uri
errors:
type: array
items:
type: object
description: an individual error, info or warning message.
properties:
code:
type: integer
description: The message code
key:
type: string
description: The message key
message:
type: string
description: The error message
description:
type: string
description: Optional detailed error message
more_info:
type: string
description: Optional additional information for the message
category:
type: string
description: The message category whereby only user messages are designed to be shown to an end user
enum:
- API
- USER
level:
type: string
description: Indicates the message level
enum:
- INFO
- WARNING
- ERROR
parameters:
type: object
description: The message parameters of this message.
field:
type: string
description: Only present on field validation errors, indicates the field in error.
locale:
type: string
description: The current locale used to produce the error message.
required:
- code
- key
- message
- description
- more_info
- category
- level
- parameters
- field
- locale
required:
- requestId
- service
- requestMethod
- requestUri
- errors
x-ibm-dx-security-user-roles:
- admin
- manager
- editor
- viewer
/authoring/v1/versions/{classification}/{id}/{timestamp}:
get:
summary: Retrieve a specific version for a specific authoring item.
description: 'Use the /versions/{classification}/{id}/{timestamp} endpoint to retrieve a specific version for the specified authoring item.
<br />User roles: admin, manager, editor, viewer'
parameters:
- name: id
in: path
description: Provide the ID of the authoring item that you want to retrieve a version for.
required: true
schema:
type: string
- name: classification
in: path
description: Provide the classification of the authoring item that you want to retrieve a version for.
required: true
schema:
type: string
- name: timestamp
in: path
description: Provide the ISO-8601 timestamp of the version that you want to retrieve.
required: true
schema:
type: string
format: date-time
tags:
- Authoring version
responses:
'200':
description: Successfully retrieved the API representation of the version that matches the parameters that you provided.
content:
application/json:
schema:
type: object
'404':
description: No versions found for item with ID {id} and classification {classification}.
content:
application/json:
schema:
type: object
description: An error response.
properties:
requestId:
type: string
description: The current request ID
service:
type: string
description: The name of the service that produced the error
requestMethod:
type: string
description: The Http method type of the current request
requestUri:
type: string
description: The request uri
errors:
type: array
items:
type: object
description: an individual error, info or warning message.
properties:
code:
type: integer
description: The message code
key:
type: string
description: The message key
message:
type: string
description: The error message
description:
type: string
description: Optional detailed error message
more_info:
type: string
description: Optional additional information for the message
category:
type: string
description: The message category whereby only user messages are designed to be shown to an end user
enum:
- API
- USER
level:
type: string
description: Indicates the message level
enum:
- INFO
- WARNING
- ERROR
parameters:
type: object
description: The message parameters of this message.
field:
type: string
description: Only present on field validation errors, indicates the field in error.
locale:
type: string
description: The current locale used to produce the error message.
required:
- code
- key
- message
- description
- more_info
- category
- level
- parameters
- field
- locale
required:
- requestId
- service
- requestMethod
- requestUri
- errors
'429':
description: Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: Unable to retrieve the versions for the specified item from the database as the service is unavailable. Try again later.
content:
application/json:
schema:
type: object
description: An error response.
properties:
requestId:
type: string
description: The current request ID
service:
type: string
description: The name of the service that produced the error
requestMethod:
type: string
description: The Http method type of the current request
requestUri:
type: string
description: The request uri
errors:
type: array
items:
type: object
description: an individual error, info or warning message.
properties:
code:
type: integer
description: The message code
key:
type: string
description: The message key
message:
type: string
description: The error message
description:
type: string
description: Optional detailed error message
more_info:
type: string
description: Optional additional information for the message
category:
type: string
description: The message category whereby only user messages are designed to be shown to an end user
enum:
- API
- USER
level:
type: string
description: Indicates the message level
enum:
- INFO
- WARNING
- ERROR
parameters:
type: object
description: The message parameters of this message.
field:
type: string
description: Only present on field validation errors, indicates the field in error.
locale:
type: string
description: The current locale used to produce the error message.
required:
- code
- key
- message
- description
- more_info
- category
- level
- parameters
- field
- locale
required:
- requestId
- service
- requestMethod
- requestUri
- errors
default:
description: Unexpected error.
content:
application/json:
schema:
type: object
description: An error response.
properties:
requestId:
type: string
description: The current request ID
service:
type: string
description: The name of the service that produced the error
requestMethod:
type: string
description: The Http method type of the current request
requestUri:
type: string
description: The request uri
errors:
type: array
items:
type: object
description: an individual error, info or warning message.
properties:
code:
type: integer
description: The message code
key:
type: string
description: The message key
message:
type: string
description: The error message
description:
type: string
description: Optional detailed error message
more_info:
type: string
description: Optional additional information for the message
category:
type: string
description: The message category whereby only user messages are designed to be shown to an end user
enum:
- API
- USER
level:
type: string
description: Indicates the message level
enum:
- INFO
- WARNING
- ERROR
parameters:
type: object
description: The message parameters of this message.
field:
type: string
description: Only present on field validation errors, indicates the field in error.
locale:
type: string
description: The current locale used to produce the error message.
required:
- code
- key
- message
- description
- more_info
- category
- level
- parameters
- field
- locale
required:
- requestId
- service
- requestMethod
- requestUri
- errors
x-ibm-dx-security-user-roles:
- admin
- manager
- editor
- viewer
/authoring/v1/versions/restore:
post:
summary: Restore a versioned item - currently supported for content and assets.
description: 'Use this endpoint to restore a specific version of a content or an asset item by sending the JSON payload as the request body. The restored item will always be a draft - overwriting an existing one or creating a new one. Link to the new draft is sent as a response-header `Location`.
<br />User roles: admin, manager, editor'
tags:
- Authoring version
parameters:
- name: projectId
in: query
description: Optional projectId that the item belongs to.
required: false
schema:
type: string
responses:
'200':
description: 'A draft version already exists for the item and was used to restore the item''s version.
'
'201':
description: 'No draft version already existed for the item and a new draft item was created to restore the item''s version.
# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/acoustic/refs/heads/main/openapi/acoustic-authoring-version-api-openapi.yml