---
title: "Upload a PDF in one request"
method: POST
path: "/v1/blueprints/upload"
tags: ["Blueprints / Actions"]
---

# Upload a PDF in one request

`POST /v1/blueprints/upload`

## Request

- Base URL: `https://api.kamai.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kamai.io/v1/blueprints/upload`
- Auth: HTTP bearer

Upload a blueprint file directly in the request body.

Suitable for smaller files. For large files, use the two-step
`/upload/init` + `/upload/complete` flow instead.

## Query parameters

- `project_id` string, nullable: Target project ID. When omitted, the user's Default Project is used or created.

## Response `200`

Successful Response

- UploadBlueprintResponse
  - `job_id` string, uuid, required: Unique identifier for the job
  - `upload_id` string, uuid, nullable: Identifier of the whole upload (all pages of the file)
  - `project_id` string, required: Project ID used for the upload

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kamai/apis/kamai-api.md) · [All operations](https://skmtc.dev/kamai/apis/kamai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kamai/apis/kamai-api/revisions/78f938546270?raw)