# HTTP: media

Arc agent documentation

All 3 media 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.

## 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.