Semaphore API

REST discovered

Details

URL: https://<organization-url>.semaphoreci.com/api/v1alpha
Docs: https://docs.semaphore.io/reference/api

Authentication

Semaphore API token Authorization: Token <credential> + Semaphore service account API token Authorization: Token <credential> discovered

Semaphore API token bearer Get token ↗

Get your token from your Semaphore account profile. In the web app, open your user menu, choose Profile settings, and under API Token use Reset API Token to mint a new one, or visit your Semaphore account page. The same token is used for the REST API, sem, sem-ai, and MCP token auth.

Semaphore service account API token bearer Get token ↗

Service accounts must be enabled for your organization; request access via Service Accounts. Then in Semaphore open the organization People page, choose Create Service Account, assign a role, create it, and copy the token when shown. Service account tokens can only be viewed once and are used the same way as user API tokens.