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-delivery-sites-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 Delivery sites API
version: 1.0.142
x-ibm-name: ibm-watson-content-hub-api
description: 'Operations tagged Delivery sites 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: Delivery sites
description: 'Use the Content delivery sites service Rest APIs to retrieve published site artefacts.
'
paths:
/delivery/v1/sites/{siteId}:
get:
x-ibm-dx-security-user-roles:
- admin
- manager
- editor
- viewer
- authenticatedVisitor
- anonymous
x-ibm-dx-vary: []
summary: Get the site descriptor of a public site
description: 'Returns the site descriptor of the site specified by *siteId*.
<br />User roles: admin, manager, editor, viewer, authenticatedVisitor, anonymous'
parameters:
- name: siteId
in: path
description: The ID of the site item, or `@current` to indicate that the ID of the site is derived from the addressed URL via custom domain site mapping or URL path based site addressing. For further details consult the Content documentation.
required: true
schema:
type: string
format: uuid
- name: fields
in: query
description: Reduce the returned content down to just the specified fields. Fields specified by a comma seperated list of field names and should only be used once in query string. To only retrieve `id` and `name` this parameter should look like `id,name`. Undefined fields are ignored.
required: false
style: form
explode: false
schema:
type: string
items:
type: string
- name: If-None-Match
in: header
description: The Etag value from a previous request to check whether a content item has been updated since, if so, a 304 (Not Modified) response code is returned instead of the content item.
required: false
schema:
type: string
responses:
'200':
description: Success
headers:
Etag:
description: The etag value identifies this site item for future requests.
schema:
type: string
content:
application/json:
schema:
title: Site
type: object
properties:
id:
type: string
description: The ID of the site item.
name:
type: string
description: The site item name.
routingMode:
type: string
description: The routing mode. can be "path" or "anchor"
classification:
type: string
description: The classification defines the document type. For site items, all documents are classified as "site".
lastModified:
type: string
description: The last modified date of this site item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
lastModifierId:
type: string
description: The id of the user which applied the last modification of this item.
created:
type: string
description: The created date of this site item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
creatorId:
type: string
description: The id of the user that created this item.
example:
name: Example site
routingMode: path
classification: site
lastModified: '2018-01-22T09:11:53.100Z'
lastModifierId: 52fb9c98-822f-4d6b-99ed-a8b5e04f3782
creatorId: 00000000-0000-0000-0000-000000000009
created: '2018-01-10T12:01:57.188Z'
id: 949c298a-03c9-21b5-9386-b8ea3c3e0ee3
'304':
description: The "Not modified" message is returned when the If-None-Match header is used and the Etag value matches the most recent version of the content item.
'400':
description: "Bad request. \n This error status is returned if a parameter value is invalid.\n"
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 7001
message: Missing or invalid value for 'fields' query parameter.
level: ERROR
description: Check that the 'fields' parameter is not blank, does not contain spaces or empty values, e.g. 'fields=rev,,last-modified' is considered invalid.
locale: en
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 7003
message: 'Site not found for id : f54e763a-fd53-424b-8ad9-7cc690cca2dc.'
level: ERROR
description: A site item with the specified id was not found in the system.
locale: en
'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'
default:
description: "Unexpected error \n An internal error has occurred. For example, a dependant service is not running.\n"
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 1014
message: Unexpected error occurred.
level: ERROR
description: Unable to complete the request due to an unexpected error. Try again or contact Acoustic support if problem persists.
locale: en
tags:
- Delivery sites
/mydelivery/v1/sites/{siteId}:
get:
x-ibm-dx-security-user-roles:
- admin
- manager
- editor
- viewer
- authenticatedVisitor
summary: Get the site descriptor of a public or protected site.
description: 'Returns the site descriptor of the site specified by *siteId*.
<br />User roles: admin, manager, editor, viewer, authenticatedVisitor'
parameters:
- name: siteId
in: path
description: The ID of the site item, or `@current` to indicate that the ID of the site is derived from the addressed URL via custom domain site mapping or URL path based site addressing. For further details consult the Content documentation.
required: true
schema:
type: string
format: uuid
- name: fields
in: query
description: Reduce the returned content down to just the specified fields. Fields specified by a comma seperated list of field names and should only be used once in query string. To only retrieve `id` and `name` this parameter should look like `id,name`. Undefined fields are ignored.
required: false
style: form
explode: false
schema:
type: string
items:
type: string
- name: If-None-Match
in: header
description: The Etag value from a previous request to check whether a content item has been updated since, if so, a 304 (Not Modified) response code is returned instead of the content item.
required: false
schema:
type: string
responses:
'200':
description: Success
headers:
Etag:
description: The etag value identifies this site item for future requests.
schema:
type: string
content:
application/json:
schema:
title: Site
type: object
properties:
id:
type: string
description: The ID of the site item.
name:
type: string
description: The site item name.
routingMode:
type: string
description: The routing mode. can be "path" or "anchor"
classification:
type: string
description: The classification defines the document type. For site items, all documents are classified as "site".
lastModified:
type: string
description: The last modified date of this site item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
lastModifierId:
type: string
description: The id of the user which applied the last modification of this item.
created:
type: string
description: The created date of this site item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
creatorId:
type: string
description: The id of the user that created this item.
example:
name: Example site
routingMode: path
classification: site
lastModified: '2018-01-22T09:11:53.100Z'
lastModifierId: 52fb9c98-822f-4d6b-99ed-a8b5e04f3782
creatorId: 00000000-0000-0000-0000-000000000009
created: '2018-01-10T12:01:57.188Z'
id: 949c298a-03c9-21b5-9386-b8ea3c3e0ee3
'304':
description: The "Not modified" message is returned when the If-None-Match header is used and the Etag value matches the most recent version of the content item.
'400':
description: "Bad request. \n This error status is returned if a parameter value is invalid.\n"
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 7001
message: Missing or invalid value for 'fields' query parameter.
level: ERROR
description: Check that the 'fields' parameter is not blank, does not contain spaces or empty values, e.g. 'fields=rev,,last-modified' is considered invalid.
locale: en
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 7003
message: 'Site not found for id : f54e763a-fd53-424b-8ad9-7cc690cca2dc.'
level: ERROR
description: A site item with the specified id was not found in the system.
locale: en
'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'
default:
description: "Unexpected error \n An internal error has occurred. For example, a dependant service is not running.\n"
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 1014
message: Unexpected error occurred.
level: ERROR
description: Unable to complete the request due to an unexpected error. Try again or contact Acoustic support if problem persists.
locale: en
tags:
- Delivery sites
/delivery/v2/sites/{siteId}:
get:
x-ibm-dx-security-user-roles:
- admin
- manager
- editor
- viewer
- authenticatedVisitor
- anonymous
x-ibm-dx-vary: []
summary: Get the site descriptor of a public site
description: 'Returns the site descriptor of the site specified by *siteId*.
<br />User roles: admin, manager, editor, viewer, authenticatedVisitor, anonymous'
parameters:
- name: siteId
in: path
description: The ID of the site item, or `@current` to indicate that the ID of the site is derived from the addressed URL via custom domain site mapping or URL path based site addressing. For further details consult the Content documentation.
required: true
schema:
type: string
format: uuid
- name: fields
in: query
description: Reduce the returned content down to just the specified fields. Fields specified by a comma seperated list of field names and should only be used once in query string. To only retrieve `id` and `name` this parameter should look like `id,name`. Undefined fields are ignored.
required: false
style: form
explode: false
schema:
type: string
items:
type: string
- name: If-None-Match
in: header
description: The Etag value from a previous request to check whether a content item has been updated since, if so, a 304 (Not Modified) response code is returned instead of the content item.
required: false
schema:
type: string
responses:
'200':
description: Success
headers:
Etag:
description: The etag value identifies this site item for future requests.
schema:
type: string
content:
application/json:
schema:
title: Content
type: object
properties:
id:
type: string
description: The ID of the content item.
name:
type: string
description: The name of the content item.
description:
type: string
description: The description text for this content item.
classification:
type: string
description: The classification defines the document type. For site items, all documents are classified as "content".
typeId:
type: string
description: The ID of the content type this item belongs to.
locale:
type: string
description: locale of the document (e.g "en", or "de").
lastModified:
type: string
format: date-time
description: The last modified date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
lastModifierId:
type: string
description: name of user for now, this property may change once user management is defined.
created:
type: string
format: date-time
description: The created date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
creatorId:
type: string
description: The Id of the user that created this content item.
kind:
type: array
items:
type: string
uniqueItems: true
description: The kind of content. At least, one item kind element should be "site".
tags:
type: array
items:
type: string
uniqueItems: true
description: The tags which has been set for this content item.
elements:
type: object
description: Defined by the type and capture in the schema given by the type, in a real content, this property will be filled with more information.
type:
type: string
description: this is the Id of the content type document this content is based on.
'304':
description: The "Not modified" message is returned when the If-None-Match header is used and the Etag value matches the most recent version of the content item.
'400':
description: "Bad request.\n This error status is returned if a parameter value is invalid.\n"
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 7001
message: Missing or invalid value for 'fields' query parameter.
level: ERROR
description: Check that the 'fields' parameter is not blank, does not contain spaces or empty values, e.g. 'fields=rev,,last-modified' is considered invalid.
locale: en
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that is specific to the service that reports the error.
message:
type: string
description: A brief error message.
level:
type: string
enum:
- WARNING
- ERROR
description: The error severity.
description:
type: string
description: A detailed description that describes what caused the eror, and how to proceed.
cause:
type: object
description: The causing error.
locale:
type: string
description: The locale setting of the message and description text.
examples:
response:
value:
service: prod-delivery-sites
requestId: c39d3e05-22f7-4d7c-8d7b-21ba6a2db508
errors:
code: 7003
message: 'Site not found for id : f54e763a-fd53-424b-8ad9-7cc690cca2dc.'
level: ERROR
description: A site item with the specified id was not found in the system.
locale: en
'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'
default:
description: "Unexpected error\n An internal error has occurred. For example, a dependant service is not running.\n"
content:
application/json:
schema:
type: object
properties:
service:
type: string
description: The name of the microservice that detected the error.
requestId:
type: string
description: The ID of the request in which this error happened.
errors:
type: object
description: This JSON object describes a specific error of an error condition.
properties:
code:
type: integer
description: An error code that i
# --- truncated at 32 KB (96 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/acoustic/refs/heads/main/openapi/acoustic-delivery-sites-api-openapi.yml