COcontentstudio
📁 Content Library

Upload media

Changed on

Upload a media file or import from URL into the workspace content library. Provide either a file or a URL, not both.

post/api/v1/workspaces/{workspace_id}/media

Request

  • Base URL
    https://api.contentstudio.io
  • URL
    https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/media
  • Auth
    API key in header X-API-Key

Path parameters

workspace_idstring required
Example:610a1e660cb41530ca40d372

Workspace ID

Request body multipart/form-data

filestring binary

Media file to upload (mutually exclusive with url)

urlstring url

URL to import media from (mutually exclusive with file)

folder_idstring nullable

Folder ID to upload into

Example request

{
  "url": "https://example.com/image.jpg",
  "folder_id": "625d06734ceb636c2f5e7743"
}

Response

Media uploaded successfully

statusboolean
messagestring

Example response

{
  "status": true,
  "message": "Media uploaded successfully. Use the returned `id` in `content.media.media_ids` when creating a post. If `is_processing` is true, wait and check GET /media before referencing it.",
  "data": {
    "id": "625d06734ceb636c2f5e7743",
    "_id": "625d06734ceb636c2f5e7743",
    "name": "photo.jpg",
    "url": "https://storage.googleapis.com/.../photo.jpg",
    "mime_type": "image/jpeg",
    "extension": "jpg",
    "size": 245760,
    "type": "image"
  }
}

Changes