Tags /
Put tag
Update or create a resource tag.
Required permission
Account > Tags > General > Update
Path parameters
resourceTagId
string requiredID of the tag
Request body
- {object}
useSpotNodes
booleanSchedule workloads to spot nodes
useOnDemandNodes
booleanAlso allow workloads to schedule to on demand nodes. Only relevant if you want workloads to schedule across both spot and on demand nodes
nodeAffinities
[array]- {object}
preference
booleanweight
numberThe node affinity weight. Required when
preference
istrue
.min1max100matchExpressions
[array] required- {object}
key
string requiredoperator
string requiredone ofIn, NotInvalues
[array] required- string
color
stringpattern^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$description
stringmax length200pattern^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$name
string requiredmin length3max length100pattern^[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*$
Response body
- {object}
Response object.
data
{object} requiredResult data.
API
CLI
JS Client
PUT /v1/tags
Example request
Request body
curl
curl --header "Content-Type: application/json" \
--header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
--request PUT \
--data '{"useSpotNodes":false,"useOnDemandNodes":false,"color":"#57637A","name":"Example Tag"}' \
https://api.northflank.com/v1/tags
Example response
200 OK
The operation was performed successfully.
JSON
{
"data": {}
}