---
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`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v1/book/copy-jobs/{job_id}/accept`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

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.dev/ocrolus/apis/encore.md) - [All operations](https://skmtc.dev/ocrolus/apis/encore/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/encore/revisions/09ef8c1b8910?raw)