skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
sumsub/agent-skills1.4k installs

sumsub-check-permissions

Fetch the current tenant's allowed entitlements (BackgroundCheckTarget list). Returns JSON `{"allowedChecks":{key:label}}` — a map whose keys are the enabled entitlement keys. Called by sumsub-create-level (and other create-* skills) before building a payload to gate entitlement-required features.

How do I install this agent skill?

npx skills add https://github.com/sumsub/agent-skills --skill sumsub-check-permissions
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill securely retrieves account entitlement information from the Sumsub API to gate features. It correctly handles authentication via environment variables, implements HMAC request signing, and includes a safeguard to prevent the accidental use of production credentials in a development environment.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Check Permissions

Returns the tenant's allowed entitlements so callers can gate features before making any API writes.

Auth — App Token + secret (sandbox only)

This skill talks to the public Sumsub API and signs each request per the authentication reference. The full how-it-works writeup lives in the sumsub-api-auth skill — read it if you hit 401 Invalid signature.

⚠️ Sandbox tokens only. Do not accept or use a production App Token here. If the user offers one, refuse and ask them to generate a sandbox pair at https://cockpit.sumsub.com/checkus/devSpace/appTokens (toggle the workspace to Sandbox first, then Create). Token + secret are shown once — copy both before closing the dialog. The helper script enforces this — it rejects tokens that don't start with sbx:.

VarExample
SUMSUB_APP_TOKENsbx:... — sandbox App Token from the dashboard.
SUMSUB_SECRET_KEYThe paired secret shown once at token creation.
SUMSUB_BASEOptional. Defaults to https://api.sumsub.com.

Usage

Run the script and parse the result:

bash ${CLAUDE_SKILL_DIR}/scripts/check_permissions.sh

Output: raw Sumsub response body followed by HTTP <code>.

Success (HTTP 200):

{"allowedChecks": {"REUSABLE_KYC_SDK": "Reusable KYC via API/SDK: ...", "VIDEO_IDENT": "Video Identification: ..."}}
HTTP 200

Error (non-200):

{"description":"Unauthorized","errorName":"...","correlationId":"..."}
HTTP 401
  • allowedChecks — map of permission key → human-readable label for all entitlements enabled for this tenant.
  • Permission keys present as keys of allowedChecks are the allowed entitlements.

How callers should use this

If the HTTP status is not 200, stop immediately — show the error body to the user and do not proceed.

After a successful response, check whether the required BackgroundCheckTarget key is present in allowedChecks. If it is not, stop immediately — do not build or POST the payload. Tell the user which entitlement is missing and that they need to contact their CSM or Sumsub Support to get it enabled.

Entitlement → feature mapping (key examples):

FeatureRequired entitlement
E_KYC docsetE_KYC_TARGET
PROOF_OF_RESIDENCE docsetPOA
E_SIGN docsetE_SIGN_TARGET
deviceIntelligenceSettings.enabled: trueDEVICE_INTELLIGENCE
QUESTIONNAIRE scoringQUESTIONNAIRE_SCORING
QUESTIONNAIRE attachmentsQUESTIONNAIRE_ATTACHMENT
NFC chip readingNFC
Video ident sessionsVIDEO_IDENT
Reusable KYC via SDKREUSABLE_KYC_SDK
Known face searchKNOWN_FACE_SEARCH
AML / watchlist stepWATCHLISTS

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/sumsub/agent-skills/sumsub-check-permissions">View sumsub-check-permissions on skillZs</a>