Skip to content

/v1/labels/{id}/grape-varieties (PUT)

PUT
/v1/labels/{id}/grape-varieties
curl --request PUT \
--url https://example.com/v1/labels/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/grape-varieties \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[ { "grape_variety_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "grape_variety_synonym_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "percentage": 1 } ]'

Replace the label’s entire grape-varieties list. The body is the complete new list; rows not in the body are deleted. An empty array clears the list.

id
required
string format: uuid
Media typeapplication/json
Array<object>
<= 200 items
object
grape_variety_id
string | null format: uuid
grape_variety_synonym_id
string | null format: uuid
percentage
number | null
Examplegenerated
[
{
"grape_variety_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"grape_variety_synonym_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"percentage": 1
}
]

The label’s grape-varieties after replacement

Media typeapplication/json
object
items
required
Array<object>
<= 200 items
object
id
required
string format: uuid
grape_variety_id
required
string | null format: uuid
grape_variety_synonym_id
required
string | null format: uuid
percentage
required
number | null
Examplegenerated
{
"items": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"grape_variety_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"grape_variety_synonym_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"percentage": 1
}
]
}

Invalid body

Media typeapplication/problem+json
object
type
required
string
<= 2000 characters
title
required
string
<= 2000 characters
status
required
number
detail
string
<= 2000 characters
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Missing or invalid bearer token

Media typeapplication/problem+json
object
type
required
string
<= 2000 characters
title
required
string
<= 2000 characters
status
required
number
detail
string
<= 2000 characters
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Label not writable

Media typeapplication/problem+json
object
type
required
string
<= 2000 characters
title
required
string
<= 2000 characters
status
required
number
detail
string
<= 2000 characters
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Upstream error

Media typeapplication/problem+json
object
type
required
string
<= 2000 characters
title
required
string
<= 2000 characters
status
required
number
detail
string
<= 2000 characters
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}