Passer au contenu

Limited
Share finished product chapter (library)

Requête

Grants access to this finished product chapter.

Always grants access to the company that owns the chapter, taken from the chapter itself, never from the caller. A library chapter created through this API is visible to nobody until it is shared, so this is how its owner first sees it.

List companyIds to grant access to other companies as well, typically a retailer. No body and an empty list both grant the owner only.

Idempotent: a company that already has access is left as it is.

Sécurité
oauth2(Portées requises: t1_api)
Chemin
chapterIdstring, (uuid)obligatoire

The unique identifier of the library chapter

Corpsapplication/json
companyIdsArray of strings, (uuid)

Companies to grant access to IN ADDITION to the owner company, which every share grants. Absent or empty = the owner only. All of them are granted or none is: an unknown id is refused naming the field, and nothing is written before the refusal.

curl -i -X POST \
  'https://apis.traceone.com/spec/v2/library/food/finished-product-chapters/{chapterId}/share' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "companyIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }'

Réponses

The chapter was shared

Réponse
Aucun contenu