# sumsub-manage-applicant-tags

This skill edits Sumsub applicant tags through the public API. Use it to add labels, replace the full set, remove selected tags, and verify the result.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 634 installs · ★ 7
- Author: sumsub
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-applicant-tags/SKILL.md
- Updated: 2026-10-02
- HTML: https://affpapa.org/en/nevibecode/skills/sumsub-manage-applicant-tags

## What it does

The skill manages tags on a Sumsub applicant profile. It can append labels to the existing set, replace every tag, or remove only the selected ones. Each write is followed by `GET /resources/applicants/{applicantId}/one`, which is the endpoint used to confirm the resulting profile.

It runs the operations through `scripts/manage_applicant_tags.sh` with `list`, `add`, `overwrite`, and `remove` modes. Setup requires the sandbox values `SUMSUB_APP_TOKEN` and `SUMSUB_SECRET_KEY`; the token must begin with `sbx:`. Replacing tags, including clearing them with an empty set, requires confirmation first.

The per-applicant limit is 30 tags, and tag names are case-sensitive. Going over the limit returns HTTP 400 and leaves the request unapplied, so the skill must not trim tags and retry. Production App Tokens are not accepted.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-applicant-tags -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumsub-manage-applicant-tags/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumsub-manage-applicant-tags/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-applicant-tags -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumsub-manage-applicant-tags/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-applicant-tags -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumsub-manage-applicant-tags/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills sumsub-manage-applicant-tags
```

2. **Manually: put the files in place**
- File: `.github/skills/sumsub-manage-applicant-tags/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-applicant-tags -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-manage-applicant-tags
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumsub-manage-applicant-tags/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-applicant-tags -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-applicant-tags/SKILL.md

## When to use it
- add labels to a Sumsub applicant profile
- replace an applicant’s complete tag set
- remove selected applicant tags
- verify tag changes through the API

## Example prompts
- Add `VIP` and `High Risk` to applicant `<applicantId>`.
- Remove `Legacy KYC` from applicant `<applicantId>`, then verify the profile.
- Show the current tags for `<applicantId>` and replace them with `Compliance Reviewed` after I confirm.

## Similar
- [Applicant Screening](https://affpapa.org/en/nevibecode/skills/applicant-screening.md) — skill · 4600 installs
- [rivet-secure-exec](https://affpapa.org/en/nevibecode/skills/rivet-secure-exec.md) — skill · 945 installs
- [generate-sandbox-policy](https://affpapa.org/en/nevibecode/skills/generate-sandbox-policy.md) — skill · 470 installs
- [deno-sandbox](https://affpapa.org/en/nevibecode/skills/deno-sandbox.md) — skill · 358 installs
- [meta-tags-optimizer](https://affpapa.org/en/nevibecode/skills/meta-tags-optimizer.md) — skill · 5000 installs
- [planetscale-query-insights-and-tags](https://affpapa.org/en/nevibecode/skills/planetscale-query-insights-and-tags.md) — skill · 1800 installs

From the same set: [sumsub/agent-skills](https://affpapa.org/en/nevibecode/by/sumsub/agent-skills.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md