Skip to content

docs(portal-extension): document dataExport and account management hooks - #164

Merged
durasj merged 1 commit into
mainfrom
docs/portal-extension-undocumented-hooks
Oct 7, 2026
Merged

durasj merged 1 commit into
mainfrom
docs/portal-extension-undocumented-hooks

Conversation

@durasj

@durasj durasj commented Oct 7, 2026

Copy link
Copy Markdown
Member

Summary

The portal extension hooks page was missing 4 of the 11 hook types defined in the app-api spec (PortalExtensionHook in app-api/openapi.yml). This PR adds them:

  • Data Export (dataExport): hands block exports (CSV/Excel/PDF) to the app's own API. Covers block_types, the response format (download_url required, plus filename, content_type and expires_at), error handling and template variables.
  • Account Management (new group):
    • changeEmail: change_mode (synchronous/asynchronous), require_password_confirmation, the default body and the Input.new_email / Input.old_email variables
    • changePassword: require_new_password and Input.new_password
    • deleteAccount: deletion_mode and delete_contact (none/soft/hard)
  • Updates the intro to list five hook groups instead of three.

The default request bodies and template variables were checked against the hook execution code in customer-portal-api (extension/hook-execution.ts and user/user-handlers.ts).

Test plan

  • Docusaurus build passes
  • Review rendered page at /docs/apps/components/portal-extension#hooks

🤖 Generated with Claude Code

https://claude.ai/code/session_01RP5hkrawFeehBJxe6yCJX3


Generated by Claude Code

Add the dataExport, changeEmail, changePassword and deleteAccount hook
types, which exist in the app-api spec but were missing from the docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RP5hkrawFeehBJxe6yCJX3
@durasj
durasj merged commit 9b044d9 into main Oct 7, 2026
1 check passed
@durasj
durasj deleted the docs/portal-extension-undocumented-hooks branch October 7, 2026 08:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant