# HTTP: loops

Megastructure Arc documentation

All 4 loops endpoints, with request fields and access notes.

[HTTP directory](/arc/docs/reference/http) · [Transport guide](/arc/docs/guides/http)

Request fields and access notes below are partial. Additional constraints and permissions may apply. Prefer the corresponding MCP tool and schema where available.

## PATCH /v1/loops/{id}

Loop definition.

Path parameters: `id`.

Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

## PATCH /v1/loops/{id}/instructions

Loop instructions.

Path parameters: `id`.

Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

## POST /v1/loops/{id}/restart

Loop restart.

Path parameters: `id`.

Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

## POST /v1/loops/{id}/{action}

Loop control.

Path parameters: `id`, `action`.

Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.