Skip to main content
POST
/
v2
/
tags
/
add-to-subject
Add Tag To Subject
curl --request POST \
  --url https://public.api.serval.com/v2/tags/add-to-subject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subjectId": "<string>",
  "tagId": "<string>"
}
'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "color": "<string>",
      "iconSlug": "<string>",
      "teamId": "<string>",
      "description": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

---- Polymorphic tag attach ----

​
subjectType
enum<string>
required

TagSubjectType is the kind of entity a tag is attached to. Mirrors the DB tag_subject_type enum and keys the polymorphic tag-subject RPCs that replace the per-subject tag-attach RPCs.

Deliberately distinct from AccessRelationshipSubjectType: the two overlap but diverge (tags add workflow/guidance; owners add team) and back separate DB enums. Unifying them would trade enum type-safety for runtime subset validation.

Available options:
TAG_SUBJECT_TYPE_UNSPECIFIED,
TAG_SUBJECT_TYPE_WORKFLOW,
TAG_SUBJECT_TYPE_GUIDANCE,
TAG_SUBJECT_TYPE_APP_INSTANCE,
TAG_SUBJECT_TYPE_RESOURCE,
TAG_SUBJECT_TYPE_ENTITLEMENT
​
subjectId
string
required
​
tagId
string
required

Response

Success

​
data
Tag · object[]

The subject's resulting tag set.