Error
A valid request URL is required to generate request examples{
"brandId": "brand-solya",
"supplierIds": [
"sup-cycling",
"sup-denim"
]
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Catalog
Replace a brand's supplier (fournisseur) set
REPLACES the whole set of suppliers linked to a brand (add/remove is expressed as the new set, so a save is idempotent). The brand id rides the PATH, the supplier ids the body; a repeated id is deduplicated. An empty array clears every link. Every id must resolve to an existing supplier: an unknown one is a 422 naming it, and nothing is written. 404s for an unknown brand; 400s on a missing supplierIds.
PUT
/
v1
/
brands
/
{brandId}
/
suppliers
Error
A valid request URL is required to generate request examples{
"brandId": "brand-solya",
"supplierIds": [
"sup-cycling",
"sup-denim"
]
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Path Parameters
The brand id (a slug derived from the code, e.g. brand-nike).
Minimum string length:
1Body
application/json
The deduplicated supplier (fournisseur) ids the brand is sold by; empty clears every link.
Minimum string length:
1