SKILL.md
Sumsub — Manage Applicant Tags
Adds, replaces, and removes tags on an applicant profile, always followed by
a read-back. Tags are free-form labels used for filtering and classification
in the applicant list; they are also readable as applicant.tags in workflow
routing and TM rule expressions.
Endpoints
| Verb | Path | Purpose |
|---|---|---|
POST |
/resources/applicants/{applicantId}/tags/add |
Add tags on top of the existing set. Additive; repeat adds of an existing tag are deduped server-side. Body: bare JSON array of strings. |
POST |
/resources/applicants/{applicantId}/tags |
Overwrite — replaces the entire tag set with the body. [] clears all tags. Destructive: requires the confirm step below. |
DELETE |
/resources/applicants/{applicantId}/tags |
Remove only the tags listed in the body; the rest stay. |
GET |
/resources/applicants/{applicantId}/one |
Read-back. Tags come back in the tags field of the applicant — there is no dedicated tags GET. |
All writes return {"ok": 1} on success. Tag names not seen before are
auto-created on both the add and the overwrite endpoint (sandbox-verified;
the docs' claim that overwrite requires pre-existing tags is outdated).