Upload Photo API

The following API allow you to upload a single photo and generate a photo object.

Note: All the apis accept api key based token authentication

Request Path

Format 1

Upload a photo without a photo id

POST /v1/ext/photo

Format 2

You can generate an offline photo id. id has to be a UUID. and then use the id to upload the photo

POST /v1/ext/photo/<photoId>

Request Headers

Key	value
Authorization	Bearer accessToken
Content-Type	multipart/form-data

Request body parameters

Key	Required/Optional	Notes
photo	Required	pass the photo data. Can be a Buffer object or a ReadableStream depending on your client library. While testing in postman you can directly select a file for this formdata parameter
filename	Optional	name of the photo being uploaded
filetype	Optional	filetype of the file being uploaded

Sample Request

curl --request POST \
  --url https://api.chakrahq.com/v1/ext/photo \
  --header 'Authorization: Bearer <accessToken>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'photo=@/Users/steve/Documents/sample_screenshot.png' \
  --form filename=mobile_screenshot \
  --form filetype=png

Response format

The photo object is returned as a succesful response to the api. the photo id can be used in process apis to save a photo against a process like a lead or ticket

Sample response

{
	"_data": {
		"id": "f03ee609-cd2d-4e61-821d-9b0531e4ad8c",
		"createdAt": 1700558337172,
		"updatedAt": 1700558337172,
		"filetype": "png",
		"filename": "mobile_screenshot",
		"height": null,
		"width": null,
		"isPublic": false,
		"team": "5fc9f8e3-af4a-4f29-bfd8-6c02e3abe3ee",
		"user": null
	}
}