---
title: "Add Job Document"
method: POST
path: "/jobs/{jobId}/documents"
tags: ["jobs"]
---

# Add Job Document

`POST /jobs/{jobId}/documents`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/jobs/{jobId}/documents`
- Auth: HTTP bearer

Use this endpoint to add a job document for a specific job.  Special characters and spaces will be removed from the file name before upload.

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Path parameters

- `jobId` string, uuid, required

## Request body `multipart/form-data`

- AddJobDocumentPost
  - `file` string, binary, required: The following file types are not allowed: .exe, .com, .dll, .msi, .bat, .cmd, .sh, .pl, .vbs, .py, .php
  - `description` string: A brief description of the file being uploaded
  - `documentFolderId` string, uuid, required: Indicates the folder ID where the job document will be saved.
  - `externalId` string: A field to link the file with a job external reference identifier
  - `externalSource` string: A field to link the file with a job external reference source

## Response `202`

Accepted

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `429`: The rate limit for this operation has been exceeded. Use the RateLimit-* response headers to determine when you can retry.

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)