Sign in
Media

Create a media item

Create a media item. Provide either album_id or category_id, and either embed_url or file.

post/media/

Response

OK

successboolean
transcodingboolean

If true, the media requires transcoding and will be available later.

Note Conditionally returned

Changes

Changed in 4 of the 7 revisions of this API.411

  • e271d0e41f6d36See the full diff
    • ▲

      removed the media type application/json from the request body

      request-body-media-type-removed

    • ▲

      removed the media type application/x-www-form-urlencoded from the request body

      request-body-media-type-removed

    • ▲

      the success response's property type/format changed from string/ to boolean/ for status 200

      response-property-type-changed

    • ○

      api operation id post_media_ removed and replaced with postMedia

      api-operation-id-removed

    • ○

      the endpoint scheme security XF-Api-Key was added to the API

      api-security-added

    • ○

      the endpoint scheme security XF-OAuth2 was added to the API

      api-security-added

    • ○

      added the new optional header request parameter XF-Api-User to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter api_bypass_permissions to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the media type multipart/form-data to the request body

      request-body-media-type-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 0f490cfb79314See the full diff
    • ○

      api tag Media added

      api-tag-added

    • ○

      api tag media removed

      api-tag-removed

    • ○

      added optional request body

      request-body-added-optional

    • ○

      added the media type application/json for the response with the status 200

      response-media-type-added

  • 6b68c4d49c451See the full diff
    • ○

      endpoint added

      endpoint-added

  • fc0a40f3b8591See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 18 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog