---
title: "Create a new spec_section"
method: POST
path: "/api/v3/projects/{project_id}/spec_sections"
tags: ["spec sections"]
---

# Create a new spec_section

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

## Path parameters

- `project_id` string, uuid, required

## Headers

- `Fieldwire-Version` string, date, required

## Request body

- SpecSectionCreateInput — Schema for creating a spec_section. Creates an associated spec_section_version.
  - `section_number` string — The number that the spec_section corresponds to within a spec book
  - `project_id` string, uuid — ID of the project the spec_section belongs to
  - `current_version_id` string, uuid, nullable — ID of the current spec_section_version of the spec_section
  - `creator_user_id` integer — ID of the user who created the spec_section
  - `last_editor_user_id` integer, nullable — ID of the last user who edited the spec_section
  - `device_created_at` string, date-time — Time when the device created the spec_section
  - `device_updated_at` string, date-time — Time when the device last updated the spec_section
  - `file_url` string — File url to a PDF of the spec_section
  - `name` string — File name for the attachment
  - `version_title` string, required — Title of the spec_section_version
  - `version_description` string, required — Description of the spec_section_version

## Response `201`

Successful response

- SpecSection — An entity that represents a spec section within a spec book. Can have multiple versions.
  - `id` string, uuid, required — ID of the spec_section
  - `section_number` string, required — The number that the spec_section corresponds to within a spec book
  - `project_id` string, uuid, required — ID of the project the spec_section belongs to
  - `current_version_id` string, uuid, nullable, required — ID of the current spec_section_version of the spec_section
  - `current_version_title` string, required — Title of the current spec_section_version of the spec_section
  - `current_version_description` string, required — Description of the spec_section_version of the spec_section
  - `current_version_file_url` string, nullable, required — The URL for the PDF associated with the current spec_section_version of the spec_section
  - `current_version_thumb_url` string, nullable, required — The URL for the thumbnail associated with the current spec_section_version of the spec_section
  - `conflict` boolean, required — Indicates a version conflict on the spec_section
  - `processing` boolean, required — Indicates the processing status of the spec_section
  - `error` boolean — Indicates whether the spec_section contains an error
  - `creator_user_id` integer, required — ID of the user who created the spec_section
  - `last_editor_user_id` integer, nullable, required — ID of the last user who edited the spec_section
  - `created_at` string, date-time, required — Time when the server created the spec_section
  - `updated_at` string, date-time, required — Time when the server last updated the spec_section
  - `deleted_at` string, date-time, nullable, required — Time when the server last deleted the spec_section
  - `device_created_at` string, date-time, required — Time when the device created the spec_section
  - `device_updated_at` string, date-time, required — Time when the device last updated the spec_section

---

[API](https://skmtc.dev/fieldwire/apis/fieldwire-super-api.md) · [All operations](https://skmtc.dev/fieldwire/apis/fieldwire-super-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fieldwire/fieldwire-super-api/revisions/66ee1c20b92d/schema)