Action: Get Media Upload Status

Hootsuite Operation

The Get Media Upload Status action retrieves the current status of a media file upload.

Example User Story

I want to check the upload status of my media in Hootsuite so that I can ensure my content is ready for scheduling.

Fields

Field Name	Field Type	Required
mediaId	String	Yes

Related Connections

Hootsuite

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "get-media-upload-status",
  "state": "inDev",
  "meta": {
    "short": "Get Media Upload Status",
    "description": "Retrieves the status of a media upload in Hootsuite."
  },
  "input": [
    {
      "name": "mediaId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the media whose upload status is to be retrieved."
      }
    }
  ],
  "output": [
    {
      "name": "status",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "The current status of the media upload."
      }
    },
    {
      "name": "progress",
      "type": "Integer",
      "selector": ["progress"],
      "meta": {
        "description": "The progress percentage of the media upload."
      }
    },
    {
      "name": "error",
      "type": "String",
      "selector": ["error", "message"],
      "meta": {
        "description": "Error message if the upload failed."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "GET",
        "path": "/media/upload/status/{{mediaId}}",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    }
  ]
}