curl --request POST \
--url https://api.avest.fr/v1/external-integration/agency/{agencyId}/shift-planning/{transaction} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"year": 2026,
"weekNumber": 37,
"shifts": [
{
"userId": "618a35a36d932054e195ca0b",
"day": "mon",
"time": "am"
},
{
"userId": "618a35a36d932054e195ca0c",
"day": "mon",
"time": "pm"
},
{
"userId": "618a35a36d932054e195ca0b",
"day": "tue",
"time": "all"
}
]
}
'{
"success": true,
"agencyId": "618a35a36d932054e195ca0a",
"transactionType": "sale",
"year": 2026,
"weekNumber": 37,
"dryRun": false,
"deletedCount": 2,
"createdCount": 3,
"warnings": []
}Alimenter le planning de permanence d'une semaine
Remplace le planning de permanence d’une semaine ISO pour une agence et un type de transaction. Le corps décrit l’état complet de la semaine : tout créneau absent de shifts est supprimé. Rejouer le même corps donne le même résultat.
L’écriture ne touche que la semaine visée : les autres semaines et les créneaux de semaine type ne sont jamais modifiés. L’appel est tout ou rien — en cas d’erreur, rien n’est écrit.
Garde-fous : une semaine vide exige allowEmpty: true ; dryRun: true valide et compte sans écrire ; une agence paramétrée en semaine type est refusée, car ses créneaux datés seraient ignorés par l’attribution.
Requiert l’autorisation en écriture sur le scope externalIntegration — un token en lecture seule reçoit 401.
curl --request POST \
--url https://api.avest.fr/v1/external-integration/agency/{agencyId}/shift-planning/{transaction} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"year": 2026,
"weekNumber": 37,
"shifts": [
{
"userId": "618a35a36d932054e195ca0b",
"day": "mon",
"time": "am"
},
{
"userId": "618a35a36d932054e195ca0c",
"day": "mon",
"time": "pm"
},
{
"userId": "618a35a36d932054e195ca0b",
"day": "tue",
"time": "all"
}
]
}
'{
"success": true,
"agencyId": "618a35a36d932054e195ca0a",
"transactionType": "sale",
"year": 2026,
"weekNumber": 37,
"dryRun": false,
"deletedCount": 2,
"createdCount": 3,
"warnings": []
}Autorisations
Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.
La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.
Paramètres de chemin
Corps
Réponse
Semaine remplacée (ou simulée si dryRun).