Set Sandbox Tags
Tags
Set Sandbox Tags
PUT
Set Sandbox Tags
Replace the full tag set for a sandbox. Partial updates are not
supported — GET, modify, PUT.
{} clears all tags.
Preview: Usage and tag APIs are new. Endpoints, response fields,
and SDK method names may change before GA; temporary inaccuracies or
rough edges are possible while the surface settles.
string
required
Sandbox ID.
string
Each top-level key in the body is a tag name; the value is a
string. Flat map only — nested objects are rejected.
Validation
- At most 50 tag keys per sandbox.
- Keys: 1–128 characters,
A–Z a–z 0–9 _ . - :.:is allowed as a user namespace separator. - Values: 0–256 UTF-8 characters.
- The
oc:key prefix is reserved for future system-set tags.
Retagging rewrites attribution going forward: a sandbox re-tagged
from
team=payments to team=growth will appear under growth in
every subsequent /usage query, including for time before the retag.
Surface tagsLastUpdatedAt alongside usage in dashboards so readers
can see when tags changed.