docs/ai/well-known-actions.md
This section lists a number of well-known Actions registered with the Actions Registry.
This is a (non-exhaustive) list of actions that are known to be part of the Actions Registry. Entries are in the format: "action-name (Action Title): Shortened Action Description"
auth.who-am-i (Who Am I): Returns the catalog entity and user info for the currently authenticated user. This action requires user credentials and cannot be used with service or unauthenticated credentials.catalog.get-catalog-entity (Get Catalog Entity): This allows you to get a single entity from the software catalog.catalog.query-catalog-entities (Query Catalog Entities): Query entities from the Backstage Software Catalog using predicate filters.catalog.register-entity (Register entity in the Catalog): Registers one or more entities in the Backstage catalog by creating a Location entity that points to a remote catalog-info.yaml file.catalog.unregister-entity (Unregister entity from the Catalog): Unregisters a Location entity and all entities it owns from the Backstage catalog.catalog.validate-entity (Validate Catalog Entity): This action can be used to validate catalog-info.yaml file contents meant to be used with the software catalog.notifications.get-notifications (Get Notifications): Fetches notifications for the currently authenticated user. Defaults to returning only unread notifications. Supports filtering by read status (unread, read, saved, all), severity, topic, free-text search, and creation date. Supports pagination via offset and limit.scaffolder.dry-run-template (Dry Run Scaffolder Template): Dry-runs a scaffolder template to validate it without making changes. Returns success with execution logs, or errors for validation failures.scaffolder.list-scaffolder-actions (List Scaffolder Actions): Lists all installed Scaffolder actions.scaffolder.list-scaffolder-tasks (List Scaffolder Tasks): This allows you to list scaffolder tasks that have been created.scaffolder.execute-template (Execute Scaffolder Template): Executes a Scaffolder template with its template ref and input parameter values.scaffolder.get-scaffolder-task-logs (Get Scaffolder Task Logs): This allows you to fetch the logs of a given scaffolder task.search.query (Query Search Engine): Query the Backstage search engine for documents across all or selected document types.