Team / Tags /

Put tag

Update or create a resource tag.

Required permission

Account > Platform > Tags > Update

Path parameters

resourceTagId
string required
ID of the tag

Request body

{object}

useAsInfrastructureLabel
boolean
Expose this tag as an infrastructure label on service and job workloads after their next deployment. Required for usage in egress IP selectors.
useSpotNodes
boolean
Schedule workloads to spot nodes
useOnDemandNodes
boolean
Also 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
boolean
weight
number
The node affinity weight. Required when `preference` is `true`.
min
1
max
100
matchExpressions
[array] required

{object}

key
string required
operator
string required
one of
In, NotIn
values
[array] required

string

sandboxing
{object}

builds
{object}
Build sandboxing runtime configurations

enabled
boolean required
Enables runtime scheduling constraints for builds
runtimeClass
(multiple options: oneOf)

string

Defines which runtime scheduling constraints apply for builds

one of

none, gvisor, kata-clh, kata-qemu

services
{object}
Service sandboxing runtime configurations

enabled
boolean required
Enables runtime scheduling constraints for services
runtimeClass
(multiple options: oneOf)

string

Defines which runtime scheduling constraints apply for services

one of

none, gvisor, kata-clh, kata-qemu

addons
{object}
Addon sandboxing runtime configurations

enabled
boolean required
Enables runtime scheduling constraints for addons
runtimeClass
(multiple options: oneOf)

string

Defines which runtime scheduling constraints apply for addons

one of

none, gvisor, kata-clh, kata-qemu

jobs
{object}
Job secure runtime configurations

enabled
boolean required
Enables runtime scheduling constraints for jobs
runtimeClass
(multiple options: oneOf)

string

Defines which runtime scheduling constraints apply for jobs

one of

none, gvisor, kata-clh, kata-qemu

color
string
pattern
^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$
description
string
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
name
string required
min length
3
max length
100
pattern
^[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*$

Response body

{object}
Response object.

data
{object} required
Result data.

API

CLI

JS Client

PUT /v1/tags

PUT /v1/teams/{teamId}/tags

Example request

Request body

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request PUT \
  --data '{"useAsInfrastructureLabel":false,"useSpotNodes":false,"useOnDemandNodes":false,"sandboxing":{"builds":{"enabled":false,"runtimeClass":"gvisor"},"services":{"enabled":false,"runtimeClass":"gvisor"},"addons":{"enabled":false,"runtimeClass":"gvisor"},"jobs":{"enabled":false,"runtimeClass":"gvisor"}},"color":"#57637A","name":"Example Tag"}' \
  https://api.northflank.com/v1/tags

Example response

200 OK

The operation was performed successfully.

JSON

{
  "data": {}
}