Skip to content
Back to skills

Didit Users Lists

ASecurity

Manages Didit lists, the blocklist and allowlists. Use when the user says "blocklist", "block this face, document, phone or email", "unblock", "allowlist", "trust this phone number", "custom list", "add an entry", "remove from the list", "add a face from a photo", or "delete a list" in their Didit account.

  • 28 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsrustgonodeapi

Works with

  • api

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add didit-protocol/skills --skill didit-users-lists --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Didit Users Lists?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Didit Users Lists
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/didit-protocol-didit-users-lists/badge)](https://www.skillsdirectory.com/skills/didit-protocol-didit-users-lists)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: didit-users-lists
description: Manages Didit lists, the blocklist and allowlists. Use when the user says "blocklist", "block this face, document, phone or email", "unblock", "allowlist", "trust this phone number", "custom list", "add an entry", "remove from the list", "add a face from a photo", or "delete a list" in their Didit account.
---

# Lists, blocklist and allowlist

Follow the rules of didit-users-start first: call `didit_context_get` and pick the application. Lists belong to one application.

## 1. Read lists

- `didit_lists_list` lists the application's lists. Filters: `list_type` (`blocklist`, `allowlist`, `custom`), `entry_type`, `limit`, `offset`.
- `didit_lists_get` with `list_uuid` returns one list.
- `didit_lists_entries_list` with `list_uuid` lists its entries. Filters: `search` (value or label), `reference_session_id` (only entries created from that session), `limit`, `offset`.

Entry types: `face`, `document`, `phone`, `email`, `ip_address`, `device_fingerprint`, `wallet_address`, `bank_account`, `user`, `business`, `country`, `key`.

## 2. Create, rename or delete a list

- `didit_lists_create`: `name` (unique in the application), `list_type` (`allowlist` or `custom`), `entry_type`, optional `description`. System blocklists exist already, one per entry type, and cannot be created.
- `didit_lists_update`: `list_uuid` plus a new `name` and/or `description`. System blocklists cannot be changed.
- `didit_lists_delete`: `list_uuid`. It deletes the list and all its entries; system blocklists cannot be deleted. Say how many entries it holds and wait for the person to confirm.

Show the name, type and entry type and wait for a yes before creating or renaming.

## 3. Add and remove entries

- `didit_lists_entry_create`: `list_uuid`, then either `value` (for example a phone, email or IP) or `reference_session_id` to take the value from a session. Optional: `reference_object_uuid`, `display_label`, `comment`, `metadata`. Only for a face blocklist entry taken from a session (`reference_session_id`), `face_image_source` picks which face (`liveness` by default, or `front_image_camera_front` / `back_image_camera_front`), and `reference_node_id` picks the ID verification step when there are several.
- `didit_lists_entry_upload_face`: `list_uuid` of a face list plus the image as `image_base64` (or an attachment reference) on the hosted server. Use it only with real image bytes the person attached; never ask them to paste base64 text.
- `didit_lists_entry_delete`: `list_uuid` and `entry_uuid`. It also unblocks the underlying user or business when that applies. Show the entry and wait for the person to confirm.

Show the list and the value or session before adding an entry and wait for a yes.

## 4. Blocklist from a session

- `didit_blocklist_get` lists what is blocked (faces, documents, phones, emails), newest first, each with the `session_id` it came from. Filter `item_type`; page with `limit` and `offset`.
- `didit_blocklist_add`: `session_id` and at least one of `blocklist_face`, `blocklist_document`, `blocklist_phone`, `blocklist_email` set to true. A flag works only if the session holds that item. Later sessions of the application with the same item are caught.
- `didit_blocklist_remove`: the `session_id` of the blocklist entry and at least one of `unblock_face`, `unblock_document`, `unblock_phone`, `unblock_email`. Name what will be unblocked and wait for the person to confirm.

## 5. Allowlist a phone

`didit_allowlist_add`: `session_id` and `allowlist_phone: true`. It marks that session's phone number as trusted so phone verification does not turn it away as high risk. A phone number is the only thing that can be allowlisted, and a blocked number stays blocked. Wait for a yes before calling.

## What good output looks like

- Lists as a table: name, type, entry type, number of entries when shown.
- For a block: the session, and exactly which items (face, document, phone, email) are blocked or unblocked.
- A clear question before every deletion, removal or unblock.

## Do not

- Never ask for credentials (password, API key, one-time code).
- Never fall back to raw HTTP calls (curl/REST) for a console task.
- Never try to create, rename or delete a system blocklist.
- Never invent list ids, entry ids or session ids.
- Never state prices. Link https://didit.me/pricing.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.