Tags /
Add tag
Required permission
Account > Tags > General > Create
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.
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]+)*$id
string requiredmin length3max length100pattern^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$createdAt
stringtime of creation
POST /v1/tags
Example request
curl --header "Content-Type: application/json" \
--header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
--request POST \
--data '{"useSpotNodes":false,"useOnDemandNodes":false,"color":"#57637A","name":"Example Tag"}' \
https://api.northflank.com/v1/tags
Example response
200 OK
JSON
{
"data": {
"useSpotNodes": false,
"useOnDemandNodes": false,
"color": "#57637A",
"name": "Example Tag",
"id": "example-tag",
"createdAt": "2000-01-01T12:00:00.000Z"
}
}