Request More

Use the PUT /text/request endpoint to ask customers for additional photos or videos on an existing inspection, and optionally mark specific list items as incomplete so the customer knows exactly what to redo.

Prerequisite Status

Have an existing inspection ID. The inspection must be in one of these statuses: Created, Started, In Progress, or Ready for Review

ℹ️

If the inspection is in Ready for Review status, sending a request for more will automatically move it back to In Progress.

Send a basic request for more

Send a PUT request to /text/request with the inspection ID. This re-sends the inspection link to the customer via their configured send methods (text, email, or both), using the "request more" message template.

curl -X PUT https://vision-api.truepic.com/v3/text/request \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "inspection_id": 1843
  }'

{
  "response_code": 200,
  "message": "Success",
  "api_version": "3.0.0",
  "result": "https://visionbytruepic.com/23AUkqg1xRb"
}

Mark specific list items as incomplete

To tell the customer which photos or videos need to be retaken, mark individual list items as incomplete. Set include_list to true and provide the list items with incomplete: true on the items that need to be redone.

Each list item in the request must include its existing id so the API knows which item to update.

⚠️

You must include all existing list items in the list.items array — not just the ones you want to mark as incomplete. The API replaces the inspection's entire list with what you provide. Any list items you omit will be removed, and photos or videos previously submitted for those items will become uncategorized because they are no longer associated with an existing list item.

Also, each list item in the request that is staying must include its existing id so the API knows which items to update and keep.

curl -X PUT https://vision-api.truepic.com/v3/text/request \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "inspection_id": 1843,
    "include_list": true,
    "list": {
      "items": [
        {
          "id": 501,
          "name": "Front of vehicle",
          "type": "IMAGE",
          "is_required": true,
          "incomplete": true
        },
        {
          "id": 502,
          "name": "Rear of vehicle",
          "type": "IMAGE",
          "is_required": true
        },
        {
          "id": 503,
          "name": "Driver side",
          "type": "IMAGE",
          "is_required": true
        },
        {
          "id": 504,
          "name": "Passenger side",
          "type": "IMAGE",
          "is_required": false
        }
      ]
    }
  }'

In this example, item 501 is marked as incomplete: true while items 502, 503, and 504 are included as-is to preserve them on the inspection. The customer will see item 501 flagged as incomplete in the Vision app and will be prompted to recapture it.

You can also add new list items to the inspection in the same request. Marking any new item as incomplete: true even though the user didn't have a chance to complete them the first time is a useful way to draw the customer's attention to the new items.

Optional: Include a custom message

Add a message_supplement to attach a custom note to the text or email the customer receives. The note is limited to 255 characters. Note, your Request More template must include the {{message_supplement}} template tag so we can insert this text into the right spot in your message.

curl -X PUT https://vision-api.truepic.com/v3/text/request \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "inspection_id": 1843,
    "message_supplement": "The photos of the front bumper were too blurry. Please retake them in good lighting.",
    "include_list": true,
    "list": {
      "items": [
        {
          "id": 501,
          "name": "Front bumper",
          "type": "IMAGE",
          "is_required": true,
          "incomplete": true
        }
      ]
    }
  }'

Request body reference