--- title: list-event-types product: vercel url: /docs/rest-api/user/list-event-types type: reference prerequisites: [] related: - /docs/rest-api summary: Learn about list-event-types on Vercel. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # List Event Types ```http GET /v1/events/types ``` Returns the list of user-facing event types with descriptions. ## Authentication **bearerToken**: HTTP bearer ## Query parameters | Name | Type | Required | Description | |---|---|---|---| | `teamId` | string | No | The Team identifier to perform the request on behalf of. | | `slug` | string | No | The Team slug to perform the request on behalf of. | ## Responses ### 200: No description Content-Type: `application/json` ```json { "type": "object", "required": [ "types" ], "properties": { "types": { "type": "array", "items": { "type": "object", "required": [ "deprecated", "description", "name", "replacedBy" ], "properties": { "replacedBy": { "type": "array", "items": { "type": "string" } }, "deprecated": { "type": "boolean", "enum": [ true ] }, "name": { "type": "string", "enum": [ "team", "avatar", "alias", "plan", "flag", "deployment", "access-group-created", "access-group-deleted", "access-group-project-updated", "access-group-updated", "access-group-user-added", "access-group-user-removed", "password-protection-disabled", "password-protection-enabled", "aliases-assigned", "alias-chown", "alias-delete", "alias-invite-created", "alias-invite-joined", "alias-invite-revoked", "alias-protection-bypass-created", "alias-protection-bypass-exception", "alias-protection-bypass-regenerated", "alias-protection-bypass-revoked", "alias-system", "alias-user-scoped-access-denied", "alias-user-scoped-access-granted", "alias-user-scoped-access-requested", "alias-user-scoped-access-revoked", "oauth-app-connection-created", "oauth-app-connection-removed", "oauth-app-connection-updated", "oauth-app-created", "oauth-app-deleted", "vercel-app-installation-request-dismissed", "vercel-app-installation-requested", "vercel-app-installation-updated", "vercel-app-installed", "oauth-app-secret-deleted", "oauth-app-secret-generated", "oauth-app-token-created", "vercel-app-tokens-revoked", "vercel-app-uninstalled", "oauth-app-updated", "attack-mode-disabled", "attack-mode-enabled", "auto-expose-system-envs", "invoice-refunded", "invoice-modified", "payment-method-added", "payment-method-default-updated", "payment-method-removed", "subscription-created", "subscription-updated", "subscription-product-added", "subscription-product-removed", "bulk-redirects-settings-updated", "bulk-redirects-version-promoted", "bulk-redirects-version-restored", "cert", "cert-system-create", "cert-autorenew", "cert-chown", "cert-clone", "cert-delete", "cert-renew", "cert-replace", "connect-configuration-created", "connect-configuration-deleted", "connect-configuration-link-updated", "connect-configuration-linked", "connect-configuration-unlinked", "connect-configuration-updated", "connect-github", "disconnect-github", "connect-github-limited", "disconnect-github-limited", "connect-github-custom-host", "disconnect-github-custom-host", "connect-gitlab", "connect-gitlab-app", "disconnect-gitlab-app", "connect-bitbucket", "connect-bitbucket-app", "disconnect-bitbucket-app", "custom-suffix-clear", "custom-suffix-disable", "preview-deployment-suffix-disabled", "custom-suffix-enable", "preview-deployment-suffix-enabled", "custom-suffix-pending", "custom-suffix-ready", "deploy-hook-created", "deploy-hook-deleted", "deploy-hook-deduped", "deploy-hook-processed", "deployment-check-created", "deployment-check-updated", "deployment-check-deleted", "authorize-git-deployment", "deployment-chown", "deployment-creation-blocked", "deployment-delete", "disabled-integration-installation-removed", "dns-add", "dns-delete", "dns-update", "domain", "domain-buy", "domain-cdn", "domain-chown", "domain-delegated", "domain-delete", "domain-service-type-updated", "domain-custom-ns-change", "dns-zonefile-import", "domain-zone-change", "domain-move-in", "domain-move-out", "domain-move-out-request-sent", "domain-renew-change", "domain-transfer-in", "domain-transfer-in-canceled", "domain-transfer-in-completed", "drain-created", "drain-deleted", "drain-disabled", "drain-enabled", "drain-updated", "edge-cache-dangerously-delete-by-src-images", "edge-cache-dangerously-delete-by-tags", "edge-cache-invalidate-by-src-images", "edge-cache-invalidate-by-tags", "edge-cache-purge-all", "edge-cache-rollback-purge", "edge-config-created", "edge-config-deleted", "edge-config-items-updated", "edge-config-schema-deleted", "edge-config-schema-updated", "edge-config-transfer-in", "edge-config-transfer-out", "edge-config-token-created", "edge-config-token-deleted", "edge-config-updated", "email", "email-notification-rule-removed", "email-notification-rule-updated", "env-variable-add", "env-variable-delete", "env-variable-edit", "env-variable-read", "env-variable-read:cli:dev", "env-variable-read:cli:env:add", "env-variable-read:cli:env:ls", "env-variable-read:cli:env:pull", "env-variable-read:cli:env:rm", "env-variable-read:cli:pull", "env-variable-read:unknown-source", "env-variable-read:v0:env:pull", "shared-env-variable-create", "shared-env-variable-delete", "shared-env-variable-read", "shared-env-variable-update", "firewall-bypass-created", "firewall-bypass-deleted", "firewall-config-modified", "firewall-config-promoted", "firewall-config-removed", "firewall-managed-rulegroup-updated", "firewall-managed-ruleset-updated", "flags-segment", "flags-settings", "flags-explorer-subscription", "flags-sdk-key", "instant-rollback-created", "integration-configuration-owner-changed", "integration-configuration-scope-change-confirmed", "integration-configurations-disabled", "integration-installation-billing-plan-updated", "integration-installation-completed", "integration-installation-permission-updated", "integration-installation-removed", "integration-scope-changed", "log-drain-created", "log-drain-deleted", "log-drain-disabled", "log-drain-enabled", "login", "manual-deployment-promotion-created", "microfrontend-group-added", "microfrontend-group-deleted", "microfrontend-group-updated", "microfrontend-project-added-to-group", "microfrontend-project-removed-from-group", "microfrontend-project-updated", "monitoring-disabled", "monitoring-enabled", "observability-disabled", "observability-enabled", "observability-plus-project-disabled", "observability-plus-project-enabled", "owner-blocked", "owner-unblocked", "owner-soft-blocked", "owner-soft-unblocked", "passkey-created", "passkey-deleted", "passkey-updated", "preview-deployment-suffix-update", "privatelink-endpoint-created", "production-branch-updated", "project-directory-listing", "project-analytics-disabled", "project-speed-insights-disabled", "project-analytics-enabled", "project-speed-insights-enabled", "project-automation-bypass", "project-affected-projects-deployments-updated", "project-external-rewrite-caching-updated", "project-build-command-updated", "project-framework-updated", "project-install-command-updated", "project-node-version-updated", "project-output-directory-updated", "project-prioritize-production-builds-updated", "project-root-directory-updated", "project-source-files-outside-root-directory-updated", "project-build-machine-updated", "project-client-cert-delete", "project-client-cert-upload", "project-connect-configurations", "project-created", "project-cron-jobs-toggled", "project-delete", "project-domain-unverified", "project-domain-verified", "project-elastic-concurrency-updated", "project-auto-assign-custom-production-domains-updated", "project-preview-environment-branch-tracking-updated", "project-custom-environment-updated", "project-custom-environment-created", "project-custom-environment-deleted", "project-functions-fluid-disabled", "project-functions-fluid-enabled", "project-function-max-duration", "project-function-cpu-memory", "project-function-regions", "project-function-failover", "project-preview-deployment-suffix", "project-name", "project-git-repository-connected", "project-git-repository-disconnected", "project-git-pr-comments-toggled", "project-git-commit-comments-toggled", "project-git-repository-dispatch-events-toggled", "project-git-create-deployments-toggled", "project-git-require-verified-commits-toggled", "project-git-lfs-toggled", "project-consolidated-git-commit-status-updated", "project-ignored-build-step-updated", "project-add-alias", "project-add-redirect", "project-domain-deleted", "project-domain-moved", "project-domain-updated", "project-member-removed-batch", "project-alias-configured-change", "project-member-added", "project-member-invited", "project-member-removed", "project-member-updated", "project-move-in-success", "project-move-out-failed", "project-move-out-started", "project-move-out-success", "project-oidc-token-created", "project-options-allowlist", "project-password-protection", "project-paused", "project-program-enrollment-changed", "project-rolling-release-enabled", "project-rolling-release-disabled", "project-rolling-release-configured", "project-rolling-release-started", "project-rolling-release-completed", "project-rolling-release-aborted", "project-rolling-release-approved", "project-rolling-release-timer", "project-routes-version-promoted", "project-routes-version-restored", "project-oidc-issuer-mode-updated", "project-customer-success-code-visibility-updated", "project-git-fork-protection-updated", "project-protected-sourcemaps-updated", "project-build-logs-and-source-protection-updated", "project-deployment-retention-updated", "project-skew-protection-threshold-updated", "project-skew-protection-max-age-updated", "project-skew-protection-allowed-domains-updated", "project-sso-protection", "project-static-ips-updated", "project-trusted-ips", "project-unpaused", "project-web-analytics-disabled", "project-web-analytics-enabled", "protected-git-scope-added", "protected-git-scope-removed", "runtime-cache-purge-all", "scale", "scale-auto", "secondary-email-added", "secondary-email-removed", "secondary-email-verified", "secret-add", "secret-delete", "secret-rename", "security-plus-updated", "set-bio", "set-name", "set-profiles", "set-scale", "signup", "signup-via-bitbucket", "signup-via-github", "signup-via-gitlab", "speed-insights-settings-updated", "spend-created", "spend-deleted", "spend-updated", "storage-accept-tos", "storage-transfer-request-created", "storage-transfer-out-success", "storage-transfer-in-success", "storage-create", "storage-reset-credentials", "storage-update", "storage-connect-project", "storage-disconnect-project", "storage-update-project-connection", "storage-delete", "storage-accessed-data-browser", "storage-view-secret", "storage-inactive-store-deleted", "storage-resource-repl-command", "storage-disconnect-projects", "storage-access-token-set", "ai-code-review", "ai-alert-investigation", "vercel-agent-team-trial-credits-applied", "team-avatar-update", "team-default-build-machine-updated", "team-delete", "strict-deployment-protection-settings", "team-domain-verification-created", "team-domain-verification-deleted", "team-domain-verification-verified", "team-emu-updated", "vercel-toolbar", "team-email-domain-update", "team-invite-bulk-delete", "team-member-add", "team-member-confirm-request", "team-member-decline-request", "team-member-delete", "team-member-entitlement-added", "team-member-entitlement-canceled", "team-member-entitlement-reactivated", "team-member-entitlement-removed", "team-member-join", "team-member-leave", "team-member-request-access", "team-member-role-update", "team-mfa-enforcement-updated", "concurrent-builds-update", "team-ended-trial", "team-paid-invoice", "team-invite-code-reset", "team-name-update", "team-program-enrollment-changed", "team-remote-caching-update", "enforce-sensitive-environment-variables", "show-ip-addresses", "team-saml-enforced", "team-saml-roles", "team-ip-blocking-rules-created", "team-ip-blocking-rules-removed", "audit-log-export-requested", "audit-log-export-downloaded", "team-slug-update", "unlink-login-connection", "user-mfa-removed", "user-delete", "user-mfa-challenge-verified", "user-mfa-configuration-updated", "user-mfa-recovery-codes-regenerated", "user-mfa-totp-verification-started", "user-mfa-totp-verified", "user-primary-email-updated", "username", "alert-rule-created", "alert-rule-updated", "alert-rule-deleted", "vpc-peering-connection-accepted", "vpc-peering-connection-deleted", "vpc-peering-connection-rejected", "vpc-peering-connection-updated", "web-analytics-tier-updated", "webhook-created", "webhook-deleted", "webhook-updated", "v0-chat-created", "v0-chat-ai-usage", "v0-chat-message-sent", "workflow-deployment-key-accessed" ] }, "description": { "type": "string" } } } } } } ``` ### 400: No description ### 401: The request is not authorized. ### 403: You do not have permission to access this resource. --- ## Related - [user endpoints](/docs/rest-api#user) - [REST API overview](/docs/rest-api) - [OpenAPI spec](https://openapi.vercel.sh/) (machine-readable, all endpoints) --- [View full sitemap](/docs/sitemap)