Comment on page
Connecting to the API using an access token
The API is hosted at
https://app.marpledata.com/api/v1on the Marple cloud, or
.../api/v1on your self-managed server. All API endpoints are relative to this URL. E.g. the
/versionendpoint should be called as
https://app.marpledata.com/api/v1/version.Always make sure that you use https for secure communication.
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.
Some endpoints require administrator privileges. Admin authorization is associated with the account that generated the access token. Admin access can be granted by administrators of the workspace in the 'Team' tab of the workspace settings.