API Access Tokens

Connecting to the API using an access token

URL

The API is hosted at https://app.marpledata.com/api/v1 on the Marple cloud, or .../api/v1 on your self-managed server. All API endpoints are relative to this URL. E.g. the /version endpoint should be called as https://app.marpledata.com/api/v1/version. Always make sure that you use https for secure communication.

Access Token

Authentication is done by passing an access token in the Authorization header in Bearer token format:

Authorization: Bearer <access-token>

Generate and manage your Marple API tokens in the Marple settings tab: Settings > Tokens. Create a new token with the desired expiry date and user role (editor/admin). Tokens are only ever shown once, so keep them secure after generation.

Access Token Tab in the Settings

These requests may be done in any language, but the easiest way to use the Marple API is through our Python SDK.

Administrator Privileges

Some endpoints require administrator privileges. Those will only be accessible by tokens with Admin role. Admin tokens can only be created by administrators of the workspace.

Changing the role of a user can be done in the 'Team' tab of the workspace settings.