---
title: "Create Book copy jobs"
method: POST
path: "/v1/book/copy-jobs"
tags: ["Encore"]
---

# Create Book copy jobs

`POST /v1/book/copy-jobs`

This API submits asynchronous copy requests that duplicate a <<glossary:Book>> and all uploaded documents to a specified recipient organization. Each request creates a job. You can monitor job status using the [List Book Copy Jobs](https://docs.ocrolus.com/reference/list-book-copy-jobs) endpoint.
### Supported workflows
1. **Updating existing applications**: Use a prior share label on the Book you are sharing so the new docs are appended to existing Book. Prevents duplicate Books when an applicant submits additional or missing documents.
2. **Renewal/re-engagement**: This workflows support two approaches. You can create a new Book by using either a new shared Book label to initiate a new application with receivers, or a previously used shared Book label to associate the new application with an existing one. Alternatively, you can reuse an existing Book, similar to the application update workflow.

To learn more, see the [Sender's guide](https://docs.ocrolus.com/docs/senders#supported-workflows).

> 👍 Suggestion
> We recommend using new share labels for re-engagement and renewal applications to avoid creating confusion on the receiver's side.

> 📘 Note
> - This API is intended for small and medium business (SMB) funders.
> - This API supports a maximum of 50 requests per call meaning you can include up to 50 Book copy requests in a single API call. If you need to process more, split them into multiple calls.

## Request body

- object
  - `Copy Requests` object[] — An array of copy requests for Books to be copied to recipient organizations.
    - `book_uuid` string, required — Unique identifier (UUID) of the Book to be copied.
    - `org_uuid` string, required — Unique identifier (UUID) of the recipient organization.
    - `shared_book_label` string — Optional label for the shared Book in the recipient organization. Maximum length limit is 255 characters.
    - `doc_uuids` string[] — Optional list of document UUIDs to be copied from the source Book. If not provided, all documents from the source Book will be shared by default.

## Response `200`

Success

- object
  - `copy_jobs` object[] — A list of copy job objects.
    - `job_id` string — The unique identifier (UUID) for the copy job.
    - `book_uuid` string — The UUID of the Book.
    - `org_uuid` string — The UUID of the recipient organization.
    - `status` string — The status of the copy job. Possible values: - **`PENDING`**: Job created, awaiting processing. - **`AWAITING_RECIPIENT`**: Waiting for recipient acceptance. - **`IN_PROGRESS`**: Currently processing. - **`SUCCESSFUL`**: Completed successfully. - **`REJECTED`**: Rejected by recipient. - **`FAILED`**: Failed with error.
    - `created_ts` string, date-time — The timestamp when the copy job was created.
    - `shared_book_label` string — An optional unique identifier assigned for each individual Book share request.

## Other responses

- `400` — Client Errors
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.net/ocrolus/apis/user-management.md) · [All operations](https://skmtc.net/ocrolus/apis/user-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocrolus/user-management/versions/3571ef602d13/schema)