Collaborative Drug Discovery Plates API
Plates of wells
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/collaborative-drug-discovery:collaborative-drug-discovery-plates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
url: https://support.collaborativedrug.com/hc/en-us/requests/new
description: 'Collaborative Drug Discovery provides an API (Application Programming
Interface) that can be used for secure programmatic access to your vault
data.'
license:
name: Proprietary
url: https://support.collaborativedrug.com/hc/en-us/requests/new
title: CDD Plates API
version: 1.0.0
servers:
- url: https://app.collaborativedrug.com/api/v1
security:
- ApiKeyAuth: []
tags:
- description: Plates of wells
name: Plates
paths:
/vaults/{vault_id}/plates:
get:
description: List plates in the vault. Supports pagination (`page_size`, `offset`), asynchronous retrieval (`async=true`), `only_ids`, and filtering by location, project, and creation/modification dates. Filtering by name is not available on this GET endpoint; use the POST query endpoint instead.
operationId: getPlates
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Maximum number of records to return (default 50, maximum 1000).
in: query
name: page_size
schema:
type: integer
- description: Number of records to skip (for pagination).
in: query
name: offset
schema:
type: integer
- description: If true, run the listing as an asynchronous export.
in: query
name: async
schema:
type: boolean
- description: If true, return only the ids of matching plates.
in: query
name: only_ids
schema:
type: boolean
- description: Comma-separated plate ids to filter by.
in: query
name: plates
schema:
type: string
- description: Comma-separated project ids to filter by.
in: query
name: projects
schema:
type: string
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/plate_object'
type: array
description: List of plates
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
summary: Get plates
tags:
- Plates
post:
description: Create a plate. Requires write permission in the vault.
operationId: createPlate
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/plate_create_update'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/plate_object'
description: The created plate
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Validation error
summary: Create a plate
tags:
- Plates
/vaults/{vault_id}/plates/{id}:
delete:
description: Delete a plate. Requires write permission. A plate that has associated run data cannot be deleted.
operationId: deletePlate
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the plate
in: path
name: id
required: true
schema:
type: integer
responses:
'200':
description: The plate was deleted
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Plate not found, or vault is unauthorized
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: The plate cannot be deleted (it has associated run data)
summary: Delete a plate
tags:
- Plates
get:
description: Retrieve a single plate.
operationId: getPlate
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the plate
in: path
name: id
required: true
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/plate_object'
description: The plate
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Plate not found, or vault is unauthorized
summary: Get a plate
tags:
- Plates
put:
description: Update a plate. Requires write permission.
operationId: updatePlate
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the plate
in: path
name: id
required: true
schema:
type: integer
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/plate_create_update'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/plate_object'
description: The updated plate
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Plate not found, or vault is unauthorized
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Validation error
summary: Update a plate
tags:
- Plates
components:
schemas:
error:
description: A general error response containing an error message and HTTP status code
properties:
code:
description: HTTP status code
type: integer
example: 404
error:
description: Human-readable error message
type: string
example: Resource not found
type: object
error_apikey:
description: Whenever the given API key doesn't allow access to the given vault or the vault doesn't exist
properties:
code:
default: 401
type: integer
error:
default: key not authorized for access to this vault
type: string
type: object
plate_object:
description: A plate of wells, optionally associated with batches/samples and run statistics.
properties:
class:
example: plate
type: string
concentration:
type: number
concentration_unit_label:
description: Units for `concentration` (e.g. "M").
type: string
created_at:
format: date-time
type: string
id:
type: integer
inventory_location_id:
type: integer
location:
description: Free-text location of the plate.
type: string
modified_at:
format: date-time
type: string
name:
type: string
projects:
description: Projects the plate belongs to.
items:
properties:
id:
type: integer
name:
type: string
type: object
type: array
statistics:
description: Per-run plate statistics (Z'-factor, control means, etc.).
items:
additionalProperties: true
type: object
type: array
volume:
type: number
volume_unit_label:
description: Units for `volume` (e.g. "µL").
type: string
wells:
description: The wells of the plate and their batch/sample assignments.
items:
additionalProperties: true
properties:
batch:
description: Batch id in the well (if any).
type: integer
col:
description: Zero-based column index.
type: integer
row:
description: Zero-based row index.
type: integer
sample:
description: Inventory sample id in the well (if any).
type: integer
type: object
type: array
required:
- id
- class
- name
type: object
plate_create_update:
description: Attributes for creating or updating a plate. On create, `name` and `projects` are required. Supplying `wells` replaces the plate's wells.
example:
name: Plate 001
projects:
- 12
location: Freezer A
wells:
- row: 0
col: 0
batch: 456
properties:
concentration:
type: number
concentration_unit_label:
type: string
inventory_location:
description: Id of the inventory location for the plate.
type: integer
location:
type: string
name:
type: string
projects:
description: Project ids the plate belongs to.
items:
type: integer
type: array
volume:
type: number
volume_unit_label:
type: string
wells:
description: Wells to populate. Each well identifies its position by `row`+`col` or `pos`.
items:
properties:
batch:
description: Batch id to place in the well.
type: integer
col:
type: integer
pos:
description: Well position in letter-number form (e.g. "A1"), as an alternative to row/col.
type: string
row:
type: integer
type: object
type: array
type: object
vault_id:
description: Numeric identifier of the vault
type: integer
securitySchemes:
ApiKeyAuth:
in: header
name: X-CDD-Token
type: apiKey