How do I install the Sub2api Admin skill?

Run npx skillmds add wei-shaw/sub2api-admin in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sub2api Admin safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sub2api Admin?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sub2api Admin free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sub2api Admin?

Wei-Shaw (@wei-shaw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sub2api Admin by wei-shaw — Agent Skill

Name: Sub2api Admin
Rating: 4.2 (5 reviews)
Author: Wei-Shaw

Sub2api Admin

Manage Sub2API admin APIs for accounts, redeem codes, groups, proxies, error passthrough rules, TLS fingerprint profiles, imports, exports, batch updates, and raw administrator API calls. Use when the user mentions Sub2API, admin API keys, account management, redeem code management, recharge codes, invitation codes, bulk account import/export, keeping or deleting accounts, refreshing accounts, clearing errors, CRS sync, or managing Sub2API backend settings through the admin API.

Wei-Shaw 5b36280 4 files · 38.9 KB Updated Sep 9, 2026

File contents

Sub2API Admin

Use the bundled CLI instead of ad hoc curl. Run examples from this skill directory.

export SUB2API_BASE_URL='https://your-sub2api-host'
export SUB2API_ADMIN_API_KEY='<admin api key>'
# Or, when the deployment uses admin JWT login instead of an admin API key:
# export SUB2API_JWT='<admin access_token>'
node scripts/sub2api-admin.js accounts list

For all commands and payload examples, read references/admin-cli.md.

Workflow

Reuse SUB2API_BASE_URL and either SUB2API_ADMIN_API_KEY or SUB2API_JWT from the environment.
Run read-only commands first: accounts list, accounts get <id>, groups all, or proxies all.
Before destructive or bulk writes, print the target account names and IDs.
Execute the write command only after the target set is clear.
Run a follow-up read command to verify the result.

Common Commands

node scripts/sub2api-admin.js accounts list --page-size 20
node scripts/sub2api-admin.js accounts get 40
node scripts/sub2api-admin.js accounts usage 40
node scripts/sub2api-admin.js accounts set-schedulable 40 true
node scripts/sub2api-admin.js accounts bulk-update --ids 40,39 --json '{"concurrency":10}'
node scripts/sub2api-admin.js redeem-codes list --page-size 20
node scripts/sub2api-admin.js redeem-codes generate --json '{"count":1,"type":"balance","value":10}' --idempotency-key redeem-$(date +%s)
node scripts/sub2api-admin.js redeem-codes create-and-redeem --json '{"code":"order_123","type":"balance","value":10,"user_id":123}' --idempotency-key order-123
node scripts/sub2api-admin.js error-rules list
node scripts/sub2api-admin.js tls-profiles list

Safety Notes

Authentication uses x-api-key from SUB2API_ADMIN_API_KEY first, then falls back to Authorization: Bearer <jwt> from SUB2API_JWT.
If the API returns INVALID_ADMIN_KEY, ask the user to regenerate the admin API key. If using JWT, log in as an admin user and copy the access_token from POST /api/v1/auth/login.
accounts export includes credentials and tokens. Prefer --file and avoid printing exports in chat.
Redeem code create/redeem commands should use --idempotency-key for payment or recharge workflows.
For uncertain or newly added backend APIs, use api <METHOD> <admin-path> after a read-only check.

---name: sub2api-admindescription: Manage Sub2API admin APIs for accounts, redeem codes, groups, proxies, error passthrough rules, TLS fingerprint profiles, imports, exports, batch updates, and raw administrator API calls. Use when the user mentions Sub2API, admin API keys, account management, redeem code management, recharge codes, invitation codes, bulk account import/export, keeping or deleting accounts, refreshing accounts, clearing errors, CRS sync, or managing Sub2API backend settings through the admin API.--- # Sub2API Admin Use the bundled CLI instead of ad hoc `curl`. Run examples from this skill directory. ```bash export SUB2API_BASE_URL='https://your-sub2api-host' export SUB2API_ADMIN_API_KEY='<admin api key>' # Or, when the deployment uses admin JWT login instead of an admin API key: # export SUB2API_JWT='<admin access_token>' node scripts/sub2api-admin.js accounts list ``` For all commands and payload examples, read [references/admin-cli.md](references/admin-cli.md). ## Workflow 1. Reuse `SUB2API_BASE_URL` and either `SUB2API_ADMIN_API_KEY` or `SUB2API_JWT` from the environment. 2. Run read-only commands first: `accounts list`, `accounts get <id>`, `groups all`, or `proxies all`. 3. Before destructive or bulk writes, print the target account names and IDs. 4. Execute the write command only after the target set is clear. 5. Run a follow-up read command to verify the result. ## Common Commands ```bash node scripts/sub2api-admin.js accounts list --page-size 20 node scripts/sub2api-admin.js accounts get 40 node scripts/sub2api-admin.js accounts usage 40 node scripts/sub2api-admin.js accounts set-schedulable 40 true node scripts/sub2api-admin.js accounts bulk-update --ids 40,39 --json '{"concurrency":10}' node scripts/sub2api-admin.js redeem-codes list --page-size 20 node scripts/sub2api-admin.js redeem-codes generate --json '{"count":1,"type":"balance","value":10}' --idempotency-key redeem-$(date +%s) node scripts/sub2api-admin.js redeem-codes create-and-redeem --json '{"code":"order_123","type":"balance","value":10,"user_id":123}' --idempotency-key order-123 node scripts/sub2api-admin.js error-rules list node scripts/sub2api-admin.js tls-profiles list ``` ## Safety Notes - Authentication uses `x-api-key` from `SUB2API_ADMIN_API_KEY` first, then falls back to `Authorization: Bearer <jwt>` from `SUB2API_JWT`. - If the API returns `INVALID_ADMIN_KEY`, ask the user to regenerate the admin API key. If using JWT, log in as an admin user and copy the `access_token` from `POST /api/v1/auth/login`. - `accounts export` includes credentials and tokens. Prefer `--file` and avoid printing exports in chat. - Redeem code create/redeem commands should use `--idempotency-key` for payment or recharge workflows. - For uncertain or newly added backend APIs, use `api <METHOD> <admin-path>` after a read-only check.

Frequently asked questions