Update tag
Update a tag's name and/or color. Namespace is immutable.
Update a tag's name and/or color. Namespace is immutable.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
manage_tagstag_id*stringuuidapplication/json- body
Fields for updating a tag. Omitted fields are left unchanged; namespace cannot be changed.
name?stringNew label text, unique within the namespace.
1 <= length <= 50color?TagColorColor a tag is displayed with.
"red""orange""amber""yellow""lime""green""emerald""teal""cyan""sky""blue""violet"The request has succeeded.
application/json- response
A named, colored label attached to agents or resources, used to write policy
rules that match a class of entities instead of naming each one. A tag's
name must be unique within its namespace, and its namespace is fixed once
created.
id*uuiduuidnamespace*TagNamespaceWhich kind of entity a tag can be applied to. A tag belongs to exactly one namespace.
"agent""resource"name*stringLabel text, unique within the namespace.
1 <= length <= 50color*TagColorColor a tag is displayed with.
"red""orange""amber""yellow""lime""green""emerald""teal""cyan""sky""blue""violet"system*booleanBuilt-in and not editable. SecureAuth applies it from the catalog or MCP annotations; you can assign it to any tool.
description?stringWhat a built-in tag means. Only set on built-in tags.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X PATCH 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/tags/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "namespace": "agent", "name": "string", "color": "red", "system": true, "description": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}