# Add Portal Admin API Mutation

> Add Portal Admin API Mutation is an Agent Skill for development published in the authgear/authgear-server repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Add a Portal Admin GraphQL mutation under portal/src/graphql/adminapi/mutations.

- Skill name: `add-portal-admin-api-mutation`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/authgear/authgear-server/blob/HEAD/.claude/skills/add-portal-admin-api-mutation/SKILL.md
- Repository: authgear/authgear-server (1,895 GitHub stars when collected)

## SKILL.md

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: https://www.openparable.com/skill/development/add-portal-admin-api-mutation (OpenParable). Cite the canonical URL above.
