Generate a signed S3 POST | Close | Developer API Documentation

curl -X POST https://api.close.com/api/v1/files/upload/ \
     -H "Content-Type: application/json" \
     -u "<CLOSE_API_KEY>:" \
     -d '{
  "content_type": "image/jpeg",
  "filename": "image.jpg"
}'

{
  "download": {
    "url": "https://app.close.com/go/file/temporary/user_Ova4RGFG7pztSeJiiMFdN7O2MFl71nD0uGO3bIOo4Wk/1Zx0AlY1DwBXzKKrVwpAoj/image.jpg/"
  },
  "upload": {
    "fields": {
      "AWSAccessKeyId": "AKIAACCESSKEYHERE",
      "Content-Disposition": "inline; filename=\"image.jpg\"",
      "Content-Type": "image/jpeg",
      "key": "temporary/user/user_Ova4RGFG7pztSeJiiMFdN7O2MFl71nD0uGO3bIOo4Wk/1Zx0AlY1DwBXzKKrVwpAoj/image.jpg",
      "policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMDItMjJ...",
      "signature": "ePInTgHEBsj0hzMeif/d0U2FQQk=",
      "success_action_status": "201"
    },
    "url": "https://close-prd-files.s3.amazonaws.com/"
  }
}

Get the data needed to make a request to S3 to store your file.

Authentication

AuthorizationBasic

Use your API key as the username and leave the password empty.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

content_typestringRequired

filenamestringRequired

Response

Successful response

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error