Get a tool tag
Resolve one tool tag ID to its type and label.
One tag by ID. Useful when you have stored an ID and want its current label without fetching the whole vocabulary; for anything more than a handful of lookups, list them once and cache instead.
GET
https://api2.rundiffusion.com/api/v2/tool-tags/{tool_tag_id}AcceptsOAuth device flowPersonal API Access TokenCompany API Access Token
Request
Headers
AuthorizationstringRequired- Bearer token. This endpoint accepts an OAuth device flow token, a Personal API Access Token, or a Company API Access Token. See Authentication.
Authorization: Bearer eyJhbGciOi…
Path
tool_tag_idstringRequired- A tool tag ID, as it appears in a tool's tool_tags array.
https://api2.rundiffusion.com/api/v2/tool-tags/9QmTz4…
curl https://api2.rundiffusion.com/api/v2/tool-tags/9QmTz4… \
-H "Authorization: Bearer $RUNDIFFUSION_TOKEN"const tag = await fetch(
'https://api2.rundiffusion.com/api/v2/tool-tags/9QmTz4…',
{ headers: { Authorization: `Bearer ${process.env.RUNDIFFUSION_TOKEN}` } },
).then(r => r.json());tag = requests.get(
"https://api2.rundiffusion.com/api/v2/tool-tags/9QmTz4…",
headers={"Authorization": f"Bearer {os.environ['RUNDIFFUSION_TOKEN']}"},
).json()Response
200 OK with the tool tag, in the same shape it takes inside a tool's
tool_tags array.
{
"id": "9QmTz4…",
"type": "MEDIA",
"label": "Video"
}idstring- The tool tag ID you requested.
typestring | null- Which taxonomy the tool tag belongs to, for example MEDIA or MODEL_FAMILY.
labelstring | null- The human-readable name. Display this, never the id.
Errors
401UNAUTHENTICATED- Missing, malformed, or expired token.
404TAG_NOT_FOUND- No visible tag with that ID. Also returned for a tag that exists but is deleted or internal: distinguishing those would disclose the tags the API withholds.
429RATE_LIMITED- Too many requests. Back off and retry per the Retry-After header. See Rate limits.
See Errors for the full envelope and the code list.