---
title: "Import a client-provided HTTPS attachment reference from an administrator-approved origin. If the client cannot expose the attachment, use signed upload or chunks. No arbitrary website fetching."
method: POST
path: "/me/documents/import"
---

# Import a client-provided HTTPS attachment reference from an administrator-approved origin. If the client cannot expose the attachment, use signed upload or chunks. No arbitrary website fetching.

`POST /me/documents/import`

## Request

- Base URL: `https://api.hiddenjobs.dev/v1`
- URL: `https://api.hiddenjobs.dev/v1/me/documents/import`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hiddenjobs.dev/v1/oauth/authorize`, token URL `https://api.hiddenjobs.dev/v1/oauth/token`, scopes: `email`)

## Request body

- object
  - `sourceUrl` string, required
  - `filename` string, required
  - `mimeType` 'application/pdf' | 'text/plain' | 'text/markdown' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', required
  - `kind` 'cv' | 'cover_letter' | 'interview' | 'template' | 'report' | 'other', required
  - `requestId` string, required: Stable unique key for this intended write. Reuse it only when retrying the same arguments.

## Response `200`

Operation result

- object
  - `data` unknown, required

## Other responses

- `400`: Invalid arguments
- `401`: Invalid credentials
- `403`: Permission denied
- `404`: Record not found
- `409`: Revision, idempotency or state conflict
- `413`: Size or quota limit
- `429`: Request limit
- `503`: Temporarily unavailable

---

[API](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api.md) · [All operations](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/revisions/c1d57d8e4720?raw)