# Add Portal Admin API Mutation > Add a Portal Admin GraphQL mutation under portal/src/graphql/adminapi/mutations. Use when this capability is needed. - Skill: `tomevault-io/add-portal-admin-api-mutation` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/add-portal-admin-api-mutation` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/add-portal-admin-api-mutation/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Integrations & APIs - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/add-portal-admin-api-mutation --- Follow this skill when adding a Portal Admin GraphQL mutation. ## Workflow 1. Read `./portal/src/graphql/adminapi/schema.graphql` first. 2. Create the `.graphql` file under `./portal/src/graphql/adminapi/mutations`. 3. Query all fields on the top-level entity unless the user explicitly says otherwise. 4. Avoid nested entities unless the user asked for them. 5. Run `cd ./portal && npm run gentype` after adding the file. ## Notes - Keep the operation name consistent with existing Portal GraphQL naming. - Do not invent schema fields; use only what exists in the schema file. --- > Source: [authgear/authgear-server](https://github.com/authgear/authgear-server) — distributed by [TomeVault](https://tomevault.io).