Tag reference

Tags let you label publications, screener sessions, and other resources with reusable metadata. Each tag follows a small schema so you can consistently filter or aggregate results in your own systems.

The tag schema

Name
_type
Type
string
Description
Always Tag. Use this to distinguish tags from other nested objects.
Name
id
Type
string
Description
Unique identifier for the tag.
Name
category
Type
string | null
Description
Optional grouping field that lets you cluster related tags.
Name
value
Type
string
Description
Human readable tag label.

Example

{
  "_type": "Tag",
  "id": "tag_priority",
  "category": "recruiting",
  "value": "priority"
}

Tag usage

Screeners & publications – Tags are defined on publications so sessions inherit them for analytics.
Screener sessions – Sessions expose an assignedTags array so downstream automations can slice progress reports.
Custom workflows – Because tags are part of API responses, you can mirror them in your CRM or use them as routing hints inside automation tools.

Refer to this schema whenever you need to persist or transform tag data outside Spot Thought.