> ## Documentation Index
> Fetch the complete documentation index at: https://docs.printools.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Proofs and mocks

> Artwork sent for approval, and the approval itself.

Use the operations below to work with proofs & mocks. Each link opens an interactive reference page generated from the published OpenAPI specification.

## Operations

| Operation                                                                                                    | Method and path                                          | Required scopes  |
| ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | ---------------- |
| [List mocks, filtered by job, quote or quote group. Not paginated](/api/reference/get_v1_mocks)              | `GET /v1/mocks`                                          | `proofs.read`    |
| [Create a mock](/api/reference/post_v1_mocks)                                                                | `POST /v1/mocks`                                         | `proofs.write`   |
| [One mock by id](/api/reference/get_v1_mocks_mockId)                                                         | `GET /v1/mocks/{mockId}`                                 | `proofs.read`    |
| [Update a mock](/api/reference/patch_v1_mocks_mockId)                                                        | `PATCH /v1/mocks/{mockId}`                               | `proofs.write`   |
| [Delete a mock](/api/reference/delete_v1_mocks_mockId)                                                       | `DELETE /v1/mocks/{mockId}`                              | `proofs.write`   |
| [One proof with its full revision history](/api/reference/get_v1_proofs_proofId_history)                     | `GET /v1/proofs/{proofId}/history`                       | `proofs.read`    |
| [Create a proof](/api/reference/post_v1_proofs)                                                              | `POST /v1/proofs`                                        | `proofs.write`   |
| [Update a proof](/api/reference/patch_v1_proofs_proofId)                                                     | `PATCH /v1/proofs/{proofId}`                             | `proofs.write`   |
| [Delete a proof](/api/reference/delete_v1_proofs_proofId)                                                    | `DELETE /v1/proofs/{proofId}`                            | `proofs.write`   |
| [Email a proof to the customer](/api/reference/post_v1_proofs_proofId_send)                                  | `POST /v1/proofs/{proofId}/send`                         | `proofs.write`   |
| [Email several proofs in one message](/api/reference/post_v1_proofs_send)                                    | `POST /v1/proofs/send`                                   | `proofs.write`   |
| [Open a new revision of a proof](/api/reference/post_v1_proofs_proofId_revise)                               | `POST /v1/proofs/{proofId}/revise`                       | `proofs.write`   |
| [Set a proof status directly, including approved](/api/reference/post_v1_proofs_proofId_status)              | `POST /v1/proofs/{proofId}/status`                       | `proofs.approve` |
| [Record the client’s decision on a proof](/api/reference/post_v1_proofs_proofId_client_decision)             | `POST /v1/proofs/{proofId}/client-decision`              | `proofs.approve` |
| [Confirm the size split on a proof item](/api/reference/post_v1_proof_item_links_proofItemLinkId_size_split) | `POST /v1/proof-item-links/{proofItemLinkId}/size-split` | `proofs.approve` |

See [Authentication](/api/authentication) before your first call. For write retries, see [Writing safely](/api/idempotency).
