REST API

The REST API lets you script the platform — list projects, inspect deployments and trigger new ones from CI or your own tools.

Authentication

Create a token in Dashboard → API Tokens. Send it as a Bearer token on every request. Treat tokens like passwords — they act with your account's permissions.

curl https://darmicloud.tech/api/v1/projects \
  -H "Authorization: Bearer <your-token>"

Endpoints

GET /api/v1/projects — list your projects.

GET /api/v1/projects/{projectId}/deployments — list a project's deployments.

POST /api/v1/projects/{projectId}/deployments — trigger a new deployment of the project's branch.

curl -X POST \
  https://darmicloud.tech/api/v1/projects/<projectId>/deployments \
  -H "Authorization: Bearer <your-token>"

Deploy hooks vs API

For the single 'just deploy on ping' use case, a deploy hook (Project → Settings) is simpler: one secret URL, no token header. Use the API when you need to list or inspect resources programmatically.

Ready to try it?

Deploy your first app free — no credit card required.

Start deploying