File - Choicely Mobile SDK

The File resource is split into two sets of endpoints:

Metadata APIs — create and manage the file’s metadata record (filename, type, access, and more).
File data APIs — upload, download, and delete the actual file bytes at the upload_url returned when you create the metadata.

Sample payload

{
  "access": {
    "access": "private",
    "updated": "1970-01-01T00:00:00Z"
  },
  "created": "1970-01-01T00:00:00Z",
  "custom_data": {},
  "file_extension": "jpg",
  "file_type": "image/jpeg",
  "filename": "file_name.jpg",
  "is_scanned": false,
  "description": "this is a description",
  "key": "<file_key>",
  "updated": "1970-01-01T00:00:00Z",
  "upload_url": ""
}

Metadata APIs

Create file metadata

POST /files Create a file metadata record. The response includes an upload_url you use with the File data APIs to upload the file bytes.

curl -X POST "https://backend.choicely.com/files" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "file_name.jpg",
    "file_type": "image/jpeg",
    "file_extension": "jpg"
  }'

Get file metadata

GET /files/<file_key> Retrieve a file’s metadata by its key.

file_key

string

required

Unique key of the file.

curl "https://backend.choicely.com/files/<file_key>" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Update file metadata

PATCH /files/<file_key> Update a file’s metadata. Include only the fields you want to change.

file_key

string

required

Unique key of the file.

curl -X PATCH "https://backend.choicely.com/files/<file_key>" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "this is a description"
  }'

Delete file metadata

DELETE /files/<file_key> Delete a file’s metadata.

file_key

string

required

Unique key of the file.

curl -X DELETE "https://backend.choicely.com/files/<file_key>" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

File data APIs

These endpoints operate on the upload_url returned by Create file metadata (the upload_url field of the file record). Use that URL directly in place of <upload_url> below.

Upload file

PUT <upload_url> Upload the file’s bytes to the upload_url.

curl -X PUT "<upload_url>" \
  --upload-file ./file_name.jpg

Download file

GET <upload_url> Download the file’s bytes from the upload_url.

curl "<upload_url>" --output file_name.jpg

Delete file

DELETE <upload_url> Delete the file’s bytes at the upload_url.

curl -X DELETE "<upload_url>"

​Sample payload

​Metadata APIs

​Create file metadata

​Get file metadata

​Update file metadata

​Delete file metadata

​File data APIs

​Upload file

​Download file

​Delete file

Sample payload

Metadata APIs

Create file metadata

Get file metadata

Update file metadata

Delete file metadata

File data APIs

Upload file

Download file

Delete file