---
title: "Get AppConfigValue by ID"
method: GET
path: "/api/v3/app-config-value/{app_config_value_id}"
tags: ["App Config Value"]
---

# Get AppConfigValue by ID

`GET /api/v3/app-config-value/{app_config_value_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/app-config-value/{app_config_value_id}`
- Auth: HTTP bearer

Get a single AppConfigValue by ID.

## Path parameters

- `app_config_value_id` string, required

## Query parameters

- `returning` string[]
- `omit` string[]

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- AppConfigValue: Represents a configured value for a Benchling App on a specific tenant. Each config value has a path identifying its location in the configuration hierarchy and valueData containing the actual value. Config values are defined by the app's configuration spec and set during installation or later configuration.
  - `__typename` string
  - `createdAt` string, datetime, nullable: DateTime at which the config value was created.
  - `description` string, nullable
  - `id` string
  - `modifiedAt` string, datetime, nullable: DateTime at which the config value was last modified.
  - `path` string[]
  - `valueData` union: A union of all possible value types stored in an AppConfigValue. Primitive types carry their native scalar, EntitySchemaAppConfigValue carries a subtype, and ResourceAppConfigValue handles all other Benchling object and schema references via a type discriminator.
    - object: Stores an element value within an array-type app configuration.
      - `__typename` string, required
      - `value` string, nullable
    - object: Stores a boolean value in an app configuration field.
      - `__typename` string, required
      - `value` boolean, nullable
    - object: Stores a date value in an app configuration field.
      - `__typename` string, required
      - `value` string, date, nullable
    - object: Stores a datetime value in an app configuration field.
      - `__typename` string, required
      - `value` string, nullable
    - object: Stores a reference to an entity schema in an app configuration field. Kept separate from ResourceAppConfigValue because it carries a subtype identifying the kind of entity (DNA sequence, AA sequence, etc.).
      - `__typename` string, required
      - `subtype` 'AA_SEQUENCE' | 'CUSTOM_ENTITY' | 'DNA_OLIGO' | 'DNA_SEQUENCE' | 'MIXTURE' | 'MOLECULE' | 'RNA_OLIGO' | 'RNA_SEQUENCE': Identifies the entity subtype of the configured schema (e.g. DNA_SEQUENCE, AA_SEQUENCE).
      - `value` string, nullable
    - object: Stores a floating-point number value in an app configuration field.
      - `__typename` string, required
      - `value` number, double, nullable
    - object: Stores an integer value in an app configuration field.
      - `__typename` string, required
      - `value` integer, nullable
    - object: Stores a JSON value (as a string) in an app configuration field.
      - `__typename` string, required
      - `value` string, nullable
    - object: Stores a reference to any Benchling object or schema that is identified by a resource ID. The type field identifies what kind of resource is referenced, matching the BenchlingAppType values used in app manifests. Covers all linked resource types except EntitySchema (which has a subtype) and array elements.
      - `__typename` string, required
      - `type` 'BOX_SCHEMA' | 'CONTAINER_SCHEMA' | 'ENTRY_SCHEMA' | 'LEGACY_REQUEST_SCHEMA' | 'LOCATION_SCHEMA' | 'PLATE_SCHEMA' | 'RESULT_SCHEMA' | 'RUN_SCHEMA' | 'WORKFLOW_TASK_SCHEMA' | 'AA_SEQUENCE' | 'ASSAY_RESULT' | 'ASSAY_RUN' | 'AUTOMATION_INPUT_GENERATOR' | 'AUTOMATION_OUTPUT_PROCESSOR' | 'BLOB' | 'BOX' | 'CONTAINER' | 'CUSTOM_ENTITY' | 'DNA_ALIGNMENT' | 'DNA_OLIGO' | 'DNA_SEQUENCE' | 'DROPDOWN' | 'DROPDOWN_OPTION' | 'ENTRY' | 'FIELD' | 'FOLDER' | 'LEGACY_REQUEST' | 'LOCATION' | 'MIXTURE' | 'MOLECULE' | 'PLATE' | 'PROJECT' | 'REGISTRY' | 'RNA_OLIGO' | 'RNA_SEQUENCE' | 'WORKFLOW_TASK_STATUS' | 'WORKLIST'
      - `value` string, nullable
    - object: Stores a secure (encrypted) text value in an app configuration field. Used for sensitive data like API keys or credentials.
      - `__typename` string, required
      - `value` string, nullable
    - object: Stores a text string value in an app configuration field.
      - `__typename` string, required
      - `value` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `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)