Collaborative Drug Discovery Fields API
Vault field definitions
Vault field definitions
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/collaborative-drug-discovery:collaborative-drug-discovery-fields-api"
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.
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: 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 Fields API
version: 1.0.0
servers:
- url: https://app.collaborativedrug.com/api/v1
security:
- ApiKeyAuth: []
tags:
- description: Vault field definitions
name: Fields
paths:
/vaults/{vault_id}/fields:
get:
description: Get all the fields both internal and user defined
operationId: getFields
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/fields'
type: array
description: List of all fields
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
summary: Retrieve all fields
tags:
- Fields
/vaults/{vault_id}/fields/{field_id}/pick_list_values:
get:
description: List the pick list values for a vault field definition.
operationId: getPickListValues
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the field definition
in: path
name: field_id
required: true
schema:
type: integer
- 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
responses:
'200':
content:
application/json:
schema:
properties:
count:
type: integer
objects:
items:
$ref: '#/components/schemas/pick_list_value_object'
type: array
offset:
type: integer
page_size:
type: integer
required:
- count
- objects
type: object
description: A page of pick list values
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
summary: Get pick list values
tags:
- Fields
post:
description: Create a pick list value on a field definition. Requires vault administrator access.
operationId: createPickListValue
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the field definition
in: path
name: field_id
required: true
schema:
type: integer
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/pick_list_value_write'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/pick_list_value_object'
description: The created pick list value
'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 pick list value
tags:
- Fields
/vaults/{vault_id}/fields/{field_id}/pick_list_values/{id}:
delete:
description: Delete a pick list value. Requires vault administrator access.
operationId: deletePickListValue
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the field definition
in: path
name: field_id
required: true
schema:
type: integer
- description: Numeric identifier of the pick list value
in: path
name: id
required: true
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
properties:
message:
type: string
type: object
description: The pick list value 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: Pick list value not found, or vault is unauthorized
summary: Delete a pick list value
tags:
- Fields
get:
description: Retrieve a single pick list value.
operationId: getPickListValue
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the field definition
in: path
name: field_id
required: true
schema:
type: integer
- description: Numeric identifier of the pick list value
in: path
name: id
required: true
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/pick_list_value_object'
description: The pick list value
'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: Pick list value not found, or vault is unauthorized
summary: Get a pick list value
tags:
- Fields
put:
description: Update a pick list value. Requires vault administrator access.
operationId: updatePickListValue
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Numeric identifier of the field definition
in: path
name: field_id
required: true
schema:
type: integer
- description: Numeric identifier of the pick list value
in: path
name: id
required: true
schema:
type: integer
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/pick_list_value_write'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/pick_list_value_object'
description: The updated pick list value
'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: Pick list value not found, or vault is unauthorized
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Validation error
summary: Update a pick list value
tags:
- Fields
components:
schemas:
fields:
properties:
batch:
items:
$ref: '#/components/schemas/field'
type: array
internal:
items:
$ref: '#/components/schemas/field'
type: array
molecule:
items:
$ref: '#/components/schemas/field'
type: array
protocol:
items:
$ref: '#/components/schemas/field'
type: array
type: object
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
pick_list_value_object:
description: A pick list value belonging to a vault field definition.
properties:
created_at:
format: date-time
type: string
hidden:
description: Whether the value is hidden from users.
type: boolean
id:
type: integer
modified_at:
format: date-time
type: string
value:
type: string
required:
- id
- value
- hidden
- created_at
- modified_at
type: object
pick_list_value_write:
description: Attributes for creating or updating a pick list value.
example:
value: blue
hidden: false
properties:
hidden:
default: false
description: Whether the value is hidden from users.
type: boolean
value:
type: string
required:
- value
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
field:
properties:
data_type_name:
type: string
id:
type: integer
name:
type: string
overwritable:
type: boolean
required_group_number:
type: integer
type:
type: string
unique_value:
type: boolean
type: object
vault_id:
description: Numeric identifier of the vault
type: integer
securitySchemes:
ApiKeyAuth:
in: header
name: X-CDD-Token
type: apiKey