Skip to main content

mr job submit

Submit one or more URLs to the download queue. The server creates one job per URL and immediately begins fetching in the background; this command returns as soon as the jobs are queued, not when downloads finish. Use --urls with a comma-separated list; attach tags, groups, an owner, or a custom name with the remaining flags.

Downloaded content becomes a new Resource once the fetch succeeds. Watch progress with jobs list or the /v1/download/events SSE stream.

Usage

mr job submit

Examples

Queue a single download

mr job submit --urls https://example.com/photo.jpg

Queue multiple URLs with tags and an owner group

mr job submit --urls https://a.example.com/a.jpg,https://b.example.com/b.jpg --tags 5,7 --owner-id 3

Flags

FlagTypeDefaultDescription
--urlsstring``Comma-separated URLs to download (required) (required)
--tagsstring``Comma-separated tag IDs
--groupsstring``Comma-separated group IDs
--namestring``Job name
--owner-iduint0Owner group ID

Inherited global flags

FlagTypeDefaultDescription
--jsonboolfalseOutput raw JSON
--no-headerboolfalseOmit table headers
--pageint1Page number for list commands (default page size: 50)
--quietboolfalseOnly output IDs
--serverstringhttp://localhost:8181mahresources server URL (env: MAHRESOURCES_URL)

Output

Object with queued=true and a jobs array containing each created job's id, url, and initial status

Exit Codes

0 on success; 1 on any error

See Also