Product / Developer toolkit / API
Semaphore API: automate CI/CD
Create and manage projects, secrets and workflows, and read pipeline results, from your own tools and integrations.
TL;DR
- REST API for projects, secrets, workflows, pipelines and jobs.
- Token authentication; use service accounts for automation.
- Build custom integrations and dashboards.
- The same data is available to agents through the MCP server.
What it does
- Create and manage resources such as projects and secrets. See the API reference.
- Custom integrations: start workflows, read results, feed dashboards.
- Build on Semaphore with service accounts instead of personal tokens.
- Coding agents can use the MCP server.
How it works
terminal
curl -H "Authorization: Token $SEMAPHORE_API_TOKEN" \
"https://my-org.semaphoreci.com/api/v1alpha/projects"Docs for this feature
FAQ
How do I authenticate?
With an API token in the Authorization header. For automation, create a service account and use its token.
What can I do with the API?
Manage projects, secrets and notifications, start and stop workflows, and read pipelines and jobs. See the API reference for every endpoint.
Is there an API for AI agents?
Yes. The MCP server exposes pipelines, logs and test results to coding agents.
Next steps
Read the API reference → · All Developer toolkit features → · Plans and pricing →
Get started
Tell your agent what you want.
It runs your CI.
$
curl -fsSL https://raw.githubusercontent.com/semaphoreio/sem-ai/main/install.sh | sh>
/plugin marketplace add semaphoreio/sem-ai>
/plugin install sem-ai@semaphoreio$
codex plugin marketplace add semaphoreio/sem-ai$
codex plugin add sem-ai@semaphoreioThen ask your agent to set things up — it connects to your org, and you start with $15 of free usage every month. No signup form.