Skip to main content
POST
Create a tag

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer , where is your auth token.

Headers

teal-instance-id
string
required

The teal instance ID

modified-by
string | null

An optional identifier for audit logging.

Body

application/json
name
string
required

An arbitrary string, useful for identifying the tag to the user.

Example:

"Sprinter - 1ab-c23"

tag_group_id
string
required

The ID of the tag group.

Example:

"NCB2xo5S1yQbNgyWskXpwG"

Response

Successful Response

id
string
required

The unique ID of the object.

Example:

"UjL3BQnEaJtecuC7CUeDk"

name
string
required

An arbitrary string, useful for identifying the tag to the user.

Example:

"Sprinter - 1ab-c23"

tag_group_id
string
required

The ID of the tag group.

Example:

"NCB2xo5S1yQbNgyWskXpwG"