Attachments

Create an attachment from a URL

Changed on

Fetch a file from a remote URL and store it as an attachment. Unlike attachments.create, the server downloads and uploads the file, so the returned attachment is immediately available.

post/attachments.createFromUrl

Request

  • Base URL
    https://app.getoutline.com/api
  • URL
    https://app.getoutline.com/api/attachments.createFromUrl
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getoutline.com/oauth/authorize
      Token URL: https://app.getoutline.com/oauth/token scopes: read, write

Request body

urlstring uri required

The remote URL to fetch the file from.

documentIdstring uuid

Identifier for the associated document, if any.

idstring uuid

An optional client-generated identifier for the attachment.

Response

OK

Example response

{
  "data": {
    "contentType": "image/png"
  }
}

Changes