The IBM Watson Content Hub REST APIs allow you to work with the content in the database. You can
retrieve, update, and manage content. The APIs provide you with the flexibility of leveraging
existing content into various channels.
Access the Watson Content Hub APIs from the API Explorer. Each API service operation has a set of user roles that are allowed for the operation. You can call only the service operations that are allowed for the specific role a user has. The roles are
- Administrator – can access all functionality including tenant administration tasks such as adding/removing users.
- Manager – can create and manage content model, content, and assets.
- Editor – can create and manage content and assets.
- Viewer – can retrieve content and assets.
- Anonymous – cannot access any authoring functionality.
- Requests from the client application can be returned with an HTTP status code 429. In such
cases, the best approach would be to retry the request after some time.
- If a client program issues a high number of requests to IBM Watson Content Hub API, limit the
number of outstanding requests. Limiting the number of outstanding requests reduces the risk that
requests are replied with HTTP status code 429. In case the client would issue too many requests per
second, the request delay algorithm of IBM Watson Content Hub would limit the throughput.
Throughput limits for tenants
IBM Watson Content Hub is used simultaneously by multiple customers through their tenants. To
process resources for all customers, IBM Watson Content Hub limits the load that is imposed by each
tenant. The throughput limit for trial and paying customers can be different. If the number of
requests that are received by IBM Watson Content Hub is below the tenants throughput limit, the
requests are processed without delay.
IBM Watson Content Hub limits the number of requests per second per tenant, if the number of
incoming requests is above the throughput limit. The processing of the requests that are above the
limit are delayed for a certain time until they can be processed. If the delay time for processing
the requests is excessive, any additional requests are returned with the HTTP status code “429 Too
When you write client applications by using the IBM Watson Content Hub, you must be aware of the
You can use a command line interface (CLI) based utility wchtools to work with content, assets, and content model artifacts for Watson Content Hub.The wchtools is an open source utility that you can install from GitHub. You can use the tool to upload and download from your Watson Content Hub tenant. You can also use this tool to install sample content artifacts to your tenant, to bulk upload assets, and to trigger a publishing job.
The API documentation provides you with all the necessary information to get started.Before you start working with our APIs, take a look at a few use cases that demonstrate common business scenarios. These use cases will help you get a better context of the APIs may be relevant to your business needs.