> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arquos.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Retirer des photos en vrac d’un relevé

> Les photos encore à ranger, désignées par l’adresse de leur fichier (celle que rend la lecture des photos) : une fois rangées par ailleurs, l’original en vrac n’a plus lieu d’être. Une photo déjà rangée ne se retire pas ainsi. Rejoué, le geste répond pareil. Le relevé doit être en cours.

### Endpoint & Authentification

| Méthode | URL |
| :- | :- |
| `POST` | `https://api.arquos.eu/api/v2/surveys/{id}/photos/remove` |

**En-têtes (Headers) :**

* `Authorization: Bearer [VOTRE_JETON_D_API]`
* `X-Arquos-Agency: [IDENTIFIANT_D_AGENCE]` (facultatif, voir [Agence](/v2/agence))
* `Content-Type: application/json`

### Paramètres de la requête

<ParamField path="id" type="string" required>
  L’identifiant de l’objet.
</ParamField>

<ParamField header="X-Arquos-Agency" type="string">
  L’identifiant de l’agence où agir. Absent : l’agence par défaut du compte. Une agence hors de sa portée est refusée (403).
</ParamField>

<ParamField body="files" type="string[]" required>
  Les adresses des photos à retirer, 200 au plus.
</ParamField>

### Réponse (`201`)

<ResponseField name="ok" type="boolean">
  Toujours `true` : un refus rend un code d’erreur et sa raison.
</ResponseField>

### Les erreurs

| Code | Quand |
| :- | :- |
| `400` | Requête mal formée ou champ obligatoire manquant. |
| `401` | Jeton absent, inconnu ou révoqué. |
| `403` | Agence hors de votre portée. |
| `404` | Objet introuvable dans vos agences. |
| `422` | Saisie refusée par Arquos (champ obligatoire, valeur hors bornes, choix inconnu). |
| `429` | Trop d’appels : réessayez après le délai de l’en-tête Retry-After. |

Le corps d'une erreur porte `error`, sa raison en français. Voir [Les erreurs](/v2/erreurs).

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request POST \
  --url https://api.arquos.eu/api/v2/surveys/ID_DE_L_OBJET/photos/remove \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON' \
  --header 'Content-Type: application/json' \
  --data '{
  "files": [
    "texte"
  ]
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={"system"}
  {
  "ok": true
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.