---
title: "Restarts the given rapids of a job."
method: POST
path: "/job/{jobId}/rapids/restart"
tags: ["Job"]
---

# Restarts the given rapids of a job.

`POST /job/{jobId}/rapids/restart`

## Request

- Base URL: `https://api.rapidata.ai`
- URL: `https://api.rapidata.ai/job/{jobId}/rapids/restart`
- Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `openid`, `profile`, `email`, `offline_access`, `api`)

The old rapids are rejected (their billed responses refunded) and soft-deleted, then cloned
 into a new target group. Results regenerate automatically once the replacements finish
 collecting; the job dips below 100% progress during re-collection and climbs back. Idempotent
 per original rapid — a repeated call reuses the existing replacement.

## Path parameters

- `jobId` string, required

## Request body

- RestartRapidsEndpointInput: The input for the restart rapids endpoint.
  - `rapidIds` string[], required: The ids of the rapids to restart.

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Forbidden

## Changes

- **2026-09-04** `9da534659e5f`: 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`

[Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/job/:jobId/rapids/restart/post.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/004a977d7d9f?raw)