---
title: "Update a cell component by ID"
method: PATCH
path: "/cell_components/{component_id}"
tags: ["Cell Components"]
---

# Update a cell component by ID

`PATCH /cell_components/{component_id}`

Update an existing cell component identified by its ID.

Only components in the current organization can be updated.

## Path parameters

- `component_id` string, required

## Request body

- UpdateCellComponent — Model for updating an existing cell component. All fields are optional.
  - `component_type` 'cathode' | 'anode' | 'electrolyte' | 'separator' | 'case' | 'cell' — Enum for cell component types.
  - `material_id` string, nullable — New material ID
  - `properties` object, nullable — New properties

## Response `200`

Successful Response

- CellComponent — Model representing a cell component as returned by the API.
  - `component_type` 'cathode' | 'anode' | 'electrolyte' | 'separator' | 'case' | 'cell', required — Enum for cell component types.
  - `material_id` string, required — ID of the material
  - `properties` object, nullable — Application properties using Quantity format for numerics. Example: {'diameter': {'value': 14, 'unit': 'mm'}, 'binder': 'PVDF'}
  - `id` string, required — Unique identifier for the component
  - `organization_id` string, required — Organization ID of the component
  - `project_id` string, required — Project the component is scoped to, derived from the cell specification(s) that reference it.
  - `created_at` string, date-time, required — Timestamp when the component was created
  - `updated_at` string, date-time, required — Timestamp when the component was last updated
  - `created_by` string, nullable — User ID of the creator.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)