Skip to main content
Uploads a file from the agent’s local disk to the public storage bucket. Returns the public HTTPS URL. Useful for attaching screenshots, diagrams, or build artifacts to PR descriptions and comments. Equivalent to murmur upload in the CLI.

​
Parameters

NameTypeRequiredDescription
filenamestringyesFile name (e.g. diagram.png). Used as the storage object name and to infer MIME type when content_type is omitted.
pathstringyesAbsolute path to the file on disk.
content_typestringnoMIME type (e.g. image/png). Inferred from filename extension if omitted. Falls back to application/octet-stream.
workspacestringnoWorkspace name. Overrides the session default.

​
Response

Returns the public HTTPS URL as a plain string.

​
Examples

​
Upload a screenshot

{
  "filename": "screenshot.png",
  "path": "/tmp/screenshot.png"
}
Response: 
https://storage.googleapis.com/murmur-public/uploads/abc123/screenshot.png

​
Upload with explicit MIME type

{
  "filename": "report.html",
  "path": "/home/agent/output/report.html",
  "content_type": "text/html"
}

​
Errors

CodeMeaningWhat to do
INVALID_ARGUMENTMissing filename or path.Provide both required fields.
NOT_FOUNDFile not found at the given path.Check the file path exists on disk.
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.
  • murmur upload — equivalent CLI command
  • port_url — share a live service URL instead of a static file
  • status — check agent state (timeline includes upload events)