---
title: "Reschedule person tracker list refresh"
method: POST
path: "/v1/tracker/person-lists/{listId}/reschedule"
tags: ["Tracker"]
---

# Reschedule person tracker list refresh

`POST /v1/tracker/person-lists/{listId}/reschedule`

## Request

- Base URL: `https://api.fiber.ai`
- URL: `https://api.fiber.ai/v1/tracker/person-lists/{listId}/reschedule`
- Auth: none declared

Move this list's next scheduled refresh to a chosen date (UTC) — later (for example to skip a cycle or align with a billing period) or earlier, as long as the date is tomorrow or later. The refresh runs on the chosen date and checks all tracked people in the list, with credits charged per entity as usual. Future refreshes continue at the list's regular interval, counted from the rescheduled run. Changing the list's refresh interval later resets the schedule from that moment. To refresh a list immediately, use the refresh endpoint instead.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Path parameters

- `listId` string, required

## Request body

- object
  - `apiKey` string, required: Your Fiber API key
  - `nextRefreshDate` string, required: The date (YYYY-MM-DD, UTC) on which the next scheduled refresh should run. Must be tomorrow (UTC) or later, and at most 90 days ahead. To refresh a list immediately, use the refresh endpoint instead. Subsequent refreshes continue at the list's regular interval, counted from this run.

## Response `200`

Default Response

- object
  - `output` object, required
    - `previousNextRefreshAt` string, nullable: When the next refresh was scheduled before this call. Null if the list had no refresh scheduled yet.
    - `newNextRefreshAt` string, required: When the next refresh is now scheduled to run.
    - `message` string, required: Human-readable confirmation of the new schedule.
  - `chargeInfo` union, required
    - object: Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
    - object: Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable: Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required: URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required: Human-readable credits warning.
        - `availableCredits` number, required: Number of credits remaining in the current billing period.
  - `warnings` object[], nullable: Warnings about extraneous fields in request
    - `field` string, required: Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required: Warning message
  - `advice` string[], nullable: Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400`: Default Response
- `401`: Default Response
- `402`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response
- `429`: Default Response
- `500`: Default Response
- `503`: Default Response

## Changes

- **2026-10-07** `7f6ae6cff8b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fiber/apis/fiber-ai-api/changes/v1/tracker/person-lists/:listId/reschedule/post.md)

---

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