akarso media upload
Upload a local media file, returning a public URL for use with
posts create --media.The file is uploaded directly to storage via a presigned URL. Supported formats: jpg, jpeg, png, webp, gif, mp4, mov.
Files already hosted at a public
https URL don't need uploading — pass the URL straight to posts create --media. You can also pass local file paths directly to posts create --media without a separate upload step; they are uploaded automatically.Limitation: on the hosted MCP server, local file paths are not available. Use
https URLs instead, or run Akarso locally with akarso mcp to access local files.Usage
1akarso media upload <fileOrUrl>
Arguments
| Argument | Required | Description |
<fileOrUrl> | Yes | fileOrUrl |
Global Options
| Option | Default | Description |
--api-key [key] | - | API key (overrides AKARSO_API_KEY env and ~/.akarso/config.json) |
--api-url [url] | - | Server URL (overrides AKARSO_API_URL env, defaults to akarso.co) |
--profile [id] | - | Profile (workspace) ID to operate on, overriding the API key's pinned profile. Use profiles list to see available IDs. |
--json | - | Output raw JSON instead of YAML |
-h, --help | - | Display this message |
-v, --version | - | Display version number |
Examples
1akarso media upload ./photo.jpg
1akarso posts create --text "Pic" --platforms x --media https://example.com/photo.jpg