# POST /api/v1/project/:username/:repo/:build_num/retry is deprecated

Calls to POST /api/v1/project/:username/:repo/:build_num/retry on CircleCI API stop working on February 1, 2027.

On February 1, 2027, the endpoint POST /api/v1/project/:username/:repo/:build_num/retry will be removed. Calls made to this endpoint after that date will fail.

- API: CircleCI API (circleci.com)
- Kind: Endpoint removal
- Announced: October 7, 2026
- Takes effect: February 1, 2027
- Calls after that day: fail
- Calls it hits: `POST /api/v1/project/:username/:repo/:build_num/retry`
- Source: [Changelog](https://circleci.com/changelog/)
- Page: https://www.okapi.bot/providers/circleci-api/breaking-changes/post-api-v1-project-username-repo-build-num-retry-is-deprecated/

## What to use instead

To rerun, use POST /api/v3/workflows/:id/rerun (API v3) or POST /api/v2/workflow/:workflow-id/rerun (API v2).

## CircleCI API's words

> POST /api/v1/project/:username/:repo/:build_num/retry