API Access Tokens
Connecting to the API using an access token
Last updated
Connecting to the API using an access token
Last updated
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.
Authentication is done by passing an access token in the Authorization header in Bearer token format:
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.
These requests may be done in any language, but the easiest way to use the Marple API is through our Python SDK.
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.
