---
title: "Retry Failed Batch Sessions"
method: POST
path: "/v1/batch-sessions/{batch_id}/retry"
tags: ["Batch Sessions"]
---

# Retry Failed Batch Sessions

`POST /v1/batch-sessions/{batch_id}/retry`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/batch-sessions/{batch_id}/retry`
- Auth: API key in header `anchor-api-key`

Retries failed sessions in a batch by creating new browser pods for each
failed session. The batch status will be set back to 'processing'.

## Path parameters

- `batch_id` string, uuid, required

## Request body

- BatchSessionRetryRequestSchema
  - `retry_failed_only` boolean: Whether to only retry failed sessions
  - `max_retries` integer: Maximum number of attempts per failed session. Each session is retried up to this many times, stopping on first success.

## Response `200`

Retry initiated successfully

- object
  - `data` BatchSessionRetryResponseSchema
    - `batch_id` string, uuid: Unique identifier for the batch
    - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled': Current status of the batch after retry
    - `retried_sessions` integer: Number of sessions that were retried
    - `message` string: Summary message

## Other responses

- `400`: No failed sessions to retry
- `401`: Invalid API Key
- `404`: Batch not found
- `500`: Internal server error

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/batch-sessions/:batch_id/retry/post.md)

---

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