# EmployeeDocumentItem

> A single item: attach `documents` to the worker identified by `worker_id`.

A single item: attach \`documents\` to the worker identified by \`worker\_id\`.

# EmployeeDocumentItem

A single item: attach `documents` to the worker identified by `worker_id`.

**worker\_id** string required

Id of the worker to attach documents to.

**documents** object\[\] required

Documents to attach to the role. At least one required. Each entry references a FileUploadTracker by file\_id.

-   Array \[
    

**file\_id** string required

Id of a FileUploadTracker in ACTIVE status whose file should become a document on the hire

**name** string

Document name. Defaults to the uploaded file name when omitted.

**signature\_date** string

Signature date in YYYY-MM-DD format.

-   \]
    

**folder\_id** string

Optional destination folder for documents. Accepts either: (1) an ObjectId string for custom folders, or (2) a default folder identifier ('root', 'confidential\_documents', 'notices', 'work\_authorization'). When omitted, documents land at the root of the worker's profile (current default behavior). When supplied, the folder must exist, be in an active state, be provisioned for the target worker, and the caller must have UPLOAD permission on it — otherwise behavior is governed by `on_invalid_folder`.

**on\_invalid\_folder** string

**Possible values:** \[`fail`, `fallback_to_root`\]

Fallback behavior when `folder_id` is supplied but inaccessible. 'fail' (default) rejects each affected document with FOLDER\_ACCESS\_ERROR. 'fallback\_to\_root' uploads to the worker's root profile instead and attaches a FOLDER\_ACCESS\_FALLBACK warning to each result. Ignored when `folder_id` is omitted.

Source: https://developer.rippling.com/documentation/rest-api/reference/schemas/employeedocumentitem

> For the complete documentation index, see [llms.txt](https://developer.rippling.com/llms.txt). Public pages have a Markdown version at the same URL with .md added.