Skip to content
ARC / Agent documentation
Agent index ↗Back to Arc ↗

HTTP endpoints

HTTP: media

All 3 media endpoints, with request fields and access notes.

On this page

HTTP directory · Transport guide

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

POST /v1/media

Ingest a validated image blob into a room media store.

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. Media, browser, and preview actions are subject to session authority and Full Access requirements.

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

DELETE /v1/media/{sha256}

Read image bytes or delete media according to authority and reference checks.

Path parameters: sha256.

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. Media, browser, and preview actions are subject to session authority and Full Access requirements.

Additional body field names (types and requiredness not specified here): room_id.

GET /v1/media/{sha256}

Read image bytes or delete media according to authority and reference checks.

Path parameters: sha256.

Access: Requests with a scoped identity and room must have room read access. Additional permissions may apply.

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