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

$	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"
>	}'

1	{
2	"download": {
3	"url": "https://app.close.com/go/file/temporary/user_Ova4RGFG7pztSeJiiMFdN7O2MFl71nD0uGO3bIOo4Wk/1Zx0AlY1DwBXzKKrVwpAoj/image.jpg/"
4	},
5	"upload": {
6	"fields": {
7	"AWSAccessKeyId": "AKIAACCESSKEYHERE",
8	"Content-Disposition": "inline; filename=\"image.jpg\"",
9	"Content-Type": "image/jpeg",
10	"key": "temporary/user/user_Ova4RGFG7pztSeJiiMFdN7O2MFl71nD0uGO3bIOo4Wk/1Zx0AlY1DwBXzKKrVwpAoj/image.jpg",
11	"policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMDItMjJ...",
12	"signature": "ePInTgHEBsj0hzMeif/d0U2FQQk=",
13	"success_action_status": "201"
14	},
15	"url": "https://close-prd-files.s3.amazonaws.com/"
16	}
17	}