---
title: "Create documents on the company an answer request is about"
method: POST
path: "/api/questionnaires/requests/{requestId}/documents"
tags: ["Questionnaire Responses"]
---

# Create documents on the company an answer request is about

`POST /api/questionnaires/requests/{requestId}/documents`

Uploads documents as the answer to a DOCUMENTS question, filed on the company the request is *about*. The target company is taken from the request's `onBehalfOfCompanyId` and is deliberately **not** accepted in the body, so this grant cannot be aimed at any other company. Only the answering company (`forCompanyId`) may call it, and only while the brand that issued the request is still connected to it; anyone else gets 404 `request_not_found`, so the existence of another company's request is never confirmed. Where the generic `POST /v3/company-documents/bulk-create` requires the target to be in the caller's own network — which a delegated answering party never is — this route treats the request itself as the authorization. Each document is filed on the subject company with the caller as its owner, is never public, and is auto-shared with the brand that asked, which is what makes it visible to all three parties. Files must belong to the caller; any that do not are skipped rather than failing the batch. Responds 201 with the created ids.

## Path parameters

- `requestId` string, required

## Request body

- object
  - `documents` object[], required
    - `fileId` string, required
    - `name` string
    - `documentTypeId` string

## Response `201`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `documents` object[], required
      - `id` string, required
      - `name` string, required
      - `documentTypeId` string, required
      - `fileId` string, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

## Changes

> 21 revisions in range; 1 not diffed.

- **2026-08-24** `d1450ba9a75a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/questionnaires/requests/:requestId/documents/post.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/1df37791a1bb/schema)