.. include:: common.rst

Media uploads
=============

.. http:post:: /api/statusnet/media/upload

  Upload a file.

  **Example response**:

  .. sourcecode:: xml

    <?xml version="1.0" encoding="UTF-8"?>
    <rsp stat="ok" xmlns:atom="http://www.w3.org/2005/Atom">
      <mediaid>573169</mediaid>
      <mediaurl>https://social.heldscal.la/attachment/573169</mediaurl>
      <media_url>https://social.heldscal.la/attachment/573169</media_url>
      <size>35586</size>
      <atom:link rel="enclosure" href="https://social.heldscal.la/file/8f4757d1cf693eb1ace0fb904b1fcaab1805cac32bda1192de1ae7b8f199e235.png" type="image/png"></atom:link>
      <media_id>573169</media_id>
      <media_id_string>573169</media_id_string>
      <image w="514" h="403" image_type="image/png"></image>
    </rsp>

  :form media: |file|
  :reqheader Authorization: |auth|

.. http:post:: /api/media/upload.json

  Upload a file.

  :form media: |file|
  :reqheader Authorization: |auth|

  **Example response**:

  .. sourcecode:: json

    {
        "media_id": "664893",
        "media_id_string": "664893",
        "media_url": "https://social.heldscal.la/attachment/664893",
        "size": "13"
    }