---
title: "Create a partial spec_upload_draft_item"
method: POST
path: "/api/v3/projects/{project_id}/spec_upload_draft_items"
tags: ["spec upload draft items"]
---

# Create a partial spec_upload_draft_item

`POST /api/v3/projects/{project_id}/spec_upload_draft_items`

## Request

- Base URL: `https://client-api.us.fieldwire.com`
- URL: `https://client-api.us.fieldwire.com/api/v3/projects/{project_id}/spec_upload_draft_items`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Headers

- `Fieldwire-Version` string, date, required

## Request body

- SpecUploadDraftItemCreateInput: Schema for creating a spec_upload_draft_item
  - `spec_upload_id` string, uuid: ID of the SpecUpload this spec_upload_draft_item belongs to
  - `draft_item_number` string, nullable: Spec section number on the spec_upload which is encapsulated by this spec_upload_draft_item
  - `title` string, nullable: Title of the spec section which is encapsulated by this spec_upload_draft_item
  - `start_page_number` integer, nullable: The starting page number of the encapsulated spec_section on the associated spec_upload attachment
  - `end_page_number` integer, nullable: The ending page number of the encapsulated spec_section on the associated spec_upload attachment
  - `project_id` string, uuid: ID of the project this spec_upload_draft_item belongs to
  - `creator_user_id` integer: ID of the user who created this spec_upload_draft_item
  - `last_editor_user_id` integer, nullable: ID of the last user who edited this spec_upload_draft_item
  - `device_created_at` string, date-time, nullable: Time when the device created the spec_upload_draft_item
  - `device_updated_at` string, date-time, nullable: Time when the device last updated the spec_upload_draft_item

## Response `201`

Successful response

- SpecUploadDraftItem: A draft entity that encapsulates a spec_section on a given spec_upload.
  - `id` string, uuid, required: ID of the spec_upload_draft_item
  - `spec_upload_id` string, uuid, required: ID of the SpecUpload this spec_upload_draft_item belongs to
  - `draft_item_number` string, nullable, required: Spec section number on the spec_upload which is encapsulated by this spec_upload_draft_item
  - `title` string, nullable, required: Title of the spec section which is encapsulated by this spec_upload_draft_item
  - `start_page_number` integer, nullable, required: The starting page number of the encapsulated spec_section on the associated spec_upload attachment
  - `end_page_number` integer, nullable, required: The ending page number of the encapsulated spec_section on the associated spec_upload attachment
  - `project_id` string, uuid, required: ID of the project this spec_upload_draft_item belongs to
  - `creator_user_id` integer, required: ID of the user who created this spec_upload_draft_item
  - `last_editor_user_id` integer, nullable, required: ID of the last user who edited this spec_upload_draft_item
  - `created_at` string, date-time, required: Time when the server created the spec_upload_draft_item
  - `updated_at` string, date-time, required: Time when the server last updated the spec_upload_draft_item
  - `deleted_at` string, date-time, nullable, required: Time when the server last deleted the spec_upload_draft_item
  - `device_created_at` string, date-time, nullable, required: Time when the device created the spec_upload_draft_item
  - `device_updated_at` string, date-time, nullable, required: Time when the device last updated the spec_upload_draft_item
  - `resolved_conflict` boolean, nullable, required: Specifies if PUT/PATCH request was rejected - do not store this field!

## Other responses

- `404`: Associated spec_upload not found

---

[API](https://skmtc.dev/fieldwire/apis/fieldwire-regional-api.md) - [All operations](https://skmtc.dev/fieldwire/apis/fieldwire-regional-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fieldwire/apis/fieldwire-regional-api/revisions/34b820438c0b?raw)