Upload a photo to a job

Uploads an image and stores it on the job. Send the request as multipart/form-data with these
fields:

  • photo[image]: the image file, JPEG, PNG, HEIC or WebP, up to 15 MB.
  • photo[photo_type] (required): damage, before, after or drone. Any other value is
    rejected. The type is also added to the photo's tags.
  • photo[title] and photo[description] (optional).
  • photo[taken_at] (optional): when the photo was taken, as an ISO 8601 timestamp.
  • photo[latitude] and photo[longitude] (optional): where the photo was taken.
  • photo[tag_list] (optional): a comma-separated list of extra tags. Tags are stored in lowercase.

The user behind the token is recorded as the uploader, and an entry noting the upload is added to
the job's activity log. To queue an AI damage analysis straight away, add analyze_ai=1 as a
separate form field; it only runs for damage photos.

The token's role must be able to work on sales or production jobs.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
file
required

The image file: JPEG, PNG, HEIC or WebP.

string
enum
required
string
string
date-time
number
number
string

Comma-separated tags

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json