# Benchling App Definition API

**Canonical:** https://apis.io/apis/benchling/benchling-appdefinition-api/  
**Provider:** Benchling — https://apis.io/providers/benchling/  
**Base URL:** https://{tenant}.benchling.com/api/v2  
**Documentation:** https://docs.benchling.com/docs/developer-platform-overview

Benchling App Definition API is one of 219 APIs that [Benchling](https://apis.io/providers/benchling/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include AppDefinition. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog.

Represents a Benchling App definition, which is the developer-side configuration for an application that can be installed on Benchling tenants. App definitions specify webhook endpoints, configuration keys, and link to versioned releases (see `AppDefinitionVersion`). Each app has a unique clientId for OAuth authentication.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/app-definition` | Create AppDefinition |
| GET | `/app-definition/items` | List AppDefinition items |
| GET | `/app-definition/{app_definition_id}` | Get AppDefinition by ID |
| PATCH | `/app-definition/{app_definition_id}` | Update AppDefinition |
| GET | `/app-definition/{app_definition_id}/versions/items` | List AppDefinitionVersion items |
| POST | `/app-definition/{app_definition_id}:upsert-version` | Upsert App Definition Version |
| POST | `/app-definition:batch-create` | Batch create AppDefinition |
| PATCH | `/app-definition:batch-update` | Batch update AppDefinition |
| POST | `/app-definition:bulk-create` | Bulk create AppDefinition |
| PATCH | `/app-definition:bulk-update` | Bulk update AppDefinition |

## Machine-readable artifacts (14)

- **OpenAPI** — https://artifacts.apis.io/benchling/openapi/benchling-appdefinition-api-openapi.yml
- **OpenAPIRemote** — https://benchling.com/api/v3/openapi.yaml
- **Documentation** — https://docs.benchling.com/docs/developer-platform-overview
- **APIReference** — https://benchling.com/api/v3/reference
- **Authentication** — https://artifacts.apis.io/benchling/authentication/benchling-authentication.yml
- **Conventions** — https://artifacts.apis.io/benchling/conventions/benchling-conventions.yml
- **ErrorCatalog** — https://artifacts.apis.io/benchling/errors/benchling-problem-types.yml
- **DataModel** — https://artifacts.apis.io/benchling/data-model/benchling-data-model.yml
- **Webhooks** — https://artifacts.apis.io/benchling/asyncapi/benchling-webhooks.yml
- **RateLimits** — https://artifacts.apis.io/benchling/rate-limits/benchling-rate-limits.yml
- **Lifecycle** — https://artifacts.apis.io/benchling/lifecycle/benchling-lifecycle.yml
- **ChangeLog** — https://artifacts.apis.io/benchling/changelog/benchling-changelog.yml
- **StabilityPolicy** — https://docs.benchling.com/docs/stability-guidelines
- **SDKs** — https://artifacts.apis.io/benchling/packages/benchling-packages.yml

## Other Benchling APIs (12)

- [Benchling AA Sequences API](https://apis.io/apis/benchling/benchling-aa-sequences-api/)
- [Benchling Apps API](https://apis.io/apis/benchling/benchling-apps-api/)
- [Benchling Assay Results API](https://apis.io/apis/benchling/benchling-assay-results-api/)
- [Benchling Assay Runs API](https://apis.io/apis/benchling/benchling-assay-runs-api/)
- [Benchling Audit API](https://apis.io/apis/benchling/benchling-audit-api/)
- [Benchling Authentication API](https://apis.io/apis/benchling/benchling-authentication-api/)
- [Benchling Blobs API](https://apis.io/apis/benchling/benchling-blobs-api/)
- [Benchling Boxes API](https://apis.io/apis/benchling/benchling-boxes-api/)
- [Benchling Codon Usage Tables API](https://apis.io/apis/benchling/benchling-codon-usage-tables-api/)
- [Benchling Connect API](https://apis.io/apis/benchling/benchling-connect-api/)
- [Benchling Containers API](https://apis.io/apis/benchling/benchling-containers-api/)
- [Benchling Custom Entities API](https://apis.io/apis/benchling/benchling-custom-entities-api/)

## Tags

AppDefinition

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/benchling/benchling-appdefinition-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/benchling/.