Classic REST API

Each service here also has a newer version in the REST API, which lists every service. Use the newer version where you can.

Call these services as you would the REST API, with the same base URL and API key.

Services

Data

• Containerized extractor service

• Ingest service

• Streaming session service

• Units service

Metadata

• Asset service

• Comments service

• Event service

Access and administration

• Workspace service

Errors

A failed request gets an HTTP error status and a JSON body like this one:

{
  "errorCode": "NOT_FOUND",
  "errorName": "Catalog:DatasetNotFound",
  "errorInstanceId": "<error instance id>",
  "parameters": {}
}

errorName says which error it is, and each service’s page lists the errors it defines. errorCode is its kind, such as NOT_FOUND or INVALID_ARGUMENT.