Add Portal Admin API Mutation
Developmentadd-portal-admin-api-mutationAdd 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/authgear/authgear-server/blob/HEAD/.claude/skills/add-portal-admin-api-mutation/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/add-portal-admin-api-mutation, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Follow this skill when adding a Portal Admin GraphQL mutation.
Workflow
- Read
./portal/src/graphql/adminapi/schema.graphqlfirst. - Create the
.graphqlfile under./portal/src/graphql/adminapi/mutations. - Query all fields on the top-level entity unless the user explicitly says otherwise.
- Avoid nested entities unless the user asked for them.
- Run
cd ./portal && npm run gentypeafter 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.