Analytics REST API Developer Guide
jNewer Version Available
Analytics REST API Resources Overview
The Analytics REST API provides resources so you can access your Analytics
data.
All Analytics REST API resources are accessed using:
- A base URL for your company (for example, https://yourInstance.salesforce.com)
- Version information (for example, /services/data/v42.0)
- A named resource (for example, /wave)
1https://yourInstance.salesforce.com/services/data/v42.0/waveOrg and Object Identifiers
Id fields in Salesforce, and in the Analytics UI, are typically 15-character, base-62, case-sensitive strings. This is true of JSON XMD too. However, many Salesforce APIs, including the Analytics REST API, use 18-character, case-insensitive strings—for example, the Id property of the Dataset resource/wave/datasets/<dataset ID>. The last three digits are a checksum of the preceding 15 characters. The use of case-insensitive Id’s eases interaction with external applications and development environments that use case-insensitive references. To convert an 18-character Id back to a 15-character ID, simply remove the last three characters.
| Resource | Description | Supported HTTP Method | Resource URL |
|---|---|---|---|
| Wave Resource | Lists the top-level resources available for Analytics. | GET | /wave |
| Query Resource | Executes a query written in Salesforce Analytics Query Language (SAQL). | POST | /wave/query |
| Datasets List Resource | Returns a list of Analytics datasets. | GET | /wave/datasets |
| Dataset Resource | Returns, deletes, or updates a dataset with the specified ID or API name. | GET, DELETE, PATCH | /wave/datasets/<dataset ID> |
| Dataset Versions List Resource | Returns a list of dataset versions for a particular dataset or creates a version. | GET | /wave/datasets/<dataset ID>/versions |
| Dataset Version Resource | Returns an Analytics dataset version or updates the version predicate. | GET, PATCH | /wave/datasets/<dataset ID>/versions/<version ID> |
| Dataset Version File Resource | Provides access to the binary content of the dataset version file. | GET | /wave/datasets/<dataset ID>/versions/<version ID> /files/<file ID> |
| XMD List Resource | Returns a list of XMD resources for a version of a dataset. This list is for main, system, and user XMD types. To view asset type XMDs, refer to the Asset XMD API resource. | GET | /wave/datasets/<dataset ID>/versions/<version ID>/xmds |
| XMD Resource | Returns the extended metadata (XMD) for a version of a dataset and updates the user XMD file. | GET, PUT | /wave/datasets/<dataset ID>/versions/<version ID>/xmds/<XMD type> |
| Lenses List Resource | Returns a list of Analytics lenses or creates a lens. | GET, POST | /wave/lenses |
| Lens Resource | Returns, deletes, or updates the lens with the specified ID or API name. | GET, DELETE, POST | /wave/lenses/<lens ID> |
| Lens File Resource | Returns or updates a file that is part of an Analytics lens. | GET, PUT | /wave/lenses/<lenses ID>/files/<files ID> |
| Dashboards List Resource | Returns a list of Analytics dashboards or creates a dashboard. | GET, POST | /wave/dashboards |
| Dashboard Resource | Returns, deletes, or updates the dashboard with the specified ID or API name. | GET, DELETE, PATCH | /wave/dashboards/<dashboard ID> |
| Dashboard Saved Views Resources | Work with saved views. | GET DELETE PATCH POST |
|
| Dependencies Resource | Returns the dependencies for an asset. | GET | /wave/dependencies/<folder ID> |
| Folder Resource | Work with folders. | GET, PUT, PATCH, DELETE |
|
| Replicated Dataset Resource | Returns, updates, and deletes replicated datasets, also know as connected objects. A data sync loads source object data as a connected object in Analytics. Connected objects can’t be visualized directly, but are used like a cache to speed up other jobs that pull from the source object and load it into a dataset. | GET, PATCH, DELETE | /wave/replicatedDatasets/<ID> |
| Replicated Datasets List Resource | Returns a list of replicated datasets, also know as connected objects. | GET, POST | wave/replicatedDatasets |
| Replicated Dataset Fields Resource | Returns a list of fields for the specified connected object. | GET, PATCH | /wave/replicatedDatasets/<ID>/fields |
| Templates List Resource | Returns a list of Analytics templates, or creates a template. | GET | /wave/templates |
| Template Resource | Returns a list of Analytics templates, or creates a template. | GET | /wave/templates/<templateIdOrApiName> |
| Template Configuration Resource | Returns the configuration of an Analytics template. | GET | /wave/templates/<templateIdOrApiName>/configuration |
| Trended Reports List Resource | Returns a list of trending reports or creates a trending report. | GET, POST | /wave/trendedreports |
| Trended Reports Resource | Returns, deletes, or updates a trending report. | DELETE, GET, PATCH | /wave/trendedreports/<Id> |
| Lens File Metadata Resource | Returns or creates the lens file metadata with the specified ID or API name. | GET, POST | /wave/lenses/<lensId>/files |
| Features Configuration Resource | The Analytics features that are available to a user. | GET | /wave/config/features |
| Annotations List Resource | Returns a list of annotations. | GET, POST | /wave/annotations |
| Annotations Resource | An asset's annotations. | GET, PATCH | /wave/annotations/<Annotation ID> |
| Template Release Notes Resource | Returns the release notes for a single Analytics Template. | GET | /wave/templates/<templateIdOrApiName>/releasenotes |
| Charts Maps List Resource | Returns a list of maps or creates a map. | GET POST | /eclair/maps |
| Charts Maps Resource | Returns, updates, or deletes a specific map. | DELETE GET PATCH | /eclair/maps/<id> |
| Charts Geodata Resource | Returns a geodata definition, updates, or delete a geodata definition. | DELETE GET PATCH | /eclair/geodata/<id> |
| Charts Geodata List Resource | Returns a collection of geodata definitions and creates a geodata definition. | GET POST | /eclair/geodata |
| Charts Geodata File List Resource | Return the binary file associated with a geodata definition. | GET | /eclair/geodata/<id>/file |
| Data Connector Resources | Work with data connectors. | GET DELETE PATCH POST |
|
| Recipe Resources | Retrieve or update recipes. | GET DELETE PATCH |
|
| Dataflows Resources | Work with dataflows. | GET POST PATCH |
|
| Dataflow Jobs Resources | Work with dataflow jobs. | GET POST PATCH |
|
| Security Resources | Discover whether objects and particular dataset versions have support for sharing inheritance. | GET |
|
Filtering REST Responses
Returns, deletes, updates, or replaces an Analytics application or
folder with the specified ID.
In addition to Analytics REST API input parameters, you can use the following Chatter REST API input parameters to filter the results returned from a request: filterGroup, external, and internal. For more information, see Specifying Response Sizes in the Chatter REST API Developer Guide.