This API is intended to be used in conjunction with the Unity Cloud Build service. A tool for building your Unity projects in the Cloud.

See https://developer.cloud.unity3d.com for more information.

Making requests

This website is built to allow requests to be made against the API. If you are currently logged into Cloud Build you should be able to make requests without entering an API key.

You can find your API key in the Unity Cloud Services portal by clicking on 'Cloud Build Preferences' in the sidebar. Copy the API Key and paste it into the upper left corner of this website. It will be used in all subsequent requests.

Clients

The Unity Cloud Build API is based upon Swagger. Client libraries to integrate with your projects can easily be generated with the Swagger Code Generator.

The JSON schema required to generate a client for this API version is located here:

https: / /build-api.cloud.unity3d.com/api /v1/api .json

Authorization

The Unity Cloud Build API requires an access token from your Unity Cloud Build account, which can be found at https://build.cloud.unity3d.com/login/me

To authenticate requests, include a Basic Authentication header with your API key as the value. e.g.

Authorization : Basic [YOUR API KEY]

Pagination

Paged results will take two parameters. A page number that is calculated based upon the per_page amount. For instance if there are 40 results and you specify page 2 with per_page set to 10 you will receive records 11-20.

Paged results will also return a Content-Range header. For the example above the content range header would look like this:

Content-Range: items 11 - 20 / 40

Versioning

The API version is indicated in the request URL. Upgrading to a newer API version can be done by changing the path.

The API will receive a new version in the following cases:

removal of a path or request type

addition of a required field

removal of a required field

The following changes are considered backwards compatible and will not trigger a new API version:

addition of an endpoint or request type

addition of an optional field

removal of an optional field

changes to the format of ids

Identifiers

It should not be assumed that any of the identifiers used in paths will be a perfect match for your user-entered information. If you see unexpected 403s or 404s from API calls then check your identifiers match the ones used by the API. In particular, projectId does NOT typically change when the project is renamed and in fact may not be a direct match for the project name even at initial creation time.

To avoid confusion we recommend that instead of using the human-readable autogenerated orgId and projectId available from the API you should instead use:

org foreign key for orgId (available from project APIs as orgFk and org APIs as coreForeignKey )

(available from project APIs as and org APIs as ) guid for projectId

All links generated by the API and the Dashboard should follow this format already, making it easy to figure out the correct parameters by making a comparison.

Rate Limiting

Requests against the Cloud Build API are limited to a rate of 100 per minute. To preserve the quality of service throughout Cloud Build, additional rate limits may apply to some actions. For example, polling aggressively instead of using webhooks or making API calls with a high concurrency may result in rate limiting.

It is not intended for these rate limits to interfere with any legitimate use of the API. Please contact support at cloudbuild@unity3d.com if your use is affected by this rate limit.

You can check the returned HTTP headers for any API request to see your current rate limit status.

X-RateLimit-Limit: maximum number of requests per minute

maximum number of requests per minute X-RateLimit-Remaining: remaining number of requests in the current window

remaining number of requests in the current window X-RateLimit-Reset: time at which the current window will reset (UTC epoch seconds)

Once you go over the rate limit you will receive an error response: