---
title: "Update the status of a document (v2)"
method: PUT
path: "/v2/documents/{id}"
---

# Update the status of a document (v2)

`PUT /v2/documents/{id}`

## Path parameters

- `id` integer, required

## Request body

- object
  - `upload_status` string, required — Update the upload status of the document to the Amazon S3. Allowed values are 'Completed' or 'Failed'.

## Response `200`

200

- object
  - `document` object
    - `id` integer
    - `category` string
    - `ref_no` string
    - `notes` string
    - `doc_date` string
    - `doc_fields` object
      - `notes` string
    - `doc_time` string
    - `uploader` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `email` string
      - `role` string
      - `deactivated_at` unknown
      - `driver_company_id` unknown
    - `attachments` object[]
      - `id` integer
      - `name` string
      - `upload_url` string
      - `doc_type` string
      - `offline_id` unknown
    - `field_docs` unknown
    - `created_at` string
    - `updated_at` string

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/versions/c71780e497f5/schema)