# Start a deploy of the project from its source

`POST /api/projects/{name}/deploy` · Praecise Cloud · Projects

Start a deploy of the project from its source. Answers at once with a job; follow it at /api/projects/{name}/deploys/{id}. One deploy runs at a time.

- Scope: deploy
- Role: member

## Parameters

- `name` (path, required), string: The project's name.
- `Idempotency-Key` (header), string: Send the same key when retrying. Within 24 hours the first successful answer is returned again, with Idempotent-Replayed: true, instead of running twice.

## Responses

- `202`: The deploy has started.
- `400`: The request is not valid: a bad parameter, or a release that is not kept. Code bad_request or bad_release.
- `401`: No token, or the token is unknown, revoked or expired. Code unauthenticated, token_revoked or token_expired.
- `403`: The token lacks the scope, the call is not open to tokens, or the caller is not an owner. Code scope_missing, session_required or owner_required.
- `404`: No such project, or one the caller cannot see. The two are not told apart. Code not_found.
- `409`: A deploy is already running for the project, or the first request with this Idempotency-Key has not finished. Code deploy_running, no_source or request_in_progress.
- `422`: The Idempotency-Key was already used for a different request. Code idempotency_key_reused.
- `429`: Too many requests for this token. Retry-After says how many seconds to wait. Code rate_limited.

## Example

```sh
curl -X POST 'https://console.praecise.cloud/api/projects/{name}/deploy' \
  -H 'Authorization: Bearer $KEY'
```