---
title: "Create or update a registered RNA oligo"
method: PATCH
path: "/rna-oligos/{entity_registry_id}:upsert"
tags: ["rnaOligos"]
---

# Create or update a registered RNA oligo

`PATCH /rna-oligos/{entity_registry_id}:upsert`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/rna-oligos/{entity_registry_id}:upsert`
- Auth: HTTP bearer

Create or update a registered RNA oligo.

Schema field links can be populated using entity registry IDs or API IDs. In the `value` field of the `Field` resource, the object `{"entityRegistryId": ENTITY_REGISTRY_ID}` may be provided instead of the API ID if desired (see example value).

## Path parameters

- `entity_registry_id` string, required

## Request body

- OligoUpsertRequest
  - `archiveRecord` ArchiveRecordSet: Currently, we only support setting a null value for archiveRecord, which unarchives the item
  - `fields` FieldsWithResolution
  - `name` string, required: Name of the Oligo.
  - `registryId` string, required
  - `schemaId` string, required: ID of the oligo's schema.
  - `aliases` string[]: Aliases to add to the Oligo
  - `authorIds` string[]: IDs of users to set as the Oligo's authors.
  - `bases` string: Base pairs of the oligo.
  - `customFields` CustomFields
  - `folderId` string: ID of the folder containing the Oligo.

## Response `200`

Updated

- unknown

## Other responses

- `400`: Bad Request

---

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