---
title: "Create proof"
method: POST
path: "/sheets/{sheetId}/rows/{rowId}/proofs"
tags: ["proofs"]
---

# Create proof

`POST /sheets/{sheetId}/rows/{rowId}/proofs`

Creates a proof on a row.

## Headers

- `Content-Type` string

## Response `200`

SUCCESS

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `result` Proof — Object containing zero or more media items, including images, videos, and documents, for review, editing, or approval.
    - `id` number — Proof ID of the proof version.
    - `originalId` number — Proof ID of the original proof version.
    - `name` string — Proof name. This is the same as primary column value. If the primary column value is empty, name is empty.
    - `type` 'DOCUMENT' | 'IMAGE' | 'MIXED' | 'NONE' | 'VIDEO' — File type for the proof version.
    - `documentType` string — If `type=DOCUMENT`, then this indicates the type of file, such as PDF.
    - `proofRequestUrl` string — URL to review a proofing request.
    - `version` number — The version number of the proof.
    - `lastUpdatedAt` union
      - string, date-time
      - number
    - `lastUpdatedBy` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `isCompleted` boolean — Indicates whether the proof is completed.
    - `attachments` Attachment[] — Array of Attachment objects. Only returned if the include query string parameter contains attachments.
      - `id` number — Attachment ID.
      - `parentId` number — The ID of the parent.
      - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
      - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
      - `mimeType` string — Attachment MIME type.
      - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
      - `createdAt` union
        - string, date-time
        - number
      - `createdBy` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `name` string — Attachment name.
      - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
      - `url` string — Attachment temporary URL (files only).
      - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
    - `discussions` Discussion[] — Array of Discussion objects. Only returned if the include query string parameter contains discussions.
      - `accessLevel` 'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER'
      - `id` number — Discussion ID.
      - `comments` Comment[] — Array of comments in discussion. Only returned if the include query string parameter contains comments.
        - `attachments` Attachment[] — Array of attachments on comments.
          - `id` number — Attachment ID.
          - `parentId` number — The ID of the parent.
          - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
          - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
          - `mimeType` string — Attachment MIME type.
          - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
          - `createdAt` union
            - string, date-time
            - number
          - `createdBy` MiniUser — MiniUser Object
            - `email` string, email
            - `name` string
          - `name` string — Attachment name.
          - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
          - `url` string — Attachment temporary URL (files only).
          - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
        - `createdAt` union
          - string, date-time
          - number
        - `createdBy` MiniUser — MiniUser Object
          - `email` string, email
          - `name` string
        - `discussionId` number — Discussion ID of discussion that contains comment.
        - `id` number — Comment ID.
        - `modifiedAt` union
          - string, date-time
          - number
        - `text` string — Comment body.
      - `commentAttachments` Attachment[] — Array of attachments on discussion comments. Only returned if the include query string parameter contains attachments.
        - `id` number — Attachment ID.
        - `parentId` number — The ID of the parent.
        - `attachmentType` 'BOX_COM' | 'DROPBOX' | 'EGNYTE' | 'EVERNOTE' | 'FILE' | 'GOOGLE_DRIVE' | 'LINK' | 'ONEDRIVE' | 'TRELLO' — Attachment type. Note--Dropbox, Egnyte, and Evernote are not supported for Smartsheet.gov accounts.
        - `attachmentSubType` 'DOCUMENT' | 'DRAWING' | 'FOLDER' | 'PDF' | 'PRESENTATION' | 'SPREADSHEET' — Attachment sub type. Note--Folder type is for EGNYTE values and the rest are GOOGLE_DRIVE values.
        - `mimeType` string — Attachment MIME type.
        - `parentType` 'COMMENT' | 'PROOF' | 'ROW' | 'SHEET' — The type of object the attachment belongs to.
        - `createdAt` union
          - string, date-time
          - number
        - `createdBy` MiniUser — MiniUser Object
          - `email` string, email
          - `name` string
        - `name` string — Attachment name.
        - `sizeInKb` number — The size of the file, if the attachmentType is FILE.
        - `url` string — Attachment temporary URL (files only).
        - `urlExpiresInMillis` number — Attachment temporary URL time to live (files only).
      - `commentCount` number — Number of comments in the discussion.
      - `createdBy` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `lastCommentedAt` union
        - string, date-time
        - number
      - `lastCommentedUser` MiniUser — MiniUser Object
        - `email` string, email
        - `name` string
      - `parentId` number — The ID of the associated row or sheet.
      - `parentType` 'ROW' | 'SHEET' — Type of parent object.
      - `readOnly` boolean — Indicates whether the user can modify the discussion.
      - `title` string — Title automatically created by duplicating the first 100 characters of top-level comment.
  - `version` number, nullable — New version of the sheet. Applicable only for operations which update sheet data.

---

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