Getting Started

Authentication

Secoda API's require an Authorization header with a Bearer token. You can generate an API key in your workspace, as outlined here.

Base URL and API Versioning

To determine the base URL of your API requests, please refer to the chart below. Note that endpoints may be available under different API versions (e.g., /api/v1/, /api/v2/). The version number in the path indicates the API version for that specific endpoint.

Workspace URL	Base URL	API Versions
app.secoda.co	api.secoda.co	/api/v1/, /api/v2/
eu.secoda.co	eapi.secoda.co	/api/v1/, /api/v2/
apac.secoda.co	aapi.secoda.co	/api/v1/, /api/v2/

For teams with an On Premise or Managed instance with a custom domain, the Base URL is the custom domain followed by the appropriate API version path (e.g., /api/v1/ or /api/v2/).