# Repeatable workflows, when offered

Facet and repeatable-work tools may be unavailable in a Space. Inspect the released catalog, requirements and installed health before proposing or installing anything. Preparation is not installation; installation and permission acceptance need their own authority, and saved active status does not prove a live runtime.

> [API guide](https://swarm.services/guide/api.md) · [Documentation index](https://swarm.services/guide/llms.txt) · [Web reference](https://swarm.services/guide/api/reference/mcp-repeatable-workflows-when-offered)

[Read the Facets guide](https://swarm.services/guide/facets.md) for the workflow.

## Get Space Facet catalog

`swarm_get_space_facet_catalog`

Browse one page of released workflow packages (Facets), with requirements and connection setup guidance for this Space. Does not install them.

Required: none. Optional: space_id, limit, cursor.
Effect: read. Capability: `space.read`.

## Get Facet detail

`swarm_get_facet_detail`

Inspect a released Facet workflow's permissions, connections and setup. Does not install it.

Required: facet_version_id. Optional: space_id.
Effect: read. Capability: `space.read`.

## Get installed Facets

`swarm_get_installed_facets`

List one page of workflow packages (Facets) installed in a Space, with versions, saved status and Core assignments.

Required: none. Optional: space_id, limit, cursor.
Effect: read. Capability: `space.read`.

## Get Facet health

`swarm_get_facet_health`

Inspect an installed Facet workflow's saved status and setup guidance. Active status does not verify live Core or connection health.

Required: facet_instance_id. Optional: space_id.
Effect: read. Capability: `space.read`.

## Make work repeatable

`swarm_prepare_repeatable_work`

Prepare one private, non-executable repeatable-work proposal from an accepted Run.

Required: run_id, idempotency_key. Optional: space_id.
Effect: additive. Capability: `space.facet.create`.

## Install Facet

`swarm_install_facet`

Start installation from an immutable Facet catalog version.

Required: facet_version_id, idempotency_key. Optional: space_id, core_id, accepted_capabilities, install_config.
Effect: additive. Capability: `facet.install`.

## Continue Facet install

`swarm_continue_facet_install`

Continue one canonical Facet install session.

Required: install_session_id, idempotency_key. Optional: space_id, preview_hash.
Effect: control. Capability: `facet.install`.

## Accept Facet install

`swarm_accept_facet_permissions`

Accept one canonical Facet install session.

Required: install_session_id, idempotency_key. Optional: space_id, preview_hash.
Effect: control. Capability: `facet.install`.

## Cancel Facet install

`swarm_cancel_facet_install`

Cancel one canonical Facet install session.

Required: install_session_id, idempotency_key. Optional: space_id, preview_hash.
Effect: destructive. Capability: `facet.install`.

## Pause Facet

`swarm_pause_facet`

Pause an installed Facet.

Required: facet_instance_id, idempotency_key. Optional: space_id.
Effect: control. Capability: `facet.manage`.

## Resume Facet

`swarm_resume_facet`

Resume an installed Facet.

Required: facet_instance_id, idempotency_key. Optional: space_id.
Effect: control. Capability: `facet.manage`.

## Disable Facet

`swarm_disable_facet`

Disable an installed Facet.

Required: facet_instance_id, idempotency_key. Optional: space_id.
Effect: destructive. Capability: `facet.manage`.