Docs
Media
POST
/media

Two ways to add a file, then pass its id in mediaIds when creating or updating a post.

  • Import from a URL: send url (public https, up to 100 MB). FeedHorizon downloads it and answers when it is stored. Easiest for agents and scripts.
  • Upload: send filename, mimeType and sizeBytes (up to 5 GB). The answer carries upload.url; PUT the raw bytes there with the same Content-Type within two hours. No API key is needed for that request.

Supported types: image/jpeg, image/png, image/gif, image/webp, video/mp4, video/quicktime, video/webm, application/pdf. Which platform takes which type is listed under GET /platforms.

Requires posts:write.

Authorization

bearerAuth
AuthorizationBearer <token>

API key starting with fh_

In: header

Header Parameters

Idempotency-Key?string

Any unique string up to 255 characters. A retry with the same key within 24 hours returns the first response instead of running again.

Lengthlength <= 255

Request Body

application/json

url?string

Import this public https URL

Formaturi
Lengthlength <= 2048
filename?string

File name, required for uploads

Length1 <= length <= 255
mimeType?string

Required for uploads

Value in"image/jpeg" | "image/png" | "image/gif" | "image/webp" | "video/mp4" | "video/quicktime" | "video/webm" | "application/pdf"
sizeBytes?integer

Required for uploads

Range1 <= value <= 5368709120

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://feedhorizon.com/api/v1/media" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "id": "med_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
    "url": "string",
    "filename": "string",
    "mimeType": "string",
    "sizeBytes": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "upload": {
      "url": "string",
      "method": "PUT",
      "headers": {
        "property1": "string",
        "property2": "string"
      },
      "expiresAt": "2019-08-24T14:15:22Z"
    }
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}

Get a media file GET

Requires `posts:read`.

Delete a media file DELETE

Only files that no post uses can be deleted; others answer `409 media_in_use`. Requires `posts:write`.