Action: Upload Media

WordPress Operation

The Upload Media action uploads a file (image, video, document, etc.) to the media library.

Example User Story

I want to upload a media file to WordPress so that I can include it in my blog posts.

Fields

Field Name	Field Type	Required
file	File	Yes
title	String	No
alt_text	String	No

Related Connections

WordPress

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "upload-media",
  "state": "inDev",
  "meta": {
    "short": "Upload Media",
    "description": "Uploads a media file to WordPress."
  },
  "input": [
    {
      "name": "file",
      "type": "File",
      "required": true,
      "meta": {
        "description": "The file to upload."
      }
    },
    {
      "name": "title",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The title of the media."
      }
    },
    {
      "name": "alt_text",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The alt text for the media."
      }
    }
  ],
  "output": [
    {
      "name": "id",
      "type": "Integer",
      "selector": ["id"],
      "meta": {
        "description": "The ID of the uploaded media."
      }
    },
    {
      "name": "url",
      "type": "String",
      "selector": ["source_url"],
      "meta": {
        "description": "The URL of the uploaded media."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/wp-json/wp/v2/media",
        "headers": {
          "Content-Disposition": "attachment; filename={{file.name}}",
          "Content-Type": "{{file.type}}"
        },
        "bodyTemplate": {
          "value": "{{file.content}}"
        }
      }
    }
  ]
}