Pull an existing RTSP stream into a slot

POST 
/api/mediasrc/pull

Points the slot's mediamtx path at a stream that already exists on the network (an IP camera, another server) so applications read it at rtsp://…/srcN. The packets are forwarded unchanged. Only rtsp:// and rtsps:// URLs are accepted; credentials go in username/password or in the URL and never appear in any response. Insight checks the camera once before configuring the pull: rejected credentials answer 400 with reason: "auth_failed" and nothing is configured; an unreachable camera still configures the pull (status unreachable) and the slot recovers by itself. The pull is session-only and needs the loopback mediamtx control API.

Request

Responses

200

The slot, now pulled.

400

Invalid index or URL, or the camera rejected the credentials (reason: "auth_failed").

404

The requested resource was not found.

409

The slot is streaming, held by an external publisher, a webcam source (clear it first), or already pulling.

502

mediamtx refused the path configuration or could not be reached.