---
title: "Batch create FeatureLibraryItem"
method: POST
path: "/api/v3/feature-library-item:batch-create"
tags: ["Feature Library Item"]
---

# Batch create FeatureLibraryItem

`POST /api/v3/feature-library-item:batch-create`

## Request

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

Batch create FeatureLibraryItem synchronously in one transaction. Maximum 25 items per request.

## Request body

- object
  - `items` CreateFeatureLibraryItemInput[], required
    - `color` string, required: Must be a valid hex color string (for example, `#F58A5E`).
    - `featureLibraryId` string, required: Feature library id to contain this feature. Each library supports at most 5,000 items.
    - `featureType` string: The type of the Feature Library Item, like gene, promoter, etc. Note: This is an arbitrary string, not an enum
    - `matchType` 'NUCLEOTIDE' | 'AA_SEQUENCE', required: Determines how `pattern` is interpreted during auto-annotation (`NUCLEOTIDE` or `AA_SEQUENCE`). Required on create and cannot be changed on update.
    - `name` string, required: Item names must be non-empty after trimming whitespace and at most 255 characters.
    - `pattern` string, required: 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 `201`

Created

- FeatureLibraryItemBatchcreateResponse201
  - `items` FeatureLibraryItem[], required
    - `__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/c9f087b98b8b?raw)