---
title: "Update FeatureLibraryItem"
method: PATCH
path: "/api/v3/feature-library-item/{feature_library_item_id}"
tags: ["Feature Library Item"]
---

# Update FeatureLibraryItem

`PATCH /api/v3/feature-library-item/{feature_library_item_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/feature-library-item/{feature_library_item_id}`
- Auth: HTTP bearer

Update FeatureLibraryItem.

## Path parameters

- `feature_library_item_id` string, required

## Request body

- UpdateFeatureLibraryItemInput
  - `color` string: Must be a valid hex color string (for example, `#F58A5E`).
  - `featureLibraryId` string: New feature library id to contain this feature.
  - `featureType` string, nullable: The type of the Feature Library Item, like gene, promoter, etc. Note: This is an arbitrary string, not an enum
  - `name` string: Item names must be non-empty after trimming whitespace and at most 255 characters.
  - `pattern` string: Patterns must be non-empty and valid for the item's `matchType`. Nucleotide patterns accept IUPAC bases plus wildcards (`#`, `<`, `>`, `()`). Amino acid patterns accept standard residues plus the same wildcard characters. Patterns are compared case-insensitively within a library, so two items cannot differ only by letter case.

## Response `200`

OK

- FeatureLibraryItem: Represents a single feature definition within a FeatureLibrary used for auto-annotation. Each item defines a searchable pattern (nucleotide or amino acid sequence), a feature type classification (such as 'gene', 'promoter', or 'domain'), a display name, and a color for visualization. When auto-annotate runs against a sequence, the pattern is matched according to the matchType (see FeatureLibraryMatchType), and matching regions are annotated with the item's name, type, and color. Patterns can include special characters for flexible matching, such as wildcards for arbitrary bases or optional flanking regions.
  - `__typename` string
  - `color` string: The color of the annotations generated by the Feature Library Item. Must be a valid hex string
  - `createdAt` string, datetime: DateTime the Feature Library Item was created
  - `featureLibrary` FeatureLibraryRef
    - `__typename` string
    - `id` string, api_id
  - `featureType` string, nullable: The type of the Feature Library Item, like gene, promoter, etc. Note: This is an arbitrary string, not an enum
  - `id` string
  - `matchType` 'NUCLEOTIDE' | 'AA_SEQUENCE': The match type of the Feature Library Item. Used to determine how auto-annotate matches are made
  - `modifiedAt` string, datetime: DateTime the Feature Library Item was last modified
  - `name` string: The name of the Feature Library Item
  - `pattern` string: The pattern used for matching during auto-annotation

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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