MCP and events

Reference

Event catalog

Every event Volobox can deliver to a webhook, grouped by what it is about, with its scope and what it means.

These are the events Volobox can deliver to a webhook. Events that never leave the workspace, such as chat messages and meetings, are not listed and are never sent. How to add a webhook and choose its events is in Webhooks; how to verify and process a delivery is in Receive and verify webhooks.

The Event column is the key a delivery names in its body and in the X-Volobox-Event header, except app events (see app.event.published). Scope is the kind of place the event happens in.

Note

Events about coding assignments, coding sessions, Docs pages, Docs spaces, files and folders, members, shared drives and workflow runs are recorded only while something listens for them, such as a webhook. Events from before that are not sent.

Alerts

EventScopeDescription
alert.acknowledgedAlertA person acknowledged an alert for everybody it is addressed to.
alert.escalatedAlertAn active alert's source raised its severity.
alert.raisedAlertA condition started to hold: a new alert, or one raised again after it resolved. Not raised again while it stays active. Carries ids, severity and a label, never the alert's summary; a personal alert never leaves the workspace.
alert.resolvedAlertAn alert's source reported that the condition no longer holds.

Coding assignments

EventScopeDescription
coding_assignment.completedProjectAn agent finished a coding assignment.
coding_assignment.failedProjectAn agent's coding assignment failed.
coding_assignment.startedProjectAn agent started working on a task assigned to it for coding.

Coding sessions

EventScopeDescription
coding_session.archivedRepositoryA coding session on a repository was archived.
coding_session.createdRepositoryA coding session was started on a repository. Carries no title: a session's title can quote a task the reader may not see.

Custom apps

Note

Available where the workspace uses custom apps.

EventScopeDescription
app.event.publishedAppA rule of a published custom app published an event its app.json declares. Delivered as app.{appKey}.{event}, such as app.orders.order.placed.

Docs pages

EventScopeDescription
page.createdDocs spaceA page was created in a shared Docs space, by hand, as a copy or as a duplicate.
page.deletedDocs spaceA page was moved to the trash.
page.movedDocs spaceA page moved in its space or to another one. Scoped to the destination space.
page.revision.restoredDocs spaceAn earlier revision of a page was restored.
page.sharing.changedDocs spaceWho may open a page changed: a member added or removed, or its visibility reset.

Docs spaces

EventScopeDescription
space.createdDocs spaceA shared Docs space was created.
space.deletedDocs spaceA shared Docs space was deleted.
space.member.addedDocs spaceA person, group or agent was added to a shared Docs space.
space.member.removedDocs spaceA person, group or agent was removed from a shared Docs space.
space.member.role.changedDocs spaceA Docs space member's role changed.
space.updatedDocs spaceA shared Docs space's settings changed. Names the fields.

Files and folders

EventScopeDescription
file.deletedShared driveA file or folder in a shared drive was deleted for good.
file.link.changedShared driveA share link of a file or folder in a shared drive was turned on, changed or turned off.
file.movedShared driveA file or folder moved within, into or out of a shared drive. Scoped to the destination drive, or to the drive it left for a personal one.
file.renamedShared driveA file or folder in a shared drive was renamed.
file.restoredShared driveA file or folder in a shared drive was restored from the trash.
file.sharing.changedShared driveWho may open a file or folder in a shared drive changed.
file.trashedShared driveA file or folder in a shared drive was moved to the trash.
file.uploadedShared driveA file was added to a shared drive: uploaded, created as text or copied.
file.version.addedShared driveA new version of a file in a shared drive was uploaded.
file.version.restoredShared driveAn earlier version of a file in a shared drive was restored.
folder.createdShared driveA folder was created in a shared drive.

Members

EventScopeDescription
member.deactivatedWorkspaceA member was deactivated.
member.joinedWorkspaceA person became a member of the workspace. Names the person's id only.
member.reactivatedWorkspaceA deactivated member was activated again.

Milestones

EventScopeDescription
milestone.closedProjectA milestone was closed.
milestone.createdProjectA milestone was created in a project.
milestone.deletedProjectA milestone was deleted.
milestone.reopenedProjectA closed milestone was reopened.
milestone.updatedProjectA milestone's name, description or dates changed.

Pipeline runs

EventScopeDescription
pipeline.run.failedProjectA run of an Azure DevOps pipeline linked to a project failed, whoever started it and from where. Carries the linked pipeline, the run's id, branch and commit, never its log.
pipeline.run.succeededProjectA run of an Azure DevOps pipeline linked to a project succeeded, fully or partially; the result says which. A canceled run raises nothing.

Projects

EventScopeDescription
project.archivedProjectA project was archived.
project.createdProjectA project was created.
project.deletedProjectA project was deleted.
project.member.addedProjectA person, group or agent was added to a project.
project.member.removedProjectA person, group or agent was removed from a project.
project.member.role.changedProjectA project member's role changed.
project.unarchivedProjectAn archived project was restored.
project.updatedProjectA project's settings, slug or agent guidance changed.

Pull requests

EventScopeDescription
pull_request.ai_review.completedRepositoryAn AI review of a pull request finished with a verdict.
pull_request.ai_review.failedRepositoryAn organization AI review of a pull request failed before it reached a verdict. Carries the head it was of and the failure's code as its outcome when the failure was a known one.
pull_request.checks.completedRepositoryThe CI of an open pull request settled at its head: every deciding check finished. Once per head and outcome; names the checks that failed.
pull_request.ci_fix.completedRepositoryA CI repair round on a pull request ended: green, gave up, or could not start.
pull_request.closedRepositoryA pull request was closed without merging.
pull_request.mergedRepositoryA pull request was merged.
pull_request.openedRepositoryA pull request was opened.
pull_request.ready_for_reviewRepositoryA draft pull request was marked ready for review.
pull_request.reopenedRepositoryA closed pull request was reopened.
pull_request.review.submittedRepositoryA reviewer submitted a review on the code host (approved, changes requested or commented).

Requests

EventScopeDescription
request.assignedProjectA person or an agent was added to a request's assignees; one event per assignee.
request.closedProjectA request was closed: by a person, or by the last open task made from it or given it.
request.convertedProjectA request was linked to a task: a task was made from it, alone or with other requests, or it was added to an existing task.
request.createdProjectA request was created.
request.deletedProjectA request was deleted.
request.reopenedProjectA closed request was reopened: by a person, or because a task made from it or given it was reopened.
request.status.changedProjectA request was closed, reopened or converted into a task.
request.updatedProjectA request's fields changed. One event per save, naming the fields.

Shared drives

EventScopeDescription
drive.createdShared driveA shared drive was created.
drive.deletedShared driveA shared drive was deleted.
drive.member.addedShared driveA person, group or agent was added to a shared drive.
drive.member.removedShared driveA person, group or agent was removed from a shared drive.
drive.member.role.changedShared driveA shared drive member's role changed.
drive.updatedShared driveA shared drive's settings changed. Names the fields.

Support tickets

Note

Available where the workspace uses Support.

EventScopeDescription
ticket.assignedSupport deskA support ticket was assigned, reassigned or unassigned.
ticket.customer.repliedSupport deskA customer replied on a support ticket.
ticket.mergedSupport deskA support ticket was merged into another; the event names the ticket that was merged away.
ticket.openedSupport deskA customer opened a support ticket.
ticket.reopenedSupport deskA resolved or closed support ticket was opened again.
ticket.status.changedSupport deskA support ticket's status changed. A reopen raises ticket.reopened instead.

Tasks

EventScopeDescription
task.assignedProjectA person or an agent was added to a task's assignees; one event per assignee.
task.closedProjectA task was closed, by a person, an agent, a merged pull request or a synced tracker.
task.column.pinnedProjectA task was pinned to a board column.
task.comment.addedProjectA person posted in a task's discussion.
task.createdProjectA task was created.
task.deletedProjectA task was deleted.
task.movedProjectA task was moved to another project. Scoped to the destination project.
task.reopenedProjectA closed task was reopened.
task.status.changedProjectA task's status or work state changed. A close also raises task.closed after it.
task.updatedProjectA task's fields changed (title, description, priority, dates, labels, milestone, area, type, effort, parent or assignees). One event per save, naming the fields.

Workflow runs

EventScopeDescription
workflow.run.completedWorkflowA run of a shared workflow completed.
workflow.run.failedWorkflowA run of a shared workflow failed.
workflow.run.waitingWorkflowA run of a shared workflow stopped to wait for an answer or an approval.