---
title: "Définir l'objectif de CA (surcharge le calcul auto)"
method: PUT
path: "/objective"
tags: ["Stats"]
---

# Définir l'objectif de CA (surcharge le calcul auto)

`PUT /objective`

## Request

- Base URL: `https://api.swipify.fr/api/v1`
- URL: `https://api.swipify.fr/api/v1/objective`
- Auth: API key in header `X-API-Key`

Définit l'objectif annuel manuel (surcharge le calcul automatique). `yearlyTarget` null revient au calcul auto. `year` optionnel (défaut = année en cours). Scope requis : `stats:write`.

## Request body

- ObjectiveSet
  - `yearlyTarget` number, nullable, required: null → revient au calcul automatique
  - `year` integer

## Response `200`

Objectif mis à jour

- Objective
  - `year` integer
  - `mode` 'auto' | 'manual'
  - `yearlyTarget` number, nullable

## Other responses

- `400`: Données invalides
- `401`: Échec d'authentification : clé API manquante (`missing_api_key`) ou invalide/révoquée/expirée (`invalid_api_key`). Le client doit présenter une clé valide.
- `403`: Clé authentifiée mais non autorisée : scope insuffisant pour cette route (`scope_required`), ou organisation sans abonnement Pro actif (`pro_required`). `GET /me` reste accessible sans Pro pour diagnostiquer la clé.

---

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