Create a browser upload session

Returns uploadUrl for the user to open in a browser and upload images or video. Poll get_upload_session until status is completed, then use files[].url in create_post.

Category: Media
Calls: POST/v1/media/upload-sessions
Safe to auto-approve: No. It changes data, so keep a human in the loop or scope the key.

Parameters

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

Example

A tool call as an MCP client would send it.

{
  "name": "create_upload_session",
  "arguments": {}
}