---
title: "Save Condition To Library"
method: POST
path: "/api/v1/projects/{project_id}/conditions/{condition_id}/save-to-library"
tags: ["conditions"]
---

# Save Condition To Library

`POST /api/v1/projects/{project_id}/conditions/{condition_id}/save-to-library`

## Request

- Base URL: `https://api.rudus.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rudus.ai/api/v1/projects/{project_id}/conditions/{condition_id}/save-to-library`
- Auth: none declared
- TypeScript: <https://skmtc.dev/rudus/apis/rudus-api/docs/api/v1/projects/:project_id/conditions/:condition_id/save-to-library/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `project_id` string, uuid, required
- `condition_id` string, uuid, required

## Request body

- SaveToLibraryRequest
  - `folder_id` string, uuid, nullable
  - `name` string, nullable

## Response `201`

Successful Response

- SaveToLibraryResponse
  - `template` ConditionTemplate, required
    - `id` string, uuid, required
    - `org_id` string, uuid, required
    - `name` string, required
    - `geometry_kind` 'count' | 'linear' | 'area', required
    - `shape` 'circle' | 'square' | 'rectangle', nullable, required
    - `color` string, required
    - `config` ConditionConfig, required
      - `dimensions` Dimensions: Geometric parameters. Field meaning depends on (geometry_kind, shape). Count + Circle/Square: width_in = diameter/side; height_in = vertical extrusion. Count + Rectangle: width_in = x footprint; thickness_in = y footprint; height_in = vertical extrusion. Linear: height_in (vertical face), thickness_in (material thickness), slope. Area: thickness_in (material thickness), slope. Per ADR-0040 and docs/superpowers/specs/2026-05-27-condition-render-dims-design.md §3.1. Values are decimal inches (ADR-0091); pre-existing integer payloads coerce.
        - `width_in` number, nullable
        - `thickness_in` number, nullable
        - `height_in` number, nullable
        - `slope` string, nullable
      - `tile_module` TileModule
        - `w_in` integer, required
        - `h_in` integer, required
        - `gap_in` integer, required
      - `grid_spacing` GridSpacing
        - `x_in` integer, required
        - `y_in` integer, required
      - `rounding` Rounding
        - `enabled` boolean
        - `increment` number
      - `display` DisplayConfig
        - `name` boolean
        - `dimension` boolean
        - `pattern_while_drawing` boolean
    - `notes` string, nullable, required
    - `attachment_kind` 'area' | 'linear', nullable, required
    - `attachment_config` AttachmentConfig, required
      - `deduct_from_parent` boolean
    - `extension_id` string, uuid, nullable, required
    - `phase_code_id` string, uuid, nullable, required
    - `folder_id` string, uuid, nullable, required
    - `sort_order` number, required
    - `external_id` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `row_version` integer, required
    - `derivations` Derivation[]
      - `id` string, uuid, required
      - `ordinal` integer, required
      - `result_type` 'count' | 'total_height' | 'perimeter' | 'surface_area_top_or_bottom' | 'surface_area_top_and_bottom' | 'surface_area_all_sides' | 'surface_area_full' | 'volume' | 'length' | 'segment_count' | 'surface_area_single_side' | 'surface_area_both_sides' | 'surface_area_single_end' | 'surface_area_both_ends' | 'surface_area_all_side_duct' | 'area' | 'grid_length_visible' | 'grid_length_x_visible' | 'grid_length_y_visible' | 'grid_intersection_count' | 'tile_count_average' | 'tile_count_visible' | 'area_counts', required
      - `uom` 'EA' | 'LF' | 'IN' | 'FT' | 'SF' | 'SY' | 'CF' | 'CY', required
      - `respects_backouts` boolean
      - `respects_attachments` boolean
  - `warnings` string[], required

## Other responses

- `4XX`: Client Error
- `5XX`: Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) - [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rudus/apis/rudus-api/revisions/5673f72c8a5d?raw)