---
title: "Modifie la programmation du scan hebdomadaire. Champs optionnels : trigger_day (lundi…dimanche), trigger_hour (HH:MM), timezone (IANA), grid_size (3|5|7), grid_step_km (> 0, ≤ 10). Renvoie la programmation et `next_scan_window`."
method: PATCH
path: "/v1/listings/{id}/ranking-schedule"
tags: ["Fiches (listings)"]
---

# Modifie la programmation du scan hebdomadaire. Champs optionnels : trigger_day (lundi…dimanche), trigger_hour (HH:MM), timezone (IANA), grid_size (3|5|7), grid_step_km (> 0, ≤ 10). Renvoie la programmation et \`next_scan_window\`.

`PATCH /v1/listings/{id}/ranking-schedule`

## Request

- Base URL: `https://app.localnord.io/api`
- URL: `https://app.localnord.io/api/v1/listings/{id}/ranking-schedule`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object

## Response `200`

OK

- object
  - `data` unknown
  - `pagination` object
  - `meta` object

## Other responses

- `400`: Requête invalide (`invalid_body`, `invalid_query`)
- `401`: Clé API invalide
- `402`: Crédits insuffisants (`insufficient_credits`, avec `required` et `balance`)
- `404`: Ressource introuvable (`place_not_found`, fiche ou scan inconnu)
- `409`: Conflit d'état (déjà publié, déjà répondu, mauvais statut) ou `Idempotency-Key` réutilisée avec un autre corps (`idempotency_key_reused`) / requête encore en cours (`idempotency_in_flight`)
- `429`: Rate limit (headers X-RateLimit-*, Retry-After)
- `503`: Fournisseur de données indisponible (`upstream_unavailable`)

---

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