Key parameters
Example call - all possible standard parameters
This example is from the activities API. However, similar parameters can be used in most API calls.
| Parameter | Description | Examples | More Info |
|---|---|---|---|
| Action | Defines the API call. | action=update | Typically CRUD verbs |
| Authorization | OAuth 2.0 Bearer access token (HTTP header, not a query param) | Authorization: Bearer <access_token> | See Synergist API Authentication for how to obtain a token |
| Version number | API version | version=6 | Incremented for each new version of Synergist |
| Company | Synergist company | company=1 | |
| Activityid | ID of a specific record | activityid=4833 | Filters |
| View | ID for a pre-existing query (called a "view") | view=-1700 | Table of views |
| Collection | Data collection support | collection=<collection ID> /new | Advanced option |
| Type | The data area | type=activity | Which API to use |
| Page | Data page to return | page=1 | Page numbering starts at 0 |
| Rows | Number of records/rows to return. | rows=2 | 0 = return all rows |
| Style | Which kind of data is required | style=modelstructure / style=modeldata | Using models / Meta-data |
| Modelstructure | Defines the fields returned | Modelstructure=activitylist | Using models |
| Input | JSON array | see example | Passing data array to an API request |