---
title: "Accept Book copy jobs"
method: POST
path: "/v1/book/copy-jobs/{job_id}/accept"
tags: ["Encore"]
---

# Accept Book copy jobs

`POST /v1/book/copy-jobs/{job_id}/accept`

This API enables a recipient organization to accept an incoming <<glossary:Book>> copy request. Once accepted, Ocrolus begins copying the Book and its associated documents to the recipient organization. The recipient may optionally change the Book name when accepting a Book copy request. Alternatively, the recipient can rename the Book after it has been accepted.
A `book.copy.request_accepted` webhook event is then triggered and sent to the sender organization.

> 📘 Note
> - This API is intended for small and medium business (SMB) funders using the Book copy feature. 
> - A Book copy job can be accepted only when its status is `AWAITING_RECIPIENT` or `REJECTED`.

## Path parameters

- `job_id` string, uuid, required

## Request body

- object
  - `book_name` string — Custom name for the copied Book. If not provided, the Book will be named using the sender's original Book name followed by a timestamp. > 📘 Book name sanitization > - The provided `book_name` is automatically cleaned. > - The Book name must be between 4 and 255 characters long. > - Leading and trailing whitespace is removed. > - Non-ASCII characters such as emojis or special Unicode characters are removed. > - If the resulting name is empty after sanitization, a 400 error is returned.

## Response `204`

The Book copy job was successfully accepted.

- object
  - `message` object — The Book copy job was successfully accepted. > 📘 When a Book is successfully accepted, the API returns a `204 No Content` response with no response body. Since no payload is returned, an example response is not shown.

## Other responses

- `400` — Client Errors
- `404` — Job ID not found
- `412` — Trying to accept in invalid state
- `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/revisions/3571ef602d13/schema)