The first thing you'll need to know is where to send your REST requests:
The root API URL is
You'll probably notice the
realm parameters that form part of
the URL. In the future these will allow us to run multiple instances and
versions of Sibelius Cloud Publishing, but for now their values are always
All communication is via HTTPS.
Authorization and access tokens
Use of the API is authenticated and authorized using an access token. Your access token will be provided to you by e-mail.
You must send your access token as an HTTP
Authorization header with every
The required format of the header is
Authorization: Bearer <your access token here>. Here's an example:
GET /apis/avid.sibelius.publishing;version=2;realm=global/publishers HTTP/1.1
Making your first request
Before getting into any publishing related calls, you can use the
serviceHealth method to check your connectivity and authorization.
GET /apis/avid.sibelius.publishing;version=2;realm=global/core/health HTTP/1.1
Some resources have user-definable parameters. These may be set either as as query parameters or in the body of the HTTP request as a JSON document.
For example, the next two examples demonstrate how you can specify the
scoreUrl parameter first using query parameters:
POST /apis/avid.sibelius.publishing;version=2;realm=global/scores?scoreUrl=http%3A%2F%2Fwww.sibelius.com%2Ftest.sco HTTP/1.1
And now as part of the HTTP body:
POST /apis/avid.sibelius.publishing;version=2;realm=global/scores HTTP/1.1
Note: You must URI-encode any parameters that you pass as query parameters. There is no need to do this when specifying parameter as part of the HTTP body.