add_portal_admin_api_query

To add a Portal Admin GraphQL query, create a new .graphql file under portal/src/graphql/adminapi/query. You must first reference portal/src/graphql/adminapi/schema.graphql to ensure you only use existing fields and respect established naming conventions for portal operations.

Pagination for portal admin API queries requires including cursor, pageInfo, and totalCount metadata in your .graphql file whenever the query supports pageable results. This ensures portal APIs return predictable and consistent pagination structures.

Regenerating portal type definitions requires running the command npm run gentype inside the portal directory. This npm script syncs client code with the newly added or updated GraphQL query files.

Nested entity selections should be avoided when creating portal admin GraphQL queries unless explicitly requested. The query creation process emphasizes respecting entity field scope to maintain schema fidelity and prevent querying unsupported data.

Referencing schema.graphql prevents inventing unsupported schema entries. Reading portal/src/graphql/adminapi/schema.graphql first ensures your new query adheres to existing fields, maintaining schema fidelity across the portal admin API.