---
title: "Adds a document to an assessment for a monitored company."
method: POST
path: "/api/v2/companies/{id}/assessments/{assessmentId}/documents"
tags: ["Assessment"]
---

# Adds a document to an assessment for a monitored company.

`POST /api/v2/companies/{id}/assessments/{assessmentId}/documents`

## Request

- Base URL: `https://app.blackkitetech.com`
- URL: `https://app.blackkitetech.com/api/v2/companies/{id}/assessments/{assessmentId}/documents`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.blackkitetech.com//api/v2/oauth/token`
- TypeScript: <https://skmtc.dev/blackkitetech/apis/black-kite-api/docs/api/v2/companies/:id/assessments/:assessmentId/documents/post.ts> (a function with typed inputs; its response is checked against the schema)

Uploads a document to the specified assessment for the given company.

## Path parameters

- `id` integer, required
- `assessmentId` integer, required

## Request body `multipart/form-data`

- object
  - `fileName` string, binary, required: The binary content of the file to be uploaded. Supported file extensions: .xlsx, .xls, .xlsm, .docx, .doc, .txt, .pdf, .csv, .md
  - `isStorable` boolean: Indicates whether the uploaded document should be persistently stored in the system. If true, the document will be retained and accessible for future reference; if false, the document will be permanently deleted after processing is complete.
  - `password` string: If the uploaded document is password-protected, enter its password here. This is required to access the document's content. Leave blank if the document is not protected.

## Response `200`

Document uploaded successfully.

- object
  - `DocumentId` integer: This is the id of the assessment document. Use this id as a query parameter in the getAssessmentDocumentDetail action to retrieve the document status and details.

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `404`: Not Found
- `default`: Failure

---

[API](https://skmtc.dev/blackkitetech/apis/black-kite-api.md) - [All operations](https://skmtc.dev/blackkitetech/apis/black-kite-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blackkitetech/apis/black-kite-api/revisions/0950b35c0e4a?raw)