Introduction

The Benchling In Vivo API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Authentication

The Benchling In Vivo API uses OAuth 2.0 access tokens to authenticate requests. These Bearer tokens are the predominant type of access token used with OAuth 2.0.

The Client Credentials grant type is used by clients to obtain an access token outside of the context of a user.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Data Model

The diagram below provides a high-level overview of the entities in the In Vivo API and their relationships.

Data Model

Errors

Benchling In Vivo uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a request failed, etc.). Codes in the 5xx range indicate an error with the In Vivo servers (these are rare).

Metadata

Benchling In Vivo entities—including Study, Cage, Group, Animal, Sample and Project have a metadata parameter. You can use this parameter to attach key-value data to these In Vivo entities.

Metadata filtering

You can perform filtering of List API responses on metadata that you’ve added to entities that support it.

You can use the metadata query param so the filter term only looks up metadata values. To filter for a specific metadata key-value pair, use the metadata key name as a query param, such as study-internal-id=STUDY-1234.

Metadata Glossary

Benchling In Vivo entities that can attach metadata—including Study, Cage, Group, Animal, Sample and Project can store a glossary field, used to design a schema. For example you can set metadata to be a select field, or a date field.

Pagination

All top-level API resources have support for bulk fetches via "list" API methods. For instance, you can list studies, list animals, and list cages. These list API methods share a common structure, taking at least these three parameters: limit, page, perPage.

Versioning

When backwards-incompatible changes are made to the API, a new, dated version is released. The latest version is 2022-12-14.

All requests use your API key settings, unless you override the API version.

To set the API version on a specific request, send a X-Studies-Api-Version header.

Your API version controls the API and webhook behavior you see (for example, what properties you see in responses, what parameters you’re permitted to send in requests, and so on). Your version gets set when you create your API key. When a breaking change is introduced to the Benchling In Vivo API, a new dated version is released. To avoid breaking your code, we don’t change your version until you’re ready to upgrade.

Each webhooks listener is configured with a specific API version. If you wish to change the version of your webhook events contact support.

Breaking Changes

2022-12-14

  • Measurement response variables replaced with calculations.

Global Resources

OAuth Token

An OAuth Access Token is a string that the OAuth client uses to make requests to the resource server.

Attributes

Path Type Description

token_type

String

Indicates the token type value.

expires_in

Number

The amount of time that an access token is valid (in seconds).

access_token

String

The requested access token.

Create a token

Fields

Path Type Description

grant_type

String

Denotes the flow you are using.

client_id

String

Your application’s Client ID.

client_secret

String

Your application’s Client Secret.

Request

POST /api/public/v1/oauth/token HTTP/1.1
Content-Type: application/json
Content-Length: 161
Host: localhost:8080

{
  "grant_type" : "client_credentials",
  "client_id" : "0722315a-4478-41f1-aee0-400fc99d6657",
  "client_secret" : "zCfxwIOghm7HwsAjW7aV7bOpluN9u1W5CVv46aW1"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1019

{
  "token_type" : "Bearer",
  "expires_in" : 86400,
  "access_token" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwNzIyMzE1YS00NDc4LTQxZjEtYWVlMC00MDBmYzk5ZDY2NTciLCJqdGkiOiJkY2U2ODRmMC04ZDg4LTQ1MjEtODk0MS05ZmY3ZWI1NWIxN2QiLCJpYXQiOjE3NjE5MTE4MDQsIm5iZiI6MTc2MTkxMTgwNCwiZXhwIjoxNzYxOTk4MjA0LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.a8loh9PyNMEYsvRzsj16ClN10-q1aF_L-M1Jcjsby4SoIn3-0lB-1B4PQ3nkvzQGhbmIKK4KBdlS8SQmhQaCNAGt9R7I-63-oUyW-ew0g5pOozehABRsQN9whklWKsuw81TiUsdNXFsK2sJXDZhDYa7hQpTd8VHZWPVYuwg9qMnc0q-b6mNPEA_26KeovebSnB0uuRpmaWjK7kq3Ovtpb6ZcWuQiBXLOjhwY1G_DNW39aarNVaNbklet29T6zjWAe94mZSn5Ntjx-pMC3-9hG7ik-dUNcQ_t8z8wKB6MAGQ9tSpfs3y0IapjYJsFr1lvzryzdZelx0wtXVETHEuuXqdB0q716m6kAh6Ei5RXF2HlzX6nKP5tJ0oh8OUvV98WUuucTtmyrxLtToT94-sUmeTwsCwQWTdCLRDZh8D92nb0Y4u9S6Voa9A6S1iqY9nA8kd2GUOUq8yybMtPgS60V8kOtp60lRgbjRjsBi7qeQHLQj0xGyLybCy9LCyOemyS13ycFCe2L_edPUdSzbbdQ6fod1myMd9cwiyXXSIRYZBW_6K1-fkS0i8-mns6bZXdG45aJqq_3VbYPlxsekcF2zVF8sfNgOHs3ST7e-IXlxFyHesKExNXZ3FH41Vg0PdWKlXTVV6MQlGu_RPXMO3QdPYqvjqGZBIcbuUoO-FtlEY"
}

Glossary

Your team’s glossary and their configurations for entities that include—Samples, Observations and Euthanized reasons.

Attributes

Path Type Description

id

String

The unique identifier of the glossary.

title

String

The title the glossary.

group

String

The group associated to the glossary.

Retrieve a glossary item

Retrieves the details of an existing glossary.

Request

GET /api/public/v1/glossary/gly_3IkwOw2xnMmvs1WQI8PQGV HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyZGIxMDQ0Ni1lYTRlLTQ1ZmYtODRkYy00NzY2NTU3MjBkYWMiLCJqdGkiOiJiNTcwNjhkMi02MTllLTRmNWEtODI2My04MmMzOWU1ZmFjNWQiLCJpYXQiOjE3NjE5MTE3OTYsIm5iZiI6MTc2MTkxMTc5NiwiZXhwIjoxNzYxOTk4MTk2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.d3ZVaIjyDDYNvH38WsVRpIF3zVTV6ZEGpsrsHeJov_E5zFX1bUgP5NMk_AC3QYYS-Yt87S635ODpxV5ScMNFYl363JOqtAIcKjfDdnpyxcdUFwahn1uDugYajwH41qBPfNU3SKTKoOtDS5lLZzNsqNu7Fl3qS1dnOGQ8Y5bdU8MjCNnlBaBped3gY5Zs61oVTEiIJmC0Qygal2I_mYLIEYahKiuKmfrX4eB1YmFtqKbWR0_VTRdZWdxGYS2jRWglbhg1u2Pk5ukN3U6YQyREN8h28BU2Tr6dE7N969cGgBu1REuGxizSI1PXG8xe9PVI2SDzcaU9JDFZvqUH5j98PC8gT8zENdwd-s1E8J3J9intuzBIZR4Je6a8x8YrdRpu72SdRUtV1W-A2L-qjawXeb3uhN6w8PONLEgjNfl60rffaMzFKJeQ6Ae2s-wFfilrw1Dplf5O9Wo9I4-SgbNXqcoqmmiQWVE9WPzNcca2u5_LVHF3_1dbISZbYviFqBt2rkKAjzh49drkxQ5ob1NNZilZTJvlMEqk26VfxAtvDhL8y-MT7ysKCwmglRyf74SLQTTUhBHPghTjgZXZ-E1RdwQQA0X1lZddAmrKCQnG9uN1Hf4L89K3J-ErxBmKcncNs4mbFc4Mnv_w8YkKQ1pnbsSfHYiAP37pD4kyG-MwNR4
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 100

{
  "id" : "gly_3IkwOw2xnMmvs1WQI8PQGV",
  "title" : "Euthanised",
  "group" : "euthanize_reasons"
}

List all glossary items

Returns a list of your glossary.

Query parameters

Parameter Description

perPage

The number of glossaries to return per page.

page

The page of glossaries to return.

type

Filter glossaries by type

Request

GET /api/public/v1/glossary HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3NWQ1OWI2Ni0wNTgyLTRmNWItYmExMy0wNTFiMjJjYzUzNWEiLCJqdGkiOiIxZGZjYjcyYS0zMzhmLTRmMTktYjkxYy1kNTFiMzdmM2I3MGUiLCJpYXQiOjE3NjE5MTE3OTUsIm5iZiI6MTc2MTkxMTc5NSwiZXhwIjoxNzYxOTk4MTk1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.C-IQJMwJGApZyyB-_ezC3uNcn4YqPzP6m6f2T-aznQD0Py77kSb1E-l6pnFPMe_m4tXD86DO1mh2ohgzF1DK1JhH-d6qo00BsfzgfU91wvFrmZ0UbeLXbng-3zE4WToJzKd2dXsrON7uVM5sFmtOz4V5GrxNqu_yfJ87CJ2al_MaQAs3qv_cc1u2ekFHThNSeIYZvkb-sOnDM7e0yqcItW6kHeZvF3v9lr-SDsyUOGifhscS1f8spWYP6GeHXEWKinleI3rbMgqG8zVdZFP1ftDCJ-wlhUPvn7LIZ6kr5zSVvEFPydfXT0P1PoPPNZkry06IxgTgVeYZFB355uEsc_685QkObkesgo6RQiuQHCrDPourlSmKOrgibBvEFXsJPTfDZGqwV2vbBI7F5OidCVjminmnarTI5D5xOl7UhYVkKhJOMQKJJ8xum6SPQmWSVQVDT6HGNFhAtJtlbzpKHRQqEAo3AIJCzK5Z2pUhGLiiM9a9TKKJi4FY49CYT95pLqfia5lTr5j3oy-rlTH_aU25CWyP72C122Z9W-QYz1WMFSTMWvz2CDxuqsN_sD0tFdxaekTQI1qRuqDMXjn8lxnm9Gv-qslqF3N09CKHJPZPWMR6DMbF8Ag9G82MD49cQ3VHpawi8amU0Mm2WTHErI7OULXCalxIpbyPHQnF23Q
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 496

{
  "data" : [ {
    "id" : "gly_3DThcjuT7xs13OrFkNGfkr",
    "title" : "Brain",
    "group" : "samples"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/glossary?page=1",
    "last" : "http://localhost:8080/api/public/v1/glossary?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/glossary",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Animal Resources

Animal

This is an object representing an animal in your facility. You can retrieve it to see the status, date of birth, sex, species, strain, identifiers and treatment group of the animal.

Attributes

Path Type Description

id

String

The unique identifier of the animal.

catalog

String

Unique catalog number of the animal.

name

String

The name of the animal.

number

Number

The number of the animal.

strain

String

The strain of the animal.

species

String

The species of the animal.

sex

String

The sex of the animal.

dob

String

The date of birth for the animal.

tail

String

The identifier for the tail of the animal.

ear

String

The identifier for the ear of the animal.

tag

String

The identifier by tag of the animal.

donor

String

The identifier for the donor patient of the animal.

tracking_date

String

The tracking date for the animal.

disease_induction_date

String

The disease induction date for the animal.

terminated_at

String

The terminated date of the animal.

terminated_by

Object

The user who terminated the animal.

disease_survivor

Boolean

Specifies whether animal survived the study before being euthanized.

metadata

Object

The metadata associated to the animal.

study

Object

The study of the animal.

study_group

Object

The study of the animal.

cage

Object

The cage of the animal.

created_at

String

The created timestamp of the animal.

updated_at

String

The last updated timestamp of the animal.

Create an animal

Fields

Path Type Description

cage_id

String

The cage of the animal.

name

String

The name of the animal.

strain

String

The strain of the animal.

sex

String

The sex of the animal.

dob

String

The date of birth of the animal.

metadata

Object

The metadata to be associated the cage.

Request

POST /api/public/v1/animals HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI5N2I3ZDM5ZC1lMmYwLTQyODAtYTBkZC00MTZkMzUzMDU0YjEiLCJqdGkiOiIwNDIyMjMyNC1mMDZlLTQ3MzQtOWZkYS0yY2Q0OGY2NDRhZmQiLCJpYXQiOjE3NjE5MTE3ODAsIm5iZiI6MTc2MTkxMTc4MCwiZXhwIjoxNzYxOTk4MTgwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Ihe0e5sjNhQWsO6ru0f7jXopeXpf4W4S3IEHB3gnM7JXljs_CfVGTjoRxqhxR4yJxkwWakRrCJoiT91a8bHy4WoGLPzx-NXgF091xuzTllLKYnueBoxu3DKwDALVr4eZa5dtIuKQI1OrYsJ1fjkwNzSAXJIghItuat4lS-_ErJZFoqAoGzKbUBZRRscPV_K-28OtrQDE0E-n98ZmrMyjjzOBdyrQNmbmofQamU4c4oLlo_FyNOTAIJfGrLAuF7EOjSsyP4ANIqEC9nd-LEJP8QnZSsl5kNM6N0JzkXs8hoGdT_qn5QbZu1wrDJsO7kb_IBgCIjfceA56IkiCcS5Q3-SvRD6OFlOmLq7zbkf6ysxYVYho-vI0SN_7BpYzZBXGZnO-HBNIFeL9ZPVjNx-UJ5EG1FxekGfb46kcaNPstJjOIjypKWLYVa36UEuxe4RfKCeUbDoyY84dYxcpkgaYsyQn_aqn7UQqb-llR2-H_EEJ3Z-Z-hUzJcUwbsQn9hqUvdfXM42PJokXCAPtoMTYV_OtlInDlyacGkDIkxs-4jvt5Qw06Q88AngwcQNIyTl4xcQYr7W2yXlOiVieB5DuqYgjpL2K3PBpE09RI1IZ4Oj_5kJupzxfUGNc7Pu0KMkOkR9VhFwJi31_BPkQD1qdf67BHvTLRB_B4j1CkMdrIV8
Content-Length: 198
Host: localhost:8080

{
  "cage_id" : "cge_4lqPGK8yyw4JLp4ZMKhkuR",
  "name" : "Animal 1",
  "strain" : "wzcLojVbWt",
  "sex" : "m",
  "dob" : "2025-10-31",
  "metadata" : {
    "animal-internal-id" : "ANIMAL-1234"
  }
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1815

{
  "id" : "aml_1MNvkII6ZBy7L7XZV0BwKA",
  "catalog" : "A0000001",
  "name" : "Animal 1",
  "number" : 1,
  "strain" : "wzcLojVbWt",
  "species" : "OvZbUkMUX6",
  "sex" : "m",
  "dob" : "2025-10-31",
  "tail" : null,
  "ear" : null,
  "tag" : null,
  "donor" : null,
  "tracking_date" : null,
  "disease_induction_date" : null,
  "terminated_at" : null,
  "terminated_by" : null,
  "terminated_reason" : null,
  "disease_survivor" : null,
  "metadata" : {
    "animal-internal-id" : "ANIMAL-1234"
  },
  "study" : {
    "id" : "sdy_3tnaskS5GmKJ5jiywVzsw2",
    "project_id" : "pjt_12Svtzu8TdIvCzufT3McJ6",
    "name" : "74NqfSMVo0",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "GDcA8Zm7yN",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_3HBXLoiRfHXDYfrFEj4nVn",
      "name" : "3xlOTEKslR",
      "email" : "bmzvcx1u@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_4PYeOllpZFHOhzPx9hGeaZ",
      "name" : "cVpIIKgLWn",
      "email" : "ZUwXeJB8@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:20.091063Z",
    "updated_at" : "2025-10-31T11:56:20.091063Z"
  },
  "study_group" : null,
  "cage" : {
    "id" : "cge_4lqPGK8yyw4JLp4ZMKhkuR",
    "study_id" : "sdy_3tnaskS5GmKJ5jiywVzsw2",
    "name" : "tJEeMM3GPY",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "created_at" : "2025-10-31T11:56:20.258385Z",
    "updated_at" : "2025-10-31T11:56:20.258385Z"
  },
  "created_at" : "2025-10-31T11:56:20.281881Z",
  "updated_at" : "2025-10-31T11:56:20.281881Z"
}

Retrieve an animal

Retrieves the details of an existing animal.

Path parameters ./api/public/v1/animals/{animalId}

Parameter Description

animalId

The unique identifier of the animal.

Request

GET /api/public/v1/animals/aml_53lHzbw6Rq93rlVUO4MmAl HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJlMWZhZWVlZC1kYmFlLTRiOWMtOWU3ZS03YjAwOGZmODhlOGMiLCJqdGkiOiI2NTM1NTdlZC1mM2I4LTQzM2QtOWE3ZS04NzNkNmM1ZWEyOTQiLCJpYXQiOjE3NjE5MTE3ODAsIm5iZiI6MTc2MTkxMTc4MCwiZXhwIjoxNzYxOTk4MTgwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.TbeSntXAKkAGOmKgKOuLctPYdI2GKAJsSP8XAeJ-OOM5JTgQSgWeZPF0lu9WpFT9IZYNG0jo75k-5eGGHQdf9K4HIM6wgcFhT97Xu9x8qdzitXanzQ0YynnUL9nyOFEORfTCyVBc8YU-wYjyPRr757zExHybP0jkuJ5FCnqQCpKkJK1xKZe3F0_wkA8GNcVHOs5_D_u5EbnN4l4MzeGsVIZ05K7BqqRIfjl4jyHZilgrNoEAct0Lzf0DdbvI-QrmfYoSaH4fNsU1j17D0qJXYOI4tDGt3ZQT-gDNflqlNDfpN80cz3-RB2RTq8fjfaXfAKsD_ZIpvGGYyDFHqhrJHn1oPqY8YazQWmEtWhx4NtKOxYFT2-mi-_gK0W3GJ1-jrxBMhWUjSJoUrkgvvXs1He-HTiK4XJOUsx-t6sA270VHpq1xxbUCfFvebkmd41iEUixdp7qqGwrDvEl7tgK6502pkghj3r-I-0qPhdyb6BhQGfytkBfURFZeoR5eBikae4ZVI1dx44-08vuZTDq5NtA_m2YObmzKH1WWmpIE0V7ffF7lSt0HHrTEY9aHkchJMEutqbxLCpyC2jjWUIKy3qndeWFj96OYVI7ZcJOKcDm0pZ5fGriDxQagDFL7ROgawtcIhSvfC3Too0ziwtaR2ACqyp8zgBOaqX3qP_85Rqs
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2499

{
  "id" : "aml_53lHzbw6Rq93rlVUO4MmAl",
  "catalog" : "A0000001",
  "name" : "cyWuDxCykQ",
  "number" : 1,
  "strain" : "dWtNJ2lpWt",
  "species" : "oTkBbeAuI4",
  "sex" : "m",
  "dob" : "2025-10-30",
  "tail" : "4ZM2IIAIp6",
  "ear" : "7oAGH5F7cv",
  "tag" : "McrPAD2fZg",
  "donor" : "3sLQU8QOvD",
  "tracking_date" : "2025-10-31",
  "disease_induction_date" : "2025-10-31",
  "terminated_at" : "2025-10-31",
  "terminated_by" : {
    "id" : "usr_3snO1oCjT8c3Qu0AGWwaOw",
    "name" : "HpRvCfo4op",
    "email" : "d4D7z5Bw@benchling.com",
    "timezone" : "UTC"
  },
  "terminated_reason" : {
    "glossary_id" : "gly_56eo4p5SJburMsEoDmIEuk",
    "title" : "Found dead",
    "comment" : "S5Z0IaYc7L"
  },
  "disease_survivor" : false,
  "metadata" : {
    "animal-internal-id" : "ANIMAL-1234"
  },
  "study" : {
    "id" : "sdy_3f2Nu0C1JcSgmetHYIZRyB",
    "project_id" : "pjt_45ERSRlBHE5Q1qbb4kejEf",
    "name" : "J9jNNgS3M7",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "w6Jb2z7P0L",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_4vgbMG28KTC9fJfjwfhcLy",
      "name" : "vmHrjkUlZa",
      "email" : "Jtrs8gH0@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_544Q8HLZqnrI7O1YrLPCeE",
      "name" : "LNs01Ez9PX",
      "email" : "0KEfWXHV@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:20.542135Z",
    "updated_at" : "2025-10-31T11:56:20.542135Z"
  },
  "study_group" : {
    "id" : "grp_lUayKhUL1p2xj8j9MtCgR",
    "study_id" : "sdy_3f2Nu0C1JcSgmetHYIZRyB",
    "name" : "kGjghA4uSB",
    "no" : 1374551487,
    "color" : "cKVcMykg44",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "GROUP-1234"
    },
    "created_at" : "2025-10-31T11:56:20.704585Z",
    "updated_at" : "2025-10-31T11:56:20.704585Z"
  },
  "cage" : {
    "id" : "cge_11fV1tFdIebiQRRDZFibpk",
    "study_id" : "sdy_3f2Nu0C1JcSgmetHYIZRyB",
    "name" : "KNSd6IxwML",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "created_at" : "2025-10-31T11:56:20.694405Z",
    "updated_at" : "2025-10-31T11:56:20.694405Z"
  },
  "created_at" : "2025-10-31T11:56:20.707939Z",
  "updated_at" : "2025-10-31T11:56:20.707939Z"
}

Update an animal

Updates the specified animal by setting the values of the parameters passed.

Path parameters ./api/public/v1/animals/{animalId}

Parameter Description

animalId

The unique identifier of the animal.

Fields

Path Type Description

study_group_id

String

The study group of the animal.

cage_id

String

The cage of the animal.

name

String

The name of the animal.

strain

String

The strain of the animal.

sex

String

The sex of the animal.

dob

String

The date of birth of the animal.

metadata

Object

The metadata to be associated the animal.

Request

PATCH /api/public/v1/animals/aml_3dxn4NYnPkLjCh3lxZG5Sq HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwNGVjZDNmZi1lM2VjLTQxMGMtYTYwMi1iOTYwZTdlYmI1NDEiLCJqdGkiOiI4YzQxNDhlNi05ZmQ1LTQwMTYtODBiMy1iODRjYTIwZDJiZjIiLCJpYXQiOjE3NjE5MTE3ODEsIm5iZiI6MTc2MTkxMTc4MSwiZXhwIjoxNzYxOTk4MTgxLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.hBAmHwufC048goKFJkMe51r56xKIT9PU4X5uJAl1A3KwpdVhFvVBEPZ-V2sBFmst1q0SX_GGylutRhndgXRHyPJjEoBXrgH3-2zT6t4NmFCIaEDHvj0m6wehbCvGKjWm97bv2vxkXFOQKZ59NvOmg8wx75Htd8W9to3CD67aq24e3PhqIh_yRXYn49wWL665Wkujxc0HkO6IlUwB8IFY3zygmUhgKsc0sVrYU9IEA7lwGw43SkM1WOiN1UpjaKC5foE3lfcrOphLEVYlqSr8IqcBKX3PAC9I7IlySfmaapYZjG34oz-b_kYEy75Sc0hHzLldaszswwdC9odUzOpSNSQKlhLmkx6iAPR17_VHpL8LVyr-dDn3mZIAUdwU30cYS6I4nbLVIXGZJSHl8WcYqBQb9d-BFCGlBIo9e4vbY1wPBaHAixEs9U8iuqZ8VmEPQkOkGYVDSKFOVNwz1L7MB2ajDIxmRWIIONG9e1hcYQ_l3zkQRtK2cLUCjTmRjVdhs7wf0OaW1JPOlIJgtyj2zThwRHoa8c1NitbWNTf2SWMqTJSGb30hUtCnN8zxmE3kASuOyNcYhMzo8tIC-rmXcRjzx43NwmLbXtESfHBvITxb5g418M177B-1oPx5nKF-fArwNaWyLhPoWZMJaHYmxHhj_lsvMEd9Kk6R98yX0jk
Content-Length: 265
Host: localhost:8080

{
  "study_group_id" : "grp_5GprOuXhY5kjiKhmTVDCq3",
  "cage_id" : "cge_6bWn9yaLkkrUQzO4ftkKOg",
  "name" : "Benchling In Vivo Animal",
  "strain" : "VGc17OXuSh",
  "sex" : "f",
  "dob" : "2025-10-29",
  "metadata" : {
    "animal-internal-id" : "ANIMAL-4321"
  }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2275

{
  "id" : "aml_3dxn4NYnPkLjCh3lxZG5Sq",
  "catalog" : "A0000001",
  "name" : "Benchling In Vivo Animal",
  "number" : 1,
  "strain" : "VGc17OXuSh",
  "species" : "8tGlug0Sew",
  "sex" : "f",
  "dob" : "2025-10-29",
  "tail" : "KcG5QgoSrj",
  "ear" : "b586qYiCzL",
  "tag" : "b19RiM9gnh",
  "donor" : "QNethLwocK",
  "tracking_date" : "2025-10-31",
  "disease_induction_date" : "2025-10-31",
  "terminated_at" : null,
  "terminated_by" : null,
  "terminated_reason" : null,
  "disease_survivor" : null,
  "metadata" : {
    "animal-internal-id" : "ANIMAL-4321"
  },
  "study" : {
    "id" : "sdy_4Ez749bMNIRfFIT3iLrHQC",
    "project_id" : "pjt_JhNXOCLwbZ014ncvPtCr5",
    "name" : "4YVDvT5prl",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "9M81cYEMs3",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_2F1rQCj1mJkb0QuiCXRvao",
      "name" : "ZtQw9VcsUS",
      "email" : "LYhKLSSU@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_1n1POwx9c1pua3UJDBtoMK",
      "name" : "WhMZmCi7rc",
      "email" : "vLRbBcVU@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:21.623613Z",
    "updated_at" : "2025-10-31T11:56:21.623613Z"
  },
  "study_group" : {
    "id" : "grp_5GprOuXhY5kjiKhmTVDCq3",
    "study_id" : "sdy_4Ez749bMNIRfFIT3iLrHQC",
    "name" : "pNcV4UpUlx",
    "no" : 939241789,
    "color" : "#9cbb60",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "new-study-group-internal-id" : "NEW-GROUP-1234"
    },
    "created_at" : "2025-10-31T11:56:21.807861Z",
    "updated_at" : "2025-10-31T11:56:21.807861Z"
  },
  "cage" : {
    "id" : "cge_6bWn9yaLkkrUQzO4ftkKOg",
    "study_id" : "sdy_4Ez749bMNIRfFIT3iLrHQC",
    "name" : "wLOsQZpkMU",
    "catalog" : "C0000002",
    "metadata" : {
      "new-cage-internal-id" : "NEWCAGE-1234"
    },
    "created_at" : "2025-10-31T11:56:21.812083Z",
    "updated_at" : "2025-10-31T11:56:21.812083Z"
  },
  "created_at" : "2025-10-31T11:56:18.814773Z",
  "updated_at" : "2025-10-31T11:56:21.831796Z"
}

List all animals

Returns a list of your animals.

Query parameters

Parameter Description

perPage

The number of animals to return per page.

page

The page of animals to return.

name

Filter animals to return by name

cage_id

Filter animals to return by cage ID

catalog

Filter animals to return by catalog

sex

Filter animals to return by sex

metadata

Filter animals to return by metadata value

Request

GET /api/public/v1/animals HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkMTFjMDQyNC1lMjcwLTQ5MjktOTNlNC1kY2NhMTVlYWIxZWIiLCJqdGkiOiJjYzc5NDc0NS04NTU5LTQ4YWMtODEyNC0xODkyYThkYmM2ODYiLCJpYXQiOjE3NjE5MTE3NzcsIm5iZiI6MTc2MTkxMTc3NywiZXhwIjoxNzYxOTk4MTc3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Lue1O-5QpPHRY3ZL6NgXRUvj50Oz8DoDUPznZ6eKdndVfdaKX1JOPHSh3AwHKLCXecAPmb052hZRSyxnuT3lt0v0zmLfQeeh_aLppj5ycixlmPOs0yGNG9tFg8kHPMt3T42V95nP8t-XSylOmLc3DmNQoEoHwtVekCFMPfb-Zu647b0hSafJOLhiTdkcX1sNoigKTKffDdILX-4f7bNP_v5iiDuuik_HMzHL2jPgOcDGeqOXUpsx72tKunKAicQhAKQsIb_UQs1xwJKMKgx4s6mmfTqxuaHXCD4kIn9N13qzWoginZ3gzQmVVPKCFAN8qyytu8Cm_VtrvO97sORom5O317G-iNWxLfjKvKPt4SVQaAFaboTq1OcW5qXSoIfLvIl08FKt3XJuA7BV6Q1hV7Uskwehh-z_PO_QS1PbJzqcH32dInnSLTFTFnSNIzaZcN5-HcwXOK-O9AMamStt_cGxGpthGJuA1Tny5CRBgYPCfdcbS8DiFo_YULdlJYKDF4XPeqFhaBuo11TeT7-WQHH4gOof6e41JFj-FtAjSGifmoA_AHzi_RTGUiTs1GZc_7sWPY4Ik_RsuqwgG4FU3tqikMTzmT31IIeUTff52Sn9djCbmC6B1qb5Mh_bVU74OQKPYHFIf_QByOGiYwAROkzVyxQpspkIB5BxEPPQ3C8
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3076

{
  "data" : [ {
    "id" : "aml_7ln1t44FVZgM91XJn99kzb",
    "catalog" : "A0000001",
    "name" : "Ij9UYUQUas",
    "number" : 1,
    "strain" : "geDcLs0m9x",
    "species" : "JNiHRuKv1D",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "ifnn0tC6ig",
    "ear" : "2zsNMjWkk3",
    "tag" : "UfH2gcYrii",
    "donor" : "7u14E8HEda",
    "tracking_date" : "2025-10-31",
    "disease_induction_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_7Qjz8xaPd1IqVNojDf2DNV",
      "name" : "4FrRQJKVnq",
      "email" : "gAIACJng@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_68mieBLWG7o509oU8ekGcj",
      "title" : "Found dead",
      "comment" : "X9dv5z2k0E"
    },
    "disease_survivor" : false,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "study" : {
      "id" : "sdy_1huEFEejcnZ9udk7H7bRCP",
      "project_id" : "pjt_6Ep3tDWdYFwnwyyeeuzPeU",
      "name" : "nlLOUQXAo8",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ClfcthpyVO",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_7kglfeX52KJiNrW1wt5Dch",
        "name" : "N2y3alLvqF",
        "email" : "5K1QJuNM@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_1iSW1oMzVpWlDJRn1ExnY6",
        "name" : "eYbq31NNHY",
        "email" : "KEpQeE5Z@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:16.690119Z",
      "updated_at" : "2025-10-31T11:56:16.690119Z"
    },
    "study_group" : {
      "id" : "grp_6ZVPficGQHkSt3Iy8VJmvA",
      "study_id" : "sdy_1huEFEejcnZ9udk7H7bRCP",
      "name" : "1WeUVa3Ix5",
      "no" : 1997166451,
      "color" : "HngKkbBZYM",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:56:16.986973Z",
      "updated_at" : "2025-10-31T11:56:16.986973Z"
    },
    "cage" : {
      "id" : "cge_3ZXs8II8N0o1WaznoUJgPI",
      "study_id" : "sdy_1huEFEejcnZ9udk7H7bRCP",
      "name" : "V9Yqon1YUj",
      "catalog" : "C0000001",
      "metadata" : {
        "cage-internal-id" : "CAGE-1234"
      },
      "created_at" : "2025-10-31T11:56:16.960023Z",
      "updated_at" : "2025-10-31T11:56:16.960023Z"
    },
    "created_at" : "2025-10-31T11:56:16.994583Z",
    "updated_at" : "2025-10-31T11:56:16.994583Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/animals?page=1",
    "last" : "http://localhost:8080/api/public/v1/animals?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/animals",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete an animal

Removes an animal.

Path parameters ./api/public/v1/animals/{animalId}

Parameter Description

animalId

The unique identifier of the animal.

Request

DELETE /api/public/v1/animals/aml_5wZuuffUZ1Tn99LBsc4SGB HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3ZjQ3MWE2OS0xMDdmLTRkNTYtYTI4OS05ZTZlMDU4ZTU5NzMiLCJqdGkiOiI0YjBkZGU3Yi1iYjMxLTRjMDQtYTQyMC01MDRjMmFhYmEwZDIiLCJpYXQiOjE3NjE5MTE3ODAsIm5iZiI6MTc2MTkxMTc4MCwiZXhwIjoxNzYxOTk4MTgwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.ekdc1f4tO0cU-hr-UVumJHPJndz9cYR31dF5wJIzHQWz1rS8KC3aFzHpcnC9-uHqrmIhA6C88mxNQ0kCV2-1QpnBTXxjO28kaJutm4QJTaSZumSYIWQDwUudrgrqDx1wKiQbKTh3LLyhP6oPU-YGrBBIm3iKvih-iDtVlC4gaN3Vl3orhrx95hcGotZe4H2o7SXTOO1NsfCEmn5XGoOKmR6owDdMu6usES-A2g9nI7zkppbGnEszX0twObAJLsbg44BP-lIoKFYm_2-ZRKTTA1OHcshLLnXfDKOKnASQmllTNBHYdAFZTtv4EsdipT3I6AxUOb6IEbi8w6-NJz2iklUlpVFxQe-v3dNvNKAJh0pTBKOncURqJ_zS6WyKpcwKCrYEkPqa_bsiGg-mD2uPypX2G9tfgFG1IqmxZ6ALaGHxbWjTsvAbgUphDKrVXxwcGOIhkRrifniVqqrY7086jjtP_EtVH_NNI1DuTcWeDsk30ji7FrWVKQk3ftF7waX7ONFtqxrMn0sydehezjWBoV7bIZtlLw7EP7EAOTaBDbxoMywZ7bjV9NfSBq73WC8edBkwQjBDGfyY83Hiwxsj55gvWxCTnpA6hX0mXbuKMMOZ3VDlCP_BSh0KBXrOs6sCHPfGd8QsaL8Guk-gxwv7_AcZrq_cvzwa3BT31fY_AhU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Animal Dosage

This is an object representing a dose of compound administered to an animal. You can retrieve it to see the dosing method, stock, volume, concentration, date administered, user administered and the treatment group of the animal it was administered to by of the dosage.

Attributes

Path Type Description

id

String

The unique identifier of the dosage.

name

String

The name of the treatment type.

dosed_at

String

The created timestamp of the dosage.

comments

String

The comments associated with the dosage.

dose

Object

The dose concentration associated with the dosage.

dose_volume

Object

The dose volume associated with the dosage.

stock

Object

The stock concentration associated with the dosage.

volume

Object

The volume of the dosage.

study

Object

The study associated with the dosage.

animal

Object

The animal associated with the dosage.

measurement

Object

The measurement associated with the dosage.

user

Object

The user associated with the dosage.

treatment

Object

The treatment associated with the dosage.

weight_at_dosing

String

The optional weight that’s taken during a dosage.

created_at

String

The created timestamp of the dosage.

updated_at

String

The last updated timestamp of the dosage.

Retrieve an animal dosage

Retrieve an animal dosage.

Path parameters ./api/public/v1/animals/{animalId}/dosages/{dosageId}

Parameter Description

animalId

The unique identifier of the animal.

dosageId

The unique identifier of the dosage.

Request

GET /api/public/v1/animals/aml_2tXaR0tpyWJt9IrpqYdNw2/dosages/dsg_2i0NR1vsSOE7zjuPLZYZS3 HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJmM2E1ZTRhMC1jZmQwLTRiOWEtOTdhNy1iZTdlMWJiNjAwNjgiLCJqdGkiOiJhNTM0OTBiNC1kMzUzLTQwOTEtYTJmMy01MDliMzExMDYyYzIiLCJpYXQiOjE3NjE5MTE3OTEsIm5iZiI6MTc2MTkxMTc5MSwiZXhwIjoxNzYxOTk4MTkxLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.fJOLT7H4wp1DqOIWWEFx-rldN9jKm6LR35pjCizzqm8V2gnyOWocv7uflHYdpFlovSfN1DtREI4By4ySPRTQWCreW4EB0cZBQ4jDnA4MFGQsastJji9D5Kgyy_zcnue9g-top1rOyH0E7fdTTFUnRkbcY62A67GIB3QlrQFFRK9GNJ_yCwz69jjKsS9LBxABVXAlnd6L_FRanP6EQHEUuATjWVjKPJa2XRMvuVGOWJDdQWNXa65oLh4NxrLpjve0f-vEBJLUNdgSfy8cUftwdAKVf6MnqrBY2p5YiqzKhU1b55gsFOk2UbculZPH82J81yXZ2kzx5cZq_-5I1L8TZvHKJMShXsOCxXYmBCRgEDGTO0EIPhT47lM3hZJbQ7pZH3H-kFIxw8v_tzVLgzbCuuQJ23_-09wKBI9eQoyux9sah4JtOgm99zlVKUEJLyF-wYMKHAE-cf52CTA4jBQfmon5KqjVQArLMuRs83wHr01_Q84u9XuaTVDeUnRqFPS5IDDv8QON4hkSqS3BTVh4IQAOMtDAoY4Pn6b5A16e7do8q56a28h-gufwfOLc9i-A-wm7WbC8wxoKoXd59k2mjWXcYJtUy7NURpWvk0A4O92ijbGCO0FbsKdeyhoSKndinK3XIhyfP582BvorlseJJEdboI4TL7aAz6oc4MsvkDU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 4545

{
  "id" : "dsg_2i0NR1vsSOE7zjuPLZYZS3",
  "name" : "Example dosage",
  "dosed_at" : "2025-10-31T11:56:31.386453Z",
  "comments" : "WSZoeOprz4",
  "weight_at_dosing" : null,
  "dose" : {
    "unit" : "mg/kg",
    "value" : "3.98",
    "display_unit" : "mg/kg",
    "display_value" : "3.98"
  },
  "dose_volume" : {
    "unit" : "ml/kg",
    "value" : "13.36",
    "display_unit" : "ml/kg",
    "display_value" : "13.36"
  },
  "stock" : {
    "unit" : "mg/ml",
    "value" : "27.65",
    "display_unit" : "mg/ml",
    "display_value" : "27.65"
  },
  "volume" : {
    "unit" : "µL",
    "value" : "37.28",
    "display_unit" : "µL",
    "display_value" : "37.28"
  },
  "study" : {
    "id" : "sdy_3HlWtf7Vh4m7DBOgnvbHcM",
    "project_id" : "pjt_3Nu0CXhdxCZtlCSu3IgPIQ",
    "name" : "M1ZW9X5JIm",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "9CQr7a3JL7",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_1ZjaTKhDJYESOLxbaRi9N3",
      "name" : "2uFv6IWBLs",
      "email" : "PAOmWdU0@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_p9C3dsMzG7sGZNpPSVv8G",
      "name" : "wilNQjfaRB",
      "email" : "7vUki41t@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:31.134092Z",
    "updated_at" : "2025-10-31T11:56:31.134092Z"
  },
  "animal" : {
    "id" : "aml_2tXaR0tpyWJt9IrpqYdNw2",
    "study_id" : "sdy_3HlWtf7Vh4m7DBOgnvbHcM",
    "study_group_id" : "grp_1Dw3YoLH0DrYuB0tAhI5sq",
    "cage_id" : "cge_xBfaXCkS0FjPX9ImyiXjy",
    "catalog" : "A0000001",
    "name" : "qzE4rPYXDM",
    "number" : 1,
    "strain" : "U2LU5THMwr",
    "species" : "p2Nrj2iRMq",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "ehGkvotxhV",
    "ear" : "rRRIPEZsD0",
    "tag" : "K7CH2HorVf",
    "donor" : "UitAXU7o31",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_2HRtZfNA8Rk9u2Lv4LCLJx",
      "name" : "gQGgim9zWu",
      "email" : "bYCFZre4@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_4huveePkpGraZivqdKGKbb",
      "title" : "Found dead",
      "comment" : "9uNpSkhZFv"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:31.303826Z",
    "updated_at" : "2025-10-31T11:56:31.303826Z",
    "disease_induction_date" : "2025-10-31"
  },
  "measurement" : {
    "id" : "mst_3ZM0qhBN9bkOzfaxXveZII",
    "study_id" : "sdy_3HlWtf7Vh4m7DBOgnvbHcM",
    "animal_id" : "aml_2tXaR0tpyWJt9IrpqYdNw2",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_4DtnRyzrJ0FunkHLFVxGc1",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "created_at" : "2025-10-31T11:56:31.375585Z",
    "updated_at" : "2025-10-31T11:56:31.375585Z"
  },
  "user" : {
    "id" : "usr_3ylSmUZIbuOeyXkUtWRguj",
    "name" : "Ew3k1 Overwatch",
    "email" : "aoPol7tT@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:31.112507Z",
    "updated_at" : "2025-10-31T11:56:31.112507Z"
  },
  "treatment" : {
    "id" : "tmt_28Hk9fDcM2U08wBI73McZS",
    "study_id" : "sdy_3HlWtf7Vh4m7DBOgnvbHcM",
    "type" : "concentration_mlkg",
    "name" : "OOX27YiPVp",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "created_at" : "2025-10-31T11:56:31.380784Z",
    "updated_at" : "2025-10-31T11:56:31.380784Z",
    "external_entity_id" : "6Bh70xAnzF"
  },
  "created_at" : "2025-10-31T11:56:31.386460Z",
  "updated_at" : "2025-10-31T11:56:31.386460Z"
}

List all animal dosages

Returns a list of your animal dosages.

Path parameters ./api/public/v1/animals/{animalId}/dosages

Parameter Description

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of dosages to return per page.

page

The page of dosages to return.

Request

GET /api/public/v1/animals/aml_1ZKSuFWUyPxDJbQ9uGNrGe/dosages HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI5NGMzNDliNi1jN2IzLTRjNGItYTc0ZC02NmE2MjIzZGI2YjIiLCJqdGkiOiI0ZThkNTRiOS05MmQyLTQ5NWMtYTdiNS1iNjE3OWE1ODgzZWYiLCJpYXQiOjE3NjE5MTE3ODksIm5iZiI6MTc2MTkxMTc4OSwiZXhwIjoxNzYxOTk4MTg5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.j0Qk8EliAUBF-bMRvUaLze69EZ0mTNDfHXD8mubmMDLR51nvJPC8qm6ap9IFg54-cD0GkttChIXSlMoAwbrZ7YdwB0e87ECg79CFPjWe_4TPiKD6KPJRqpKpC71tv_Bl6-ANw2Bf_v8gCb20etfQVDWUxY4XsOaXGnQGHl6vV0vs0_C1ZqznDnEw4Js_odh-5if1l0tCPDdLezGg5EBH9vBcgX7fEjZTXfoo4ZWKx9pbAQcAgmu2JGPGhrSgA6AyBbTs0AN5A-Qv1LTrslVvox34I5HdnDLGLtvUrKyUW-sSOtKedLoOTAnNwLFGI1ADHexYzxpT8wGY3-6UcYW9NLgAe452fiA-W75A8ts4qQbZLXZol0m283lhsfjFpbVyqfukFX7hGoYvvYGDJ8V7Dp3An9E1jgmPxHU_zbumghdxvjiXd8jYsZdHpVa9yq5Q7xi1tt2dBdOrWF_oqEOULegfSpbqvuW4ZllDvlbTBnlJC0CRACJl4rmviWqsEIT-cMt_a6QUs8ttpznb9W-CRkW2QhCWfOx6KfITWxRJAKucXavVac49tS-oHoOFapimEZUrp271HM1nwK6ee5mtAF5Fv2upinhWYoaloIecY6KXE6hpsM0xRYNJAPvXA3GD2aXsKh2F36s1YTnyvWgkuI6cXpWqxhgJzhh_6lGa3rU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 5373

{
  "data" : [ {
    "id" : "dsg_1eWRr69xL0hCkZXRecFgrH",
    "name" : "Example dosage",
    "dosed_at" : "2025-10-31T11:56:29.532006Z",
    "comments" : "99Ayx1o7O5",
    "weight_at_dosing" : null,
    "dose" : {
      "unit" : "mg/kg",
      "value" : "6.17",
      "display_unit" : "mg/kg",
      "display_value" : "6.17"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "13.05",
      "display_unit" : "ml/kg",
      "display_value" : "13.05"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "23.63",
      "display_unit" : "mg/ml",
      "display_value" : "23.63"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "32.44",
      "display_unit" : "µL",
      "display_value" : "32.44"
    },
    "study" : {
      "id" : "sdy_5lZiV8rQxcmPeRKHYN6QrC",
      "project_id" : "pjt_1QV4GNfH0oQLcwNilOpRr7",
      "name" : "HhhGzF2mMY",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "Y3QtZTADsy",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_l0o1Ut08KERQfIuAu0Ikp",
        "name" : "6kxM4dCMC2",
        "email" : "ujdEfW1R@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3oFKYsckn4T4lyjXxlc8eB",
        "name" : "J6sShSk2BC",
        "email" : "XCoyXtaK@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:29.288440Z",
      "updated_at" : "2025-10-31T11:56:29.288440Z"
    },
    "animal" : {
      "id" : "aml_1ZKSuFWUyPxDJbQ9uGNrGe",
      "study_id" : "sdy_5lZiV8rQxcmPeRKHYN6QrC",
      "study_group_id" : "grp_HGttTQUwDaWKWAjWdvNMJ",
      "cage_id" : "cge_3NGXU6u0WtcXOd7g0UT9Et",
      "catalog" : "A0000001",
      "name" : "K75Usjkm0l",
      "number" : 1,
      "strain" : "jetNBz4MvW",
      "species" : "CMaBEEHVSh",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "euzN3DeQLx",
      "ear" : "mKOM78rOIy",
      "tag" : "9nNS0OBou1",
      "donor" : "kzYBH1qtit",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_79h1gKbMjwTbslHDzWk8K4",
        "name" : "4fSORWLYuT",
        "email" : "ATBy8Qnq@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_7JVeUpctck4RrHfAP9tG4D",
        "title" : "Found dead",
        "comment" : "UMVaOmz0Hx"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:29.445252Z",
      "updated_at" : "2025-10-31T11:56:29.445252Z",
      "disease_induction_date" : "2025-10-31"
    },
    "measurement" : {
      "id" : "mst_4pxKqREzZj52iMrYZvbSsQ",
      "study_id" : "sdy_5lZiV8rQxcmPeRKHYN6QrC",
      "animal_id" : "aml_1ZKSuFWUyPxDJbQ9uGNrGe",
      "measured_at" : "2025-10-31",
      "calculations" : [ {
        "id" : "vbl_5VmMgDqnuT70xDBbBqmRGg",
        "key" : "weight",
        "name" : "Weight",
        "unit" : "g",
        "excluded" : false,
        "value" : "55",
        "formula" : "weight",
        "variables" : [ ]
      } ],
      "created_at" : "2025-10-31T11:56:29.519683Z",
      "updated_at" : "2025-10-31T11:56:29.519683Z"
    },
    "user" : {
      "id" : "usr_179zi38Bf6v5pfsiX1t4Gm",
      "name" : "emuWo Overwatch",
      "email" : "kpEik8xU@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:29.274230Z",
      "updated_at" : "2025-10-31T11:56:29.274230Z"
    },
    "treatment" : {
      "id" : "tmt_1PaEGkTxuSQrCnTRLPG6rb",
      "study_id" : "sdy_5lZiV8rQxcmPeRKHYN6QrC",
      "type" : "dose_volume",
      "name" : "aR4TWCpaPe",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "created_at" : "2025-10-31T11:56:29.525124Z",
      "updated_at" : "2025-10-31T11:56:29.525124Z",
      "external_entity_id" : "WI7WWCUyzc"
    },
    "created_at" : "2025-10-31T11:56:29.532015Z",
    "updated_at" : "2025-10-31T11:56:29.532015Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/animals/aml_1ZKSuFWUyPxDJbQ9uGNrGe/dosages?page=1",
    "last" : "http://localhost:8080/api/public/v1/animals/aml_1ZKSuFWUyPxDJbQ9uGNrGe/dosages?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/animals/aml_1ZKSuFWUyPxDJbQ9uGNrGe/dosages",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Animal Measurement

This is an object representing a measurement that has been recorded from an animal on a day. Measurements are created in studies which have a preset, typically for observable data like tumour volume or blood glucose.

Attributes

Path Type Description

id

String

The unique identifier of the measurement.

measured_at

String

The measured at timestamp of the measurement.

calculations

Array

The calculations associated to the measurement.

study

Object

The study of the measurement.

animal

Object

The animal of the measurement.

user

Object

The user that recorded measurement.

created_at

String

The created timestamp of the measurement.

updated_at

String

The last updated timestamp of the measurement.

calculations[].variables

Array

The measurement calculation variables.

Retrieve an animal measurement

Retrieves the details of an existing animal measurement.

Path parameters ./api/public/v1/animals/{animalId}/measurements/{measurementId}

Parameter Description

animalId

The unique identifier of the animal.

measurementId

The unique identifier of the measurement.

Request

GET /api/public/v1/animals/aml_5DyLyN5PkyLkOUsFaTOgx5/measurements/mst_WRxnmDKX86k9NXOBK7ejA HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI4NzUyYzFjYi1jZWRhLTRhZTktYWM1Ny1kMjY4YzU1OTdmNmEiLCJqdGkiOiIyZGNmMWVkMi1iYWQyLTQwOTctOTFkMi1kNDA0MWU2NzFjZmYiLCJpYXQiOjE3NjE5MTE3OTgsIm5iZiI6MTc2MTkxMTc5OCwiZXhwIjoxNzYxOTk4MTk4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Pi7P2pM7uvGfj-TsCs5b9A4twtpg7a9nOr8pFwsnFD9hk-3MZG6DxufVToujm0YO7veRB66KZUdMkaPycxbjnwZ3OWcRQo_wZJ8cZAGZw4rfe-maHpGCVClOaO_AR0OY8vc_OpXV32N0n5GFcJhLg6r85Rmeq3ys2d9c-ONwVgdLzv0nWlNZQ7YI_ijqVLQuWLHvnTRLCM2qt1_Hu6km_jgenzBNyqbvYDnlbVw0y2m0_BgapU9rfvGB9cjnQoLo4wb-ohnU6BZjFW2tVANookMFK3WU6e8B9tLvyBxgMhPq8i6iagixFt8yFvsRAjzoxAZjk3xxOSKwnL6tATDaDVULqqveu7RxLCKlYO-pq3QHzsdhS0JZFJC2M86cH_BltRkdDLUqBoNxNw_8J80XHJgyMeRbTEPvRHmG1Eb_n6Pdz9VrT_DnllzsgqPh5WvXdv86CFW3kV9ddCqwIdWO40gGEnNolv6CQ_2ohUn1ndSgdV-MGCVu9PaSRdhd2KtyNPQy_GJkmLkkvJHRoyYtoOV22JMuqRjoZDy3xCb03uyUzpCNEhnOWyLMX-6LdFTK0XaWkaCmhpmtfW7dftyRDwGneo9Fk7iRibG_vBlOqxJAltV45UAwFpnp04AQAaSdKl7nqDDNhcYfZsdiygerFiRHexOS-eajLUf4UilGNOQ
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3202

{
  "id" : "mst_WRxnmDKX86k9NXOBK7ejA",
  "measured_at" : "2025-10-31",
  "calculations" : [ {
    "id" : "vbl_1hLvVMmzTbWbQslEN6arIu",
    "key" : "tumour_volume",
    "name" : "Tumour Volume",
    "unit" : "mm³",
    "excluded" : false,
    "value" : "75",
    "formula" : "(width * width * length) / 2",
    "variables" : [ {
      "id" : "vbl_3lKtuO4p2u00emXPHyS3jG",
      "key" : "width",
      "value" : "5",
      "unit" : "mm"
    }, {
      "id" : "vbl_5oY1a0zBpBDGOKFajYHEfQ",
      "key" : "length",
      "value" : "6",
      "unit" : "mm"
    } ]
  }, {
    "id" : "vbl_4KI8ux7TrhxQd08Y07z8oN",
    "key" : "weight",
    "name" : "Weight",
    "unit" : "g",
    "excluded" : false,
    "value" : "55",
    "formula" : "weight",
    "variables" : [ ]
  } ],
  "study" : {
    "id" : "sdy_21eT38g1dZN5SndmyvLKr9",
    "project_id" : "pjt_4OVFkRq8IXXI6zpOyD62g9",
    "name" : "XehlwIDn6t",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "RTsCNPgvwD",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_JJXg8IPtGOAMXaq96dZ9Y",
      "name" : "jiXFB2xNEX",
      "email" : "wqtlSgk1@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_4PrnDGxJ8eKXFmQRw8fI69",
      "name" : "8YqNJfm9nR",
      "email" : "Tsa4qvcF@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:38.299031Z",
    "updated_at" : "2025-10-31T11:56:38.299031Z"
  },
  "animal" : {
    "id" : "aml_5DyLyN5PkyLkOUsFaTOgx5",
    "study_id" : "sdy_21eT38g1dZN5SndmyvLKr9",
    "study_group_id" : "grp_11R6qUsOu7F4HFN0QnHasV",
    "cage_id" : "cge_3vt4qnq7bQPBOo13ma4GPk",
    "catalog" : "A0000001",
    "name" : "FaLxCoLV7p",
    "number" : 1,
    "strain" : "Y5S0f6WJsJ",
    "species" : "9gdjv6dzj2",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "x9YiIT9dCl",
    "ear" : "euoWxbXPtu",
    "tag" : "Tf2UuRlhDf",
    "donor" : "zj8N0RDEBv",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_6obQCZRYhrZrUH8oUZZiCj",
      "name" : "uIjcajKJSZ",
      "email" : "JEt86zwT@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_7B8ta8sJZ0xoP1xCRUSGJw",
      "title" : "Found dead",
      "comment" : "k7SnsRPHbq"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:38.450664Z",
    "updated_at" : "2025-10-31T11:56:38.450664Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_5D2BBz4q4z4RWmeqsTGXnl",
    "name" : "yFDKq Overwatch",
    "email" : "2cfQ9qsD@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:38.289086Z",
    "updated_at" : "2025-10-31T11:56:38.289086Z"
  },
  "created_at" : "2025-10-31T11:56:38.522371Z",
  "updated_at" : "2025-10-31T11:56:38.522371Z"
}

List all animal measurements

Returns a list of your animal measurements.

Path parameters ./api/public/v1/animals/{animalId}/measurements

Parameter Description

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of measurements to return per page.

page

The page of measurements to return.

measured_at

Filter measurements to return by date (yyyy-mm-dd).

Request

GET /api/public/v1/animals/aml_3SxZspZ4qtEIpdxEZ0LY7K/measurements HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3MWU4YWQ3ZS00MmIyLTRiZWQtODY2My1kYjA1Y2Q0YzM3N2MiLCJqdGkiOiI0ZjdkNjUyNC00YTExLTQ3MDUtODE2OS03OGE1N2VmOTYyMzUiLCJpYXQiOjE3NjE5MTE3OTksIm5iZiI6MTc2MTkxMTc5OSwiZXhwIjoxNzYxOTk4MTk5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.HyltwE9uYYVXtd3RsBVHFIYS2R3UhI3O3xC7zwAhIxyMA_iA2SKTDqLi9E4LizNHZDuVIfpqBoVsKQp4M2zI3iKnV2NNjJSv17Vb_eVDigW7LwbaPQbd1t1uFoEyof9JtcLoABeZVD9ofLcwwZjFPCzNGvUryn2qVhEY8ee8iV4rZCgCLUdOEUPFZWFczIiygmtUsSPYUYvR7TXelsjhzstCQCmCpkLEDD4Eg8splEM63cK3QRFt3A1Ud2jbgRVhjUO2-MFRAgK6nplp77_17tJzffOgW4Xgmu8hmfbu6hgFpUL6n4fM0bL7KwgVSNZsswLsAJU44zO09r9s4fAQyu3Wy8mrnJ5rMsOpnfcpeloa0OyhgV2UNoMPQ2lag0Z7rWBEuKy1YioPcE_Qx0mOdAbx7zUzG5y_pXB0LwPiYtFtX9jh_NOa0lmFPizw14s5Qoo4l6t2P4OCeV_zQo54z1Let5u2qupKb0dKzo7PaxEk6Ka29mV3A866UxHNvLTyV-hRAEuD0t03KRbq8bquSaN5TU8XoApjJ_wXw2mHEiobaL6kODx0X28OtLApNhrK21yD_lRzvqsAMyqPPzTB5_rZKJZjLefiTEsdCZyGnMIELH0IgSZVcJNidHtmc4-UtE_fzQR9LtpcrRYHb-xKymh6_S5iCKgFiWnsCpsAXQk
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 7381

{
  "data" : [ {
    "id" : "mst_6ndDB0Aa6Xu79b4xQ7SeD3",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_2RRSOJ7Ckko8c4mjEPEt1P",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "75",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_6SpmaArdspSd4DZYFpY1AW",
        "key" : "width",
        "value" : "5",
        "unit" : "mm"
      }, {
        "id" : "vbl_6Jo3dhQIdM8pI09dEfKoDe",
        "key" : "length",
        "value" : "6",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_7SgqrysifDWu3dFmmFuBtJ",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_5vTZiNdXTh3pBuqQP73wkG",
      "project_id" : "pjt_1BiHbeqZcqNtH1o9bsuNp",
      "name" : "S8yaiE5iPz",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "k49irM1zrk",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_3qDtvJ8clrwHl1Jo5cqwOB",
        "name" : "gbmBE8dpH7",
        "email" : "JaQyRlw8@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_23rTf2aH04tM7QXZF5i5K8",
        "name" : "AQ5qXEukAq",
        "email" : "DKdAOKWw@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:39.681456Z",
      "updated_at" : "2025-10-31T11:56:39.681456Z"
    },
    "animal" : {
      "id" : "aml_3SxZspZ4qtEIpdxEZ0LY7K",
      "study_id" : "sdy_5vTZiNdXTh3pBuqQP73wkG",
      "study_group_id" : "grp_4fhSljYrqujSinPmtP61H6",
      "cage_id" : "cge_7888DZYoQwf1zvFcewj5Ts",
      "catalog" : "A0000001",
      "name" : "jlk1RUvF7w",
      "number" : 1,
      "strain" : "xSLDxuY2mP",
      "species" : "HTj3LTXWXW",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "fm09G4yrwo",
      "ear" : "dz7v9S9lH5",
      "tag" : "EZoFoQWyj1",
      "donor" : "hbFty69iqj",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_2oqoaFv5XrEF5nycjM4sMp",
        "name" : "GM0UjqojY9",
        "email" : "058Xjwab@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_1Fdtgr4o25yegQ2DbTgnKQ",
        "title" : "Found dead",
        "comment" : "sBtkzavYWU"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:39.840332Z",
      "updated_at" : "2025-10-31T11:56:39.840332Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_1KjK3G0RtvU0LlQtr1Xb6s",
      "name" : "8NL2u Overwatch",
      "email" : "jnogfNJ8@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:39.661563Z",
      "updated_at" : "2025-10-31T11:56:39.661563Z"
    },
    "created_at" : "2025-10-31T11:56:39.911715Z",
    "updated_at" : "2025-10-31T11:56:39.911715Z"
  }, {
    "id" : "mst_5RKYWOwHosUbKo8S3Q9oJm",
    "measured_at" : "2025-10-30",
    "calculations" : [ {
      "id" : "vbl_5gZBCGhh7Qu531qyoeSzNI",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "196",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_6NuDHaojrlVI6MiqWGfKal",
        "key" : "width",
        "value" : "7",
        "unit" : "mm"
      }, {
        "id" : "vbl_50Rrngen5SfvizQ25P0XiB",
        "key" : "length",
        "value" : "8",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_6eif6iEOyJSvGlUrti8sHD",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "56",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_5vTZiNdXTh3pBuqQP73wkG",
      "project_id" : "pjt_1BiHbeqZcqNtH1o9bsuNp",
      "name" : "S8yaiE5iPz",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "k49irM1zrk",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_3qDtvJ8clrwHl1Jo5cqwOB",
        "name" : "gbmBE8dpH7",
        "email" : "JaQyRlw8@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_23rTf2aH04tM7QXZF5i5K8",
        "name" : "AQ5qXEukAq",
        "email" : "DKdAOKWw@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:39.681456Z",
      "updated_at" : "2025-10-31T11:56:39.681456Z"
    },
    "animal" : {
      "id" : "aml_3SxZspZ4qtEIpdxEZ0LY7K",
      "study_id" : "sdy_5vTZiNdXTh3pBuqQP73wkG",
      "study_group_id" : "grp_4fhSljYrqujSinPmtP61H6",
      "cage_id" : "cge_7888DZYoQwf1zvFcewj5Ts",
      "catalog" : "A0000001",
      "name" : "jlk1RUvF7w",
      "number" : 1,
      "strain" : "xSLDxuY2mP",
      "species" : "HTj3LTXWXW",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "fm09G4yrwo",
      "ear" : "dz7v9S9lH5",
      "tag" : "EZoFoQWyj1",
      "donor" : "hbFty69iqj",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_2oqoaFv5XrEF5nycjM4sMp",
        "name" : "GM0UjqojY9",
        "email" : "058Xjwab@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_1Fdtgr4o25yegQ2DbTgnKQ",
        "title" : "Found dead",
        "comment" : "sBtkzavYWU"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:39.840332Z",
      "updated_at" : "2025-10-31T11:56:39.840332Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_1KjK3G0RtvU0LlQtr1Xb6s",
      "name" : "8NL2u Overwatch",
      "email" : "jnogfNJ8@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:39.661563Z",
      "updated_at" : "2025-10-31T11:56:39.661563Z"
    },
    "created_at" : "2025-10-31T11:56:39.916808Z",
    "updated_at" : "2025-10-31T11:56:39.916808Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/animals/aml_3SxZspZ4qtEIpdxEZ0LY7K/measurements?page=1",
    "last" : "http://localhost:8080/api/public/v1/animals/aml_3SxZspZ4qtEIpdxEZ0LY7K/measurements?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/animals/aml_3SxZspZ4qtEIpdxEZ0LY7K/measurements",
    "to" : 2,
    "total" : 2,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Animal Observation

Retrieves the details of an existing animal observation.

Attributes

Path Type Description

id

String

The unique identifier of the observation.

glossary_id

String

The unique identifier of the glossary item.

title

String

The title of the glossary item.

text

String

Text related to the observation.

type

String

The type of observation recorded.

value

String

The value of the observation taken.

observed_at

String

The timestamp of when the observation occurred.

study

Object

The study of the measurement.

animal

Object

The animal of the measurement.

user

Object

The user that recorded measurement.

created_at

String

The created timestamp of the project.

updated_at

String

The last updated timestamp of the project.

Retrieve an animal observation

Retrieves the details of an existing animal observation.

Path parameters ./api/public/v1/animals/{animalId}/observations/{observationId}

Parameter Description

animalId

The unique identifier of the animal.

observationId

The unique identifier of the observation.

Request

GET /api/public/v1/animals/aml_1ypC7GbHsf8VrZdsAE9BSE/observations/obs_6g5dWmCjpnhbSPqYZK06uY HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3ZDgxNTczMC02NDc3LTQzOTktYjhkMS05NWJiZjE3MWY2ZmQiLCJqdGkiOiJhNjBkZmFlYy0wYzcwLTRlYTYtOTE0OC0wMTI1ZmNlZWEzYTciLCJpYXQiOjE3NjE5MTE4MDUsIm5iZiI6MTc2MTkxMTgwNSwiZXhwIjoxNzYxOTk4MjA1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.OEOj-vQ1gEgXpoBK1wiyXKgLnWNKBAp_HVCTDNCZxAmjZ0MJipr6qA7nW_F-ISQE_W3psM_EPpuKT6cBIDpfEbWU5_AvKWvBRUywdtkJpdvi90pzYasMgvmuiIfIWwULHr_80tZQZSss6G0z35pxFlWs3Z7BVvaXPLcrXWTMnpFc4b0Jv-8EjvmDi7SUo4rHTOxvTjksaKSuHZbouESyaJubtsdBkybkoCtzEXDXqnTjI934H-NkPvqcq5ryAohiau948EWN4C-6lHQqqbooqNfhX4cQ6hQAULEWMCVleGRBim4It6VZwR6LZ7l-hKdjqu0l_xXA7Z0pARdBpanDFbpmK5R1D3eLtvhztcspvPn3kawlxMoF7jXWbKgzogLSIQAuPhyOxyMVSMcbVom5_ExDcspI2EOFO13ZQ6zs7dSpHZSH5ftlF8uYMTyfdw4PRsIscfD2TpSWMj4nhuS0olBvdqd5gnsy6jrbknBz4cnGlUKZ8m4cu5xiAGYpBf3U0pGQnkZzWBuRLSbuFev4kvCHYof9IuT0rjejE-mbSUkCJL1nWmd8wOOrUmL5FLxw8wV7q4wFKlMfvZndr1HidEbTC4kUFPVikzRUv8_igjXoykM5Z7JEIfiI9FB9T4z7vuTFt-p_jn5uvz6QC5g0u_WUxcuuDTVHWafP2cQuBog
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2676

{
  "id" : "obs_6g5dWmCjpnhbSPqYZK06uY",
  "glossary_id" : "gly_1B4lc1OTAO4jAJ8N6HcAbm",
  "title" : "Observation Glossary",
  "text" : "Example text",
  "type" : "severity",
  "value" : "Severe",
  "observed_at" : "2025-10-31T11:56:45.122417Z",
  "study" : {
    "id" : "sdy_2WEiOvsGZxN6FlCjzMIdUv",
    "project_id" : "pjt_4bf5JDhfwYwRFROBFa4im",
    "name" : "vOxQhqk888",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "WWJ6yZeJcA",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_5vudn4qUiYoeELjTBqTspH",
      "name" : "4y99iiLTgL",
      "email" : "s37uz5fS@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_663fY4PEcnBkqJ3wrD1O6M",
      "name" : "P5j0TpoeDa",
      "email" : "Abqhjhjx@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:44.891452Z",
    "updated_at" : "2025-10-31T11:56:44.891452Z"
  },
  "animal" : {
    "id" : "aml_1ypC7GbHsf8VrZdsAE9BSE",
    "study_id" : "sdy_2WEiOvsGZxN6FlCjzMIdUv",
    "study_group_id" : "grp_5NgaaVrXokjsWlyBVjrHsQ",
    "cage_id" : "cge_62XxSnuLu4moYfLzhqYit9",
    "catalog" : "A0000001",
    "name" : "4eCjRKcQDc",
    "number" : 1,
    "strain" : "6j3ysVcr6W",
    "species" : "AKElbH4Xf2",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "eDV37tdlKe",
    "ear" : "7DXtbF6th1",
    "tag" : "3pyssMGWzx",
    "donor" : "ZUZcIFsmVV",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_5UpbqdfJQdw3lx7dlQzVZp",
      "name" : "QETxxZjPPg",
      "email" : "ZkZ5XsWu@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_5bysQCXm3ap39Gp4IpdLx9",
      "title" : "Found dead",
      "comment" : "XJSnaYTvjX"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:45.048207Z",
    "updated_at" : "2025-10-31T11:56:45.048207Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_2oGXXOzx2QuGtW9USJrmwz",
    "name" : "jhDro Overwatch",
    "email" : "SDusZeOJ@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:44.876929Z",
    "updated_at" : "2025-10-31T11:56:44.876929Z"
  },
  "created_at" : "2025-10-31T11:56:45.122515Z",
  "updated_at" : "2025-10-31T11:56:45.122515Z"
}

List all animal observations

Returns a list of your animal observations.

Path parameters ./api/public/v1/animals/{animalId}/observations

Parameter Description

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of observations to return per page.

page

The page of observations to return.

Request

GET /api/public/v1/animals/aml_27KIT1ZeJqmKzdHX80ZKiH/observations HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyYTA5NWYxMS0zNDM1LTQ2N2ItOWJiYi1lNzc2MWVmZWMwNDgiLCJqdGkiOiIwNjdhNWQ5Yy0zMmJmLTQ1NjUtOTY5Yi0wYmRlZjE2OTIwZGUiLCJpYXQiOjE3NjE5MTE4MDYsIm5iZiI6MTc2MTkxMTgwNiwiZXhwIjoxNzYxOTk4MjA2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Z5lXUHFpC4WiJTA9nBiN3dbqZwcsIZtikDPGk2cP7KyoyKcwvR-AUk2y_sz7VykkQd5PGGdS3VUfsnbj8F5MaxHi3mCSoce-gSK680VjNrYgz_Z5BBQFZ_5d2JQmTybLA5ZG8gLb19hfBG5IqhiUCnZRHlcTknpnTfxbOVYDHSNPzi-zmecw8dF-5X-uhWr-cYG8Vhm9rPm095bRFpDuXapOZ14bQUuNoSOa5yjPNpWJqPbZ3Nnsj6270xORoHaxDE76gghjhGqnJHXg4fWY2baIa9SDMh2iVfC30u-KejXTG-H85z7zQYieh-vav1tzfFkswdtSdKyFMWVePBqctgzPI17Kxcu6TDC4CNcw_9_QLs6sVjDXScteOrRr31evxtbgSg5_sNoR4j4j1Jh7QkqkVR6leY1g57zVUCuEwcm2d08IKd6xvgvyuope3tTLcGAKblEIxlZTvv89-jLevlKIr9nOagfDgIg73AUMZZmOeVTLUa8LrVg8pp3hfcoCegAldn0O6ZQhvsiQXAicYPk5lKCf9M4IU8Y_JM8he7ZwCqcsCi3GUEhEtBzVPE_bfqUXrK3lR6e1TVApAFiCNgtuUjf0_-ydL44qIs_nZD2_Kn77HX-5Hw5rNh1jUjjYPtUk1C8DksT9L_46RLaW9XAYKho4hA3DJwCwnGcf2K4
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3374

{
  "data" : [ {
    "id" : "obs_1SbOGigNKnSsywZrbAnaBA",
    "glossary_id" : "gly_2hF0k3wp9pJEtLRhOtUATf",
    "title" : "Observation Glossary",
    "text" : "Example text",
    "type" : "severity",
    "value" : "Severe",
    "observed_at" : "2025-10-31T11:56:46.820397Z",
    "study" : {
      "id" : "sdy_55Xjb8IJb3pEXWlcpQlc1k",
      "project_id" : "pjt_7byXjOOIFK7fkrXXnhGYRu",
      "name" : "bmFVzg3YGd",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "zKv6dhBx1p",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6H6PdOIxvsSktzH6Vxibjc",
        "name" : "ENIpqXrLMr",
        "email" : "MNrqgBqN@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2QnOIkFnORU5CfeGDR7jhb",
        "name" : "IGWAfpke3L",
        "email" : "zfvyHpxR@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:46.590160Z",
      "updated_at" : "2025-10-31T11:56:46.590160Z"
    },
    "animal" : {
      "id" : "aml_27KIT1ZeJqmKzdHX80ZKiH",
      "study_id" : "sdy_55Xjb8IJb3pEXWlcpQlc1k",
      "study_group_id" : "grp_3LsLCHoaFS7Cc4aOu2jIeK",
      "cage_id" : "cge_VWpVJhqKbkpuflkuquprk",
      "catalog" : "A0000001",
      "name" : "ebzjy1phMi",
      "number" : 1,
      "strain" : "cXrPPBOcKh",
      "species" : "weqGSqMQcL",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "RyXpTF1JnW",
      "ear" : "2BB9HJcJrT",
      "tag" : "8WVYjUwcXo",
      "donor" : "QxbF8VsjAf",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_6bx1isX1RtGLQub0YMO7gj",
        "name" : "mwagfzIVI3",
        "email" : "mjmcGS4F@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_4xuLy3ghQsMgVYl4IaPT1P",
        "title" : "Found dead",
        "comment" : "i8dsWWkWOj"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:46.743301Z",
      "updated_at" : "2025-10-31T11:56:46.743301Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_6DntN8hECDwtKggpiJEKFg",
      "name" : "a6F7i Overwatch",
      "email" : "I9xbVvwO@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:46.578318Z",
      "updated_at" : "2025-10-31T11:56:46.578318Z"
    },
    "created_at" : "2025-10-31T11:56:46.820423Z",
    "updated_at" : "2025-10-31T11:56:46.820423Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/animals/aml_27KIT1ZeJqmKzdHX80ZKiH/observations?page=1",
    "last" : "http://localhost:8080/api/public/v1/animals/aml_27KIT1ZeJqmKzdHX80ZKiH/observations?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/animals/aml_27KIT1ZeJqmKzdHX80ZKiH/observations",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Animal Sample

This is an object representing a sample such as blood or tissue collected from an animal in your facility. You can retrieve it to see the sample identifier, type, status (collected, planned, cancelled), timepoint, details like volume or mass and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the sample.

sample_id

String

The sample ID of the sample.

label

String

The label of the sample.

type

String

The type of the sample.

status

String

The status of the sample (collected, planned, cancelled).

timepoint

String

The timepoint identifier for the sample.

collected_at

String

The collected timestamp of the sample.

details

Array

The details of the sample.

comments

String

Comments of the sample.

metadata

Object

The metadata associated to the sample.

study

Object

The study of the sample.

animal

Object

The animal of the sample.

user

Object

The user who collected the sample.

created_at

String

The created timestamp of the sample.

updated_at

String

The last updated timestamp of the sample.

Retrieve an animal sample

Retrieves the details of an existing animal sample.

Path parameters ./api/public/v1/animals/{animalId}/samples/{sampleId}

Parameter Description

animalId

The unique identifier of the animal.

sampleId

The unique identifier of the sample.

Request

GET /api/public/v1/animals/aml_4unv17Hy3HltWbMA8p40l4/samples/spl_4Rhay5AP3S4LSIr5GdhGKq HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkMTJiY2Y2Yi1mYTg0LTRmZGEtOWYzYi0xYmI1MzFlNDJjOTYiLCJqdGkiOiIzOTgyNTYxOS02MmM1LTQyZjItOTNkYS0wY2ZmNzc2OTc2MjYiLCJpYXQiOjE3NjE5MTE4MTgsIm5iZiI6MTc2MTkxMTgxOCwiZXhwIjoxNzYxOTk4MjE4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.UedJeX7A45b9c_g31XDjvhC88U-c-1-JDfkBi1CxOKh5C4CBos42Y6dcspfVw2Y3K0SptcqZvgj-H-XzeB2-_z69HoLU2mGABLDL9FUUzZhT0WapmXXRD3qFR_XxnEGMTmauZ8CSWWQRU7Y7U9qEoq4_Y8Wja4oiV82AXKfboPnwXoibnWCftxIGKgHD5QXHFsN4YIKStY35nZid0uoYcnQGZl0MN1bSPKt0ijltGWLZpvj6FbGvN0jwKlhtXtepiNbCOEUpPbC7a6maW5ufuu3TPmsKmUCkCYD5mSH6HTgqfY_zi6nQI7lFXkWpAYVm1EnxNG1rT1GAWGGEZIztguz8Y5FVlekOkBlHm-f-MX6Uso-fluFfpOmPWkSyWeNln-x0ExuKgAXEqlmhIJ9Y8f1kmKviBOxMnr76VJ6VJOejIpTr_DbIycdQKGVQN5Hj-i7LEWgoJmwYhVVRCFqzPAi5zeeWUaLK1lJn964NyjHAJC9sybPqnO7ErGY9gtXdxThCxnqh9LIafvF6GY5aZ0twYVpXrn9alg3k0hCVHSX43sJ7CxYlyMCcYTL5uOp6xPy3gkleN3k-feIHwitoLtPJ6idLEFBRTdRqyi3iiB2CKPZo3t5vhWDUHxitc13q_HOLjt0_f6nOEy0mCplsXFtEdDIBeYQBwY8Rvyrujw0
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2821

{
  "id" : "spl_4Rhay5AP3S4LSIr5GdhGKq",
  "sample_id" : "S622711786",
  "type" : "Blood",
  "label" : "BLOOD",
  "status" : "collected",
  "timepoint" : "PT15M",
  "collected_at" : "2025-10-31T13:56:58.748878Z",
  "details" : [ {
    "key" : "volume",
    "unit" : "ml",
    "value" : "5"
  } ],
  "comments" : "A blood sample",
  "metadata" : {
    "sample-internal-id-2024757966" : "SMPL-1234"
  },
  "study" : {
    "id" : "sdy_79skmPPRZPR5x4Z0tQz0fL",
    "project_id" : "pjt_389lqOU9aqLzO2Imld7dri",
    "name" : "TQbkkmRUw0",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "V7F8SunH3I",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_2iR0ogjFtw1y1Ep9ajycD",
      "name" : "67y69T9gwp",
      "email" : "b09IB1PB@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_55u9Pvg71i9vtwUenyUEKG",
      "name" : "7rBLYJ0ABN",
      "email" : "s9NuUzTa@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:58.424154Z",
    "updated_at" : "2025-10-31T11:56:58.424154Z"
  },
  "animal" : {
    "id" : "aml_4unv17Hy3HltWbMA8p40l4",
    "study_id" : "sdy_79skmPPRZPR5x4Z0tQz0fL",
    "study_group_id" : "grp_7ZHg9ofK0aPtq3al0ebHHu",
    "cage_id" : "cge_5yoVBY3IEsof6TiWl5NXEZ",
    "catalog" : "A0000001",
    "name" : "VI0yk4VfIb",
    "number" : 1,
    "strain" : "4QLMOboyMH",
    "species" : "FR7T012KdE",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "bU2yRTEmsv",
    "ear" : "Gtop4YIxl4",
    "tag" : "8oBZhsoaes",
    "donor" : "cjeQCBac1d",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_RgiuUjWtZpmpcrwAPbVKK",
      "name" : "t8R3mLY0Zx",
      "email" : "omlJoPDw@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_6iJkG3Rllvz1nCbqCyM1M3",
      "title" : "Found dead",
      "comment" : "2Pj6zOEw0O"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:58.588895Z",
    "updated_at" : "2025-10-31T11:56:58.588895Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_4bnsVYUsPUGTODYNViFlMI",
    "name" : "F7CEhVnqwe",
    "email" : "tCmn6EdK@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "3A2sJulQnM" : "rB6cTQhIKT"
    },
    "created_at" : "2025-10-31T11:56:58.739958Z",
    "updated_at" : "2025-10-31T11:56:58.739958Z"
  },
  "created_at" : "2025-10-31T11:56:58.748975Z",
  "updated_at" : "2025-10-31T11:56:58.748975Z"
}

List all animal samples

Returns a list of your animal samples.

Path parameters ./api/public/v1/animals/{animalId}/samples

Parameter Description

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of samples to return per page.

page

The page of samples to return.

sort

Sort samples based on an attribute (animal, cage, date, group sample, study or type).

order

The order in which the samples will be sorted (asc or desc).

metadata

Filter samples to return by metadata value

type

Filter samples to return based on sample type.

Request

GET /api/public/v1/animals/aml_7WCrxPswLapoibBVlxbfwM/samples HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhZDUyOTg0YS0zOWUxLTQwMGYtODFhMS00MWE5YmY5NmVjODciLCJqdGkiOiJkMjQ5YTI5Yy0wNzc4LTRkMTctOTdjYS1hM2ViMWNjOWIwYmMiLCJpYXQiOjE3NjE5MTE4MTgsIm5iZiI6MTc2MTkxMTgxOCwiZXhwIjoxNzYxOTk4MjE4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.m8LrPbZpvJpjWN8Ldw8Ws31daUE2KF3Ea3mTcPlU75xlbFEnZBx5ZizgaA5ziOF7dHZh7yP-zj1xnOa41RkfeswXFeadIxLp-QjnYf7SvD30bbMQEV4n_FFR3aL5QoHAFeQPLKx0hOBivNkUyTJbFNTgT0R2AcEupBTNxq3t3jUR3svHDhVRDq7LGAFyl6ZFtlhbM8y3QVFXAWU8wFwejxOFQHq4H4UNq630uUhY1wGCS7kat-A-i5TtymlfeTuRMfdsfiUD92T8HAZ6LK24BdEXlc3pw8uPU0ZljOJNJh3ItJxXHER4qWLWJjgBobPW_xP13WCZIIy9JwGc_9Wtg2oCWJLBV-BTUDpLWALeSrkQo5i5OvYAlssSFx_aEhqt5c9-tLZC25tQjDxs1MPbbmElVVVo9nTfmqP-9-fg5MXYGcizBR39ShHu4JZy4AtTiAelqjLmRiQe1DftDJrF7EUWBMqlrgKtEis-gwmmfRqi6--1MsxLKnQkIqSbo0CbCEkzHpUDigA8caPQzTSBrMNWkazD9riZO7hLRynm65Yiuz2da6BLeA8AxUcVnfTvQ-f2RfxVMSTjVQhWc5h8oL5LZhO7m3O_CTf4yuP9ztMpnae0A1VPuCtNgdqMHlBlnhyVz9ftrZ6KoHhT4Qrzep4AACkCSERVV20Nv8DyvpU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3522

{
  "data" : [ {
    "id" : "spl_5rDSuIAP4x55A1r47H7YlJ",
    "sample_id" : "S1761422776",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:56:58.049642Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-2025205451" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_QG8yuv8NdGVUZKicZmIoD",
      "project_id" : "pjt_2GgxdAdf89rhFQ2updZWkc",
      "name" : "DoAiVf2O7P",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "lFRSO2Ofte",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_3siCyDQeLxgbj8S1wNNrNG",
        "name" : "EmIR649k9t",
        "email" : "IUzmYl60@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_1INUwZ8CYLoSAN8YSyYweQ",
        "name" : "Jr358ZezyW",
        "email" : "etx3POOg@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:57.755798Z",
      "updated_at" : "2025-10-31T11:56:57.755798Z"
    },
    "animal" : {
      "id" : "aml_7WCrxPswLapoibBVlxbfwM",
      "study_id" : "sdy_QG8yuv8NdGVUZKicZmIoD",
      "study_group_id" : "grp_1pgwlyW2pipYVW7EhXXdNQ",
      "cage_id" : "cge_3JidzrqHcvW2BUFpQqKT81",
      "catalog" : "A0000001",
      "name" : "EK8mD8Bchk",
      "number" : 1,
      "strain" : "9GG3gyr8ih",
      "species" : "ArKGAHYVKW",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "3bPd6UnH4E",
      "ear" : "dMOAEa1Bcq",
      "tag" : "fV2anULk2m",
      "donor" : "n0x7ZFJXuL",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_gKvGPDaBlz86EdXXsUnN0",
        "name" : "2hsfRP5XNq",
        "email" : "wqoknaIC@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_305RncAKOaPaKszfT97ayD",
        "title" : "Found dead",
        "comment" : "pRW6LezYZv"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:57.910121Z",
      "updated_at" : "2025-10-31T11:56:57.910121Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_4OLAKIaHGVRrB09SA4jwr4",
      "name" : "ILfz77qKFK",
      "email" : "ZlB2NA2R@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "Pa8u8kzVMS" : "r9pSyA30Vj"
      },
      "created_at" : "2025-10-31T11:56:58.040450Z",
      "updated_at" : "2025-10-31T11:56:58.040450Z"
    },
    "created_at" : "2025-10-31T11:56:58.049691Z",
    "updated_at" : "2025-10-31T11:56:58.049691Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/animals/aml_7WCrxPswLapoibBVlxbfwM/samples?page=1",
    "last" : "http://localhost:8080/api/public/v1/animals/aml_7WCrxPswLapoibBVlxbfwM/samples?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/animals/aml_7WCrxPswLapoibBVlxbfwM/samples",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Cage Resources

Cage

This is an object representing a cage in your facility. You can retrieve it to see the catalog number, name and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the cage.

name

String

The name of the cage.

catalog

String

Unique catalog number of the cage.

metadata

Object

The metadata associated to the cage.

study

Object

The study of the cage.

created_at

String

The created timestamp of the cage.

updated_at

String

The last updated timestamp of the cage.

Create a cage

Fields

Path Type Description

name

String

The name of the cage.

study_id

String

The study of the cage.

metadata

Object

The metadata to be associated the cage.

Request

POST /api/public/v1/cages HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwNjMxZmRhNi03Yzc4LTQ5ZWEtOGM5YS0wM2MwY2FjOWFmMjciLCJqdGkiOiIwOWYwYjZkMy1jYWUwLTQ3MmYtYTdmYi0yZmM4ODE2MmNiMzciLCJpYXQiOjE3NjE5MTE3ODcsIm5iZiI6MTc2MTkxMTc4NywiZXhwIjoxNzYxOTk4MTg3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.HS6CpALJdAv35z9wMeV7eW2UPDs9PIT4Gsgj7Megga5mTlLtbE2u1XLKZqx6CQcIEEhYFT703oKzbI3QMtqQIqm8kVgPoTKB7Cfmyn8zQtnolMi1ZJEw9wtrPU6jBrKTpmjYkvtMYEZ4bPUaW6mUmH818h-W07hiUJc8txNi34oK-F5UxrkG34pbloohKlKy0ASnwBpem8kZ5p_D6-UzDLxMdzu_uQytT7U-ri88VZ6kHg2ruqXLDW9P_Topfppf7FMqPT_0Po40jge6ga_eeo9oXc7n4lWaUmfW6N2xZNb4Dl7uO6TFLw0LjsNgvF67fnb--h7fMUsDBZK4mXAfHPN23UZbGvFFc4NcWIjufXHv1LfX3evpfq16cehX05D9P3TOpAPfU2YY0McAZhGJpzv3_aiAbBCzAx9rP9eu9IKbcSeRY1PUUSAqb5aM3AtmXm_0bhWVKVM4WX5Px0NUknF9nyYMoBkWrE6l-tY4-te6cjNv2arimBFGO45x4gKcC0Uec3z78J9hyAds1USy13zs1qVNtNkijrr42tyvkRhg48ljVo2WddvRal6eIg_IyfujUp-5_nf8sOcfnfK-QkF1YlQKLU9kIVZOVfS97zDVlbMx-53lQHzbNrUeCMllrEafQEcZ-j4BbX_8YPFUSgJcJ3tp6MJHAI4AK78WHHw
Content-Length: 107
Host: localhost:8080

{
  "study_id" : null,
  "name" : "YhtxPB78Ou",
  "metadata" : {
    "cage-internal-id" : "CAGE-1234"
  }
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 265

{
  "id" : "cge_2XQDLWgCbrOWtM3eXWuqQz",
  "name" : "YhtxPB78Ou",
  "catalog" : "C0000001",
  "metadata" : {
    "cage-internal-id" : "CAGE-1234"
  },
  "study" : null,
  "created_at" : "2025-10-31T11:56:27.094533Z",
  "updated_at" : "2025-10-31T11:56:27.094533Z"
}

Retrieve a cage

Retrieves the details of an existing cage.

Path parameters ./api/public/v1/cages/{cageId}

Parameter Description

cageId

The unique identifier of the cage

Request

GET /api/public/v1/cages/cge_6SFjusPn8fbWpcBseJkHAW HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkZDZjY2M5Ni1hNjJiLTRhODktOTVkNy04OTQ0MzhkYTExOTMiLCJqdGkiOiJlMTA5MTk2MS02N2UxLTRhMmEtYjhmNi1iMTExNmUyMTBmOTQiLCJpYXQiOjE3NjE5MTE3ODUsIm5iZiI6MTc2MTkxMTc4NSwiZXhwIjoxNzYxOTk4MTg1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.idKphcynx__1dXzresFvsa6tIMenDqctPPNhlMb6cpRFo07Na3oygK86bfWDGbMksn__D8tBaWP68agMXtgsbHwU0K6fJYT47yHAw6m_YL4SpEudC5ef2w_NHFwFYT8AKnNm3p01s3zHv4hS2E7KnJSgVxal0doocto0vRF6pjJTAP8lmHkAIEbwo_d-yiOBMFqRYVGamapC5vqQioa9MgMxrzCtuDjk9nfaSf3Cl7PT5uI62tRuRq-7AWzkqRa7hDv7A60pjPjShm0Yb_PH7_2qbhesA4nTRGLOYOWM7_hCuQB9dCjVw_xcKomO7KKXZlJtOJ3bdpnkf2ujJAEpeHwjnz3NHpdDjsC-rCF8UQV6CGP4zZKONHBnQP0skW5IKzhibRP3oNG48dVySF7h-B05bBA82GPsBveJImsMM9XAqMwcf49qC7ptKYGixISyqyV0Fr0LAnfbxr-scKk9ecZExtTA4yG7RNJKaKiT388eW8MjkXIxlidb5g-4bjFmuyS4XQXzXG4xfWUh3_x8iw9QhA8uI3mNGPDJ0JvgDEsHaAzWgsQEux98ehC6p_uB8VpepbBF5Shgg1pCCr7ee8tsBvzoXGT3H8YZ3iXtDUCPhpsG2sAg-kV6p6kZF9GVb-guVcmb8TWdlGDKue-31zAO0F6hW6csMb-TCqljLr8
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1114

{
  "id" : "cge_6SFjusPn8fbWpcBseJkHAW",
  "name" : "cpUJ3S2brn",
  "catalog" : "C0000001",
  "metadata" : {
    "cage-internal-id" : "CAGE-1234"
  },
  "study" : {
    "id" : "sdy_5IX6MKysvnuOu97ef8RiGl",
    "project_id" : "pjt_1rjxGUd54X3d4mk3dx5IcU",
    "name" : "ZyiLxP1tWm",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "nNZFBgokz4",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_zCAjLed5xtT437wZVHkoF",
      "name" : "rHrZpDdiwa",
      "email" : "MO9y97C4@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_2QtHkesKopT8eKeGFqVhxE",
      "name" : "lt2foSYIt0",
      "email" : "vWpcP2K7@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:25.613671Z",
    "updated_at" : "2025-10-31T11:56:25.613671Z"
  },
  "created_at" : "2025-10-31T11:56:25.779260Z",
  "updated_at" : "2025-10-31T11:56:25.779260Z"
}

Update a cage

Updates the specified cage by setting the values of the parameters passed.

Path parameters ./api/public/v1/cages/{cageId}

Parameter Description

cageId

The unique identifier of the cage.

Fields

Path Type Description

name

String

The name of the cage.

study_id

String

The study of the cage.

metadata

Object

The metadata to be associated the cage.

Request

PATCH /api/public/v1/cages/cge_2jaLpgFdETIcrgSxcSZsi0 HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxOWE2YjgxMy0zNmM5LTRlOGYtYjZlMS1kMmFiZmYzYmQ2YmEiLCJqdGkiOiI3OGQzMzcyNS1hMzZmLTRhZTMtYmI4Zi1iMjkwYWY2Y2I2ZmQiLCJpYXQiOjE3NjE5MTE3ODcsIm5iZiI6MTc2MTkxMTc4NywiZXhwIjoxNzYxOTk4MTg3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.j5HN-F3n9R2TN0MKbN38c4c5ppxdb7L9c-bGaYMZGdxhUfVRsEOYZ3Tvh7rZegR3X_kNHn5oXm01uKzQoKbT5uVRBvuO9X0UR9EMtrZ4p2dGZVHgSMDv_gtZdPDNiqzB6jeK5XovCYegr6HXgvQS1V4fd8ZQCd28iqQCrrXoeEM5NhrCNMnle0AXLa68c_V951COgHiIpmbm8JJu-8TGW0E6zsuViKoMvVof-M42mPgtIFnQl6TSeatszRWmu3bh2J-NGHlJbSRbtsEp__xEFI9r1EW2fCbknVmCf9e7LPrIY9zZpn25WUFAoNwevn5qGY7iALrujQIDHfZoKnES1A-eUx1ICkEjUUKQedScoQdKDnCMUibMKiUsH7q9whW-0bASviKN0LgGz4oUpft6b2UHTzCRRgF79QmhLx5DGhwRVwBv7mi6Xr2QmeqqnJa9bwH4YrUzVDbd1tSmH3T7uClyENHxKUkt9z-3b9zgZOMyCoXdsjhEs9xwVghKAda4rVz0RGd_RLtkvFD8rBnLs1U8Pt9bCdpKopu9LAySr8L-7YjydTIlhHrS0W_SQK9N-iRVYiMLlI0n8TmjyoQpyifS0gBwaKAJqukgeU1Byvu-oQGgvUzxxkk8_J6DTy5rvXWMxrGrEniwJDYPx8w_z7D2_c1gqg2JzD1ckz4cxs0
Content-Length: 143
Host: localhost:8080

{
  "study_id" : "sdy_7JLO6LWqy6rY4mYD2sN6BT",
  "name" : "Benchling In Vivo Cage",
  "metadata" : {
    "cage-internal-id" : "CAGE-4321"
  }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1135

{
  "id" : "cge_2jaLpgFdETIcrgSxcSZsi0",
  "name" : "Benchling In Vivo Cage",
  "catalog" : "C0000001",
  "metadata" : {
    "cage-internal-id" : "CAGE-4321"
  },
  "study" : {
    "id" : "sdy_7JLO6LWqy6rY4mYD2sN6BT",
    "project_id" : "pjt_7OP78TPVLLlo3XDNATsvGZ",
    "name" : "84Oy3cGa7A",
    "code" : "CD-25-446",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "Ehy7HWQMBD",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "new-study-internal-id" : "NEW-STUDY-1234"
    },
    "author" : {
      "id" : "usr_4ZokpUZEMA1lNT04Z9AbO1",
      "name" : "7Glb8y2wOG",
      "email" : "rTINk8Qs@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_1Pc2WxDrDsYuwC4LtHxFho",
      "name" : "OIeTMCdMCZ",
      "email" : "FbkQ9Zv3@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:27.773828Z",
    "updated_at" : "2025-10-31T11:56:27.773828Z"
  },
  "created_at" : "2025-10-31T11:56:24.929257Z",
  "updated_at" : "2025-10-31T11:56:27.946047Z"
}

List all cages

Returns a list of your cages.

Query parameters

Parameter Description

perPage

The number of cages to return per page.

page

The page of cages to return.

name

Filter cages to return by name

study_id

Filter cages to return by study

catalog

Filter cages to return by catalog

metadata

Filter cages to return by metadata value

Request

GET /api/public/v1/cages HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI5MzliNTAxZC1hY2UzLTQ3ZWQtOTBkNS03Nzg3MWQxYTQzMzAiLCJqdGkiOiI2MjQ0NjA1OS1iZDhjLTQzNzItOWYwMi01ZDg5MGE2MTE3ZDYiLCJpYXQiOjE3NjE5MTE3ODYsIm5iZiI6MTc2MTkxMTc4NiwiZXhwIjoxNzYxOTk4MTg2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.QwM--jOuEpSKRhdkH8vPSD0A0QC9Gt7oIZlKiQWEJ2R-6kq8OLclWKP38zFhRPVnwuq1uSziBrf9dZODLNPvBwuZYLt43-20_ElJ61JYlKJypMmVM8mE-57NolWQ27QuSLzk96655erO67m9HWuYq8YefaKfDWyR4m4UTcB299K3MUar1jjFBrKywkxw1YwDGcsviuoNIVyUNba2D_dL0Mzd9tErpxCeOUzHq2C2p2oAgvzMb1Wp2895UAAgKA2SUtvbNm_eXIzA-DPBQJfqRi7rQ1uS5DrFCga1kL6AkNr0gDXCyvP6lmq4OLmkE8TgU44J5DMh86B1QXWmRP7nG8Psl3kUrtLizGEOCFcJhEYzebxa3m95vTXOGpL5zHR54-m7CxrjO8SFu55RtPYhon5h-23qHW90OIgkaJmUR2X8GwYGBfJDRnBIox5lj77hdar9AZ9ryXM1JtxPjg3vTvPdeDHpgQOyaf4m6teX7jVRfLAu0iEdtKsGosvlj0EJDnO_YEq1m-BfwuUAWgRdV-ehjRqYyTJsHY-TI7rm5Ful2VQGP7vTJBq3NvMMrMEttAPdWA4w5fe4Pg2ISn1mLL2CsjawxjsEl-U5VyKyBzrgBJMUPMWaMR71IauZ0bkD6XOUAXY_P6_gPZIx8BLMZ2Uh0K5JzPqpPxTPA7zT4Ng
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1586

{
  "data" : [ {
    "id" : "cge_7k4toSjEiDeB7uFaHCmv3h",
    "name" : "f1rmhSvVrT",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "study" : {
      "id" : "sdy_1FygvMMsT8hqDXi86mFBkk",
      "project_id" : "pjt_6MpT4y4xmtmMT3MqC4nsx",
      "name" : "PyLt3meKl5",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "0tqpBKvi6k",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_5HwXSSnd5EhocfwHDcSAQl",
        "name" : "5rY753ux74",
        "email" : "ybWEI9Mw@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_6rS52ueMg2nL02FNB59ULk",
        "name" : "GNZFLKdRyK",
        "email" : "thEM8LFL@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:26.212217Z",
      "updated_at" : "2025-10-31T11:56:26.212217Z"
    },
    "created_at" : "2025-10-31T11:56:26.371858Z",
    "updated_at" : "2025-10-31T11:56:26.371858Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/cages?page=1",
    "last" : "http://localhost:8080/api/public/v1/cages?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/cages",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a cage

Removes a cage.

Path parameters ./api/public/v1/cages/{cageId}

Parameter Description

cageId

The unique identifier of the cage.

Request

DELETE /api/public/v1/cages/cge_39puplLBeRATEtYCHYp80p HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwOTZhMmQ2ZS00YzA0LTQ3MTctODEzMi1kYjg0MjJlOWMxZWYiLCJqdGkiOiIxNmUwZGIzYi0wMDM1LTRiNzYtYjQ4NC00ZjYzMDY2NDE3ZjQiLCJpYXQiOjE3NjE5MTE3ODcsIm5iZiI6MTc2MTkxMTc4NywiZXhwIjoxNzYxOTk4MTg3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.WLGCKOJd7LG_WU7-lyqZT4Sq2pxXBQ4nkyApNvLM91-6VRMho4wjXnIZNWsfTIS0_CMTHiydOvg9kTk7m1To_JgEVYAPx9FkydNawEbo6YQq4vFpXSlYUkNmJnrnhZ2i1fqQJVY4tMKjjMgeI2pepGELlUt-h8pe8WFcSXqgQE2pg3n4v15EOTIEXyXQDBPrYajVA44MlufPKoIYPWimTHPtKAlhHg68F9DPLag8WoL298SZopdLvbU4XpIH9fiEgOLTJ6fOi_cet4iYpokX8SZuBmashJElSB6_84cybGmG37_kMTfS97yXkZbd7f0H5dzDZSLXBtQrJNU38fWDPkZJeVFQx1V2CjDWwbDV_EBt_QVrWZo4XHQJV7evy2T2vp28_2MCgHpM929i9427pmMVRr-H5EBlWXGQH9T9Bsamsm37UsC_IZzLGZVL9bMBYNYTDDjNyHXJcT24UpZNIlvEsdn179kx69MAjdcmkxhESQvlNvt4qeL9ejj5IGx6999DJfjVu62R658l3vM4ViJrbr0yyG2aqy1Lmrkq6c3mQ3hakPBZyiA94lo4BiEk3G2-1K44ALf_zMAhESyX0IuONaIXFVBsojc-9G_UyLvNE7pBVUhTVIrUiBxkmEUlpriDM-v7LBbK3iu6KvrS-AB26hfkW0AXNZsUCYVySHk
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Metadata Resources

Metadata

Benchling In Vivo entities—including Study, Cage, Group, Animal, Sample and Project have a metadata parameter. You can use this parameter to attach key-value data to these In Vivo entities.

Attributes

Path Type Description

id

String

The unique identifier of the metadata glossary.

type

String

The type of the metadata glossary.

title

String

The title of the metadata glossary.

slug

String

The unique slug of the metadata glossary.

field_type

String

The field type of the metadata glossary.

options

Array

The metadata options associated to the metadata glossary.

active

Boolean

The active status of the metadata glossary.

read_only

Boolean

The read only status of the metadata glossary.

Create a metadata

Fields

Path Type Description

title

String

The title of the metadata glossary.

slug

String

The unique slug of the metadata glossary.

type

String

The type of the metadata glossary.

field_type

String

The field type of the metadata glossary.

active

Boolean

The active status of the metadata glossary.

read_only

Boolean

The read only status of the metadata glossary.

options

Array

The metadata options associated to the metadata glossary.

Request

POST /api/public/v1/metadata HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzN2UzMzc2NS0zOWYwLTQ4Y2EtOGNmZC0xNjk4MzBhNjM1MjciLCJqdGkiOiJhNzc2NmM0Yi01OWNkLTQ3M2UtYjgxMS03NWNhYzBiYWJkMTkiLCJpYXQiOjE3NjE5MTE4MDMsIm5iZiI6MTc2MTkxMTgwMywiZXhwIjoxNzYxOTk4MjAzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.NRzkFICEN7yzawKesymq4i32lb14cmKzzO4Zuqh4oVNd5Jp9uT7MCcAdGTtXj-4dRXanKxmtsn26pC2U6kL8oPRyhmKefyASEjtSi4FOrT9YTqTB0xd1Cc8OqlCcKjg5ZGxHEzClVKWpv5smVd2Wh5B4rlZ9v9VNagcfKtBZ-WjxpYx5sMC00pdAnKTzlMiq7UbNxlf5CDkD8eEx4l7MCOVhDsax93AXq2wM-0ECrC3QXgUlPlGRA92LWmLt259QJJy0Sx3aApz_0tdZBfS_GuL5ZTZnU3p5YJMw7C8tmz7xhEuyWYnJHdaZOXjoDz7Xz1GtLWaBfbX5nt_lQK6RJVHiaMucLqivyfRR6oET4D-BxJeL7WphgN_2z8bcwuLMHSyr9ku6ugdVAE62eQLqtYNbKGm62RsmPhSKpm6yf_bFMdDHFZ4TJhAMutY8wrt6o6c1cTD48wHNz5ztvgIHDjFsnvZ-dFqAk3eLiF90BEf8qlTd2PVSlaARhIF9D20ypNDEicKFBULk0Irl_2bGIg7pg7hEFTEoAZP1N6fk199C4ZT7tLv9yxx8bx925J6reofhocKn_ezwfvBS6RgHlO_rGQiKFDRvnpQNbUTWVOLsBEKhege9whXYIVJ1lZ0HgYUsuIqPCrpk3Kur5-LpcYIXgw4P-vHpsvkZs74j5wY
Content-Length: 174
Host: localhost:8080

{
  "type" : "study",
  "title" : "b01CP6mnDc",
  "slug" : "XqHLO7RvKZ",
  "field_type" : "select",
  "options" : [ "1", "2", "3" ],
  "active" : true,
  "read_only" : true
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 213

{
  "id" : "mgl_3RGrldkpGr1hKgXhd6Lu6C",
  "type" : "study",
  "title" : "b01CP6mnDc",
  "slug" : "xqhlo7rvkz",
  "field_type" : "select",
  "options" : [ "1", "2", "3" ],
  "active" : true,
  "read_only" : true
}

Update a metadata

Updates the specified metadata by setting the values of the parameters passed.

Path parameters ./api/public/v1/metadata/{metadataId}

Parameter Description

metadataId

The unique identifier of the metadata.

Fields

Path Type Description

title

String

The title of the metadata glossary.

slug

String

The unique slug of the metadata glossary.

active

Boolean

The active status of the metadata glossary.

read_only

Boolean

The read only status of the metadata glossary.

options

Array

The metadata options associated to the metadata glossary.

Request

PATCH /api/public/v1/metadata/mgl_6R5drcdq0qaP5nFWLucXG3 HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzMjIxMTAxNS1iMjhmLTQ4YzItOWZkMi0wOGU5ZWIxNDY3YjUiLCJqdGkiOiJiYzU2OWIwYS1kZDZhLTQzMDgtODk1NC05N2M2ZTMzNjAzYzciLCJpYXQiOjE3NjE5MTE4MDMsIm5iZiI6MTc2MTkxMTgwMywiZXhwIjoxNzYxOTk4MjAzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.dYZHhRZ9j_LCGuYhYF_IQiBBu5x88VVBAFHCtEohAPT10zqh0gWlIzLjChW1W0LhqTD0iz-cOSo4Eix5zjrhTXp31U7K0nZNNTUM_bkRt3iR5a02dRiH5DXeCiB82VzpJLJJf8FoWxMMvTKV9lhUHOyXsUU8pPnxByYv10_w-i9NL7QvfJtLL4y-JU82vyFvX3ydcRSDvIFPkbE3C4S478QSpI0znz2SV59BYOMp__uNbH00lzIwfzaxOStGUYPVNvmV8QF8aU3MeTUIF7LGE4v2Rkq7E7A0DFC6G1QXGtEEGstOx0JTwosDUdkZna1xKF---KSMyt48XEnpCeBzmdsYFkYrwBR8TDNR8T7iYUG_FRrwPyv0i9hMLniHttBo5h9UuOZbiQFGrGYI_Jbg-kjxumTpmDN3B_zaFbhOunEXLfsmwmDwosIuiEas2eKjDpXkx3G5bpm7FDvs8CSr8w3vTUpxW7NH2176Ey--00Cr6Z8kURWaWqWa0ISj92RdHvLnv6SmV93HwLS9Vo2xrKlm1t0cXxjr6LAGf6IKFmx7PjzRoxE5-pWmpIlAuJ0b--OvrhjrTwZYJpg7LgnlkrgN3D2pLkac6Z4jg41BzrRc0SmjLjzHK9RLqnwNzLU-I70EBPWEJvyvoN6eQPO-vvEujPc4Us7qs6BV_hFtpZg
Content-Length: 149
Host: localhost:8080

{
  "title" : "New Internal Category Id",
  "slug" : "internal-category",
  "options" : [ "B", "C", "D" ],
  "active" : true,
  "read_only" : false
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 236

{
  "id" : "mgl_6R5drcdq0qaP5nFWLucXG3",
  "type" : "global",
  "title" : "New Internal Category Id",
  "slug" : "internal-category",
  "field_type" : "select",
  "options" : [ "B", "C", "D" ],
  "active" : true,
  "read_only" : false
}

Retrieve a metadata

Retrieves the details of an existing metadata.

Path parameters ./api/public/v1/metadata/{metadataId}

Parameter Description

metadataId

The unique identifier of the metadata.

Request

GET /api/public/v1/metadata/mgl_1wGMROtPQvpGCqyeFL7jR0 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkNWRkNzgxOS03MmFlLTQ0NDEtYTM1NC1hZTU4MDE0NjM2ZWIiLCJqdGkiOiJmNTM4NjRjNC1iMjJiLTQxZmQtYjFiOC1lOTY1NWM4M2VkYjkiLCJpYXQiOjE3NjE5MTE4MDIsIm5iZiI6MTc2MTkxMTgwMiwiZXhwIjoxNzYxOTk4MjAyLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.RRyVgohenq5nBImdKLR2FAcVUZHGkVDB2NiTe9QCXSPv0komGNGX-CXWgmHxJfQAjnXF5G9wenbDtNShqPWKW9vyvFnr1T9n0BacCSRNl8TvuGlq8XN3YMbgv1Qy1TPO2yhYhg0330ql1oR7Xqq7yLw548ekxHN55kb-Y8_lA5vj2JQ9txE20dWC00y-LN0wggn5Pvzb5juzzCUavLgn3Ny4Z_8hJfPwSF1OR9dtVRzePoSe_e7P4AuH_psEeWr4j2yvhBxdawi0pNItZBqza0KRMFwmzN-GfItKmGFQqihC_G6Aydj54kG4sVqtdQdemCPdPFqTmU2CmmmbgHR6_J6dn_vXzXT5nAE8dVvloYyC6zERHncmTw8bmmsPkhD0nHj9_S9zkkOnPyvJ9xcLDilDpcWUsTbXYCrV_XuOILmAuPG-W4SOhTFtxRrcs8I5J4ZLp8a4wGBs4G4PyKj_K4CLdL-xbZSpBOX8SlfGTJevGbUkCfNptXeAOLz4q3y359heJohIczRiyWiOqjXfQJXpnIZkL5N6Ry31pT_2RplEoGH5O-dHytgBmHj-yicIEtVdhpKupiqdA_NyGAYIIrTKTzaRuU9cX7hNqKfGZfkkNQd-uqF6n-csX0lnWtSemZTgoOTDtk_7DUJ_NCbuwd0DvuMrClbO8b4Amxo5h_Y
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 232

{
  "id" : "mgl_1wGMROtPQvpGCqyeFL7jR0",
  "type" : "global",
  "title" : "Internal Category Id",
  "slug" : "internal-category",
  "field_type" : "select",
  "options" : [ "A", "B", "C" ],
  "active" : true,
  "read_only" : false
}

List all metadata

Returns a list of your metadata.

Query parameters

Parameter Description

perPage

The number of metadata glossaries to return per page.

page

The page of metadata glossaries to return.

title

Filter metadata glossaries by title

type

Filter metadata glossaries by type

include_inactive

Filter metadata glossaries to also return inactive

Request

GET /api/public/v1/metadata HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3OGI5ZGEyNC1mNzk2LTRiZDQtYWQwZi0xMjRiMzMzNWNmOWYiLCJqdGkiOiJhZDRmNDg5OS01MGMwLTQxZDAtODA3Zi0wNGZjZGQwMWE0NGIiLCJpYXQiOjE3NjE5MTE4MDIsIm5iZiI6MTc2MTkxMTgwMiwiZXhwIjoxNzYxOTk4MjAyLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.lAQ1yvQpbDPWm9oVDN-SZ8ejdyEUZCR-HyxtoUJh6MhpheKN2NhwRNagju6pGIUtjuL0kHQpTW5DXG8eLV3xpFFRlkCN2_E7SwdLGCAZEZuDvt1b_gytGbwSAsb-CbTLL9peXvZTWpgJrXPpNFLHAWCvdDwT428MedQTdsoYajr9Vo67zrqetc05OhnPUyS20DVUmaaink30hacKpwmUnSzjY7vBcnzOU38HdSqwrlic_tnOeSbhzYGh2BbqC9QvECLlY278REIkT4kVXzu_A3ACHKCfsXjjdp5asEgvqeD8IxHW9-LxVi6UFPEWUwjnmlJuBBJ4CkaxMKtY9jAql1K1oXCn32mkuVeOmcY24fmDbrBhLHoDaSx8K_perAkz71eQOqiqkhJ4pLKAjzA-o5KLa4XDYe8oxqaXlagPq7U3RFUftVzy9K9Lz35qfwmVocNAan3QIibONo7iFS0FNbiLRloLTI8ZCFJR84H8rnYj3dJPEYNZuZvaG3--fVQrSrPjlPDLfjWLqcFZjJTB1njGnn21HaiLs4m-d0UiHyv_WN7SX-vvp9pT3hwC1X_aO5-dkr2s8w39_FOvR2TeM2z5Rpeu80ZHGbGOwtL2tSQpC_uztfaT66ioHRSGvo2r6zdiKs5ZYuTYUQFEJA_Ip-NXLOP4-HGRp1zaBDkPqW4
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 653

{
  "data" : [ {
    "id" : "mgl_6xPy9gRaYcTLosAG1i2xHo",
    "type" : "global",
    "title" : "Internal Category Id",
    "slug" : "internal-category",
    "field_type" : "select",
    "options" : [ "A", "B", "C" ],
    "active" : true,
    "read_only" : false
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/metadata?page=1",
    "last" : "http://localhost:8080/api/public/v1/metadata?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/metadata",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a metadata

Delete a specific metadata

Path parameters ./api/public/v1/metadata/{metadataId}

Parameter Description

metadataId

The unique identifier of the metadata.

Request

DELETE /api/public/v1/metadata/mgl_pwAngq3sx7d7gvzRzP2e7 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkNzUxM2ZlYi0xMmYzLTRlNjEtODM5Ni0xYTQ4NGE0YjZkMTMiLCJqdGkiOiJiOTliYzlmNy0yYjhmLTQ2MGEtOTY3NS00NWE4ZGI2ZWRkMzciLCJpYXQiOjE3NjE5MTE4MDMsIm5iZiI6MTc2MTkxMTgwMywiZXhwIjoxNzYxOTk4MjAzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Y179NL98liL7Bu7dHACUsQ_iviUnBsSQEyy4hayPtggBIewfI3tH_2xLx7TqTn1fmOK3dE3NBFR1XsR-0biQa5bSIsZ6wJMPJxsTFr7NyNM1vudeOFMC4c8RqLH7RcmAl01h1VysRUyGK_ncLdrdO7H6V4V_dD-_Vsdj7Ykk5VIxnVrhvFLi9bmvY9I39uHgFPEX1I2Y4tStGyvQigpYRxG1bJ0sCeg75zIsNkW8NbA2W_i4H6OG77UGzqZhRCBIg4dVjnqgncwEdC8yPe2GjhxCBqhiFbqK5zxVmVDdbl8Qh6Sv9GJiIyszgs1NYGCFtj6oyWVn7q8kW9ACZ5Jnt-1R-k8BH2ypBWbK4dQGMC3hcQ-EZNMFtT-b3OJHe6Sax0iy180O5s8Rn0RIi75Ws1Vty7AiI7w3ST1PSL6q_k_2grYm37bkMb0AlHdkjy6BG4bOIa0x2TUprtTWeRXlwWwbJdTvbvj3S-1kC5GXiAs8E8RFqWEN9_SwmMW-_pUk76oiUfV8ejYHCoXY-lDlQy2Cbl_yc5XpTeglM47lHACkkQVR988f6X_lEECUotAK83nzcMBQjZD77Scy8So5zRQ5takQIehAdwObl3MzlaGK_qJdxMMwUUZ_EOFmjs1ApEUuYbi3r9WqjCUMEZ1YkDl3uOv3BSoklkV0rHh0OOU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Metadata Option

For metadata glossary fields "Lookup select" and "Lookup mutli select" you can assign values that can be auto completed by users. Typically used for select option lists larger than 15 records.

Attributes

Path Type Description

value

String

The value of the metadata option

Create a metadata option

Fields

Path Type Description

options

Array

The options for the metadata.

Request

POST /api/public/v1/metadata/mgl_5DfHsNDL17X6OI99efzqJW/options HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJmODc4YWM5MS02NjA3LTQ5MzMtYWQ4Zi01ZWZjODVhYTc4NmIiLCJqdGkiOiJmZDA4YzJiNi04NTE1LTRhODYtYmUzOC0yYjA3Y2ZhMzQ4ODMiLCJpYXQiOjE3NjE5MTE4MDMsIm5iZiI6MTc2MTkxMTgwMywiZXhwIjoxNzYxOTk4MjAzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.MKXp5B2ev7y3myBOamkSf3D9IsJGLNl1lHY-NBh-1-kg42LKRnZkuBWA6y2X6kIQF8KkGXIR707XESpaQrZIR0hAcMNfpuEfzRag26PtwpqMyxMSt92C_ZgN0CqeUnZgFz2OWwq0lg2I88YHY17272wQZ-bYBmfSWnTnj0X5xsRvrFwcEOMqQ0S751bf6D-bP1yYo72KG7ceO4rPrjLbhn8t7PuqqaFwKsNbhTkhLQH09cdq4zKNA1mbSujVP-nz9XfameEdlh4RqjrgKEdasj-rwvPDtYYphhNY90j1WIQK1KMM5nQl6DRID3ynwOUyZN4MXvY3NgxvEG_FetVgGav4g79lIHsjgaEbAjsHFgbcsVMKCk5gQ2KLr0PPUmd2W3lE9AL0Ur5-kS3pqvN64W19OHBFbk6PWvH-vDNRltpc301MMysF2p_Io7Gmd6csxxzcISSllh0y93gojeQuR4G9hE5w2aKWKhoepaGaanxq2HDpjt9EOrqFflxJbvMYVWZRy59yzwD9Qx_fw1yFo355QArfKhjS-2b4pZQICERLkibS97GuiWgvYlfV9sAORV-yxN-Jj5H2FKLiwbVfGWJDrzwiypM2SgO2ciKbWWTsnqxVh1UhbEg5KbrTfNKOLTpHli5E0hpdgwPdkNyUtHqeGDdSDLt5KmV2135wKmk
Content-Length: 59
Host: localhost:8080

{
  "options" : [ "B6129SF2/J", "B6C3F1/J", "B6CBAF1/J" ]
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "success" : true
}

Update a metadata option

Updates the specific metadata option

Path parameters ./api/public/v1/metadata/{metadataId}/options

Parameter Description

metadataId

The unique identifier of the metadata.

Fields

Path Type Description

old_value

String

The old value of the option.

new_value

String

The new value of the option.

Request

PATCH /api/public/v1/metadata/mgl_4ES3qc3ulFt5AKnzJ7bHd9/options HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJlOWE5ODMzYS0zM2UyLTQ0NGUtYThmNS01MGJiOGUyY2VlZmIiLCJqdGkiOiJhMTlhZTViYi00ZjQyLTRiN2ItOTEyNC0yMmQ5MjA0ZGE4ZTkiLCJpYXQiOjE3NjE5MTE4MDMsIm5iZiI6MTc2MTkxMTgwMywiZXhwIjoxNzYxOTk4MjAzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.g4nAlxSLzTNt0k2LZAJwIolf63hf9sJOmFP7qbSdiXH7xdIU6xiV1iUNULtBd6M97155jR-warx1uN4qmqxmVzqIi4ce8lalQHR6wleD_i3anAVTOCXDiEGUJjks9-jXnnUhNr0aQ_8C-wvkU23NW6p4zMD0bLH95lGtORjL_E_7uJXtIQTNM3upf5UJs75j-X-uv-lMdAecSfUWenZnd2wiq6jBJUEQxpnnVQT-0BWUrHYVV9n-rLaaPUkI_CWlOkTrxpc34vCgH4_rstXby4kpcE5xSbctznmpM5VYD1K9qi1OD6m6w2h4_PtoANFpVIhY5dRyWSxeSI1ogFdvPVolnTdKwMoKavzXfv-OxHMvH3hgli3iwcmEk7Ed8PzT-Ztfy-0zSA9i4EyFZu4Sis18f5E3mJ0khsD3g3O_OHug8C_VAmYYRuVUc43forGqFHIJLGSl1xFc1lfHQi87SHKW9sBLbyAXOvi_AZwtE98fagt6F7c9EoMI2kWswg_ez0sDA9M8sX2j0btSWe7VM5usNNBbnASyj_O9gGxw7MYpIDpvVE43UoAkcK0MXy4WcPruVfHWqw20vpvxEfJtDfC9NS2QZzVn4j1jjPSMdz640S12O-JRb0axT48Iu_qA_57cyv2XIxwxFYeukeEFmIGiVMCYfwODpNFHlvZ2mk4
Content-Length: 61
Host: localhost:8080

{
  "old_value" : "B6129SF2/J",
  "new_value" : "B999SF2/J"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "success" : true
}

List all metadata options

Returns a list of your metadata options.

Path parameters ./api/public/v1/metadata/{metadataId}/options

Parameter Description

metadataId

The unique identifier of the metadata.

Query parameters

Parameter Description

perPage

The number of metadata options to return per page.

page

The page of metadata options to return.

query

Filter metadata option by value

Request

GET /api/public/v1/metadata/mgl_68Fp0n4uItjMz8RhnaYRpi/options HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJjNWZhNTA1OS0xYTJlLTRmODgtODViYS03NmQ4NjViZmUyNTkiLCJqdGkiOiJhMTFjZDhlMC00MmM4LTRkNGQtYmYwYi1hMjdmZjU5YjFkNGEiLCJpYXQiOjE3NjE5MTE4MDQsIm5iZiI6MTc2MTkxMTgwNCwiZXhwIjoxNzYxOTk4MjA0LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.VnBU5nVRunKZ-SVxf0Low6y0NAA-xI2mc8X2vCjbAMrPLySEKL9tnNBkxf7vuKpSJk3ltNIP3Z6sBlsu_JPy3ve_d6Yks2aYLhsAexRwE9v-ZNPiS-wcpqxQTxSuiUKUxmPX80BBSXCjbdH8TWXEAXBejhNZqxYJQCHAsqB1WHPBw6-uSDuM8LNw5_G8OW6UHbDrYr1plJCEFk2SuYrSdXBh4Bpa1U61Pxlgvo9x3vDcwfkuswSCmVEz-KIbGgYjE1fwKEpSmqMgAxEPPH9wtTiTwaiQdyxCi3uDq91eML6lE4Dbp321mTsotJ_BsPXym2fKA_Bus3_y5Cs976ZeUjOBfhtZ02EaqFrYnVm3_QSjlViihfbE7vZGRUFEi5rJwAma62fKy55qXxoUmxejYFceFRPt7K5982WJ4zelpXkWnMNDtRJPD8ZqjEbC8mqatn28HcgFkVFh0bWsn1r1e34fX0YmhCCRZdDApeqaC7SQkvuwrEM0f6zELccsf4fSB3UJo6KfKEGRrcaryHABd5PA2NT0Cnzpv5sfoQjs2pj5HGj79-G-d74yb3D72eAtDUk0DIeXnaKQTlxrsPo7eREZrDjJeEKTTc78dMjVho7cZF6sv-0weZLinWCeBpbRNcdj4ZUo5nUUYQXbzm-4v0iHSB9tl4-AiSKOdfIBBFI
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 605

{
  "data" : [ {
    "value" : "B6129SF2/J"
  }, {
    "value" : "B6C3F1/J"
  }, {
    "value" : "B6CBAF1/J"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/metadata/mgl_68Fp0n4uItjMz8RhnaYRpi/options?page=1",
    "last" : "http://localhost:8080/api/public/v1/metadata/mgl_68Fp0n4uItjMz8RhnaYRpi/options?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/metadata/mgl_68Fp0n4uItjMz8RhnaYRpi/options",
    "to" : 3,
    "total" : 3,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a metadata option

Delete a specific metadata option

Path parameters ./api/public/v1/metadata/{metadataId}/options

Parameter Description

metadataId

The unique identifier of the metadata.

Fields

Path Type Description

value

String

The value of the option to delete.

Request

DELETE /api/public/v1/metadata/mgl_5NPke28oUDTxYXeOhnQqKW/options HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhMGZjODIxMS0xOTExLTQ2OTMtODYyMS00OTJkMDFiZjg4NTAiLCJqdGkiOiIzMzczMzFjZC1lMjgxLTQ2MzctYWQxNC1iNWE3NjRiZDg3MWUiLCJpYXQiOjE3NjE5MTE4MDMsIm5iZiI6MTc2MTkxMTgwMywiZXhwIjoxNzYxOTk4MjAzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.aDCQflnTQ-GYFaASmchjRY6snPLiwFe4tt6IPJHNyLlfaJV9-bjNlhd6-VlNyeZWSW3Ye5Z3B6PD94tLEM57570tFOWmpEB6bMPGK4u1PI-fcDh-hT6Q1g3OO2rwf5xIpLoMDHoE9UxWNyDVVQuWhmp5DUikDiqZ46J-pc9w7rj6Tp_U12SujtStD_jE02TS1YYtmvmsTWUX-_6Um7hMuQdhpMFDd5ZV3fDM9a_kj_cgKa3-YZRP0k_LtOC1h5TJ8vHrDx_xIgKuf6vacGfXgtBJr991mcgcZ9WShtFjodQIkIwFtTWJAIyc2WsWOO3RN3lkfA7JiA-ug2cr1uMM1RwO7cXDhy8iOWiV7Gadv9bYTCd93ZokpKcfgVVyMPbSrsOkbayRiHBHlya5lgOdBQnWEXMVXOh_wNKwI2m8z1n8e-WK-g0gD1SGbfPyJuvdoWFcpzANmi2sKhqt3teHjhK2ZDJlgLDIOyOpIePyJL-vy3IAqpv2f3yMiUk2LsRhiFMOmAhNHuijO-j6PGhuaNaVXsj_S3PgUqd-5nc7ymTwIuYoV_LjFrgb2Gq47Gy8TCUTdvFgnMpmutN5uweHvsO4AOfg9RcTfWwdaP1M9Wt1PzojOJJri6WbZprmy4kuCim6wV4Qo0gt246LSP1JglYoicTO8O1bjjuVTxxCBOY
Content-Length: 28
Host: localhost:8080

{
  "value" : "B6129SF2/J"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Project Resources

Project

This is an object representing a project for your team. Projects are collections of studies that users are assigned roles to. You can retrieve a project to see it’s name and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the project.

name

String

The name of the project.

metadata

Object

The metadata associated to the project.

created_at

String

The created timestamp of the project.

updated_at

String

The last updated timestamp of the project.

Create a project

Fields

Path Type Description

name

String

The name of the project.

metadata

Object

The metadata to be associated the project.

Request

POST /api/public/v1/projects HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3OTU2ZjY1My1hOGRhLTRiMzQtYmVhOS0yODU5ZjlmYmFiYzYiLCJqdGkiOiIwMzFhNTI4Zi1lOTk5LTRhYTEtYmFiYy0zZGIyMTNkYzhhMGQiLCJpYXQiOjE3NjE5MTE4MDgsIm5iZiI6MTc2MTkxMTgwOCwiZXhwIjoxNzYxOTk4MjA4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Hb7uCpTEZ3rOIr7PJjc-ZICsoqLGVP_SzlZZlpHIhWfHQn6NgA1QZEOtX31u-xKQLQuteNvyZ_tJvyooe4tt7u4SPcrRthOpoiiaYmOonY3jTBn3bVnUk9AxFbMLdI4X0_Vvmh0SXwGPAu-Jnl7T_gHZIDrQd_zOIteLVQthtbCiNajXN3zU4He2gxrpHnM_39Lm-dq5SKPJ1SF2i57Wqz2qb3EYXCHEHnBWQODjoXYbBu1Cw99ftuU6cImVqMtcZjOYcoBUFE65PbDZEcl7chsrLVrCQt2wXocAZ1i2cihmfWr1mvi5w-JYUidGsVJ0pSbzK9lJW_hHDWpD3nL4XdEwMRSN9Ri7Ey2dianNNqFQamnrodY1UVdiL12cZCPrBVlKOm5tYFTyzb-LZ55RBkP32ekFPgRDmvJpf-VRuXwla43662iPEbDutQJ5IseCa4TD3WSCVW9DUnHYlSgP17Xu2mp3GZiKAwUhoyJziKW34XZXDlJ3O1KnHtnSwQzKeZJ58Q7OlPcFC_XF0VPC9SkyyB08hEkpfMHVZ4Dk9tABQYzKdrQxvhw9tulMCJ5oQKZNM3yexLM11-hnxXtTSWXNlOzsvnyKOQA5FV5BFX-VLMTgW6AZczDwRP6EWw8cBgyEFU0eeKmMt-FgTcTgvnTgqQ-g5RraOYSPWQ9zhlc
Content-Length: 89
Host: localhost:8080

{
  "name" : "FA8leA4jqo",
  "metadata" : {
    "project-internal-id" : "PROJ-1234"
  }
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 224

{
  "id" : "pjt_7YMDADMLZSpWoOnBWkMZ0P",
  "name" : "FA8leA4jqo",
  "metadata" : {
    "project-internal-id" : "PROJ-1234"
  },
  "created_at" : "2025-10-31T11:56:48.127631Z",
  "updated_at" : "2025-10-31T11:56:48.127631Z"
}

Retrieve a project

Retrieves the details of an existing project.

Path parameters ./api/public/v1/projects/{projectId}

Parameter Description

projectId

The unique identifier of the project.

Request

GET /api/public/v1/projects/pjt_2kBsAM4oewTE0deHblxUKj HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI1NzhmYTk3Mi04Y2ZlLTQ3ZWQtYTA5NS1jNTQ1YmU2MTdiY2EiLCJqdGkiOiIwODBmY2YzOC0wMDcxLTRmYjMtYTQxZC03OWYzNGMyYzYzMmIiLCJpYXQiOjE3NjE5MTE4MDgsIm5iZiI6MTc2MTkxMTgwOCwiZXhwIjoxNzYxOTk4MjA4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.XHC5Vfs6GLXD7yJuP-pGrNIIDE83MfoUm7XvSto9mYHGxOy4cS7e-pYQmoBP3pO2mweP2G1jEW_-M6WI6EF0-cqoeintnTt38TPPXA43oNyORnV8jGvVTUWpDBWftfcT3238FzHhZnr6qbVKWz5EZWAMJ5vHbJcOsjHk9QR5tCtKNIQl9vccoB2Mpsdo-AnK2JB8fYy1PFz22q0ciyVGuHnY2hiILqvFznRIYM0_jlRN1ImzWdfGPaMWsjSD-SvcpLIruYSgJ6MmVNJXOH85jLFT5OcPIE-M1vveYr-wUSw3-yJ8Uq2n3B_v2JG9GiQiy6cIhtdkii68TOKIByt1ecGlGA9MtFpY8ypZCmOziNPAJoNyPtF0Iw52qESVnxBFSM05x1D1ex_zzWPgOM2EOUG_gJ26mB6yKZ6kebkl5mhNvWSlBD59iS_UCsHCjUzrEbf7fUDa6w8a8CHQrdn5P4GzLQDDCMBnaxo8s0GZ9bwUNxXL6jHsCfwLKh3oQPgsw9WhRhA6bH2AhImf6lGzHuig59FhMlGxADEHaZ6ESseTsiIYF2Ks1zReKpyl8G6KJ0-R8zEg6f305xGsrlcptR77CXJSXR4ZMM5yNW7CKDt2HjYhUCpwfjmjkS6t6_rwehUPCwvAGTnLPOHrAF7H2fLcBipC3gSk0M9Cm0HfQko
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 224

{
  "id" : "pjt_2kBsAM4oewTE0deHblxUKj",
  "name" : "pVKzsU77oc",
  "metadata" : {
    "project-internal-id" : "PROJ-1234"
  },
  "created_at" : "2025-10-31T11:56:48.048800Z",
  "updated_at" : "2025-10-31T11:56:48.048800Z"
}

Update a project

Updates the specified project by setting the values of the parameters passed.

Path parameters ./api/public/v1/projects/{projectId}

Parameter Description

projectId

The unique identifier of the project.

Fields

Path Type Description

name

String

The name of the project.

metadata

Object

The metadata to be associated the project.

Request

PATCH /api/public/v1/projects/pjt_6Ik3VbGmnepB8gT1rNbKLe HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyNjA2MzNhYy1hZjdjLTRhMDYtYmQ3My00NmExYWNiZDE0YzUiLCJqdGkiOiIyYWY1ZDE0MS0xNDNkLTQ3MGYtOWFhZS02NDE4ODBmZDhmNmEiLCJpYXQiOjE3NjE5MTE4MDgsIm5iZiI6MTc2MTkxMTgwOCwiZXhwIjoxNzYxOTk4MjA4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Rai7tuaIBeV56z1p_1gOyMYlqv6RVwnYh_-JJklJIi4DY-aHrZidrg_yG4J0CcvABcxCCyQ32Bh0Og-7P19VWxB_obPPBC9VK-AEAUj__faqUnYnNjpjy2jF28nqydWDAp3JDVllMzHS2X_PS-jSvvAbcTQX50LxX9z2c-TwJ-zX5EFUf3cBqbFYCd6oN_qXLGvhzhGgLcEP2zoVcw7cz71w7IENhcUKbUUHI7-JvFAJ2npJ6OcKsRch17Hbx__KDTE62qk48nPGTWexJU9nXg1K4s47306-k9F-upS35oHRnvXFlU-9Ft07ZTpBhBKD6Ba9H65_QWEFzI1vhlrs50LXeHNykrYaFJ270iokDlUGMAeU5yFEuZhZlGWvKeGpb8dF52lBJxtvaw_YerYiK-yZFRESu1Lgpv33lyZZ-jDyCPj_k0zLm1KRgd9ld1ib4CxpWIPP8rGQQbqQ2F9Olq-TXWx3ACebtUZ6zQQ2nqX1S5UvkyH02kgVcxyJGK3vYzAXSOpNDoBYzU5sLj6mSPa83j_HCmSjI3NhZWURVqj6VZWBqdG4rAs1DohEV_OIhajHHUF6dOh2xYAfeFAwb42ysrDr6nih5nBvh5Lw3-2sKH0adY9mmmdou8urcnqYAckH3beg4903Bxtva-Wpm0sDESLkL7Gz5haU60RZY04
Content-Length: 104
Host: localhost:8080

{
  "name" : "Benchling In Vivo Project",
  "metadata" : {
    "project-internal-id" : "PROJ-4321"
  }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 239

{
  "id" : "pjt_6Ik3VbGmnepB8gT1rNbKLe",
  "name" : "Benchling In Vivo Project",
  "metadata" : {
    "project-internal-id" : "PROJ-4321"
  },
  "created_at" : "2025-10-31T11:56:45.182919Z",
  "updated_at" : "2025-10-31T11:56:48.197339Z"
}

List all projects

Returns a list of your projects.

Query parameters

Parameter Description

perPage

The number of projects to return per page.

page

The page of projects to return.

name

Filter projects to return by name.

metadata

Filter projects to return by metadata value

Request

GET /api/public/v1/projects HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxZTJkMTA0OS0zMWE5LTQ2NmItODdlNC02OWU5NmNjOTIwZGEiLCJqdGkiOiI3MzEzZGNlMC03ZTBjLTQ4ZGMtYThjYi1lNmYwNTYwOTliMjEiLCJpYXQiOjE3NjE5MTE4MDcsIm5iZiI6MTc2MTkxMTgwNywiZXhwIjoxNzYxOTk4MjA3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.hUB1_VzLnJd5Rpjo6d6JTvuItzhrO_YPFdysyDE-KKH-SxKL-j9euWIUinu1eMpBhCXaSO5OwiCIM6nGjaCLRCgX-Psv6dVl8y2Cu3bZJqCJTc_Qmy5KByh9BtUt9yhr2HublieApYYksu9phFo7Di6DgVHw7FCyIImHi9_bYtEGgZw6NkQfIWkNRh7NtjEQyO6p60Fwl-tQiDe-k39yP3QPZ4rKMtqHsSSRU4RMhAPujkgVZTDar4qb-MhzRyAmEtr69EtFJwOmENmx9vNoZEdhud_qhPWnVcChYIeJJwwcM2uX240FCsdeGE_oLWa2SRAu48ITZRnG9eLm53FHgWWO5WpqM4F71t5ERS-LhGmE-s6XFpPgWH7nS_STZn5F_S60CSpxyDgi64yPFAXvDBTJtHcH3rzVfY64UDxgsuq3rIvA5pwQewmDUV5BUsRRaiSysIPUiD07skWrORnBFJz0IM4l1HtfBw-bXM_OQkg7dUs1BjJfj4zdn3jS3JCaFbveh1DiEI2QB6_EbRHHAyUtrPkry1MtsMqID5U8wQPKoAYwrUJeWg_50_nvqesM0xKHep2QXUh1UnWNeoLz0eM-Vfk-KXQsP1DR_anJ-PDDkP4XB_3-GWd7VvP18Q5pmRBv6Jl21ZBtsonfYHwAd32_kTXfz0M1_Le47hfVIA8
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 643

{
  "data" : [ {
    "id" : "pjt_5zMCcf6U9e0LWZiWZlKUgh",
    "name" : "dIzRNnKRTI",
    "metadata" : {
      "project-internal-id" : "PROJ-1234"
    },
    "created_at" : "2025-10-31T11:56:47.684928Z",
    "updated_at" : "2025-10-31T11:56:47.684928Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/projects?page=1",
    "last" : "http://localhost:8080/api/public/v1/projects?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/projects",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a project

Removes a project.

Path parameters ./api/public/v1/projects/{projectId}

Parameter Description

projectId

The unique identifier of the project.

Request

DELETE /api/public/v1/projects/pjt_7aR6kS6ic3ZjBPEDcbzAAE HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI4ZjU2MjRmOS00OTVmLTQ4NjAtOWE3ZC05ZTQxODM5YjgxOTAiLCJqdGkiOiI2ZjRiZWMxYy01ZDAzLTQ5MTktOWIzMS04YjExMDA1ZTU4NDgiLCJpYXQiOjE3NjE5MTE4MDgsIm5iZiI6MTc2MTkxMTgwOCwiZXhwIjoxNzYxOTk4MjA4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.VsqLUaBhEap-YaNhJS2Cj0lEPA9Xait5Wnf1sLJqGJiHK120o2-T3BegGEWh43zxFVhwekeh6rtsqBSmAWBc7bjE1YGiqk7fZwfAjIMyge6ykw5RySfWz3La15rlmYrVznoG4XOSwcEsB6M85s9qlZ8Ek1uVev9bLcWKxFIo7kAjG7pKAubKzyo56Qkoyds5OieVANGoC1JZqm2Xda64qMo6Cnc6kthdaKDxzKuio9a0aSr8b9jZlmnuQSxJSgFEio5n5OYGgOzS3mw6_HFZjzy1GUyXErSPL80uilCK9qNcDnOl1bjrpUmfFsQHtEt9Fice_3GRDmKvkxczWsA9m7O9zd0hjE1uq2GAAN3EQ6FYaXyee7x00TD4-XDKwKw_4-J8iRMH0xold2OTCC25wbCIDJoOhjqbpOlPxrBR996Uc_6aMa0ZoHNNwA6KSIW3Zj-3KsI4qdksDIjkDpBJyyNPd2_vqSSfkJmjPQLWAMw0tMUENa-LAhUS2LJxeK-NLQFkxvHplYmkL8FEP2-j0duBIrIn7xtYj2WlrV72SWPzPqe34mYwPit1GkHI7f6wvchcG0PMrERv82ERNep2jIPCws92O0QvSoYzkeQrfTvfda2SwR-e_5hD5qEkG0R3ShltyOF-4OET8_1sttYRiFCTaD30eQfMQCrAh_RvycM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Project Role

This is an object representing a role in a project. You can retrieve it to see the name of the project role.

Attributes

Path Type Description

id

String

The unique identifier of the project role.

name

String

The name of the project role.

metadata

Object

The metadata associated to the project role.

created_at

String

The created timestamp of the project role.

updated_at

String

The last updated timestamp of the project role.

Create a project role

Fields

Path Type Description

name

String

The name of the project role.

metadata

Object

The metadata to be associated the project role.

Request

POST /api/public/v1/project-roles HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2ZTMyMWVjYS02M2I5LTRhOWQtYWUzMi1mNTMwYjE3NDViMDgiLCJqdGkiOiJjMjFhY2VlNy1jYWVjLTQyYjgtYWUzYy1iODBhNmJlZTAyOTkiLCJpYXQiOjE3NjE5MTE4MDksIm5iZiI6MTc2MTkxMTgwOSwiZXhwIjoxNzYxOTk4MjA5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.MjSWbmmle-0dJQoYSTqVtc6AYYr9mcQdDXUmL06G9sONoGYQfpsaR47hHNvCpNeH9ivIZKnvJrZv8Msp4wGmsvwWwhJsF0YfAYUy2N2kUrqu9gGuemlMpHyWNubJa68fMCf5DhucE0a1TI3X8iZdIvrAnySV9A1K_nw4bA1NsHD56E8rSIprjBIpLvXG5sSOdQTIVlxk7zWSExy9Slm_OlHEaS-NDTcW1nX0vedSJInQnnSA3zu7zIgQKrcDXlmL95m5dxLdFUcgeAmzBUHjxxdIXpuwZ5dXd_TbC_cWtcWZxwG8T65-cQrL36eaFa1jrkBsEskJOEo7eELxozD0MHyIiI3agV5RspDh72la_GB6ENl0AqclQaKf6oeAxl0LXU1CCTdcPd-u5uLKxg-MKGti3SmN4yTW3FEx_i_GhT7w0W_GMGdChZ7aR_pfBSTQxa9vtGCC9NUxxum3apfLOfGUYuElWNVzr3LXVKZIN4qkkAMQARuwxngVum72MmGGgkipI4cRkrIkTQnEJ-XnSXyd_-RRYDlLIZCZA5RNBT0xXJQ_4epGyKgJUQfzdJ-z7XaIDSS09At0UIYtTq5ODYyBSfXo24bs3DmAcmgRF1gQvQ3hAoMlj3OJsGZDb7n66jgfEJHzG4xAH_zN8YUWBQompfkRkPjoPKgA_AiEh9s
Content-Length: 99
Host: localhost:8080

{
  "name" : "ux6CYW2wBc",
  "metadata" : {
    "project-role-internal-id" : "PROJ-ROLE-1234"
  }
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 234

{
  "id" : "prl_2cqCzcOIlTj6C4LjP2Kpos",
  "name" : "ux6CYW2wBc",
  "metadata" : {
    "project-role-internal-id" : "PROJ-ROLE-1234"
  },
  "created_at" : "2025-10-31T11:56:49.189501Z",
  "updated_at" : "2025-10-31T11:56:49.189501Z"
}

Retrieve a project role

Retrieves the details of an existing project role.

Path parameters ./api/public/v1/project-roles/{projectRoleId}

Parameter Description

projectRoleId

The unique identifier of the project role.

Request

GET /api/public/v1/project-roles/prl_H5ECFf289FSZahv3azy1f HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3ZTEwNWMyMS03ZThlLTRmY2ItYThlYy1iZTg0MzQ5NGQ4OTMiLCJqdGkiOiI1M2EzZmMzOC0xZTE1LTQ3OWUtYTQ5Yi1mYWExMzZkNDFmZmYiLCJpYXQiOjE3NjE5MTE4MTAsIm5iZiI6MTc2MTkxMTgxMCwiZXhwIjoxNzYxOTk4MjEwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.S_sgG1lkxPNeTg3adcfVVD0XFohC0Nb9b8fYZNx1ABSqke1KZZKbe6HUzIh1Ns5txgSXsOApVgABs87QSegCIrjk3FRkxQ_NrBq1Iq-iMfugKO3YDYtw27vPzYFHLMaKazIIR293_AVBOXQwY9Nmco6yWV7pF4MU_wP-0_qtgxXCm1iLHHZmdUOrwWajXEpI1j-_A5kZSoqkOwfhJh6zkcLS3sPMxco2RNuaWmBwaT1h9Y_zD5eEskmVx4DD3zUGhlv105BLz3FHhyfxi08I70PR2GV_LgQH5jRiQPvb53gaIsZfVGg7sHpjoJSsVV3MHVkYL1MTFfpzq7friD0qDCXJemWFe8QWM1tijkK47qMQQGo3sYuq5m3ibtpxo5HdGY24G4qk_tW6R1cCvTsl1qop5_YPaLkk1NlK1L78i-Y08SdU1W92O0jBggiTh8FNy71-DrdGyOUqN8SCbNCWfo_Yv_-gAWdbPOBy1fkosfaCZXP7fWfN-_3t_nQ9AiEZ2Voyb5zAetH2RwfwIoVPYjSDzcWQtn1C098lycD-eP2JiUYAMYy2erTtI9qfGKE4O33K2j2ptOnUF5Se3fJXpQk7vzdBayLv3rRt-bXONU9orq4-SY0GCe3HJKQtGkAvjVkFRZDg91r-na1KGXDcYiBljJcl62tNW3WwvOdjUK4
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 233

{
  "id" : "prl_H5ECFf289FSZahv3azy1f",
  "name" : "hdwESuSHu0",
  "metadata" : {
    "project-role-internal-id" : "PROJ-ROLE-1234"
  },
  "created_at" : "2025-10-31T11:56:50.392634Z",
  "updated_at" : "2025-10-31T11:56:50.392634Z"
}

Update a project role

Updates the specified project role by setting the values of the parameters passed.

Path parameters ./api/public/v1/project-roles/{projectRoleId}

Parameter Description

projectRoleId

The unique identifier of the project role.

Fields

Path Type Description

name

String

The name of the project role.

metadata

Object

The metadata to be associated the project role.

Request

PATCH /api/public/v1/project-roles/prl_9phGyEAaugsPhzZioSGVz HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyMmU5ZWFkOS0wODc0LTRjZDMtOTA3Yi1kNjk3NGZjMWQzNmIiLCJqdGkiOiI3YzM1NWMzNC1jMTg2LTRjNmUtYmE5Ny0zMzQ3YjNkOWQwMzgiLCJpYXQiOjE3NjE5MTE4MDksIm5iZiI6MTc2MTkxMTgwOSwiZXhwIjoxNzYxOTk4MjA5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.I5B-Q4gx2gXANQXccpj4sZb0kuAHRP1QtD95jzG9DYKYUrZOBo6SFRip4npXYSvaLmh8lG8D18Nj1SqIShOOkCireWxJdObNL5B1R1maliC0tARAF0rZg__kbE3Pha5WJyq8qTLfjm6_VB4c9xzqkn_kExYkzJazjLiaaW99cqzFeCvhXTUwN-K3uiS_aTNIGY9U6q6IJqBnJuQaRdiuSXhdkPUN-WNDdsQ2uaBnR5Js2F3C7utnDQv_Ga3NDSSAXeRMKH14PV_LcK17BvDh8PaBR8CU_dYvCAf9rytx15NZwCwGymWHFyR7h092DnapjbeFd1bcRjGbIyD6aIZFb0xKEQv5ImxdOGKNf9Ylupf3FwIHGOMa-2z9RldyxH-6D7OWzDQz706xfY5xkCWsQOwcVltt6w0M7WsoP_TWZwJFrRBSrnmbQ8qR9QH2xXt120bpICJZrJrIP3e9gYahpZnJDxeJqKUZyhz8tow6tIl7TogXg-FKgkqP-UPxgxDVXKCJMyKR23MvRCfLAi5SyDFpFA2G9E-36FtKJ7XRJLR4ZsVZGzSDFwzGweKBV9nDFjogy9MAx-kfJt6KpmZP5sHPV67Ov7NFRz-lSOsPdWckFnUH1AIIFul-qouEzIOurGxtYV2gKaLsKwhXNeD7Dfd_4pgEnTcAlWO1iQ0WM-Y
Content-Length: 111
Host: localhost:8080

{
  "name" : "Benchling In Vivo Role",
  "metadata" : {
    "project-role-internal-id" : "PROJ-ROLE-4321"
  }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 245

{
  "id" : "prl_9phGyEAaugsPhzZioSGVz",
  "name" : "Benchling In Vivo Role",
  "metadata" : {
    "project-role-internal-id" : "PROJ-ROLE-4321"
  },
  "created_at" : "2025-10-31T11:56:49.774348Z",
  "updated_at" : "2025-10-31T11:56:49.794077Z"
}

List all project roles

Returns a list of your project roles.

Query parameters

Parameter Description

perPage

The number of roles to return per page.

page

The page of roles to return.

metadata

Filter roles to return by metadata value

Request

GET /api/public/v1/project-roles HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxMjJhMmE0NS03MjcxLTRhNmMtODY4Mi05NzUzNjQ1MTU0MGEiLCJqdGkiOiJkODY5M2RmZi1lNTFiLTQ0YmItYTU3MS1kZjk5ZTI0NjViZjMiLCJpYXQiOjE3NjE5MTE4MDksIm5iZiI6MTc2MTkxMTgwOSwiZXhwIjoxNzYxOTk4MjA5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.htIXE6Vbe-htlnn5XtqKPy6lWPiyqkUBFW1GBOQ2t3cpLDDnpgBUTdsBSTVNr0tZoEADxS2ESmHx9ANANyVF2cr3bHl6tDV5VSN1EnyUG0JmwTxGRLOvk6thghtVKOQPlaif6VpIWUc0LHFWRDbLXqVS0t41MMKwwCpgup2viCKxKMljuoNrOjeD9ZV1X-bj2U-nQWsfR_huRdJiml5mCGyhwrhNBnlhpS-VyTPsaOhGvAkiRekUIVRr336Bm5T-_ZaD3Sy0Gv4Kvr_0r7NrLlsu5Fbx5e9CrFDo-f9u8VaYPDgPxmGnfr4HtO4K2Nla6KWpu8fQzdLPV2eN04NN1VKHr-bmqBWvk_N_-aptX61J2WaHp1EPucazxuR6fM-eH4Aa_RiyoY140PQoZNzdGbf5kGXGQ0eycsn4DTEhe7hJ5A-XvZy3NNqztBrPRDlzZJZq0WQnAQ_NPTq8g4QLs2P80TwEBts9f1Ym5G6EXpopuPCNY1jWqL3DysbVL2Duz2LOpeZ7IFu_en314zVyzEHtbkc7vN2JX2aezUFhnnkSi2j5qSg8nY356QBqtn2PF0sGXX0h5wcWJWJqbfRAAJ18yeXnznkAYu6a4c9BZ2h-PF9w5HdmG6rQphH_UWg77v9Y-Y8m99L_ZgWyOezpN7LYg5-p1K_9ZBc_bNIba58
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 668

{
  "data" : [ {
    "id" : "prl_2sgw1elqJcEcUiTY378ufU",
    "name" : "gyE0415KDE",
    "metadata" : {
      "project-role-internal-id" : "PROJ-ROLE-1234"
    },
    "created_at" : "2025-10-31T11:56:49.144499Z",
    "updated_at" : "2025-10-31T11:56:49.144499Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/project-roles?page=1",
    "last" : "http://localhost:8080/api/public/v1/project-roles?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/project-roles",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a project role

Removes a project role.

Path parameters ./api/public/v1/project-roles/{projectRoleId}

Parameter Description

projectRoleId

The unique identifier of the project role.

Request

DELETE /api/public/v1/project-roles/prl_2ek3ga5oR2y1MZ7wz186xH HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJiYjljNGE4MC1mZmQ1LTRiZjktYmNkYy01YTA3MDNlYmViZDkiLCJqdGkiOiI3NjA3OTQ5Ni1kZDRmLTQ3NWItOGQ2Yi01YWU3ODgxYTA0MGIiLCJpYXQiOjE3NjE5MTE4MDksIm5iZiI6MTc2MTkxMTgwOSwiZXhwIjoxNzYxOTk4MjA5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.CiBYduYIU2B4WWUJ8FC7aey9eMi44jkdJwjmXaaY3WQxBgvfZsGVVc3FlD0u596AdWAeQGPwixCE3isKCdWRmu_pWVbprKxsiNymUpQpLgZBKGl2j1s5QULm-hCs3efTYKB0wbpN2cadRG4Vh9vCZPC-wsQCNUY5f24x9u-T25OenjReYSQijZf5tqBilEYEwD6mVfFWFI1SNMSHvVGgWYK8GsFA9UnicN0W_LmMWsovnyhmVrm6ANYzpx5XWzxQvy3nU1GfBfXmY-jL77hcIpKBW2C5IDlYu9v25p-rPl_-qdOk7h1KfGaHWr7Bwyt-CwZbtO4_IgW0qzxQj-zlNsAN5UkwW7ol7vieLHqAZQbTmB8CU-8u29riRsJuJhTVLXQ83wrnx8hj5B_AZKqkm3G0DOrkX6_OGuA00-GMjK66HW-Mbl_DdVnMJKZ6r7QpO89SNQd820cLQnp3jH4ORur1p16GD9PtDUtgV1Jw-WN6fnaqNJyXD23MhlJSv6gCyo2FXHKoHcUDMkn99PxHExoa5THEUuwK7bDuQKGpY7-6XnUWVb_nbL6a1QudbUJYVPLiuaDtk0i-nocgtTusagTptUGakTzOmzICaObk3tyBtyt1IYIBO7nVw1gn3TAzSC1yIK0jFTF6r22yKHzz_565OKNpo6xsVEubEX8aylM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Project User Role

This is an object representing a user’s role in a project. For example you can set a specific user as the toxicologist for a project. You can retrieve it to see the user assigned the role and the role name.

Attributes

Path Type Description

id

String

The unique identifier of the project user role.

role

Object

The project role associated to the project user role

user

Object

The user associated to the project user role.

project

Object

The project associated to the project user role.

created_at

String

The created timestamp of the project user role.

updated_at

String

The last updated timestamp of the project user role.

Create a project user role

Fields

Path Type Description

project_role_id

String

The unique identifier of the project role.

user_id

String

The unique identifier of the user.

Request

POST /api/public/v1/projects/pjt_5Ty6S8CfWVSF25vUGsSYOP/roles HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyMjllNzczMi0wZGI2LTQ5NGYtYjMyOC02MTFhYWUzZjM2OGQiLCJqdGkiOiIwZDExOWQ4ZS01ZGVhLTQ4MzktOTIzZi0xOWU2MGY3YzBmODYiLCJpYXQiOjE3NjE5MTE4MTEsIm5iZiI6MTc2MTkxMTgxMSwiZXhwIjoxNzYxOTk4MjExLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.AuJaydnOdjkoS5nCiQ0UrsilR4K5Vr1pbp8YnUiGXuOAUHTDrMtasS_WqnIVHekIWyufPM5P5g_ut1ofaOLD5uTRgf7EVfsrOhLZr9CBjo2fqWpfTQKm5BufCtDMQefGplRA4RNau3pgGTZXPRs9uiRwNDIC7Df3mHzEkk0XUZTOfNOOrbwTU-L6y0TpqTrC9yRuhvTknZVFbdmqv2RpodrzwtYWUajtdV_5dbxOTACin62ZSfHiPYUJQn6mA3TtAeWrawSs7CgiYD2FcUCleIZxDdshr470ZSu2JqCs7GTsrn6TlqU9agtqLPxwMLAk0TuSj4sUnOZePjpeF_hgaFYWvgurdHU9Hqoyf7bdl7i4M7PZy6Jted44FBJ3xzKhP_UWPZKzfOJuBsZwENvUnC5hfUHc2yM_9NA00QKMhmgplsr6LlQZcllE-WLQUnfERi7riWELd90m7lHItmjr0TvihHBXUTMes2KfkWZVdNqv00gGgvoijjwHUxpRjLVmG9bkhnfrTp5Y_9QMTQYe0Yi0rqSeguT7T3cTAoAa8OK9MK8O3uulYl6AMZy9L76ZXdIbtjMgu4Y6k1GVmstT8ER1pkKo6zaSbS4IgVP5YK4EPXoY7kclh_AGrltGEsynFQP3H2EY3S_O4Zs7PhamN4_gOi7tWunNGTBJiwBsO-g
Content-Length: 98
Host: localhost:8080

{
  "project_role_id" : "prl_3Yh3sEykMaSuiSMktM1FfW",
  "user_id" : "usr_36JASQLrAn4TMXXvFjBCA2"
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 603

{
  "id" : "psl_1dJBHym0LwsxO2Lz8QnrcV",
  "role" : {
    "id" : "prl_3Yh3sEykMaSuiSMktM1FfW",
    "name" : "SiahtRqsT7"
  },
  "user" : {
    "id" : "usr_36JASQLrAn4TMXXvFjBCA2",
    "name" : "ssnX1vtBgu",
    "email" : "Krk1wjdw@benchling.com"
  },
  "project" : {
    "id" : "pjt_5Ty6S8CfWVSF25vUGsSYOP",
    "name" : "tLqntEQOsE",
    "metadata" : {
      "project-internal-id" : "PROJ-1234"
    },
    "created_at" : "2025-10-31T11:56:50.997713Z",
    "updated_at" : "2025-10-31T11:56:50.997713Z"
  },
  "created_at" : "2025-10-31T11:56:51.079089Z",
  "updated_at" : "2025-10-31T11:56:51.079089Z"
}

Retrieve a project user role

Retrieves the details of an existing project user role.

Path parameters ./api/public/v1/projects/{projectId}/roles/{projectUserRoleId}

Parameter Description

projectId

The unique identifier of the project.

projectUserRoleId

The unique identifier of the project user role.

Request

GET /api/public/v1/projects/pjt_6VB6qNRcBYIKYqPHjl4152/roles/psl_2roHqgSEgnEsJ5JeV5xI8l HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2YTVjYTlkNC01MWU0LTQ1MzQtYWM3NC00ODYxY2M3Mjk4ODkiLCJqdGkiOiI1YmE0OTI4ZS04ZjY5LTRjNDMtOGUzMS1jOWE2ZTQyNzIwOTQiLCJpYXQiOjE3NjE5MTE4MDksIm5iZiI6MTc2MTkxMTgwOSwiZXhwIjoxNzYxOTk4MjA5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.eaMTCOA9FHT1_liHfbdDxluZoJ1d5wlaUD3sc3fnxmIl_DkP-qGk1DzWiePPwRDQuuR8YRSwD18FkK9PdTjBxLUGwjqFdcB8M9YQcn96XRZKoffFu-Ig0ByKdqetpoKlI0KRElek-1MAL2x-oQ23AAzvtQx205LJE-WcM2log1rodMB1qr9O_Ni91Cl7CBTefhL7GVBy7mIFXVX5AcFaePcn6JWVyf2-s22IKpBUUWzdrzyes-Cc5xgIyiPgxJsjZBp6CxaL3sT3UvYgwKGCDdJcFJuOmqTBWOvXeGoWV-Iwh0Rq5dl9o4VaFdSPu6T97nqiO8vSpmbdi0U_Q0bBlXSJKY8dbyCvWO3gHDWGdBuDl5rS3o0d5tBxFGrPN9IhaW_d_rTFX808B7AipXaAB9sYhDAusRSGmYY8-KLXyDIdd3cmXflzsFVZVRJw9UMNkSkj30ZCHbfLbODpq1VqZFEXTtHp2ORXbzm6YC2axxWOdDT_xew74SlQFyxtQTVN7Fv1yKxmpWojUoixTajcf7f-5JtgbN3k8aHnvsl6jA68GMR781YAjFdn2IDzcUbBdhafuC9qgurPJxb2hv4lFuC0VxNyn6T5N-_myEBh0QW1Fdh7Cs-u89MayMYib0iYmbfrBBZ9CV4Dsa4AJZUT8vZHEQdOc61cgZmOOzJSt1A
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 603

{
  "id" : "psl_2roHqgSEgnEsJ5JeV5xI8l",
  "role" : {
    "id" : "prl_1bza8R43qrIAwHVZ7qtbMl",
    "name" : "HlA6iolNjK"
  },
  "user" : {
    "id" : "usr_28z6VnYd36tRXtGcRdv2kG",
    "name" : "Fpr7pE9tpj",
    "email" : "9kkKsMV2@benchling.com"
  },
  "project" : {
    "id" : "pjt_6VB6qNRcBYIKYqPHjl4152",
    "name" : "74Dq4UwV4O",
    "metadata" : {
      "project-internal-id" : "PROJ-1234"
    },
    "created_at" : "2025-10-31T11:56:49.810326Z",
    "updated_at" : "2025-10-31T11:56:49.810326Z"
  },
  "created_at" : "2025-10-31T11:56:49.890593Z",
  "updated_at" : "2025-10-31T11:56:49.890593Z"
}

List all project user roles

Returns a list of your project user roles.

Path parameters ./api/public/v1/projects/{projectId}/roles

Parameter Description

projectId

The unique identifier of the project.

Query parameters

Parameter Description

perPage

The number of project user roles to return per page.

page

The page of project user roles to return.

role_name

Filter project user roles to return by role name.

user_name

Filter project user roles to return by user name.

user_email

Filter project user roles to return by user email.

Request

GET /api/public/v1/projects/pjt_7JXTsP3jFobt8iprRkvVAQ/roles HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI1MTUwNWUwOC1hZjU4LTRiM2YtYjkyOC1jYWQzOTU1ODEyNWMiLCJqdGkiOiJjZjM4NmZmMC1lYThmLTQwMWItODNiMy1lNGQ1NDgzMGRmMzkiLCJpYXQiOjE3NjE5MTE4MTAsIm5iZiI6MTc2MTkxMTgxMCwiZXhwIjoxNzYxOTk4MjEwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.KehPKoyL0nSosLt5yWdqtgSoJ1mraq2QkF7RG5OOFlbLjrap6ZsFQgmIMjFBI1uOZgr0s9lNjouRQuRSs_Tzj7GFKPf7W46NQXuT8uzowvL65mBOSGkPMj7kJY05i2n2hdOcj66K4r0S-reG234APJwnthP_aQdLN1EruZTxIUKSW4G6xYmIUXWmRb6NGwpsDOSV1mgGxygOvwfkUxsn7xnUgSCHk98-G5RRuGbqQJ9_tWU-FwhdZBQ2X4YqGtFl_R8e-fd6dfqPvdqORldHD2iHi7hVifkis-swoRwJYnbMnxv28O4jvpf2ppmRDQ34Ew3wOp7OsUqfFX1_LEmbnGDs_cua8nuXHR8bu4Bqaoo61WBA5A4dDUblON4infF441Wwnw36jfrdNYax-HxSBx4I301rePvXozJJoloQ9-P3tPAXZ4OuVHPxE_nq8g8OCeHN_YkWGZRrsxQdNtoS4ud4Pyfaf37fMSFiWaOOTABVytjA22PXsMSKC8qN5bsW7sE7Y4ErQ7dnhpf8kvJKyY849oBww3p2Dm5RSYDBsAKAanwp1iF1KZ-zrBTZ-41LIbJ-WB9b6RC2zUxpsPIj4E7Yg-h47BNu2YA1AZIbFNvuX3ny0PHJEUH_Ck5jrcLwGcBqmkqi38UcUQ9yjJlkIXuBH5a7-wf-4dmxyvtOYFM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1149

{
  "data" : [ {
    "id" : "psl_6Tvqd9M5lDWfcSgrI9Budp",
    "role" : {
      "id" : "prl_4lzGjykdO4jev2fwijCF1d",
      "name" : "wesV3a43FS"
    },
    "user" : {
      "id" : "usr_5hB0CcLWPpMOseYMT4MAeg",
      "name" : "9jfxo6IMGE",
      "email" : "f1YAzHOc@benchling.com"
    },
    "project" : {
      "id" : "pjt_7JXTsP3jFobt8iprRkvVAQ",
      "name" : "WdWWxS9v81",
      "metadata" : {
        "project-internal-id" : "PROJ-1234"
      },
      "created_at" : "2025-10-31T11:56:50.024835Z",
      "updated_at" : "2025-10-31T11:56:50.024835Z"
    },
    "created_at" : "2025-10-31T11:56:50.097843Z",
    "updated_at" : "2025-10-31T11:56:50.097843Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/projects/pjt_7JXTsP3jFobt8iprRkvVAQ/roles?page=1",
    "last" : "http://localhost:8080/api/public/v1/projects/pjt_7JXTsP3jFobt8iprRkvVAQ/roles?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/projects/pjt_7JXTsP3jFobt8iprRkvVAQ/roles",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a project user role

Removes a project user role.

Path parameters ./api/public/v1/projects/{projectId}/roles/{projectUserRoleId}

Parameter Description

projectId

The unique identifier of the project.

projectUserRoleId

The unique identifier of the project user role.

Request

DELETE /api/public/v1/projects/pjt_23c9RNU2BtygThrqko8G6z/roles/psl_7ftiYOc9Kp6Rh4YLxcWlIl HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzMDJkMjJiNS1lZWFjLTRlMzktYmQ0Zi05YmMyZjdkYTBlYmUiLCJqdGkiOiJmM2M0ZDM2Zi1iZWE0LTRhNmQtYjY5My03MzBjZGJlYjFiOTEiLCJpYXQiOjE3NjE5MTE4MTEsIm5iZiI6MTc2MTkxMTgxMSwiZXhwIjoxNzYxOTk4MjExLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.aoR4cl_bF6DjApX1-znayAeOyuh0dyB238L0TDHLnHBkF_nExc_GBNdlefLSpAli0_qLynso9oji7nTyS2Cik9u-xIZtB93-4pIz3E7k001baYb54HmizcOJl3fNTOiokUlRUlbDx4qb2Fn-Yofjq6nTkFt-GlfV4rrZpz-Byc37KVVbs0CcIVEL_RES3x8YU9RKvVzhKaWfFWKaGQn21IEZRG7JXV7kN0Yp86_4BX5JsPFpiTospPsvk2yo96QPMrVXFN2JWljwhW2hJ1nAjmdL5I6spUTB8_6SewNkLuDVc7fbJZEEZQFtthoDA3ejXZX-H6i2caEAqWkkp42yrHiKCOtcrdHdUGjEqXwZoa_zNszM4Quy71qraHlcUneBb-5p4HEmqEgreLRl2qjr1rbHT8SJBcPwdc4TKWJwDu5OG9ZZOohSyl27xYXw0Wo5gYmxSEk6PaPy5RMMmyJpfYJmOrqlw1wnCJGpd1jyO3gtSVq3vvGDbuLp-O69ZmtHQrZwqxDKjrZ3-HIHH3_vxYPYXi1KmkSDiqE71vLhHEddYt_QCJ37v6RtvHvoFB3ZY9IsOkEAl9ZgWhg_ZBL1OiQHsoUq20JR2fNRNdhDGRi4impNUY5LwEWQo3wMESzEX95dCxwbwM4Ss2YzcVX9HyUEptes58DvcprhT5Bejx8
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Sample Resources

Sample

This is an object representing a sample such as blood or tissue collected from an animal in your facility. You can retrieve it to see the sample identifier, type, status (collected, planned, cancelled), timepoint, details like volume or mass and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the sample.

sample_id

String

The sample ID of the sample.

label

String

The label of the sample.

type

String

The type of the sample.

status

String

The status of the sample (collected, planned, cancelled).

timepoint

String

The timepoint identifier for the sample.

collected_at

String

The collected timestamp of the sample.

details

Array

The details of the sample.

comments

String

Comments of the sample.

metadata

Object

The metadata associated to the sample.

study

Object

The study of the sample.

animal

Object

The animal of the sample.

user

Object

The user who collected the sample.

created_at

String

The created timestamp of the sample.

updated_at

String

The last updated timestamp of the sample.

Retrieve a sample

Retrieves the details of an existing sample.

Path parameters ./api/public/v1/samples/{sampleId}

Parameter Description

sampleId

The unique identifier of the sample.

Request

GET /api/public/v1/samples/spl_5hgdbpxnQLMCmCtSvtMDQD HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2YTg4NDk0My1jZDg4LTQzYTQtYTcwOC1jZmFhMzJjOWE5MTMiLCJqdGkiOiJmZTViNjE0OC0xMDVkLTQ3NGItYTZjOS1iOGM3ZDYzY2M2NjMiLCJpYXQiOjE3NjE5MTE4MTYsIm5iZiI6MTc2MTkxMTgxNiwiZXhwIjoxNzYxOTk4MjE2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.PO3RNErxbGUp-Z7UuDP2oC59-U-ctySV0_sFPVb1OXLbwAqDdQHwgeObRSnz-nBsajHO_mCYNpUhqzYHy8Do1hMwqZ27K9REWKucPGzoII0uMzUxNHmB9nj1jX5YjVma2AjjJC5hsISCpQeWJa_DcvbSawLGVaUNePNzYJpzwacHcQPY6k4Z1IZqDNgW9u_MHwPyx9-5XVAcIXcp1WxyDM4biyXLoN4qkAtG4OAekpgpJl3sMPDNjpRjmHpPK6S9hFwiixAsbBFwvyZU1wEsXCILVbngiura0TkKrbtDjw62f7ltA9JJCYIHtPMBn-VQnSt09dyYUosv85mpj4wDhvVnxIMYY8JVpawQjK1lGPVoe5YipAdmErVm_AYpn90cAZU7c5Nik4Faup_CoFt3cCGCjipMI7P6Gvp4taEmTUNj-VNxLzLs62T1R4MXZb81ZhG_91jlytSk6bq6TzIkn0v84H9UQA3PkxpJnIiIQ_e9KlVtA3TBeNE9QWTb1-xe3np-v8uYWU6UfwM121jnEJrdaTk6m3gwnLVfakAM_FMbQXPRy9Jx87enEllJy3tE5O4q4Ihd-T2lvgjapu-hSWVWfajc4mUEBl2maqSqHe-TBsB4chSnKgcoj5fRyjnvvXEL4sWpt5Gdfjv3BqyJVCKuAe1OLAAJh7d1T1Qgi1M
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2821

{
  "id" : "spl_5hgdbpxnQLMCmCtSvtMDQD",
  "sample_id" : "S1303770160",
  "type" : "Blood",
  "label" : "BLOOD",
  "status" : "collected",
  "timepoint" : "PT15M",
  "collected_at" : "2025-10-31T13:56:56.140855Z",
  "details" : [ {
    "key" : "volume",
    "unit" : "ml",
    "value" : "5"
  } ],
  "comments" : "A blood sample",
  "metadata" : {
    "sample-internal-id-506760621" : "SMPL-1234"
  },
  "study" : {
    "id" : "sdy_3EEZFTe3f0Dqeyc7W4a5hp",
    "project_id" : "pjt_64CjMPexUlk2co2ginUUlR",
    "name" : "nCG8KNfCUE",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "PUknLzfBQZ",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_57GXbsN5mm4EIMP4JqDEix",
      "name" : "zzHM8Acn8h",
      "email" : "nd54KuG6@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_6pH60mjJp49JxocGzvBbE7",
      "name" : "VVekkczGxm",
      "email" : "VsKboS3U@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:55.826550Z",
    "updated_at" : "2025-10-31T11:56:55.826550Z"
  },
  "animal" : {
    "id" : "aml_7bqgDbpkJDoV3yWAQUmZhN",
    "study_id" : "sdy_3EEZFTe3f0Dqeyc7W4a5hp",
    "study_group_id" : "grp_6bm5dtNXFOACqTgZpAMntX",
    "cage_id" : "cge_5fuZk6UBG8tVv3M7oMn3ue",
    "catalog" : "A0000001",
    "name" : "wcvkPSUlo5",
    "number" : 1,
    "strain" : "4xWfb9jp85",
    "species" : "cJH6Vcv93X",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "YsoOylsgBh",
    "ear" : "KPcq7mKcSp",
    "tag" : "xr6RmUPS7V",
    "donor" : "i9u92cLgSZ",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_GxbePCqpdi9htyrLVbJIu",
      "name" : "0sE4iMQKkH",
      "email" : "uaTRia0T@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_1rWW11bPrdk6BiaJv6Chw7",
      "title" : "Found dead",
      "comment" : "NFjjz3ALML"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:55.984905Z",
    "updated_at" : "2025-10-31T11:56:55.984905Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_7okXKaR3JWzk921pEOr13",
    "name" : "7qoWEoTfat",
    "email" : "OScADRm6@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "MtjkaFG8Rx" : "uMkNAtb0cF"
    },
    "created_at" : "2025-10-31T11:56:56.131351Z",
    "updated_at" : "2025-10-31T11:56:56.131351Z"
  },
  "created_at" : "2025-10-31T11:56:56.140904Z",
  "updated_at" : "2025-10-31T11:56:56.140904Z"
}

List all samples

Returns a list of your samples.

Query parameters

Parameter Description

perPage

The number of samples to return per page.

page

The page of samples to return.

sort

Sort samples based on an attribute (animal, cage, date, group sample, study or type).

order

The order in which the samples will be sorted (asc or desc).

animal_id

Filter samples to return based on animal.

study_id

Filter samples to return based on study.

metadata

Filter samples to return by metadata value

type

Filter samples to return based on sample type.

Request

GET /api/public/v1/samples HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2NzY4NzhjMS0xMDNkLTQ5ZmMtOTlmZS02YmI3ZTAzYWZkZGIiLCJqdGkiOiI4ZmM1MWYyNS05YWFjLTQ2OWQtYjlkYy04ZjdkNTY2YTY2MWQiLCJpYXQiOjE3NjE5MTE4MTMsIm5iZiI6MTc2MTkxMTgxMywiZXhwIjoxNzYxOTk4MjEzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Sr1qS0O46Tmmu0-PRb1EhnpTjkCQbTpjuz9oDejJ3tiykUXOHwRqehkJ8zPx12XcdjVG0gtdKTJpO8ZE-uvSKxWha0fa9CZSS8pGn1R9nyAfOPP6BlbLy0TnCeICJmTv5T3uRqQk7hJItBscY-Jx6Na9ZmYWeloFSezVy2tRdV-3PIlYQuiuF7nd6l2OW8MP8qPOVP7VZi9nyoQb9vqHWzWBGMrRV3JXNTTq6kDEsE6zhnXtKCr-O8H5O2VH95WcmFESsNr3GW_bL_R1MMsOZ68ZCP9b2DbzWRIOxhqN72f842wH1Pr48Dbe1jOzBVFmb64Og-0pBJFtnEHa8-haUyPSsvbvnWiwv6GWoDshHMaTegFWoUrr8ZTKx4eSCTqYqAUhfYTxf3r2dqyZ3OWnfB4vUN2G2EG9DwTOiPRxAjoHYbhjFlUCIuqUe_4PEy0GrMQm9QMOKAZyL-GynWfQfMQC2uHyF05-aUl7vRGklAyxJXqgRzMHEOSNKup_As6wBLcLZY75eLyBmXTHJTKOp5Iukf5yxhxni5dLYiC_aIxdDdbJS7pe3tGr9ckN84ovrPenyL1DpaTPHgXv17T4tbQUZ4Br8kl-y2PEKjILLW41cTbC4RwpyEAsb_Ub0A4Zj-38K4o3uBQI2hQ7M7zn6bN9Z4GVwltg--pX70UJxAw
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3413

{
  "data" : [ {
    "id" : "spl_RPtJUeIydrsxPC87agvEu",
    "sample_id" : "S645548604",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:56:53.065249Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-597469040" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_3N2C9p26VFNX7cKFv3pXI4",
      "project_id" : "pjt_3fvm4PQCLEIKFpSI4TiJ0O",
      "name" : "qNpNeEyata",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "dthA9fAu38",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_3UUrSP1j2qXL2on4xjkY65",
        "name" : "xdYYKhpn22",
        "email" : "rsd0U4gi@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_4TUAfZlpAbiEXPT36TIiHI",
        "name" : "ouOEKhr3nC",
        "email" : "tfe2LFCF@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:52.770843Z",
      "updated_at" : "2025-10-31T11:56:52.770843Z"
    },
    "animal" : {
      "id" : "aml_dNomhMvzhjcgbaUjaKUMR",
      "study_id" : "sdy_3N2C9p26VFNX7cKFv3pXI4",
      "study_group_id" : "grp_aYCTRGvZYbtWe8maWX3TK",
      "cage_id" : "cge_uOHtblyumRGwsr85jEKmL",
      "catalog" : "A0000001",
      "name" : "Ow7hmPYr3h",
      "number" : 1,
      "strain" : "DQQQTfqx5M",
      "species" : "GxUpfsOH8Y",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "jZCLSEAXXi",
      "ear" : "wnGnARMSut",
      "tag" : "P58QL0OQEH",
      "donor" : "20uwkR8z2r",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_212qfe3CX1TZ3WfuWs5uOL",
        "name" : "pWKe1zpT0r",
        "email" : "2RsNDJM1@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_2eosKXRLJVStUWAX2VahPA",
        "title" : "Found dead",
        "comment" : "zFqWKHT5Wh"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:52.922477Z",
      "updated_at" : "2025-10-31T11:56:52.922477Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_cMBRX8OfBDipB1vEOhepk",
      "name" : "pb08PP7Yuj",
      "email" : "gk2sZTWD@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "rBh1QDlIDN" : "W3ODWGL2zA"
      },
      "created_at" : "2025-10-31T11:56:53.055912Z",
      "updated_at" : "2025-10-31T11:56:53.055912Z"
    },
    "created_at" : "2025-10-31T11:56:53.065306Z",
    "updated_at" : "2025-10-31T11:56:53.065306Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/samples?page=1",
    "last" : "http://localhost:8080/api/public/v1/samples?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/samples",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Species Resources

Species

This is an object representing a species. You can retrieve it to see the name.

Attributes

Path Type Description

id

String

The unique identifier of the species.

name

String

The name of the species.

created_at

String

The created timestamp of the species.

updated_at

String

The last updated timestamp of the species.

active

Boolean

The active status of the species.

Create a species

Fields

Path Type Description

name

String

The name of the species.

active

Boolean

The active status of the species.

Request

POST /api/public/v1/species HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJjNjlhY2UyYS0wODUxLTQyMzUtYmM1ZS1iNjRjYjBlNjhlMjIiLCJqdGkiOiI5ZjhmZDU4Yy02ZWMzLTRlMWUtYWMzNy1iNzkzYzZkYmVmMTMiLCJpYXQiOjE3NjE5MTE4MTksIm5iZiI6MTc2MTkxMTgxOSwiZXhwIjoxNzYxOTk4MjE5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.TKDHk9Ndnrl0G0i2lFP8X7v52OnQsoWlhhfYfKAHSPAWidHa6Y-2n3LocaLDk7FJQXQrpsqC9BnincTUVTuPSgbmpVpmXuzs_XawSiqzGTAKmU9bFuPr3WMF05ZXMUbEMXeP7rFIVgnEwKQpOUYKjXTBPFIEzUAFe9oLQjIPDieGKac4HxRBHm8n8Hffl9gA95hUFCcMBqSFCPJ_UPQf-3l9mrwXqQZ1OkqZ9-HaFcvAjcCGZQo_WikkGSMFHSgPbodkt7bhkmuIDJH5HCjeYGBuyAUV7U2UA0L1yWWz-3uYW5ZDOlrRkDtxOs669KZgwOPS42n88i9XVRsyCZYYk5Wbs5Kh0lIQ9UwW8tvbigCcngH_IuuczFvzijfG3aDIRMaih4Noji7nbSktuLiKX1zqllPlNNNAYolQMNaL9kR9HO8WAjHr_Rs6h6B2NpbH_XtXl-0PUamWox204sXxhtaJzrakBiBTyNKjlKQ7x-AF8eyhgRqhSjMS7DBR72moEsGLPW6CGREIxRH6Fj53C2zTs9J7So_WtxVXBOxgmQas4vlDz8aidBKTuVLyCYZaov8Kqe4jt3ofubOS9Vr1y5cthmU__dppq9aBvGwVkOzvgvh4f6F2emw-__-Ix9I1EHbccfZCMiuW-4glg5e1p4KlyVfIQ-TTdY_M0PGqN6o
Content-Length: 46
Host: localhost:8080

{
  "name" : "pqcG9ChFiH",
  "active" : true
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 181

{
  "id" : "spc_4y1wKh4m473tfZgInG3UHz",
  "name" : "pqcG9ChFiH",
  "active" : true,
  "created_at" : "2025-10-31T11:56:59.608435Z",
  "updated_at" : "2025-10-31T11:56:59.608435Z"
}

Retrieve a species

Retrieves the details of an existing species.

Path parameters ./api/public/v1/species/{speciesId}

Parameter Description

speciesId

The unique identifier of the species.

Request

GET /api/public/v1/species/spc_1yi22fRj8Im6vYYkToZAfB HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJlNDgwOThkZS1iODE3LTQ4M2QtYWZkYi0yZmZkMmY0NTZkMTIiLCJqdGkiOiIwMzQ4YjI5Zi04MTM5LTQ2Y2YtOTRjYy05MzU5NTFmN2JhZWEiLCJpYXQiOjE3NjE5MTE4MTksIm5iZiI6MTc2MTkxMTgxOSwiZXhwIjoxNzYxOTk4MjE5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Rqk9Ew2XPaaqUPjX-SaL78ilvk8yi0_Zkkrp89kH-_tkeHcBTfqcCGErDcr5E0N8swUlIsbK-cH2SWS1eZK2I13rEH7frHgDJ1BYR2yspIjTtLuHz5FcWIVxz6PSZY_shWcaVifNvY5CIS000_MV8TnZsRYZgz2GZETUOfX7x8mqEbCYaUuK45HRiDZjioUECRd2caWPAxTbZR9TbnxqRS1OLiSaRI4wnywCYrbA7wCUqec3TrpNyfBPU4UfxkMd9_ltYvvwjgFS2zJ9WYdYVm8y9Kyfi0ZLtpnD5hhO02jCmQwvxF32kjmpE6j4qXphi2mEUJgKTqlhZM27S8IqZdiob6mPC4V1mLdLHWxWEsoWEJNwd4MUsGOIUaCrzDshHYkwhjFPKts-zFIeHwirjz8WIuS-368p__CF_MxUIiDDKpFd1fByCourGvxe6-s1uWR6huoUOe_7PKH1aCsFR6bZd2PaoCgwwkV08XrGKwF_VaP63pA_bHjIys3i7EdHQ6OZgZFjb5q0t6AuoQuceHhNfZaJrTOq3GapUja0ECZeXy8dG-lMpd1GZJ15lH9p6W2BdYHLTGoNIFJPTxnZTblLoIvgT9NDGpB4Uj1oKRvVgRKVPoefUg6nIe-H9ZbVXUlaU3WSzHlfRqNUb5tMoTcRgNsqrp096CjKe2wqYsE
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 181

{
  "id" : "spc_1yi22fRj8Im6vYYkToZAfB",
  "name" : "U8BxuuUI7U",
  "active" : true,
  "created_at" : "2025-10-31T11:56:59.622927Z",
  "updated_at" : "2025-10-31T11:56:59.622927Z"
}

Update a species

Updates the specified species by setting the values of the parameters passed.

Path parameters ./api/public/v1/species/{speciesId}

Parameter Description

speciesId

The unique identifier of the species.

Fields

Path Type Description

name

String

The name of the species.

active

Boolean

The active status of the species.

Request

PATCH /api/public/v1/species/spc_1PdigaodpsjnFUtzcE4Mfy HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxNzM2ZTM4Zi1kMTBhLTRiMjUtODRjMC1jZDI0NGFjYzE4ZmQiLCJqdGkiOiIzZGJkYTU0ZC1iYmM4LTQ4MjAtOTY3Ny1lNjY2Y2ZmMTIwZTYiLCJpYXQiOjE3NjE5MTE4MTksIm5iZiI6MTc2MTkxMTgxOSwiZXhwIjoxNzYxOTk4MjE5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Icz_93PWM7KyiXCdD2x5yRjLOza74enhjU48y6uJKylAP4jgNpRzwTSA1-5qBscqJsnV71LIgr0NN2G_2LjDk1NGK_ocYlBc9uhwXeZ7_r9XZBs9yB4vtsV55ukeFvl0KnNI4JFjh3qdTp4TqJ3z-I3jBfGqy6ApWNfP--AblqZcPmI0qn4N9vEj_Y5R5UJIre_JSsgMRwp7xT-o8nt3kPQkEFmN5PLwW4oUA3kH4Xq0f96ukEUbNqJk3S3-zyBpdtcY5888pNCl9PXNpU_eVFaNmm8aQC-ttxMFRodtIUIfUdwv7ZEc17qHPjaQP__ehelA87IPMQClKuvC5P4LgHKZkY-CJH8S09klt1D8dEG9bouTgSINbkHfKJ5rjvQzIaoMc3VJgWRjlow4fX1NL75SlX6r9blbuJQkvCGhHmK0M1xEQ7uFEKCzEXr3atcZG5Wq9Ygf50i-rbwwGxarHEcEPu7HUVHnc0pXlVJdU3G1Zdiz9vc6RwPruCBw4AfoO8_GSCECsYO5B-MeZ91qLIqhLJRgYRhxxq_zb1ZOIwx5R2JUnmcCM7zhxtRS61e9d4NPad_avXKI5nN9s6EZY-aX0LgsCtd0qSAi-TZTPfDmze8yIko1MFkBmuQpUYzMh7R306viJ8W0-pmA32q13u3Jisb5idsl83ZT3qOh408
Content-Length: 61
Host: localhost:8080

{
  "name" : "Benchling In Vivo Species",
  "active" : true
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 196

{
  "id" : "spc_1PdigaodpsjnFUtzcE4Mfy",
  "name" : "Benchling In Vivo Species",
  "active" : true,
  "created_at" : "2025-10-31T11:56:56.663702Z",
  "updated_at" : "2025-10-31T11:56:59.678584Z"
}

List all species

Returns a list of your species.

Query parameters

Parameter Description

perPage

The number of species to return per page.

page

The page of species to return.

name

Filter species to return by name.

Request

GET /api/public/v1/species HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2Mzk0ZjU0Yi1lY2YzLTQzODctOTQ3NC0wNTgzMjhlYTZlYTYiLCJqdGkiOiI0ZDZjNmQwZi0zYjY1LTQ0NzgtYjk4YS04MGY3Yzk5ODM4ZDkiLCJpYXQiOjE3NjE5MTE4MTksIm5iZiI6MTc2MTkxMTgxOSwiZXhwIjoxNzYxOTk4MjE5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.KHh9IygAbFMNSMIPxxDcSwc4RG8zapFGn0iq72lY7FtOLu04x9GlnRN2dEq5JiuNhQHv6LFf3-D7LPd8Xepa1FbWpKkXCsKToPLeXbPseln_obN8Pt2yB0dV1aaNOIpyGdwasU180SvAS7RJxyoFwNHYCTbxoyT42x4ls_Ge5e4tR-NRShYCpTDZisZzc_0tNYOHR6PwBaQVQHNqK5aQN43QxMHVqKQngTNXKFcWiBDpXTFxGVSMpoV-7qgQ1wbHPde56a2mwbyo5xH3PX0BmkCoGXNshEGhpmNIO2lEckQq7KBaUWVcYRS9q08iIIcEJCKJ9EvilPUcBn_h44peLE8UynjSxJFPIdtdVplURBKyyWdIaEM2j2YeHgn9YKaaNVKHxBQgWd827x9HqSsCDl8N6tvwdfp2ah_yBy2w4MSDFfaCldmb3tr6EydiYxsqSGopMliZAD_0dZ9N7rdIhb13kCNcGPXTyWCh9X4nRc-28g9tN2iJ5_TTCG438Xs-hwyb9EZ85bjKMczPPq8K7i3h0GuBQJ5w6rGb_TLMm2FeY0BaAfJ8wD7rqUAjXGvFj2DY3RFWhUdD7VXDks8c3kKwtG3YzrjX-FxDkR8vWAqqD4Ij3O9Jkhh9xGeXUMdUu4_iI-Fxl630jt5Xwag66-lzZfWvVsD-zCavpi2NLo4
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 593

{
  "data" : [ {
    "id" : "spc_3J8Wb1BMYoQQDAVi5l1jLQ",
    "name" : "L8oy5QQGo9",
    "active" : true,
    "created_at" : "2025-10-31T11:56:59.430648Z",
    "updated_at" : "2025-10-31T11:56:59.430648Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/species?page=1",
    "last" : "http://localhost:8080/api/public/v1/species?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/species",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Strain Resources

Strain

This is an object representing a strain. You can retrieve it to see the name and species of the strain.

Attributes

Path Type Description

id

String

The unique identifier of the strain.

name

String

The name of the strain.

species

Object

The species of the strain.

created_at

String

The created timestamp of the strain.

updated_at

String

The last updated timestamp of the strain.

active

Boolean

The active status of the strain.

Create a strain

Fields

Path Type Description

name

String

The name of the strain.

speciesId

String

The unique identifier of the species the strain belongs to.

active

Boolean

The active status of the strain.

Request

POST /api/public/v1/strains HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzYmE5NTQ2ZC02ZDkwLTQ0ZWItOTg1Ny0wNDhiOTE3NjMwMDIiLCJqdGkiOiJjYjA5YjFjNi00ZWE5LTQ5MDgtYjY2NS05NGM0MDA3YWE3ZTgiLCJpYXQiOjE3NjE5MTE4MjAsIm5iZiI6MTc2MTkxMTgyMCwiZXhwIjoxNzYxOTk4MjIwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.heUFkbgaFeVyktMP2lpR0mRHChZcY3w2qcM6f3wl8M-SNeeruu2Fkxi3BR1cTdX1zTW4m2tDXv3HtFHa2MZP6QdRh3BS5cq5IjQiv5gLUSS_KmJ3dTOFoguqAcahSGTWD33qWbO5tamNY1rlR00YHXRsb0V4i0Qvtv9xJTnCygq9P0i1ZnqqcWjTqQTI_w9RBNiw0vKTbncHEOG2YzLpaMVZzZpPGcoZhX3gTjuPf7cyrd7y7xzgeVfy8nwEkyfUZtcZ1dH8KAKXlxfhk4lvmk0cjnun2qdfhKWj25hcLVWvwlSoxoup4NPU8rQ2eex3Z9bN9kObC9xZ_B06nWiZOnRtc1QxzW_IanPWK1tfDKS6T8e-Gt0ioZ-H1_aW_boBDsMy58olLBOG6DHEtq9AzbromdvTMmYoFzNmIHKisJ4otejsSoSV3iS2GJyqCgqNt3FrK-VP_nmBtwa1z_2nLOsQ0mB0TedZOB1qkaagLc3JftkJP3Cv4vZBad-dJlRrZvjLFADPte8QcFx9EerY-RfIluj7zBxvtPOH5_IQWlu5bifkdBDCHCoFR0U7fqmuYRg_FLLWP1FBQitEdF7dDxeZchQ4wG-PeJve3jVT0-GiBVDr_8iBUYxjWnzdKZrzoEdOmk9rEFJDdFr2USaj-wHbMahN32VjmOaWJUZHfvM
Content-Length: 92
Host: localhost:8080

{
  "name" : "hZH1vw3BZq",
  "speciesId" : "spc_1nAdRmHRgliT4cDYBfG2fG",
  "active" : true
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 390

{
  "id" : "stn_5bhU7lcn9LbxrEaSNQ5esh",
  "name" : "hZH1vw3BZq",
  "species" : {
    "id" : "spc_1nAdRmHRgliT4cDYBfG2fG",
    "name" : "Oxi6vosqbU",
    "active" : true,
    "created_at" : "2025-10-31T11:57:00.053338Z",
    "updated_at" : "2025-10-31T11:57:00.053338Z"
  },
  "active" : true,
  "created_at" : "2025-10-31T11:57:00.056217Z",
  "updated_at" : "2025-10-31T11:57:00.056217Z"
}

Retrieve a strain

Retrieves the details of an existing strain.

Path parameters

Table 1. /api/public/v1/strains/{strainId}
Parameter Description

strainId

The unique identifier of the strain.

Request

GET /api/public/v1/strains/stn_PksaaP1PTGpoVGShTrhVs HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI5MWNmNGQ1Yi1jNTlmLTQxYzUtYmRkOS1lNDQ1YzRjNTgwZmQiLCJqdGkiOiJkNTc3YjdkMy1kYjc1LTQ4MTAtODE3Ni1iYjFlZDZmZTFiNjQiLCJpYXQiOjE3NjE5MTE4MTksIm5iZiI6MTc2MTkxMTgxOSwiZXhwIjoxNzYxOTk4MjE5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.eo0BU61abhAayw2Yga5ZUrnoMIDwiG4kVSkHqccAUFpwdC_4hjkRWW8BnOR6mqVQkDMNn2U5VzNbjAuRFxE318v_DkXG5A-ZbWkjI-Je3HUfJECE69vHTPo3UaT0FS3m_qfE1aF-vdPn7mCRNe1awnBMv3wVT6Z09lK3rW1FBSj90_F2xLTkHdNBxlz5LBWQY3RQd3IruawRLnCmBK7mW3NWcBiE3yVTRzUTWLYxbCrNJa2oLDnPbw4dkJkWfaUcg8DoZofi8J2eaoO-y5LIq9Gj_szaozZGldDOw5cF-BBbS58xu_kBQ67PgHyVvBl4STigl1cFdydiz9lZvCkUfMT6vrKa62-ti8UZVCllSunora7ULOv9twTNaZqZyiv9H2T8FwS2_0TTW7KgbNGUK8KxXxkCg29PTq5N2QMEhInwTAu9i6WzC4FYZiqfHQ_sJholPPuPkeIpBseH3rHGyIsn5drNcRde2qfdbUH-wZvHBUUP0ohzXp2iteYtqBdy-DIt6hBHFxBWMHrTpWX0TqWe-p0piXYzj8cPIj_c_0NiPq3wy-ltoHEiq8CKxFl1ya1OHg5xRojsqGAT-HIyi5kVPneZkgpwVHwoDv8eTcz_ehnR7MtewwoxnBH9qt7g0pTAHFfNax-lcs9yEKiuf88ZvVM8OTnQlt6id3C_9BY
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 389

{
  "id" : "stn_PksaaP1PTGpoVGShTrhVs",
  "name" : "PHZzohgPSR",
  "species" : {
    "id" : "spc_6HOhIHtANswbAd7fav6KWv",
    "name" : "vogdIFEZ6P",
    "active" : true,
    "created_at" : "2025-10-31T11:56:59.799268Z",
    "updated_at" : "2025-10-31T11:56:59.799268Z"
  },
  "active" : true,
  "created_at" : "2025-10-31T11:56:59.800542Z",
  "updated_at" : "2025-10-31T11:56:59.800542Z"
}

Update a strain

Updates the specified strain by setting the values of the parameters passed.

Path parameters ./api/public/v1/strains/{strainId}

Parameter Description

strainId

The unique identifier of the strain.

Fields

Path Type Description

name

String

The name of the strain.

active

Boolean

The active status of the strain.

Request

PATCH /api/public/v1/strains/stn_3dXlhLhHcL8lLF2lF078gF HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJiMzgzMWNkYi1jN2MyLTQyYjItYjRiZC1lMTZjMTYwMDJmYWEiLCJqdGkiOiI2MTE1N2RlYS01MjgwLTQ0NzMtODg4Yi1hMWE0NDk0ZDdmMzciLCJpYXQiOjE3NjE5MTE4MjAsIm5iZiI6MTc2MTkxMTgyMCwiZXhwIjoxNzYxOTk4MjIwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.LcWKveLNjhHbp58hHV6sD490cP0yXQ3jqzmui8FZbhFiZ7PmsDP78-eOmwa7s8ymBdJmMWeW1WIbDvrgqxIajxyEgOgHHatU4ErwUK0sl1SwlWdw0ZItKPDp8MOf3j8lOrErIhPWc0Z8ozSLOClFhv1UZ7BGOCIYuZeEr30eNdwt2M6hQDr9YVtW8iBipD7TV6UJRTtQRtj4nkQKU4WH-Ztf17QUNSxolrncTamOAyOnNriuUKfaHtkIzdiWiSsREA4JVAkuZRTBs3zhhy-BKpyRF9-0-__S3bsVNigAiwgdiGWmg8bXdLRySn5lopaNQmQl-9MyoEyw2mKYcWR9aNUlyhuFytFZCqWwSx635CGLiMt5SfX0ZDRCSa24qs2DHz3c9MEA3xcgjmsLT0BDlusFKFyOimteqtAcWmiYBIRSvV935C81tmuZ03DHfNQQLRdZE8i3kvsXN0ma3b6COOA6O02MFlUKBngtkPbbgyRboeytOh7eYNCMHG9a6IWRF-BpsB6eGhqjkfm0qdMbw4Clxb3MAbCgi7dK85HhB2tQ2LZybRlwf9hDjWQLvLtPwTBf-A02NalrLlbkHHyNgMNrtZpGAaMT23NeelUVoJzgxgh33EdScy2PshIxNIEW8Tn_nHuhoKFhNqjcE89W6MEZ57Q3WfoqY2cYxdPIXac
Content-Length: 60
Host: localhost:8080

{
  "name" : "Benchling In Vivo Strain",
  "active" : true
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 404

{
  "id" : "stn_3dXlhLhHcL8lLF2lF078gF",
  "name" : "Benchling In Vivo Strain",
  "species" : {
    "id" : "spc_2URTdpJRvGSqYuNgMLRpGZ",
    "name" : "XbdNJvKHcd",
    "active" : true,
    "created_at" : "2025-10-31T11:57:00.072603Z",
    "updated_at" : "2025-10-31T11:57:00.072603Z"
  },
  "active" : true,
  "created_at" : "2025-10-31T11:56:57.075840Z",
  "updated_at" : "2025-10-31T11:57:00.090433Z"
}

List all strains

Returns a list of your strains.

Query parameters

Parameter Description

perPage

The number of strains to return per page.

page

The page of strains to return.

name

Filter strains to return by name.

Request

GET /api/public/v1/strains HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxZWIzZmU4MS1kYjdhLTQyOTctODY0ZS01ZGVjZDdkNGYxMzYiLCJqdGkiOiJiM2E1NjllNi1jMjNkLTQwNjgtODkzMC1kNzFiMWI5MjA1NGYiLCJpYXQiOjE3NjE5MTE4MjAsIm5iZiI6MTc2MTkxMTgyMCwiZXhwIjoxNzYxOTk4MjIwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.fbl_nAjvTwApx98oYytsaJj5dufseLEhFUcN6ZvkcU9UppSdHecWsSHWc-Urd_nhwYCIbZ43_9Zt1rxXVACTQulXoahR5tluf0pdQcerVTZ6KKM3MqEdr7NlivSTtX40x8DBtrIF-y7cIUzXx6DMuikzYEt45x_TAIFgabOJlh--g3ZdM33EFYMwFQ2S5VBDpFK_HyL-QXga2yJbU572pAyUHqJImC1Ka7oHctTzius6eiC2y0B2CNRliKZ75q3baQgHgFRDdOrsFV0b3KrwMbNgYQTCC9Lu3CnCZHQZQYC8GaBQrvOdRRueSk5vduJIM9bI68aw8RVz5so07KzxWkqtBdOsBwTt_5HwyzyUpsZTspz-ljIZv9UViAQiZYOe66nJNDQ1D__ubVv_snnAV1BDkpEdAw19HExELtiL00Ez_Ipinb911j5lzrmgTsq4-rO5pC-TygKxjas3GcJhU2dXxnZVVVFuQf60dRl6B_ZizzbD70he5ETYpxSd3CKRj_YRoVAhn0SG5Ai-G9CAmaFBODDeLM4JfTTcM1wE49mCOBhZZ3W59D4ga32zBxWLVU7Hc2jUr5VrdfqBn3-qn6PFs0AKiboKSAnlhgp14m0Ee2hvEMaXf132UYRNUMVshihy3OxN533pcCY2Si_Lo2OqaxzAJaR0CG0_WQhTvVY
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 816

{
  "data" : [ {
    "id" : "stn_4GXNxXY8WuIS9clP5XaSYx",
    "name" : "53J3w6gz9p",
    "species" : {
      "id" : "spc_7FzXC7uXcgGBGYhwTbVTVk",
      "name" : "nzKW1cmfup",
      "active" : true,
      "created_at" : "2025-10-31T11:57:00.105633Z",
      "updated_at" : "2025-10-31T11:57:00.105633Z"
    },
    "active" : true,
    "created_at" : "2025-10-31T11:57:00.107794Z",
    "updated_at" : "2025-10-31T11:57:00.107794Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/strains?page=1",
    "last" : "http://localhost:8080/api/public/v1/strains?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/strains",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Resources

Study

This is an object representing a study conducted in your facility by your team. You can retrieve it to see the name, the study design, notes, average calculation for treatment groups, if it’s internal or externally conducted and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the study.

name

String

The name of the study.

code

String

The code of the study.

type

String

The type of the study.

started_on

String

The start date of the study.

status

String

The status of the study.

description

String

The description of the study.

timezone

String

The timezone of the study.

metadata

Object

The metadata associated to the study.

author

Object

The author of the study.

owner

Object

The owner of the study.

project

Object

The project of the study.

completed_at

String

The completed timestamp of the study.

canceled_at

String

The canceled timestamp of the study.

created_at

String

The created timestamp of the study.

updated_at

String

The last updated timestamp of the study.

Create a study

Fields

Path Type Description

name

String

The name of the study.

type

String

The type of the study.

started_on

String

The start date of the study.

project_id

String

The project of the study.

timezone

String

The timezone of the study.

author_id

String

The author of the study.

owner_id

String

The owner of the study.

team

Array

The team of the study.

metadata

Object

The metadata associated to the study.

Request

POST /api/public/v1/studies HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJmYjk1NzAxMi1iZWU5LTRkOWItYjdhMy0wZjk5NjdhNzdkOTQiLCJqdGkiOiI3NmZjYTNkNi1mN2ZmLTQ0ZWYtYmI5Zi0xY2UwZTcwYWMyM2IiLCJpYXQiOjE3NjE5MTE4MjYsIm5iZiI6MTc2MTkxMTgyNiwiZXhwIjoxNzYxOTk4MjI2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.DKjq1x7eL0f5_Umif40RM7KGtc8okcqfqEFR4ew-E-meAcmjYEr0TPYA2cPkx_MprC0shTAx_23JX7fBOnVF4w9677QWc1rdmJRa8xsrwUK1OAU18ksLnYPNweFBI98id1GsSsJv6hYthSENP07rXSs40ESC8UiRoWxC6EGnt5t2nKSxMxGABBm9vZv4CwrC2anrItgp033f9YC2BDkWir0gDLgQys-mT4LQuWpnh1DrwEq_-7gBwaeWTiAWtkyB1-RV7rIokf-CO1Cex3S4cqDtXkbi328d4HmybjpMhJVZedrQFLxjXfLOPsM_jrQhFjz28z79e8GPZ7bx_HVJp7X1v-eWfQoVH_Y095O-fVMOCGJWcmE08jWSKLwjgYvw1TBga7vb03vmpzgEJJMWJZiETbRfi-Tgj43j7me3Ciolyth7KzmynW0aaBqBvlywWZVEbClSDmiMkciIrhaRC4tDd6de10PrwbRqPzVtH8Jzn9AZWhMPz0MpHDOOaNSne3DEl7_VssZ1odAdRmpn1r-FFHleExLap7x8WbB0R6CdG-79MZac4_0vzw_I6x3eTmL1OFzgDPPw3cgXZgjbSpEq5DbHzk40tAzTBjVouh30GtuaIT6JRGjboISID2nrjjsF0Nsj4KUg2w6WSYexP0BrUhHmRTmvfTERHmYB6wU
Content-Length: 406
Host: localhost:8080

{
  "name" : "ohPuz1RkGN",
  "type" : "internal",
  "started_on" : "2025-10-31",
  "project_id" : "pjt_mhtB2wGL2qywlYCrDYqfn",
  "metadata" : {
    "study-internal-id" : "STUDY-1234"
  },
  "author_id" : "usr_5Bh8KUYQ45xrgQ2tPDNwAo",
  "owner_id" : "usr_2MsdNX1VnkDOxPVVx8tnq3",
  "team" : [ {
    "user_id" : "usr_MGclZ3SSIXrsdQXOdQO4Z",
    "access" : "read"
  } ],
  "timezone" : "America/Los_Angeles"
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1194

{
  "id" : "sdy_2EoKJOKhdjnQQrHZEuz4DA",
  "name" : "ohPuz1RkGN",
  "code" : "OW-SQ1-25-F",
  "type" : "internal",
  "status" : "in_progress",
  "description" : null,
  "metadata" : {
    "study-internal-id" : "STUDY-1234"
  },
  "author" : {
    "id" : "usr_5Bh8KUYQ45xrgQ2tPDNwAo",
    "name" : "zRpwoxrDc3",
    "email" : "040eHltf@benchling.com",
    "timezone" : "UTC"
  },
  "owner" : {
    "id" : "usr_2MsdNX1VnkDOxPVVx8tnq3",
    "name" : "IKge5dnNKy",
    "email" : "vzs7Efcr@benchling.com",
    "timezone" : "UTC"
  },
  "project" : {
    "id" : "pjt_mhtB2wGL2qywlYCrDYqfn",
    "name" : "KWDHaVF9CP",
    "metadata" : {
      "project-internal-id" : "PROJ-1234"
    },
    "created_at" : "2025-10-31T11:57:06.210650Z",
    "updated_at" : "2025-10-31T11:57:06.210650Z"
  },
  "timezone" : "America/Los_Angeles",
  "team" : [ {
    "id" : "usr_MGclZ3SSIXrsdQXOdQO4Z",
    "name" : "ckWr0cAns9",
    "email" : "AEmWCFOc@benchling.com",
    "timezone" : "UTC",
    "type" : "team",
    "access" : "read"
  } ],
  "started_on" : "2025-10-31",
  "completed_at" : null,
  "canceled_at" : null,
  "created_at" : "2025-10-31T11:57:06.420583Z",
  "updated_at" : "2025-10-31T11:57:06.420583Z"
}

Retrieve a study

Retrieves the details of an existing study. You need only supply the unique user identifier that was returned upon study creation.

Path parameters ./api/public/v1/studies/{studyId}

Parameter Description

studyId

The unique identifier of the study.

Request

GET /api/public/v1/studies/sdy_vIlLhIsX46gDVxenMlPRB HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzMjgzM2VhZi1jMzViLTQ5YjgtYWU3YS02MzVjODhhNGUzZDIiLCJqdGkiOiJkMjcxYjA2MS04YzRjLTQ0M2QtOTk3Yy01MWNhYWU1NDg4ZGUiLCJpYXQiOjE3NjE5MTE4MjUsIm5iZiI6MTc2MTkxMTgyNSwiZXhwIjoxNzYxOTk4MjI1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.LTa0mpVm2bmHfQGZtMYYFsf50-akJaP-mt8Jg61EDqKMfHyaFDZDXrM7CUPSNHcWrQxEd8I8sae5-VqyfktK635gV_ChOEtpfxdtxlx6H8TXCHuRjffZKffBMuNn8VXZhEnWhP8HXWCbu_HjQGV20b9mJ7xFXJehp1mEM_kMUh11RPLiBK3cSjg68MMje6VOQL11ppcmraq-SYO9PLill0NS03N5ZsxhkxeXWO-chMY-Z8fXb_nnxRvNkdyLXGvSS1Bpf0xhPx_ECKHRraoY3DfyJJnmSO5Kbtzu7o4jCtcRKpHDJyMLDdw_cD3ze8sFxwtNJSxrFITvSsG5rEL64ft25Bsx0hPXhgdQRLHO3xhSG6Jy5dc1wXB4hlh9Q3FBzIbT5pXKuWyQJSLRe3nShl_nNn1fRkCVDe9Y8-kPH280vfWdB5PA6rQzXkFFu9DMPjjHIlnM9aRAUJjVStLq20RBwFAzWKmPmFvRl_vUDd7vQm78rwTZqlCxqz7lrlI3LStolq59N3c4FQlUww5Hehh-RkyaSqhe11BHMRBLnQsQxyriqV6LDq0acuLhMH2d6bxjVE7TwY1fiMknyI8PXksqsPzC5VnMGXlmmShaRzYTQBpUjy0F_z1ngwEgQO7zJuem2-LeXW6CFTXbxxumMrwXOecPvXM-UaFJphJUtxQ
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1004

{
  "id" : "sdy_vIlLhIsX46gDVxenMlPRB",
  "name" : "t9fF6zM00z",
  "code" : "CD-25-445",
  "type" : "internal",
  "status" : "in_progress",
  "description" : "nPYhmqcB6n",
  "timezone" : "America/Los_Angeles",
  "metadata" : {
    "study-internal-id" : "STUDY-1234"
  },
  "author" : {
    "id" : "usr_6WXuLerSGPaGOGqwkxbuM4",
    "name" : "MgVwJnMYWx",
    "email" : "GBO8bdgB@benchling.com",
    "timezone" : "UTC"
  },
  "owner" : {
    "id" : "usr_72zsjcHwVf5UYkMaRQkcKe",
    "name" : "Bi8605RtQw",
    "email" : "xoiSXPia@benchling.com",
    "timezone" : "UTC"
  },
  "project" : {
    "id" : "pjt_5ZQYdTHRl6LBY3xDWm6n0u",
    "name" : "cgOpBIbVwk",
    "metadata" : {
      "project-internal-id" : "PROJ-1234"
    },
    "created_at" : "2025-10-31T11:57:05.654357Z",
    "updated_at" : "2025-10-31T11:57:05.654357Z"
  },
  "started_on" : "2025-10-31",
  "completed_at" : null,
  "canceled_at" : null,
  "created_at" : "2025-10-31T11:57:05.660082Z",
  "updated_at" : "2025-10-31T11:57:05.660082Z"
}

Update a study

Updates the specified study by setting the values of the parameters passed.

Path parameters ./api/public/v1/studies/{studyId}

Parameter Description

studyId

The unique identifier of the study.

Fields

Path Type Description

name

String

The name of the study.

project_id

String

The project of the study.

owner_id

String

The owner of the study.

team

Array

The team of the study.

metadata

Object

The metadata to be associated the study.

Request

PATCH /api/public/v1/studies/sdy_2Hz0aoKY5NOwxbuQ288yzf HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3MmFhMjU2OC03NTBjLTRjNzItODQ4Mi1kNjc4Y2RiZDA2OTciLCJqdGkiOiIwODFmZWM3NS0xZjBlLTRmNmMtOWE5ZC1jMGRhNmZlZDliNmEiLCJpYXQiOjE3NjE5MTE4MjIsIm5iZiI6MTc2MTkxMTgyMiwiZXhwIjoxNzYxOTk4MjIyLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.N1DfftS2V-KO55jtMVii6hLe-H1HO1LZtzvleL5LCjoqDPH50gfn7muBa5Qj2JPBoXKE429X2hXBy9hZi5yfkq-5L6AG5Prs2QBQei-9RuagbVrAcaEGwLZ9ap6cejhwg5UWiktXFgPTN5G1N-RazG9mPgK7lTc5QMgo8eAQW7IIkDkjG-yxSLockrKis7UdxnGLI2BqKVpJJmPUoQb7NvR2OC0UUYoBlrVBmL6ZSBKpJ9DB7s6BlMUcAhX5WcBTi1W0KCB_-Q0iZ9wcqhyMQprw8Lykpngb3GcQAOJZXNklNYJMR5CpGPeqkICri9CN1wVsYHbTKejF8sjitisevvqa2kdb87JaZ9Y2AWKz2HTntggO362Ddtqzyilvm-PtUYZvmSExfvr-X4po8-XRYx3PcKj2Dy3xvheqRRAufQkd6tRWDoZ5sU0sE_cRcf78AA483crjecwt5hnSvaMAFN7PGYDAsU42YK2EaisnlJNwTGHpsvLGDrImDRdhSjO3C92LRnKH_9xcQe8ExPmhsSKtDE4gG0DaTZb_WMosZDQFPsQ1mJY8u0KjDj81ZpJKk-w5y5YSNrRNcws_CxSRXt2UfCP_2uORjp0rYm3rSkb8c0mEAZbhZxtH7NvAilnNbRTfDAE1HPeQGbTqjIDI2t2lXbW25ebEPxuRviFPbw0
Content-Length: 277
Host: localhost:8080

{
  "name" : "Benchling In Vivo",
  "project_id" : "pjt_12YR5kO5EAz1P6O3BpUDFR",
  "metadata" : {
    "study-internal-id" : "STUDY-4321"
  },
  "owner_id" : "usr_5MdN4llRFAFMxAhigCUd2F",
  "team" : [ {
    "user_id" : "usr_6pKj9i43RKd06FINthueXO",
    "access" : "read"
  } ]
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1020

{
  "id" : "sdy_2Hz0aoKY5NOwxbuQ288yzf",
  "name" : "Benchling In Vivo",
  "code" : "CD-25-445",
  "type" : "internal",
  "status" : "in_progress",
  "description" : "hpR8APyIP0",
  "timezone" : "America/Los_Angeles",
  "metadata" : {
    "study-internal-id" : "STUDY-4321"
  },
  "author" : {
    "id" : "usr_2Ze6W5L4X8qmfazwBrk8vK",
    "name" : "lQMGjGPguA",
    "email" : "XjLRGOgB@benchling.com",
    "timezone" : "UTC"
  },
  "owner" : {
    "id" : "usr_5MdN4llRFAFMxAhigCUd2F",
    "name" : "MUz7OEKQZo",
    "email" : "wmOJpm8c@benchling.com",
    "timezone" : "UTC"
  },
  "project" : {
    "id" : "pjt_12YR5kO5EAz1P6O3BpUDFR",
    "name" : "BlWtMyzsYb",
    "metadata" : {
      "project-internal-identifier" : "PROJ-1234"
    },
    "created_at" : "2025-10-31T11:57:01.961479Z",
    "updated_at" : "2025-10-31T11:57:01.961479Z"
  },
  "started_on" : "2025-10-31",
  "completed_at" : null,
  "canceled_at" : null,
  "created_at" : "2025-10-31T11:56:59.095164Z",
  "updated_at" : "2025-10-31T11:57:02.119628Z"
}

List all studies

Returns a list of your studies.

Query parameters

Parameter Description

perPage

The number of studies to return per page.

page

The page of studies to return.

code

Filter studies to return by code

metadata

Filter studies to return by metadata value

Request

GET /api/public/v1/studies HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2MmM5ZDgwMS0xZDlhLTQ2MjAtYmQ3OS0zOTJjNTVlYTNiNzgiLCJqdGkiOiJhMTVkNTEyNC03ZmM5LTQ2MGYtYTRjYi1iODAwZGNmNzg3YzciLCJpYXQiOjE3NjE5MTE4MjYsIm5iZiI6MTc2MTkxMTgyNiwiZXhwIjoxNzYxOTk4MjI2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.cXWeIhFUYw52IgAE6x78qpgNH7fyQchdfyX9wjoU4vlKrWK7qbuskKcUk4R_hosjn6GC0JIIbarn9H-1vmYcc_f0zufckX7sHnhipaj-XTXoYtZr1aSc-LS1t05H0kZzvanXCgBy6uQreoKwGeJKaqkds5FD5ptlJZGl5ydMYNxGyluSZfTsffCxlM9xkDS2UbCCwkaeIlVk1KWUYSwigQyskmAQsrTbVZozPgOnPb4ekE4DzVSKiZccJCQNTjFG3MC4mytwczrOYb6nuPk1vLDBmdAT3B8qxBmQTfkcDS0xga1lYk2GISHA0DJ4JJsWG7qjQu0M0NEljwuRJhy6Wsa2ohfB7E4_SbY7fZKnCvPE_FxDJZdvwKluxjCy4aNiUuaOoreBy9aMHfWJWPdpTnRle31ZEsXknWdRFkAvUmIzUMEmChkL6FFKqbCJeACmIlr5Yhs1g3EK4L5Gpke_E4tXhrrAd3plBlhreLje3f_y-m730-_5Cp8MeJbNCiOuC87HWwo1YRVP4W-H4UAW7Cl0VUBaV3O_oyDutjbQraEkKECGB9jviaI79eiQ8rwExW5qDUYedMeS_NGkNYE6pR6efBzlTXKaZRTznXF-hoF2-kFXuiLgbgshUQRN9ueCKi-Q-swkS8qrabK8x28Q8S-enpuTnpvKlMuQ14KMq7o
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1478

{
  "data" : [ {
    "id" : "sdy_5B7fk1YT4dAbZ42NyqOvar",
    "name" : "4c3mZXrGQg",
    "code" : "CD-25-445",
    "type" : "internal",
    "status" : "in_progress",
    "description" : "MmyWVon5LU",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_PZKad6dtgvCsIoj3qIbpI",
      "name" : "n4PzaZsoSX",
      "email" : "IQ9jA4gc@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_1OxUFCJ5jXGr3N3arl6W2d",
      "name" : "K2VOcNEsDr",
      "email" : "OEWV3T79@benchling.com",
      "timezone" : "UTC"
    },
    "project" : {
      "id" : "pjt_5PAJkoVpxJIo0iip6ovtZO",
      "name" : "hYYsr9MSMV",
      "metadata" : {
        "project-internal-id" : "PROJ-1234"
      },
      "created_at" : "2025-10-31T11:57:05.956956Z",
      "updated_at" : "2025-10-31T11:57:05.956956Z"
    },
    "started_on" : "2025-10-31",
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:05.963224Z",
    "updated_at" : "2025-10-31T11:57:05.963224Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Animal

This is an object representing an animal that has been enlisted in a study. You can retrieve it to see the status, date of birth, sex, species, strain, identifiers and treatment group of the animal.

Retrieve a study animal

Retrieves the details of an existing study animal.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

Request

GET /api/public/v1/studies/sdy_2Al9eutqY2Dse7t864P1Pl/animals/aml_3VyjCgNUBCt9Xz1KfzQ1m5 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI4ZTg4Nzk1MC04YTQxLTQyM2EtOGNmYi03YjNhNTljZDk4ZGMiLCJqdGkiOiJkMzUzNjE5OC05ODU1LTQzODEtYjRlZi0yNGY5MjYwODJiMzUiLCJpYXQiOjE3NjE5MTE3ODEsIm5iZiI6MTc2MTkxMTc4MSwiZXhwIjoxNzYxOTk4MTgxLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.bdT5-BPOPSjL5qd1Ng-UkvC5f-9mCF-oLaqT-Z8jbk52BYIwkaGDYfME6E_zg3KJz8kFqPn2m8-z3XoeTfvKkKtN2w8ovzUi3BVYlOEkNaasqZtxg-yJUA036Kiw7GKg5yQuE5-Kzk763mx4njnDb_RxWIryaAshR04TQDSO7EePTU1ub-4EfNG8YRkajesBiUOge-ivzBXw8dSAikvQ4NidbJijOKy84QJgHBBDayH_uzW-ZEqE4pr9X1fsNN73VxMUPtmdVkB_YSbLV02ivEI4TIg11zs-XRvwTi_f2IstmxaPWu0GcZ7AGipmo-QvE-Xr9FtPwCr9V88opE4chV34aPlmZoWcUP5XuLVuNMP1fSu7PUgyIwk4wzUUYO-iy6sM-0PAN8CEzz-71yOMN0LfTsWWFOegvNNO9njuvx9wV-4GvAppf-aFCITtCF0IUkphH1FLJCrjZdahwbCejosetQ8qkchOLOv7A5O4SE0YWwAkn1YGAEdIJmVuHNjkynqkU_uE1cWj9EM6fWEv2jdUM4LPovHo-D9NIq4gq6FKPsEJo78r-qPP9B_0f80Q8XgZOHTJlH4B4r90jYWj-maTFwt8qLuFPbaAa7LwRJDlNmDAMzswPpE-m2iLUPu4-v5-8Qena_2Ra_fVMb_ss2E7XYMd0AK-vo_lxAqA7eM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2499

{
  "id" : "aml_3VyjCgNUBCt9Xz1KfzQ1m5",
  "catalog" : "A0000001",
  "name" : "czTzZ42BpW",
  "number" : 1,
  "strain" : "rWSITnWnIa",
  "species" : "LVH8CJSwJQ",
  "sex" : "m",
  "dob" : "2025-10-30",
  "tail" : "eh7WmpOHpE",
  "ear" : "JIRnG1Bwxu",
  "tag" : "4nffysmUMz",
  "donor" : "Xf1eisX277",
  "tracking_date" : "2025-10-31",
  "disease_induction_date" : "2025-10-31",
  "terminated_at" : "2025-10-31",
  "terminated_by" : {
    "id" : "usr_kUNUk106KLgDsTW9tF40p",
    "name" : "3FHpCrduRl",
    "email" : "1dThTxdZ@benchling.com",
    "timezone" : "UTC"
  },
  "terminated_reason" : {
    "glossary_id" : "gly_55VcHy1jG9ylY0GuwM4ZLe",
    "title" : "Found dead",
    "comment" : "DWZ9RgT29U"
  },
  "disease_survivor" : false,
  "metadata" : {
    "animal-internal-id" : "ANIMAL-1234"
  },
  "study" : {
    "id" : "sdy_2Al9eutqY2Dse7t864P1Pl",
    "project_id" : "pjt_5DHtng2cyhc2ZUsEoEBI3K",
    "name" : "QTMnkCmKTq",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "Qy4aiiHbGE",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_5quRGGUlvN0Nn5N03dCjje",
      "name" : "wZcEDN1orX",
      "email" : "GGzpSuxr@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_2PR3hXlamDcYgk8bzCPWUi",
      "name" : "R517AajA74",
      "email" : "1mCMbilS@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:20.942015Z",
    "updated_at" : "2025-10-31T11:56:20.942015Z"
  },
  "study_group" : {
    "id" : "grp_3KKgntrIoj0ardpoNWp4cP",
    "study_id" : "sdy_2Al9eutqY2Dse7t864P1Pl",
    "name" : "aFaeWhNybK",
    "no" : 1436596373,
    "color" : "ujcsIIVRKq",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "GROUP-1234"
    },
    "created_at" : "2025-10-31T11:56:21.113540Z",
    "updated_at" : "2025-10-31T11:56:21.113540Z"
  },
  "cage" : {
    "id" : "cge_3L2eg3AdSbdXy2BEvFjSAp",
    "study_id" : "sdy_2Al9eutqY2Dse7t864P1Pl",
    "name" : "VTnKpNCBUE",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "created_at" : "2025-10-31T11:56:21.105734Z",
    "updated_at" : "2025-10-31T11:56:21.105734Z"
  },
  "created_at" : "2025-10-31T11:56:21.116755Z",
  "updated_at" : "2025-10-31T11:56:21.116755Z"
}

List all study animals

Returns a list of your study animals.

Path parameters ./api/public/v1/studies/{studyId}/animals

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of animals to return per page.

page

The page of animals to return.

name

Filter animals to return by name

cage_id

Filter animals to return by cage ID

catalog

Filter animals to return by catalog

sex

Filter animals to return by sex

metadata

Filter animals to return by metadata value

Request

GET /api/public/v1/studies/sdy_kjK2mfRrBGpYHGekVZJtK/animals HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI4NmFkZTA3MS1lN2M2LTRhOTQtODNmOC04ZWI5YzMyNGZkMTkiLCJqdGkiOiI2OTQ3YWM3Mi05YjZkLTRjNTQtYTdkMS04MDNkNTY0NmQxZjgiLCJpYXQiOjE3NjE5MTE3ODMsIm5iZiI6MTc2MTkxMTc4MywiZXhwIjoxNzYxOTk4MTgzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.YX8DAypCYpEuzaVgGwpeaiUOCJ5LDQKEetthcWEBAFyG0frYtv1NAb58cPtceLK8MDTw2-an4KyB2vBbOoF7zxT8khoAmdOIougUXuCCpU5tKc0zpLsIWO0XOmR_kWbTWrMjGIyCDH6ueBlu2qnjKxL-KyIjRG8KVnLI963naJQnABbzP5INy0c-ac_qxsxQ0IyPcR3jvXBVQ5KgvGV49RqmmDIpU-sRmHhvUk1ZwtJROJYeCohQex97bn64W-rZ3FlALDaF9E_JXN6cQ5Y7Y5DCEfm4nByerl4hJSSmYegmpgjTDHxYUYLLcjtI0EQQ93uNHCjMfKdarqUl0Kote6x50T3QTg_aH5Gy801-m8lDgY0-_JpyDRbPWP9nG1asPwVgWR9Cjkz0Cw5SkjWta0jsKEobVWhZ2XnKdrtWqGHfa2deoPGv2hZtEF-zbcGxADuSYubrhg-LmamFaRozPXHB0BDYbw2kmW7CY4gu9ZVyihxn_s_zxmPGl81S0FB8RCkazTARKG_8j08yBTK8G3OXh8FnmKl0EWh329FpCe-WfBJHJsfgOKpUTXdVsGX5ZSCU7ix7w0X9jlS3GiWB7XwVj4BnvarbLjhF_RC-18vIfU6N0VdIMhu2YkpsLSGlpWyTMrBbJwBOjNbmfWY_1YIiQzZF843-CYCSDgWCMrE
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3175

{
  "data" : [ {
    "id" : "aml_6xJOVOXlo45GeXJsHEclSn",
    "catalog" : "A0000001",
    "name" : "y8ivlURDk5",
    "number" : 1,
    "strain" : "ScwasrVtf6",
    "species" : "RVoSnLCUeI",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "136qyDmIAP",
    "ear" : "O378Uc7OZl",
    "tag" : "XLuUhqMkvJ",
    "donor" : "avM80zmQJ8",
    "tracking_date" : "2025-10-31",
    "disease_induction_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_7KSAzLnowGP0BG8zGrXGbP",
      "name" : "mAJxLnQCT7",
      "email" : "cRrn6iwC@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_32LqC917l1yX45WNGqZNml",
      "title" : "Found dead",
      "comment" : "tmTpYwV9Mx"
    },
    "disease_survivor" : false,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "study" : {
      "id" : "sdy_kjK2mfRrBGpYHGekVZJtK",
      "project_id" : "pjt_4VnBwucDcNxHHGXCxGKtDF",
      "name" : "Mk5SKxzDWn",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "EsAih2W4Eq",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2sbm2M1m3AYXorNbJc2PfV",
        "name" : "XYJyf7mvmA",
        "email" : "G8cC2gG1@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_56kzb3m0wk9qtChwQa8TGn",
        "name" : "myO5Qe56G3",
        "email" : "bqVLrmFf@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:23.028384Z",
      "updated_at" : "2025-10-31T11:56:23.028384Z"
    },
    "study_group" : {
      "id" : "grp_5135dhFGF2l0Tn3Qe2tzPn",
      "study_id" : "sdy_kjK2mfRrBGpYHGekVZJtK",
      "name" : "6r50WG2Dod",
      "no" : 1464668690,
      "color" : "IaKjCfLZCU",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:56:23.196798Z",
      "updated_at" : "2025-10-31T11:56:23.196798Z"
    },
    "cage" : {
      "id" : "cge_6I1lGuBq9wBZ70HIPKEQDI",
      "study_id" : "sdy_kjK2mfRrBGpYHGekVZJtK",
      "name" : "M6sIXZ5LQi",
      "catalog" : "C0000001",
      "metadata" : {
        "cage-internal-id" : "CAGE-1234"
      },
      "created_at" : "2025-10-31T11:56:23.188533Z",
      "updated_at" : "2025-10-31T11:56:23.188533Z"
    },
    "created_at" : "2025-10-31T11:56:23.200564Z",
    "updated_at" : "2025-10-31T11:56:23.200564Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_kjK2mfRrBGpYHGekVZJtK/animals?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_kjK2mfRrBGpYHGekVZJtK/animals?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_kjK2mfRrBGpYHGekVZJtK/animals",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Animal Dosage

This is an object representing a dose of compound administered to an animal. You can retrieve it to see the dosing method, stock, volume, concentration, date administered, user administered and the treatment group of the animal it was administered to by of the dosage.

Attributes

Path Type Description

id

String

The unique identifier of the dosage.

name

String

The name of the treatment type.

dosed_at

String

The created timestamp of the dosage.

comments

String

The comments associated with the dosage.

dose

Object

The dose concentration associated with the dosage.

dose_volume

Object

The dose volume associated with the dosage.

stock

Object

The stock concentration associated with the dosage.

volume

Object

The volume of the dosage.

study

Object

The study associated with the dosage.

animal

Object

The animal associated with the dosage.

measurement

Object

The measurement associated with the dosage.

user

Object

The user associated with the dosage.

treatment

Object

The treatment associated with the dosage.

weight_at_dosing

String

The optional weight that’s taken during a dosage.

created_at

String

The created timestamp of the dosage.

updated_at

String

The last updated timestamp of the dosage.

Retrieve a study animal dosage

Retrieves the details of an existing study animal dosage.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/dosages/{dosageId}

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

dosageId

The unique identifier of the dosage.

Request

GET /api/public/v1/studies/sdy_7bFGhr6VcQTY6CREGugFic/animals/aml_2KdtyJpzx51mwbZ8Y3hpdr/dosages/dsg_3Z9hJKuc509AUYk56qFMOe HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3MDBmNDkyNS1mNGUxLTRiMzktODY2My1mZTVhMDg3YzcwNzIiLCJqdGkiOiIzNDA0MTMyNi1jNDdiLTRhYjUtYjIyYy03ZjExMzFhNzZmYWUiLCJpYXQiOjE3NjE5MTE3ODksIm5iZiI6MTc2MTkxMTc4OSwiZXhwIjoxNzYxOTk4MTg5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.KXX7WwyXcPDjEIy2ba0x0cPDMM8YSnPuv5XLubeNwochNuv44Xe4rOQmSBfIdMeEeb3tzinJiCGle8kBCNsqypm6UKYVlOl0b3zn7RnvwZPSkesuButrGiCnF-F_r0ONckJrKkL9t_ERbg9qK4S3ulMEffkdIkZYfUwIUxrRnRvVJ6CpuIUXGX69G4BBjxAC63VUqPvFunZCtKi8DFYSZBel1JaiIxfQHawrCXGWpFYCNdyYSOLcIUYboMX9lUvh8r8o6nahldm_xdfSWyFMTgb69fvUXgW7IdDbsjYggFWWLH9_OwU2WJdz_b7Fwdv53_gOzW5Gt_Vm7GRM9vsL2kKb5UnSch6uxzm2N6m-SwY5cfylAKdMV1xnkbrLcWoBMYfOQP4nViv9yXIvbaT0XNSZAgZJ3xz7mTdxkccS1tonIP71RpouUNR-nAXQb5Iw4lAvyXm9RvHSjD6rEqkAATwBkWowtS90CrbmDfUmNWqkcA9xa4FCeN42WjZcqsbANHAxMp0KuuU24CQ7KeMWmNw8rpbpJbkQLqxt6TzUjxS4k6fbbtoccH3eTPl7Pi7PXLPZifKgx2R_T30QnxUDTEEOJ-eeyNwI4Ha3kqOF2xl6UgQhpVeHc2NYxpSTPzObqjc2SPBvNzKgWAf4T5OqDwjLWb3ZCKSyO1eDItIOUXg
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 4540

{
  "id" : "dsg_3Z9hJKuc509AUYk56qFMOe",
  "name" : "Example dosage",
  "dosed_at" : "2025-10-31T11:56:29.924307Z",
  "comments" : "7tahpewpQ0",
  "weight_at_dosing" : null,
  "dose" : {
    "unit" : "mg/kg",
    "value" : "6.10",
    "display_unit" : "mg/kg",
    "display_value" : "6.10"
  },
  "dose_volume" : {
    "unit" : "ml/kg",
    "value" : "13.84",
    "display_unit" : "ml/kg",
    "display_value" : "13.84"
  },
  "stock" : {
    "unit" : "mg/ml",
    "value" : "23.70",
    "display_unit" : "mg/ml",
    "display_value" : "23.70"
  },
  "volume" : {
    "unit" : "µL",
    "value" : "39.19",
    "display_unit" : "µL",
    "display_value" : "39.19"
  },
  "study" : {
    "id" : "sdy_7bFGhr6VcQTY6CREGugFic",
    "project_id" : "pjt_3ug0rYqyf4kDOQbc1xPDXE",
    "name" : "BsNTeatRZe",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "sXQGqILDWo",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_2MuoPQ6DVyDtg7rXxd5Z9X",
      "name" : "RPXj1sh9dd",
      "email" : "DkDf0x5u@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3dipaesSePkg7wtZzZdcU8",
      "name" : "A1UeiibZV3",
      "email" : "nILi5h2M@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:29.669254Z",
    "updated_at" : "2025-10-31T11:56:29.669254Z"
  },
  "animal" : {
    "id" : "aml_2KdtyJpzx51mwbZ8Y3hpdr",
    "study_id" : "sdy_7bFGhr6VcQTY6CREGugFic",
    "study_group_id" : "grp_45u2KgA2raPKnhxP1XkCPD",
    "cage_id" : "cge_5Q4gdXc8mTZ0MI1wk38kJ3",
    "catalog" : "A0000001",
    "name" : "TbBjMU5HVA",
    "number" : 1,
    "strain" : "fQpKh2yQa2",
    "species" : "HKUkKVW7md",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "aLV0ueh9ZZ",
    "ear" : "KFjU07kW3G",
    "tag" : "IG8CbIk2TE",
    "donor" : "Zub9HjqqGZ",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_6rmXtr5e2YhcUm6eZooyFq",
      "name" : "MQsCYfqL8V",
      "email" : "jMZVgKrK@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_7WRIBAYuA0EP7MlAod2lUk",
      "title" : "Found dead",
      "comment" : "XVg1Pggsyt"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:29.833119Z",
    "updated_at" : "2025-10-31T11:56:29.833119Z",
    "disease_induction_date" : "2025-10-31"
  },
  "measurement" : {
    "id" : "mst_4qg3vAc8sV5bwzSjNO2Q3r",
    "study_id" : "sdy_7bFGhr6VcQTY6CREGugFic",
    "animal_id" : "aml_2KdtyJpzx51mwbZ8Y3hpdr",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_2C5P2pUtqW4AP1rm2ir4zG",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "created_at" : "2025-10-31T11:56:29.910852Z",
    "updated_at" : "2025-10-31T11:56:29.910852Z"
  },
  "user" : {
    "id" : "usr_4YWW2y8zMUry2uHYaUG6Rp",
    "name" : "odL0S Overwatch",
    "email" : "PlQZLLCY@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:29.652341Z",
    "updated_at" : "2025-10-31T11:56:29.652341Z"
  },
  "treatment" : {
    "id" : "tmt_4Ak3SgO2cEOl2B0qVkh2Cg",
    "study_id" : "sdy_7bFGhr6VcQTY6CREGugFic",
    "type" : "dose_volume",
    "name" : "rJG5Xvkuq4",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "created_at" : "2025-10-31T11:56:29.916762Z",
    "updated_at" : "2025-10-31T11:56:29.916762Z",
    "external_entity_id" : "hCDjqBouXr"
  },
  "created_at" : "2025-10-31T11:56:29.924317Z",
  "updated_at" : "2025-10-31T11:56:29.924317Z"
}

List all study animal dosages

Returns a list of your study animal dosages.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/dosages

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of dosages to return per page.

page

The page of dosages to return.

Request

GET /api/public/v1/studies/sdy_5YCfxiF5tZooBlJYyRwJnn/animals/aml_6Yj5w7IifWvJGqByrhWinR/dosages HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwYmEzOTJkNC00OTAwLTQzYTktYWI2NC02MTJhNGQwMDBjNzEiLCJqdGkiOiJkNjJiMDYyMi03ZTJhLTQxYzMtYjYzMy05ZWQxZjMwYjY5MmIiLCJpYXQiOjE3NjE5MTE3OTEsIm5iZiI6MTc2MTkxMTc5MSwiZXhwIjoxNzYxOTk4MTkxLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.jVuUkyOEHYpfvAA7qys_Egq_qRFlObHuZwHv9dEg7iurp9WUx4czyjbTOVnNrZC2iWlMF8oT4KBfUIzzqzSZzYjboMuMGGme2SbC1xavoKg6QkfAcxc0Hs835wkk3qVadBAnO9wLxl-4Uurf4HnE7kStPsgtem3LJN9wOfOWdfXGD9ImCrpCwPaCB0EJa8X6xZ40RB9pWJDLc4RbmAym4B8zFNMv6R2TWiTY8LGiABXFiHTxGejceC_RnfoVb03pE9FXw527TJgETPwT9_iZlfnR1Mz4LBACZIws6Q6NNw63PLuV5leVW0GQOvQk8F9g5PDbWfS1jwbHTvjVDTQv5rOzixwUdr8XRXAMlrMCiecK5r6lq4zQkubpFQoj6TJFHzEvtPGIgWO1Jtc2lrPPKPp1ce9ClFToFQsDBmTO1CANRLE3igZ9zuBkKb4Vmq4lyagLOvz7E-LE-kWRcAS4eIiqy-FblyHVtxl55YegdG7eBJSj3wVUo6f1p6I1CFuQqFfZQsaSEwkkdlN1NCLSDbCXkB4767fq8zEagWhITRTOyiUhruRd0oEpzsKc7wSoZeHezAvPu4MCsEPHf2F4hbgQpxYi0ySHVRRI-2E9yGBu_GSbuRnyP-0y8ge_QHNEiAjzeLsuSKWc5e1VjZaNXyxwC9cvv-8RIgxjH9OGY_M
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 5480

{
  "data" : [ {
    "id" : "dsg_4ipx464hX8zJsDY2mu84tO",
    "name" : "Example dosage",
    "dosed_at" : "2025-10-31T11:56:30.993865Z",
    "comments" : "xeAS0XNgGV",
    "weight_at_dosing" : null,
    "dose" : {
      "unit" : "mg/kg",
      "value" : "1.65",
      "display_unit" : "mg/kg",
      "display_value" : "1.65"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "19.48",
      "display_unit" : "ml/kg",
      "display_value" : "19.48"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "26.27",
      "display_unit" : "mg/ml",
      "display_value" : "26.27"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "38.70",
      "display_unit" : "µL",
      "display_value" : "38.70"
    },
    "study" : {
      "id" : "sdy_5YCfxiF5tZooBlJYyRwJnn",
      "project_id" : "pjt_6WPuiOuuEMHqM9udaFsdST",
      "name" : "1KTf22lXHI",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "lKqXscPK6C",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2XnDhXMrGQos5uzFqqjUbB",
        "name" : "eTOwQ8EngB",
        "email" : "mgNbVU6e@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_1GE6sXQuduAz78xVpa4rZ7",
        "name" : "zHE6vgzYaO",
        "email" : "GdjLDEZz@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:30.747766Z",
      "updated_at" : "2025-10-31T11:56:30.747766Z"
    },
    "animal" : {
      "id" : "aml_6Yj5w7IifWvJGqByrhWinR",
      "study_id" : "sdy_5YCfxiF5tZooBlJYyRwJnn",
      "study_group_id" : "grp_1as7EtQ8N9sUVeNVh7aXNH",
      "cage_id" : "cge_2NejDduVAAfWdbZSjMFde0",
      "catalog" : "A0000001",
      "name" : "b8ufWbyKSu",
      "number" : 1,
      "strain" : "JeMP6RwDtj",
      "species" : "DA4GLn3wqa",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "gk9Eyirdka",
      "ear" : "mBOhIUTcPl",
      "tag" : "Ji7OdhXnUO",
      "donor" : "PVp2SH5Mip",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_2rQmT3ieLofzYpQN75Xd1b",
        "name" : "bUnLVgfhCi",
        "email" : "q5MZj1km@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_51OKS2Zi9aQYy11Ke81H5o",
        "title" : "Found dead",
        "comment" : "QtMSxzQdnT"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:30.908720Z",
      "updated_at" : "2025-10-31T11:56:30.908720Z",
      "disease_induction_date" : "2025-10-31"
    },
    "measurement" : {
      "id" : "mst_5WzJInGuddm3hxJxiczLEy",
      "study_id" : "sdy_5YCfxiF5tZooBlJYyRwJnn",
      "animal_id" : "aml_6Yj5w7IifWvJGqByrhWinR",
      "measured_at" : "2025-10-31",
      "calculations" : [ {
        "id" : "vbl_7Cs4MaHEGQiOwE97B8Ikbs",
        "key" : "weight",
        "name" : "Weight",
        "unit" : "g",
        "excluded" : false,
        "value" : "55",
        "formula" : "weight",
        "variables" : [ ]
      } ],
      "created_at" : "2025-10-31T11:56:30.980573Z",
      "updated_at" : "2025-10-31T11:56:30.980573Z"
    },
    "user" : {
      "id" : "usr_7komGsybVOCP0CwtRG92EL",
      "name" : "Ip8Pd Overwatch",
      "email" : "JaQZNxJO@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:30.731482Z",
      "updated_at" : "2025-10-31T11:56:30.731482Z"
    },
    "treatment" : {
      "id" : "tmt_2X3ZJeOqIfO321QxrXDEOx",
      "study_id" : "sdy_5YCfxiF5tZooBlJYyRwJnn",
      "type" : "dose_volume",
      "name" : "kBX9psHbwh",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "created_at" : "2025-10-31T11:56:30.987275Z",
      "updated_at" : "2025-10-31T11:56:30.987275Z",
      "external_entity_id" : "EemiMlVvtp"
    },
    "created_at" : "2025-10-31T11:56:30.993879Z",
    "updated_at" : "2025-10-31T11:56:30.993879Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_5YCfxiF5tZooBlJYyRwJnn/animals/aml_6Yj5w7IifWvJGqByrhWinR/dosages?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_5YCfxiF5tZooBlJYyRwJnn/animals/aml_6Yj5w7IifWvJGqByrhWinR/dosages?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_5YCfxiF5tZooBlJYyRwJnn/animals/aml_6Yj5w7IifWvJGqByrhWinR/dosages",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Animal Measurement

This is an object representing a measurement that has been recorded from an animal on a day. Measurements are created in studies which have a preset, typically for observable data like tumour volume or blood glucose.

Attributes

Path Type Description

id

String

The unique identifier of the measurement.

measured_at

String

The measured at timestamp of the measurement.

calculations

Array

The calculations associated to the measurement.

study

Object

The study of the measurement.

animal

Object

The animal of the measurement.

user

Object

The user that recorded measurement.

created_at

String

The created timestamp of the measurement.

updated_at

String

The last updated timestamp of the measurement.

calculations[].variables

Array

The measurement calculation variables.

Retrieve a study animal measurement

Retrieves the details of an existing study animal measurement.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/measurements/{measurementId}

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

measurementId

The unique identifier of the measurement.

Request

GET /api/public/v1/studies/sdy_22yYOYuYzHmi5vfbCvoI7f/animals/aml_uxrGAVfxoqyj5VQ9S6fj/measurements/mst_4yzhXqjMObi91agdlI3Aqz HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJlNzRhOWM2Yi1mY2U3LTQ1OTItODIyZS0wYmZiNDEwMTdlN2MiLCJqdGkiOiI0OThmMWYyMS1hYzQyLTRhZDItYWEyZS1mZTk2NDA1ZTZlYmQiLCJpYXQiOjE3NjE5MTE3OTksIm5iZiI6MTc2MTkxMTc5OSwiZXhwIjoxNzYxOTk4MTk5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.gtOdP-V7zkne1LrHNhG-XYcMQpsj4Vjkx9x-elAJx2IC9uCsBGrwfvSEgsddc3skJo88bh42gf22a-0G0mN4rdJ54myjnoskofXWqH-qLmmITsw7ufLtFvPjX5Gutq3wKgDlDJ6uIJeT7pF1KDY0Gbu4P81plCen89y9iBKRFWKUIqS0NANM_pFzfyuwhidUosbyzv6b5VqEgkPXoWixvxYQmKgPAirIZmmoIndWI_5UYe7mhm4is9QFIxMoG-UvMyxIXvSzUYecVTNfBLX0ZpR_eIl9eKhOhjCKqYmzbpIrWpeXWrWdmNUi8jA3-VUKAlZE5E7loC2-ukHZW6F7-M2Ez3KGeVEJAU0-oa-32jghNcGSBBNeXw3KukS2irPZ3x4wsMA54gu470f4VvLkTDaJqlFrMp-kueIBtoziz82HPWpB9f8L6i0KGc47Hm5gwafgHd-y0Ea93pFXb5smhiUuDkU6z0h4PLuiCnS86lcA_DZIPJKRDvQzLCrfSUYIM1hqoftCt9RCu7z4V9jCiXVTDtZtJ3atebpQmBc6Wx7ZmJlAY1ugcwjPyhTOZOY9kXybejAsgB_UFjlNSws7ioIbeYdJILKaKsdQoszio44dIGWS4OCqjVSPmBD0I1nHK-2UCmAwO6LfGu8CuJwToHTllZziVP6woNpjOwucGI8
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3201

{
  "id" : "mst_4yzhXqjMObi91agdlI3Aqz",
  "measured_at" : "2025-10-31",
  "calculations" : [ {
    "id" : "vbl_3OoMnH24qUiBeBLvqjsJGq",
    "key" : "tumour_volume",
    "name" : "Tumour Volume",
    "unit" : "mm³",
    "excluded" : false,
    "value" : "75",
    "formula" : "(width * width * length) / 2",
    "variables" : [ {
      "id" : "vbl_72fdhSVOZHGUnahYr9hEIL",
      "key" : "width",
      "value" : "5",
      "unit" : "mm"
    }, {
      "id" : "vbl_5Rx8M9A7Cd9hBHrYmKGsO7",
      "key" : "length",
      "value" : "6",
      "unit" : "mm"
    } ]
  }, {
    "id" : "vbl_Z3DeipGUAuydB6aUp5O4U",
    "key" : "weight",
    "name" : "Weight",
    "unit" : "g",
    "excluded" : false,
    "value" : "55",
    "formula" : "weight",
    "variables" : [ ]
  } ],
  "study" : {
    "id" : "sdy_22yYOYuYzHmi5vfbCvoI7f",
    "project_id" : "pjt_6X2YRaAC8Yo5ru2frdCNzk",
    "name" : "BrGOAT3qXW",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "8D3NLBK5Uk",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_2txjTYkpWb6J0YfI2czHkq",
      "name" : "AcDui1OIbc",
      "email" : "D5OnwvJR@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_6sQVxyZUIgH2g8mLKh3sqV",
      "name" : "erPqqASMAx",
      "email" : "CNlF4LKs@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:39.261302Z",
    "updated_at" : "2025-10-31T11:56:39.261302Z"
  },
  "animal" : {
    "id" : "aml_uxrGAVfxoqyj5VQ9S6fj",
    "study_id" : "sdy_22yYOYuYzHmi5vfbCvoI7f",
    "study_group_id" : "grp_67fyB9sOLr7ppvddk6ZQOQ",
    "cage_id" : "cge_7hSKvHOhAfyq8uJWLUa7Wh",
    "catalog" : "A0000001",
    "name" : "rCkLw3kNnn",
    "number" : 1,
    "strain" : "woChvMTDzw",
    "species" : "qzZo03TrD8",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "yL7P5rqLlY",
    "ear" : "fNkbvUeSlm",
    "tag" : "F4kqMqUF4y",
    "donor" : "xMYOH943jl",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_3NIj7MBWL4bnJMuzBzLZr3",
      "name" : "ADJuHOxFjq",
      "email" : "JGuZHReM@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_1zdV1diQaOKntI4oXAoHaq",
      "title" : "Found dead",
      "comment" : "eVYUOs7EtN"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:39.423330Z",
    "updated_at" : "2025-10-31T11:56:39.423330Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_22hKWOrHlC4lt1gLBAYGpx",
    "name" : "bThcz Overwatch",
    "email" : "7bQWLE4K@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:39.249260Z",
    "updated_at" : "2025-10-31T11:56:39.249260Z"
  },
  "created_at" : "2025-10-31T11:56:39.501616Z",
  "updated_at" : "2025-10-31T11:56:39.501616Z"
}

List all study animal measurements

Returns a list of your study animal measurements.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/measurements

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of measurements to return per page.

page

The page of measurements to return.

measured_at

Filter measurements to return by date (yyyy-mm-dd).

Request

GET /api/public/v1/studies/sdy_5HsIiaYAYcJIfL7DAcjl3t/animals/aml_4o01GRWBKHdGtqEv7Imdcg/measurements HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkZjExZDI1MC0xN2M2LTQwMTItYmJmOS0yNWE4YzQzYmMyNWMiLCJqdGkiOiI0YWQ2ZmVjYi04MGQyLTRiYmEtYTQzOS1kYTI5MGU4NzIzNTkiLCJpYXQiOjE3NjE5MTE3OTcsIm5iZiI6MTc2MTkxMTc5NywiZXhwIjoxNzYxOTk4MTk3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.bfFgSZRlw33nJMJewJs0rhfR60NiendMnA797FEfpwQ6fTruX2MLBSFBeV7ja0sxqWlKR5K_zvTxxaVziUOFAYiDfsKLetabh6v_Tq_iSNy7pjYJ949V5R5MGzNvVE_wZx4a3fSBcG9owZ80oA-2SweFAUEJCXt8fZhaKlT561xI6ZrakxNX3UKGGGcucACv1bymR9XdbF6ongX6N8xRp9bBZv_EVS1anwMbVa1FRrwfEGtVAAw-KCAh6msuGaL6r1WUkoB-dwGegt2WHJduJpM_cT48ZSnkF8_NZ-1v7xWF5tWhxDRc_u2tN-itNGsgXURshM9_nowAKW3cMwn66ovinH0ot4jDlFnW0yqkognA59voIMy2XKrsHL7zVSRzT54nryrYXSo2JaTjuG3zm1lD_C7wyNlZzT3ZjESxYy52L24k2tikKk60B-LOVmXbL30Zqu7OerzboMY4hlXHOY8EpTtvPQrxqG7aqGQvkro58W2tOpd4mY8RQvChrv5KttimY8GhAE5_8LV2h9YxUhxgIeVec0k9r89wVHWECNQVs3HiAfSSgQF9grXrvhJRPHv7rWRsQ7zrGEIY1Zdo1Q5elsxSZJ278T_-J5JIt7o8nlKowSAnYDvLUSwhTWsOiceXC5qIYJSS6tedHpKFoTxSnX7pmCOrq0WJQ_1ETrM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 7485

{
  "data" : [ {
    "id" : "mst_6BFqQzRyySQGbJakPYAtLt",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_7UwCEtWrCjXv1nCfUCjeVv",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "75",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_9qGl6f64U7DS44nM7G9ic",
        "key" : "width",
        "value" : "5",
        "unit" : "mm"
      }, {
        "id" : "vbl_2G78G5NPmuawPTa7Pfhcp3",
        "key" : "length",
        "value" : "6",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_16fptOGz70fQmADahbdk3G",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_5HsIiaYAYcJIfL7DAcjl3t",
      "project_id" : "pjt_7I6SG0FotB09VOgML6RnYD",
      "name" : "1wP9T0h1wM",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "PrEBDuORYz",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2LcyOZKkMYctaa8AyYmq7W",
        "name" : "APMIkLFeW2",
        "email" : "ueV6DUg6@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_7lIL9pIkqKw1clXsf9RwcC",
        "name" : "pOMhyuil93",
        "email" : "8apNVvX1@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:36.987539Z",
      "updated_at" : "2025-10-31T11:56:36.987539Z"
    },
    "animal" : {
      "id" : "aml_4o01GRWBKHdGtqEv7Imdcg",
      "study_id" : "sdy_5HsIiaYAYcJIfL7DAcjl3t",
      "study_group_id" : "grp_53q7WxAZuCMU0Y3A9MbjV7",
      "cage_id" : "cge_5Zhnn3FzfSeVwu21DkiJWE",
      "catalog" : "A0000001",
      "name" : "NPFopqtiCZ",
      "number" : 1,
      "strain" : "KarHRCg7Az",
      "species" : "uVfmD1umEY",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "4TSGchywvJ",
      "ear" : "ijrycovyJa",
      "tag" : "sEw3MjIAdl",
      "donor" : "8Co4R22UmO",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_6646dD0m30zdDCsHS4Pe80",
        "name" : "KPMPbQiz19",
        "email" : "giOkpSM7@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_JakHlpYggq6bZL0lqjcD1",
        "title" : "Found dead",
        "comment" : "gc9RmJ3bDF"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:37.150417Z",
      "updated_at" : "2025-10-31T11:56:37.150417Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3ZKpGNg7GHzH75iLvf4z4n",
      "name" : "gdkBh Overwatch",
      "email" : "00b7iP97@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:36.969889Z",
      "updated_at" : "2025-10-31T11:56:36.969889Z"
    },
    "created_at" : "2025-10-31T11:56:37.223881Z",
    "updated_at" : "2025-10-31T11:56:37.223881Z"
  }, {
    "id" : "mst_1zbjdiqatgMn1wJFekaSFi",
    "measured_at" : "2025-10-30",
    "calculations" : [ {
      "id" : "vbl_5iTuRhXtVPL6IADngscAdo",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "196",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_3BJjGEArPkz1uZ0tTqFPna",
        "key" : "width",
        "value" : "7",
        "unit" : "mm"
      }, {
        "id" : "vbl_5wD93FKQNgMZaZal9ZjVBr",
        "key" : "length",
        "value" : "8",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_3A7j8tLfTyNJmaBNyTpO7c",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "56",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_5HsIiaYAYcJIfL7DAcjl3t",
      "project_id" : "pjt_7I6SG0FotB09VOgML6RnYD",
      "name" : "1wP9T0h1wM",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "PrEBDuORYz",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2LcyOZKkMYctaa8AyYmq7W",
        "name" : "APMIkLFeW2",
        "email" : "ueV6DUg6@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_7lIL9pIkqKw1clXsf9RwcC",
        "name" : "pOMhyuil93",
        "email" : "8apNVvX1@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:36.987539Z",
      "updated_at" : "2025-10-31T11:56:36.987539Z"
    },
    "animal" : {
      "id" : "aml_4o01GRWBKHdGtqEv7Imdcg",
      "study_id" : "sdy_5HsIiaYAYcJIfL7DAcjl3t",
      "study_group_id" : "grp_53q7WxAZuCMU0Y3A9MbjV7",
      "cage_id" : "cge_5Zhnn3FzfSeVwu21DkiJWE",
      "catalog" : "A0000001",
      "name" : "NPFopqtiCZ",
      "number" : 1,
      "strain" : "KarHRCg7Az",
      "species" : "uVfmD1umEY",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "4TSGchywvJ",
      "ear" : "ijrycovyJa",
      "tag" : "sEw3MjIAdl",
      "donor" : "8Co4R22UmO",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_6646dD0m30zdDCsHS4Pe80",
        "name" : "KPMPbQiz19",
        "email" : "giOkpSM7@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_JakHlpYggq6bZL0lqjcD1",
        "title" : "Found dead",
        "comment" : "gc9RmJ3bDF"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:37.150417Z",
      "updated_at" : "2025-10-31T11:56:37.150417Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3ZKpGNg7GHzH75iLvf4z4n",
      "name" : "gdkBh Overwatch",
      "email" : "00b7iP97@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:36.969889Z",
      "updated_at" : "2025-10-31T11:56:36.969889Z"
    },
    "created_at" : "2025-10-31T11:56:37.229634Z",
    "updated_at" : "2025-10-31T11:56:37.229634Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_5HsIiaYAYcJIfL7DAcjl3t/animals/aml_4o01GRWBKHdGtqEv7Imdcg/measurements?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_5HsIiaYAYcJIfL7DAcjl3t/animals/aml_4o01GRWBKHdGtqEv7Imdcg/measurements?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_5HsIiaYAYcJIfL7DAcjl3t/animals/aml_4o01GRWBKHdGtqEv7Imdcg/measurements",
    "to" : 2,
    "total" : 2,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Animal Observation

Retrieves the details of an existing study animal observation.

Attributes

Path Type Description

id

String

The unique identifier of the observation.

glossary_id

String

The unique identifier of the glossary item.

title

String

The title of the glossary item.

text

String

Text related to the observation.

type

String

The type of observation recorded.

value

String

The value of the observation taken.

observed_at

String

The timestamp of when the observation occurred.

study

Object

The study of the measurement.

animal

Object

The animal of the measurement.

user

Object

The user that recorded measurement.

created_at

String

The created timestamp of the project.

updated_at

String

The last updated timestamp of the project.

Retrieve a study animal observation

Retrieves the details of an existing study animal observation.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/observations/{observationId}

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

observationId

The unique identifier of the observation.

Request

GET /api/public/v1/studies/sdy_3jUw2OewT1LkuTqcY9zaYR/animals/aml_IVe6OSXfm68it7nGoXkrX/observations/obs_6mKUBUDJmo3M65UwWuvCfz HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2MGJkNzQ3NC01M2YzLTQ4ZjMtYjhiZS1jMzI0ZTlkOTNiZmUiLCJqdGkiOiI1Y2U5OTZhNy04OTFhLTQxNzktOTE4My05MWQxODYyNzBmMzQiLCJpYXQiOjE3NjE5MTE4MDYsIm5iZiI6MTc2MTkxMTgwNiwiZXhwIjoxNzYxOTk4MjA2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.M211asis8uUg4MisFOnqDcFbR04IhfT63Uszub1fbdZIbuTTKCd-qvI7NteeMBq4lrmaawJCGU68VVb75pc3-9qCk1b7eiPi7trIiS8KBJ6wibAcf5jfEZHL_0X3-yWUA-Ct1XC242sNzPIT3btGlsTHAUm3iHTSk9r49QRE7Z75xIokK2tMaZbOxcHYUtPr1jB3QeFUGVIkFXqR6mwX_6YrzolJkIZCAT4iVmZBJCMzp--weqh1UYj97mBCYsluSZJnQUmj-yAfVAvf3GTLEV7rHBwxgSu7R6-NtITp8kJyz_zA-hHx6VFTm153bpz8IWiOfLmJzbZgXS_Ew9fNA96k-g9EAhB6rNIdM7ZuwDyIdisLJwE1NX3XVqgZqfKo97SRVu-hpz_640qNqggtlBw7otmIB3dj97tfFc8CmfYAhdVv_82if_JLrkYDZHBvMjvZ95p3sRczFuD_LQZRdSZpcHHaW6eHSEcEdb4CN-z1um8CyRUUyQTJU4Q4BnQ21nwe6jk_DvuPkFVbZoT-j6pzGJdI-I6M9ROqkwAXkXk8YS3LVv_fvI-EwpfzkNokSAUVslazsG4qhQnHEpixBKdewvskgpq1Gn7uoovw8OHYRB5NHeaRS51pJZzrhxxIwgbYqi5ycE_g6gllPjh0QWOtEwO0FIf7qyk_SvxZeTM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2674

{
  "id" : "obs_6mKUBUDJmo3M65UwWuvCfz",
  "glossary_id" : "gly_3Q3lB4Z8o4K5LVF8fKukgJ",
  "title" : "Observation Glossary",
  "text" : "Example text",
  "type" : "severity",
  "value" : "Severe",
  "observed_at" : "2025-10-31T11:56:46.456184Z",
  "study" : {
    "id" : "sdy_3jUw2OewT1LkuTqcY9zaYR",
    "project_id" : "pjt_39w2ELHmGl0YH4fkUcYFjJ",
    "name" : "zLMy3HEoOj",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "Vra6Qvq3En",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_4YfwpujZRViUuecYBNHatE",
      "name" : "JR5Q0YHwjG",
      "email" : "KrlhEbMt@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_P916tb983tVNPf66xj0ox",
      "name" : "zDYAbtXGaS",
      "email" : "Ru8qyabi@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:46.231160Z",
    "updated_at" : "2025-10-31T11:56:46.231160Z"
  },
  "animal" : {
    "id" : "aml_IVe6OSXfm68it7nGoXkrX",
    "study_id" : "sdy_3jUw2OewT1LkuTqcY9zaYR",
    "study_group_id" : "grp_EKYKMgJhJDJgTDNBYXcsQ",
    "cage_id" : "cge_5Jlq0VdVSsjnUWD6DLTFUu",
    "catalog" : "A0000001",
    "name" : "BdSFmZPF7u",
    "number" : 1,
    "strain" : "iRLKOMM516",
    "species" : "getqTsgaE3",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "8oJiZIHvqW",
    "ear" : "BAnSpKdUmJ",
    "tag" : "EyJQFdWiSm",
    "donor" : "rh88P2x2TO",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_77ve9GuCAOl659SfbNwE7o",
      "name" : "s9TpWKfAW8",
      "email" : "649ySytS@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_64yRxF304T8P5VHysMVaCo",
      "title" : "Found dead",
      "comment" : "pCvMSpRW9J"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:46.384353Z",
    "updated_at" : "2025-10-31T11:56:46.384353Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_4n0HX3qHGI6E8xwrKsbKhS",
    "name" : "fKdeo Overwatch",
    "email" : "nDXSPsKE@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:46.216254Z",
    "updated_at" : "2025-10-31T11:56:46.216254Z"
  },
  "created_at" : "2025-10-31T11:56:46.456194Z",
  "updated_at" : "2025-10-31T11:56:46.456194Z"
}

List all study animal observations

Returns a list of your study animal observations.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/observations

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of observations to return per page.

page

The page of observations to return.

Request

GET /api/public/v1/studies/sdy_40n2zpbE5DxWpmzQYGWyyC/animals/aml_3BzQIsAh9fEHybIgIYM6vy/observations HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJjODVjZTU1Ni0zODBkLTRlM2ItYjZmZi03Yjk1NmVmYmExYTAiLCJqdGkiOiIxYWJhYTEyYS0yOWJmLTQ2MmQtODQzOS04ZGU2ZDFhYzRjNmYiLCJpYXQiOjE3NjE5MTE4MDcsIm5iZiI6MTc2MTkxMTgwNywiZXhwIjoxNzYxOTk4MjA3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.bTz3m-VV7-9qASy5ERa8i1qPWKrMLp8WPl3w_mX62PS8gilDDmRajO95BlCS1obBkPGwCAXVKd29eRJxIxTOQhCp_IYwMD_xjsM8OFGop7sMpWHV59G0sFnrbZ7dLXZD2gXwRKVVh5Z3Pt5SC88PPfaUkDdhK8oOj_68Siq6RRWYDgKgbHlhzFVd51al6DkSpZeFWM1AfRHHrVvP4fQ29vVlXtEs_sj9D8tmBy3LymF8xDFLh2t21V5Qs-7YsS0jVWhRNCUwwlry07XGGiSPF2IvPv-7It9YVEakfKSjl1YmKpjk8nN2OxaYDLPyIT2u_sj9lfRxWMJ5QFJilufiyKr_qZkFh4JPYfAVJoTjAUy3RwDMsk1l5s_n9rDoLcHsZlk0Nfz2FoTyB9fFG4JEmUdCPngBdOfTkLYPevXSza36kXXMTkMGQQK8lxRjHcAwjTaFgXgEPqPVi7fU52AMY38BzxdlE99c055eBaefEI59Ex_QrCSDpSI0_KFQJ2r1vifTX3W1Xn-e95vZ3s-MjJXwQvv4jPpfA9uXhZzf6LZMxJAB2sxL_8DOWWWN0w0NS4VtVePLF0ufCR7Xg9P-qQk4bpNc8djWgJVBSduzcN7tzKVUou_LHpfxbJx8ICno8cV9H13CpxvaxWeqcdWm-rWgXGGq5sEBNqlmdGKugnQ
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3479

{
  "data" : [ {
    "id" : "obs_FpuE5EpiA23FRiTdDiclk",
    "glossary_id" : "gly_6ziv4XPxn6rVjNXmWAgIrh",
    "title" : "Observation Glossary",
    "text" : "Example text",
    "type" : "severity",
    "value" : "Severe",
    "observed_at" : "2025-10-31T11:56:47.160392Z",
    "study" : {
      "id" : "sdy_40n2zpbE5DxWpmzQYGWyyC",
      "project_id" : "pjt_6EJcpdCjJJmjezUDS2VYz6",
      "name" : "LlvCtIYQOK",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "g9ObD7vGQt",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2asREumx5zxgGN8Qht7JE7",
        "name" : "8IYiQP866T",
        "email" : "2QBPDYbo@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2Xa70lHuZ8Vv26gUTJSltz",
        "name" : "sARx6DR93e",
        "email" : "OuDSmHSG@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:46.931437Z",
      "updated_at" : "2025-10-31T11:56:46.931437Z"
    },
    "animal" : {
      "id" : "aml_3BzQIsAh9fEHybIgIYM6vy",
      "study_id" : "sdy_40n2zpbE5DxWpmzQYGWyyC",
      "study_group_id" : "grp_7BMRSLBMHm4U5lkRRHAQA4",
      "cage_id" : "cge_5PJ11353T9Zzsm1f8LXzeY",
      "catalog" : "A0000001",
      "name" : "14rYhONnzO",
      "number" : 1,
      "strain" : "qxMHuRxCOR",
      "species" : "NOSodG5XzK",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "5Y6tWQpAcj",
      "ear" : "vMdtnbyBWN",
      "tag" : "cplwGUnSYJ",
      "donor" : "Xq0kSFyF4F",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_1gsQgRG5CuXZsbWuJIWQ0p",
        "name" : "eWSs9c7BWc",
        "email" : "7BBYBrRp@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_1LqF3YuehaOGyybMd4W6NK",
        "title" : "Found dead",
        "comment" : "pCvY9vVe2j"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:47.089333Z",
      "updated_at" : "2025-10-31T11:56:47.089333Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_6knFVkXjLdKqxd0D10bxH1",
      "name" : "5xSeT Overwatch",
      "email" : "V5bCBGBD@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:46.918260Z",
      "updated_at" : "2025-10-31T11:56:46.918260Z"
    },
    "created_at" : "2025-10-31T11:56:47.160405Z",
    "updated_at" : "2025-10-31T11:56:47.160405Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_40n2zpbE5DxWpmzQYGWyyC/animals/aml_3BzQIsAh9fEHybIgIYM6vy/observations?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_40n2zpbE5DxWpmzQYGWyyC/animals/aml_3BzQIsAh9fEHybIgIYM6vy/observations?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_40n2zpbE5DxWpmzQYGWyyC/animals/aml_3BzQIsAh9fEHybIgIYM6vy/observations",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Animal Sample

This is an object representing a sample such as blood or tissue collected from an animal in your facility. You can retrieve it to see the sample identifier, type, status (collected, planned, cancelled), timepoint, details like volume or mass and any metadata assigned.

Retrieve a study animal sample

Retrieves the details of an existing study animal sample.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/samples/{sampleId}

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

sampleId

The unique identifier of the sample.

Request

GET /api/public/v1/studies/sdy_6rVqyhipodXWVCW5tENx64/animals/aml_70ceySS5AI3EQoKnONKixb/samples/spl_2DifrNjtHQYRRWaISEYEIl HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2YjBlNDI4Ni0zZGRhLTRlYmUtYmVlMC0wNDk4ODE5YTUxYWEiLCJqdGkiOiIwOWJkZWUwZi1lNjhmLTRlY2QtYjJlNC0xYzg3YzVhMDRmOTkiLCJpYXQiOjE3NjE5MTE4MTYsIm5iZiI6MTc2MTkxMTgxNiwiZXhwIjoxNzYxOTk4MjE2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Do1ry0BKqjy741cLfogktoyH7YwG_d08_p6OSbRoc_xjNilpZfG64ja9BxaHeXugF_6lV1sLbv7yDtNrr-P7uXQvrHQ5d2P6krJeSPsg5jn5FEOFQBc0L88yBei81qA9cSJqkYOtfD-0Bb2sFPfFg0JKD-XuhrlilCawf1WTOFtLBYHmm-CPIE4M9Z9jKnFYj0RIV2jT_IWQQaH2rE9bDMFBbhiT8Fv2AcNwLU4cD35EuZRx3fXnLGAnHs4BG30PXGUpWh-f3KaiS3tcHamsRUvrPU0nAkbVehW9TrPWZIFE5n3ztbnBpVa9d1otOB_KerPVROpn6bGeGnqmANpWt2XI2zrtErbvHahXrvitGa3s33DN5TK1PqzMDt2pTpNmVkEBsC23i-UE_w0Tw_VQAkx0_x6z8CHcgcvXOzBA8b8RZz6pyj51ZsTBB544FPFEbSEQIusuxNmGDQAoCymIzCitF1h2iAxdXOHNrPZCMjWUpeAuWfa76WUUpI0chJfRHuAkLO4Gvg_ReWnf3R7IoEaB2hBPVTr9xh6qd3DuF3CXJPeRIT5ACbEjfPMQAgZnzDYPPVcE0UYFECkDaydQP0Tf90wr6iH8CuN80Bx9egtWoYjNZ8IRYd_ulln9LVUG0ikfp5BxvuxGterxNVHot2sey0zL2hT7p5bzRj_ma6s
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2824

{
  "id" : "spl_2DifrNjtHQYRRWaISEYEIl",
  "sample_id" : "S1124736432",
  "type" : "Blood",
  "label" : "BLOOD",
  "status" : "collected",
  "timepoint" : "PT15M",
  "collected_at" : "2025-10-31T13:56:56.537976Z",
  "details" : [ {
    "key" : "volume",
    "unit" : "ml",
    "value" : "5"
  } ],
  "comments" : "A blood sample",
  "metadata" : {
    "sample-internal-id-1567796434" : "SMPL-1234"
  },
  "study" : {
    "id" : "sdy_6rVqyhipodXWVCW5tENx64",
    "project_id" : "pjt_5CAEZo5knPBvlyjubbq19I",
    "name" : "k4M1aLj1UG",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "bSUUat49tT",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_21HTMJhknHmDnhLyEkWpXC",
      "name" : "B1pnqy1MBz",
      "email" : "VolsdyiO@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_1TBuWhKdSymRcKPUGvIl0H",
      "name" : "8tEW4LS3ba",
      "email" : "uFnhuWWS@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:56.237703Z",
    "updated_at" : "2025-10-31T11:56:56.237703Z"
  },
  "animal" : {
    "id" : "aml_70ceySS5AI3EQoKnONKixb",
    "study_id" : "sdy_6rVqyhipodXWVCW5tENx64",
    "study_group_id" : "grp_4WEkzfZHhg6eU4RgQUwN05",
    "cage_id" : "cge_7O4BVzWoYXQmft53qI5wYg",
    "catalog" : "A0000001",
    "name" : "TLNPKMUmlU",
    "number" : 1,
    "strain" : "N2D37nnXPe",
    "species" : "KznJCOzAAf",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "oRGGB9fQaY",
    "ear" : "esUFs0IgFc",
    "tag" : "CnTEDMJu5X",
    "donor" : "6fFCzbr62M",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_2jeLTUoF7QQXLdtGLhzOGl",
      "name" : "9Zs16qqySZ",
      "email" : "01RXst7V@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_4ZAQOoVpaLiLBTaLdUZCoM",
      "title" : "Found dead",
      "comment" : "UEELF4u8OZ"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:56.398371Z",
    "updated_at" : "2025-10-31T11:56:56.398371Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_1zYuajcLLXG7MLzgGCQogn",
    "name" : "Ma9LEc96Lw",
    "email" : "zxKDVryb@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "K2mvHbXttb" : "5F7GlVa7xt"
    },
    "created_at" : "2025-10-31T11:56:56.529189Z",
    "updated_at" : "2025-10-31T11:56:56.529189Z"
  },
  "created_at" : "2025-10-31T11:56:56.538018Z",
  "updated_at" : "2025-10-31T11:56:56.538018Z"
}

List all study animal samples

Returns a list of your study animal samples.

Path parameters ./api/public/v1/studies/{studyId}/animals/{animalId}/samples

Parameter Description

studyId

The unique identifier of the study.

animalId

The unique identifier of the animal.

Query parameters

Parameter Description

perPage

The number of samples to return per page.

page

The page of samples to return.

sort

Sort samples based on an attribute (animal, cage, date, group sample, study or type).

order

The order in which the samples will be sorted (asc or desc).

metadata

Filter samples to return by metadata value

type

Filter samples to return based on sample type.

Request

GET /api/public/v1/studies/sdy_2x5A8P2j9dDPbUZ8udFcsT/animals/aml_5qiQxRbvS6LVuNxJKymlGH/samples HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhNzJlNzU1NC04NDczLTRlODMtODdlMS1iMTVlMmFiNTA4ZTQiLCJqdGkiOiI0ZmUyZTQ1MS02MTk4LTQ5MTUtOTU3OS00NDNiNjg1OWNkZWIiLCJpYXQiOjE3NjE5MTE4MTgsIm5iZiI6MTc2MTkxMTgxOCwiZXhwIjoxNzYxOTk4MjE4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.FhWATwa8Ad_ORXMdjRUdN0yfhSaSL_O5KkxQjRvxIRM354goLyvv7Ba4K3uRIUG1iXb9Vx_lFOgLIc_kSrYrOfB2stoDlEFF6MztMYIiZYqBFyvOvVtRMxfHub_Ktn7ggTsKjqaLz_dNFWFlCLotb_slMdz5mRXpoFH5yPOaghU3XY7scpbXkWX0tp-c9PnUWNVJJOIXeNnayA0Fx12jx7bbaujfJvL6yaBJrRMAf--NPwSXmvhf1Xh4KEryAxlwVPbtSrRgzB1XP6nILvjO-bNPmJE3R-xQWdDnh5YPg8pR3pwYuEgLnE564ggLHcsXEYkh-LUfgnORTUS_2Jddlzpzs2eSBCLuEAx--YS-u2F9aM-TG9zS79328gy73kbHWRif45JXJXoXaXzmyX1MxO-5Wb0E3tNReV3Lnf5tGFlxFbyahB6tovK8Fx8zDCymp0nmVzOJuHYG-Tf8PHWv_xF6NpvFlAYPsFGYx0jsEKb4McoT8JhwCShAgiIN_A_ak7AwQ4r9oT6afTHgRuihVpHhN-131QHqcdZFcBmxDQHP3oonQmBU9Sgm2J7YxYcJlVcM-PvCiv24alRJfrioXel3167zsYxw4ahAUvEqJ686A-4sflvCzVcM-bxw8NZbG4fXxI5b_ZuUsVA8QAbU6sFv_bUszmbTumXs6IOSKbQ
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3628

{
  "data" : [ {
    "id" : "spl_5rnIrYfRRhD9XHzE6GSVGM",
    "sample_id" : "S928941355",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:56:58.384601Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-1974825775" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_2x5A8P2j9dDPbUZ8udFcsT",
      "project_id" : "pjt_58jEDZ3s0xxFvV9eLbsnMJ",
      "name" : "BGoEoc64PP",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "pibdocdghL",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_7NNM3bB7gfPacw7lmIBH1C",
        "name" : "gGo5VXrlna",
        "email" : "4UqzUYg0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_1gaV3uWmbrYVjQiDxMkqz7",
        "name" : "WOBsp4XNDv",
        "email" : "r3aBCacA@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:58.091146Z",
      "updated_at" : "2025-10-31T11:56:58.091146Z"
    },
    "animal" : {
      "id" : "aml_5qiQxRbvS6LVuNxJKymlGH",
      "study_id" : "sdy_2x5A8P2j9dDPbUZ8udFcsT",
      "study_group_id" : "grp_6OswLMXTvgRfieqg130ep",
      "cage_id" : "cge_5WE8ltW6jAQSysTlx7Ex8O",
      "catalog" : "A0000001",
      "name" : "1jgJTlAAyS",
      "number" : 1,
      "strain" : "NgvuDcCEBI",
      "species" : "oD4EjiIRIm",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "kRlPci8Hfd",
      "ear" : "noBl17NsTk",
      "tag" : "R3F9YNRjKU",
      "donor" : "3qCuVlP8sz",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_3YA9n9MLasoeEPZfmrnPgh",
        "name" : "2PeyHdOKl8",
        "email" : "wm38xQjK@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_10Tv6pidk9OlXzzW31UiPx",
        "title" : "Found dead",
        "comment" : "hQ3mZCXtcu"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:58.244360Z",
      "updated_at" : "2025-10-31T11:56:58.244360Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3Rx0A3kWBSA3SOhaM8CXet",
      "name" : "si8lXFKPjd",
      "email" : "mKBheio3@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "yPY030GQew" : "SfgOblM6AO"
      },
      "created_at" : "2025-10-31T11:56:58.375792Z",
      "updated_at" : "2025-10-31T11:56:58.375792Z"
    },
    "created_at" : "2025-10-31T11:56:58.384643Z",
    "updated_at" : "2025-10-31T11:56:58.384643Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_2x5A8P2j9dDPbUZ8udFcsT/animals/aml_5qiQxRbvS6LVuNxJKymlGH/samples?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_2x5A8P2j9dDPbUZ8udFcsT/animals/aml_5qiQxRbvS6LVuNxJKymlGH/samples?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_2x5A8P2j9dDPbUZ8udFcsT/animals/aml_5qiQxRbvS6LVuNxJKymlGH/samples",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Group

Study group blurb.

Attributes

Path Type Description

id

String

The unique identifier of the study group.

name

String

The name of the study group.

no

Number

The sequence number of the study group.

color

String

The color of the study group.

max_animals

Number

The maximum number of animals allowed in the study group.

control

Boolean

Indicates this group is a control.

metadata

Object

The metadata associated to the study group.

study

Object

The study of the study group.

created_at

String

The created timestamp of the study group.

updated_at

String

The last updated timestamp of the study group.

Retrieve a study group

Retrieves the details of an existing study group. You need only supply the unique user identifier that was returned upon study group creation.

Path parameters ./api/public/v1/studies/{studyId}/groups/{studyGroupId}

Parameter Description

studyId

The unique identifier of the study.

studyGroupId

The unique identifier of the study group.

Request

GET /api/public/v1/studies/sdy_2ipjFVBSEcDhRcEDebuVmV/groups/grp_2OxR5ul1NROZR0A8JSyiV1 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJkZWFjY2JmNS00ZDRmLTQ1MjAtODZkNi05OTM1NzBmOThhOGQiLCJqdGkiOiJhODY2OWYzMC1iOTBlLTQ5NDItYTUwNC1iMWVhODdmNjgyZGYiLCJpYXQiOjE3NjE5MTE4MjYsIm5iZiI6MTc2MTkxMTgyNiwiZXhwIjoxNzYxOTk4MjI2LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.nPKGR4WNk7OF0m_h9q5LMTOXQQEm9aVjoaY5l6Zoyw4pnUF_T328EYYNxPsDYY0-SNe1_dPGE8xD4skGwGgEXtU6z9B9YtcyclsTsofnbAmGjtao-3SXOu9jjIOrQafasogayUseskN7ia-wtfy_Ou72hjX43VCWpdke0885UJ6LJG2pcLdyvDsNQd_-WRTiKDF6JDP2owNXhJI_qvv6UAO_byPJ3PpXmqLQhqyzidfgBsBvyxp3dcKz_e2-3yogkH6O95I9_y4_YW_pMNFYeUDrxqvZ3JghoMzdtW2JCf-TeXRHhKE_dERJAFPGVx6swYrI234z2fQ6T6QVsTnY7Jra3Uh8o0ozTC7_J1D1z5xsBom8aprx8wTBinSvVQNdSAI8vVs3gevUaf0hCngMfMuDZW_XvooN_F4cw_foLu_IloEzre2942o0N3t422pvjbeI-AM-4ULilhHUseQv62RD-BkmV9ZxbMkgSjcOgjMj4yoHWSgG6bAKl_aRWTSCNGHBUVSnDvJnXit9IghWFp0mJfrYbsXfrjNhzlC5KdMfAvOEE3XJy4rcpOpmMgKZrvoPyYd6c_9WPB54WE3FODE68XHWg_1yaUBPJk_92pfgXn87RHvZ1IOpBUaTUZ_sHWrMbsrrIkzNcwV8UGNg1aQYLH1M5wYRXhg0OlmDAWI
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1167

{
  "id" : "grp_2OxR5ul1NROZR0A8JSyiV1",
  "name" : "A",
  "no" : 1,
  "color" : "#34e8eb",
  "max_animals" : 10,
  "control" : false,
  "metadata" : {
    "study-group-internal-id" : "SYSGROUP-A1"
  },
  "study" : {
    "id" : "sdy_2ipjFVBSEcDhRcEDebuVmV",
    "project_id" : "pjt_2kNiniFfHwpqBGkrlkJgbb",
    "name" : "DAgiwfECvF",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "ox5gAZiCfr",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_3FxHK19Yi2P6bgGx4Sv5yG",
      "name" : "kKDqO4bw7u",
      "email" : "KkvDJakL@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_7SBtrRTEnIGIpeGY3FWEQV",
      "name" : "kNC9D1RkuB",
      "email" : "PCg2VMFQ@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:06.608504Z",
    "updated_at" : "2025-10-31T11:57:06.608504Z"
  },
  "created_at" : "2025-10-31T11:57:06.750703Z",
  "updated_at" : "2025-10-31T11:57:06.750703Z"
}

List all study groups

Returns a list of your study groups.

Query parameters

Parameter Description

perPage

The number of study groups to return per page.

page

The page of study groups to return.

metadata

Filter study groups to return by metadata value

treatment_id

Filter study groups to return if they have an associated treatment

Request

GET /api/public/v1/studies/sdy_7CXZCzubRDAE5MgPAbAvvA/groups HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI1Y2ZmOWY1ZS0wZGJjLTQxNGMtOTQ5My1jMjUwYWQ2YTM2MTgiLCJqdGkiOiJhMmFmM2RkNC1jNDBiLTRmNDktOWFjMy1hMmU1MjY0NTlmNDciLCJpYXQiOjE3NjE5MTE4MjcsIm5iZiI6MTc2MTkxMTgyNywiZXhwIjoxNzYxOTk4MjI3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.bzloHPFIzmi3GaNyzqEMj-409BycngzuBBoEVzlIPUl3LPYP7v7ZfoyviEpsDNHT0JU8bSjZoxdoF2GnvrNJVTJVF2fWF6zS43kt70gdhNZ47QBh9o-MfnbV1ixlL2dM50jgSjGmX5-RZNUmJW1S1MISFdKWSKv5AHikE76fkW2oY3K1cSEfStejJWy7phfFx-MYj1Eu3Wp80gJqoTeyxcQls7vQogMKgv0IJL2_n-cWeZHILNC-PgbyPdf84Kujl0Ujc5NBh7Z1perP-AkJ-1QkwyDGdRb-OBjYOyQ1lS2fLvpwZGKrRzHQDlMKrPpLs8BPXdsE--J2IF2v0FnkfyuP_SnKV57SD9KcQnLbr7-O9wOVwYDrD4AAlctYFd2iiy6D-VUd9_3Y1pMQa7HK0Vkv_7bmE0YmJ7hEXtV1ppfQB0iZLaWRtV7pGGD-ZjC_YM9_fbKyNUtEvAdrAJe9gaSZPl9kly52MTm2l2uyK-u-oTWuZS8PRDO6f7DJ3z0HHp50BAk_6ss4ukAQ-fidj7CQNUrVub9NdjotateiXmjCEv-J31DF9vsMO-ShP_c98AxtXPMNoTEfX1eMoGbqb3Qv7IF3VjPG9xNirFjv5ObXETq6CEbGBY0kkpRDd_W38ogc1otQHoXM6sAZDB2InDfmHmU8Yu-697LxUUDjfl8
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 4257

{
  "data" : [ {
    "id" : "grp_D2j50J96g3rgZiPrhihJe",
    "name" : "A",
    "no" : 1,
    "color" : "#34e8eb",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "SYSGROUP-A1"
    },
    "study" : {
      "id" : "sdy_7CXZCzubRDAE5MgPAbAvvA",
      "project_id" : "pjt_3F0FCgjWXFuEQpGFISV5F5",
      "name" : "Jam0kHkmuU",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "C2bcOtqqi0",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_33z5KLBF80rtTShcYOlnau",
        "name" : "UwfZxZFrw2",
        "email" : "QUA8r6X0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2Hraef3ycNLVsAx5TV32J3",
        "name" : "R2tqYic1Ef",
        "email" : "lcOaX1LP@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:06.920620Z",
      "updated_at" : "2025-10-31T11:57:06.920620Z"
    },
    "created_at" : "2025-10-31T11:57:07.061511Z",
    "updated_at" : "2025-10-31T11:57:07.061511Z"
  }, {
    "id" : "grp_MCCFKupXiKVUk8ziDEA8E",
    "name" : "B",
    "no" : 2,
    "color" : "#4a7d4b",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "SYSGROUP-B3"
    },
    "study" : {
      "id" : "sdy_7CXZCzubRDAE5MgPAbAvvA",
      "project_id" : "pjt_3F0FCgjWXFuEQpGFISV5F5",
      "name" : "Jam0kHkmuU",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "C2bcOtqqi0",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_33z5KLBF80rtTShcYOlnau",
        "name" : "UwfZxZFrw2",
        "email" : "QUA8r6X0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2Hraef3ycNLVsAx5TV32J3",
        "name" : "R2tqYic1Ef",
        "email" : "lcOaX1LP@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:06.920620Z",
      "updated_at" : "2025-10-31T11:57:06.920620Z"
    },
    "created_at" : "2025-10-31T11:57:07.065231Z",
    "updated_at" : "2025-10-31T11:57:07.065231Z"
  }, {
    "id" : "grp_4Kne3D4zuDKLTPg2lN6Tnj",
    "name" : "C",
    "no" : 3,
    "color" : "#ad2f70",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "SYSGROUP-C2"
    },
    "study" : {
      "id" : "sdy_7CXZCzubRDAE5MgPAbAvvA",
      "project_id" : "pjt_3F0FCgjWXFuEQpGFISV5F5",
      "name" : "Jam0kHkmuU",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "C2bcOtqqi0",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_33z5KLBF80rtTShcYOlnau",
        "name" : "UwfZxZFrw2",
        "email" : "QUA8r6X0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2Hraef3ycNLVsAx5TV32J3",
        "name" : "R2tqYic1Ef",
        "email" : "lcOaX1LP@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:06.920620Z",
      "updated_at" : "2025-10-31T11:57:06.920620Z"
    },
    "created_at" : "2025-10-31T11:57:07.067684Z",
    "updated_at" : "2025-10-31T11:57:07.067684Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_7CXZCzubRDAE5MgPAbAvvA/groups?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_7CXZCzubRDAE5MgPAbAvvA/groups?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_7CXZCzubRDAE5MgPAbAvvA/groups",
    "to" : 3,
    "total" : 3,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Group Treatment

Study group treatment blurb.

Attributes

Path Type Description

id

String

The unique identifier of the treatment.

type

String

The name of the treatment type.

name

String

The name of the treatment.

external_entity_id

String

The external identifier of the treatment.

dose

Object

The dose concentration associated with the treatment.

dose_volume

Object

The dose volume associated with the treatment.

stock

Object

The stock concentration associated with the treatment.

volume

Object

The volume of the treatment.

metadata

Object

The metadata associated to the treatment.

study

Object

The study associated with the treatment.

study_group

Object

The study group associated with the treatment.

created_at

String

The created timestamp of the treatment.

updated_at

String

The last updated timestamp of the treatment.

Retrieve a study group treatment

Retrieves the details of an existing study group treatment.

Path parameters ./api/public/v1/studies/{studyId}/groups/{studyGroupId}/treatments/{treatmentId}

Parameter Description

studyId

The unique identifier of the study.

studyGroupId

The unique identifier of the study group.

treatmentId

The unique identifier of the treatment.

Request

GET /api/public/v1/studies/sdy_35hErdz3HiG2hhXSMXEexY/groups/grp_2bvbTTPEge5x8y9TvhyQZd/treatments/tmt_1XTKitfZL4jqzMilchlddA HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJlYjBjOGNmYi04OGIyLTRhNzQtOTkyZi1kYjhlZjY5NjQ0NTYiLCJqdGkiOiI1Y2VhODIxZC05NDkyLTRmN2MtOGY4ZC0xZDM1ZjQ2MjhlZDciLCJpYXQiOjE3NjE5MTE4MzIsIm5iZiI6MTc2MTkxMTgzMiwiZXhwIjoxNzYxOTk4MjMyLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.UsRXuuP5YSfHBKVJngxke5rM4YiAN_fnqPX9OC-W4RvTWBGYVR0n4WNQsL6NWEBavLp5hvvPr0q1Mfbzkcy4OdGxPjvT0zYLYUVULOpMLvZgFbMYKJxjhMRTRt2dqNYcDOJt_c-olYS6_J5P6xe7BE20vgpPlyXp1YjKuwimhh_4QBOZn7ymsG2f0syJX6QFZwTuH-G-MPsXnu-XHYJhtbKmYJI7sJqDlbtDeJQx0wb3YcJbckTk2lT0bVfCoRpx7IM8oCvssDdXXvoGyhwEDTxHqLjJUQSCXAs65qrodLpvh17DwROUnh91r1lg6D7-9TsXd_VFbEicMPQZptnYzCdSnD6Yic7AVZis7WBgrs6G3MpPvr3vGIVNSNAs83A1OvKHoz98iqJYdVpInSdoilWfPwYPWGC_0AzErFETpNZ6JyiAhfmhr46gGdjteCNf-b81bJ8HiXiqBQYVr1279oS_e557OAY7FKJW3LYOj5LVOjsT_lLV9tWo-0HSTS18fXoxGeuaBuGEsW8Qbex2-WnDg4Hdi7bhW1wCsDV3RmsqmRn92GxT_MOC0fy_r5M-Bj_rvxvvzdMJkQzOUGgw8RE2skz2KwCKQZYZkTwvQjzsgGa9gE4OkFihaIntMBcpqHcpiB_YLUWp7JyzdoAUI9pGHPAbpYjKiwTtd0Xutcw
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2051

{
  "id" : "tmt_1XTKitfZL4jqzMilchlddA",
  "type" : "concentration_mlkg",
  "name" : "sotonO8dxQ",
  "external_entity_id" : "VBimJDr6FS",
  "dose" : {
    "unit" : "mg/kg",
    "value" : "5",
    "display_unit" : "mg/kg",
    "display_value" : "5"
  },
  "dose_volume" : {
    "unit" : "ml/kg",
    "value" : "15",
    "display_unit" : "ml/kg",
    "display_value" : "15"
  },
  "stock" : {
    "unit" : "mg/ml",
    "value" : "10",
    "display_unit" : "mg/ml",
    "display_value" : "10"
  },
  "volume" : {
    "unit" : "µL",
    "value" : "8",
    "display_unit" : "µL",
    "display_value" : "8"
  },
  "metadata" : {
    "treatment-internal-id" : "TREATMENT-1234"
  },
  "study" : {
    "id" : "sdy_35hErdz3HiG2hhXSMXEexY",
    "project_id" : "pjt_1jqIUvVdUnzPw1pgs7A0Gd",
    "name" : "BKDBExTGQo",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "YXMAU7iJWR",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_3RJSaeqMc4BMYYvgzCgbhM",
      "name" : "k33rqthwab",
      "email" : "ugrixUfl@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_6fpIbWTkL4zyd1xzCWqGls",
      "name" : "1kXsPUfnrg",
      "email" : "eksukpn6@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:11.898639Z",
    "updated_at" : "2025-10-31T11:57:11.898639Z"
  },
  "study_group" : {
    "id" : "grp_2bvbTTPEge5x8y9TvhyQZd",
    "study_id" : "sdy_35hErdz3HiG2hhXSMXEexY",
    "name" : "38Ivhu6GHC",
    "no" : 1009462247,
    "color" : "wZtusr7grg",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "GROUP-1234"
    },
    "created_at" : "2025-10-31T11:57:12.052392Z",
    "updated_at" : "2025-10-31T11:57:12.052392Z"
  },
  "created_at" : "2025-10-31T11:57:12.130157Z",
  "updated_at" : "2025-10-31T11:57:12.130157Z"
}

List all study group treatments

Returns a list of your study group treatments.

Query parameters

Parameter Description

perPage

The number of measurements to return per page.

page

The page of measurements to return.

metadata

Filter studies to return by metadata value

Request

GET /api/public/v1/studies/sdy_10Xri3geNkApEldkDczgH1/groups/grp_1gKHXhhgtY5keI6SuErbow/treatments HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3OWI1NTkwNS0yOWNiLTQ1MjItYjY3Mi01NjQwZDZiYWU0MDciLCJqdGkiOiI2M2U1MzVhZC05N2VhLTRjNGEtODNhNi1hNzM2YzZjYjY1YzAiLCJpYXQiOjE3NjE5MTE4MzAsIm5iZiI6MTc2MTkxMTgzMCwiZXhwIjoxNzYxOTk4MjMwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.HYG4YH7-u1b1vFrE4QIRpVtVRwjT9Tu-CYZGo1WoF_Gcm_R32jWQ7kNFqSAtxv3QGZZdVV_QtAp7SUMgJvy9cc0mWuhj1FB1ETnWALPnibO__BwWD8v13IEyP3tsjU6K45NhtT8AbPhb6-BqG0N-T2z33Q3HJLJkdx50aQvmw5E0a4OTZH6Z2HABo8mG8ovQkrCH4a3815AaLKNgZSVbI8dodin3QdMu0ltcKzNqm3DKPB-q24QIN0GXFRngVwNWukcpPQpZymY_MiELTp5kiV5yn0ZxxGguxirOjhPzCUX-GzjNzo6w58nqyX_Es0m9oSrVdCQlAppNirJLESX7u3jHya561HpUgIdUivCl3tpS5l3k56kqMT-vDhgpEsY1a-kdsU3V1MmpYyZmb70gtt4Ta56wS5qn9XneW9Veo3syDUMRlqWMu9pQf7oZKRv-dJzlSp87Cv1jZv5SVMKt1Ggyiw80X0g0sFRE5fjtVTylad_Ro4QclO8f_2VnVAZmdT8HBvHe6Wd316UNyYeZzqTDvneds4VNE6kxOmQt9vtbLw-xZKh3HvOujE65OhNotvUc41Bfw3vnCmewlDI8rOVfHLvQjnhst_rcppTQqEaRqAmfhBGyWPSE2-WL2R1dXWed4ikzPnNmrvqZalo17ylwPSIDk6ACNxh-TizySzQ
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2817

{
  "data" : [ {
    "id" : "tmt_3gSAulFaajBoXdcQKGCSdI",
    "type" : "concentration",
    "name" : "KN3w4Z8G88",
    "external_entity_id" : "kSpmqOtTCy",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "study" : {
      "id" : "sdy_10Xri3geNkApEldkDczgH1",
      "project_id" : "pjt_4kBG5GU4jMqZY2wXIrqXX0",
      "name" : "rTafM4QmTl",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "RBStvdyHbg",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6gQf9bp9rgROt1ROmUeRng",
        "name" : "EFy4l7rhTZ",
        "email" : "N9sRCGHc@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_o4IiUkcmtgn0iF8EV09G9",
        "name" : "mEk6R6cq9k",
        "email" : "hUrdmiHP@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:10.738919Z",
      "updated_at" : "2025-10-31T11:57:10.738919Z"
    },
    "study_group" : {
      "id" : "grp_1gKHXhhgtY5keI6SuErbow",
      "study_id" : "sdy_10Xri3geNkApEldkDczgH1",
      "name" : "aleKotKOn8",
      "no" : 1523193319,
      "color" : "P62hLLPoj8",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:57:10.894721Z",
      "updated_at" : "2025-10-31T11:57:10.894721Z"
    },
    "created_at" : "2025-10-31T11:57:10.976260Z",
    "updated_at" : "2025-10-31T11:57:10.976260Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_10Xri3geNkApEldkDczgH1/groups/grp_1gKHXhhgtY5keI6SuErbow/treatments?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_10Xri3geNkApEldkDczgH1/groups/grp_1gKHXhhgtY5keI6SuErbow/treatments?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_10Xri3geNkApEldkDczgH1/groups/grp_1gKHXhhgtY5keI6SuErbow/treatments",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Dosage

This is an object representing a dose of compound administered to an animal. You can retrieve it to see the dosing method, stock, volume, concentration, date administered, user administered and the treatment group of the animal it was administered to by of the dosage.

Attributes

Path Type Description

id

String

The unique identifier of the dosage.

name

String

The name of the treatment type.

dosed_at

String

The created timestamp of the dosage.

comments

String

The comments associated with the dosage.

dose

Object

The dose concentration associated with the dosage.

dose_volume

Object

The dose volume associated with the dosage.

stock

Object

The stock concentration associated with the dosage.

volume

Object

The volume of the dosage.

study

Object

The study associated with the dosage.

animal

Object

The animal associated with the dosage.

measurement

Object

The measurement associated with the dosage.

user

Object

The user associated with the dosage.

treatment

Object

The treatment associated with the dosage.

weight_at_dosing

String

The optional weight that’s taken during a dosage.

created_at

String

The created timestamp of the dosage.

updated_at

String

The last updated timestamp of the dosage.

Retrieve a study dosage

Retrieves the details of an existing study dosage.

Path parameters ./api/public/v1/studies/{studyId}/dosages/{dosageId}

Parameter Description

studyId

The unique identifier of the study.

dosageId

The unique identifier of the dosage.

Request

GET /api/public/v1/studies/sdy_6MImhj05J8jxvfhllabC4s/dosages/dsg_zge9HLmmNbhiGZCkPZBn9 HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3NThjYTJjNy1hM2E1LTQyMjItYWM0Yy0yM2ZkMzJkZGM0YmQiLCJqdGkiOiJjNjUwY2RjOS0wZGJmLTRmZGMtOTVkNC0wNGQ5MDI3NjVmNWEiLCJpYXQiOjE3NjE5MTE3OTAsIm5iZiI6MTc2MTkxMTc5MCwiZXhwIjoxNzYxOTk4MTkwLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.dOhFvjIelyViagS3YTQaqpRBJMgLxHLZ_TCkjG79lAt0gek3PptalyCkgQ2AUybxgLM3oAT8aH_oxZaQmiZleobWqtN9toDA8QhdVKU_0KzxOn2-Gis2hX-p2nAqi8rW88H0hMGTGoUhziqbdwpJ8_JsYelVWs72K2pgNdh5dwkMJ8UmUXoO6E69dV115gs7JoUA2EpVze-jm5M3BoiJIiCUCRJGE257ijF07UsU1lh1eh-U3xCfir55IkNuxlCdpZ493a3MPSdcBisFfMHa8NFIqKJYXJzUfKgIR2zGvR4mmicLw3JvH_dXo96hpWS4o5gCIOCEdsWppC-BFASaqHee6-zSiZeTxJd9KQ7dJsvd8Wn6Xu_kAukNq0oTAdQxMmGITh1UTOo8mShZRVgmTRnS85vgdutHVn4uRYSPsno7-qRaZS75cYiPv2Ax49g6x1zHvS2R9oP-9yXStKWrJzwT3QiRjBoO9v8Gu3NNnZSyMzJP9yT0dyH6Xq5rqZVOqEsmD-821uOlvcxQ32rm4suXeDs8kyMKvjh0DsjP6OrWHPGJFBcFuO2rdN-NznVGTOUkwl-GiX5tlChvfVzYGTaGLPBmumqC8dyh9r3uIUa2RZec_29_Mjlqf-T19Gwk7hxVnGXRIgcgsPAZcokQR1WV7uKvzq6XPv67gbq0v4Q
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 4531

{
  "id" : "dsg_zge9HLmmNbhiGZCkPZBn9",
  "name" : "Example dosage",
  "dosed_at" : "2025-10-31T11:56:30.601800Z",
  "comments" : "wOHoI5WSaI",
  "weight_at_dosing" : null,
  "dose" : {
    "unit" : "mg/kg",
    "value" : "7.25",
    "display_unit" : "mg/kg",
    "display_value" : "7.25"
  },
  "dose_volume" : {
    "unit" : "ml/kg",
    "value" : "12.07",
    "display_unit" : "ml/kg",
    "display_value" : "12.07"
  },
  "stock" : {
    "unit" : "mg/ml",
    "value" : "22.42",
    "display_unit" : "mg/ml",
    "display_value" : "22.42"
  },
  "volume" : {
    "unit" : "µL",
    "value" : "32.08",
    "display_unit" : "µL",
    "display_value" : "32.08"
  },
  "study" : {
    "id" : "sdy_6MImhj05J8jxvfhllabC4s",
    "project_id" : "pjt_3be9SRjQcrI1sou9ZC1VyT",
    "name" : "IFOcjhwWmu",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "8A58EXFpzA",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_65azutatbDdBBCgGqS78XE",
      "name" : "8gdGr73dcJ",
      "email" : "XQ9gpTEb@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_2Lnj4UCXMkt8pw7YSvu9V2",
      "name" : "gwP5P2WC1t",
      "email" : "c0q1er9U@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:30.357070Z",
    "updated_at" : "2025-10-31T11:56:30.357070Z"
  },
  "animal" : {
    "id" : "aml_75KnGHoWBOgB81DhfU8g8i",
    "study_id" : "sdy_6MImhj05J8jxvfhllabC4s",
    "study_group_id" : "grp_6kuDLHSsdz8r9GSdR9NmW0",
    "cage_id" : "cge_1Xke45CBbO4AzARZIOXhid",
    "catalog" : "A0000001",
    "name" : "plWh7W4G1y",
    "number" : 1,
    "strain" : "rCypzFZ4Yx",
    "species" : "PjQBUWKQZ0",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "X570o1ENKi",
    "ear" : "qUnkZ9X6YS",
    "tag" : "k7ruGF6Jf2",
    "donor" : "VuIyDjxbAP",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_1pW2FLOF8woGVdoCXAABVk",
      "name" : "e4cTlzDd28",
      "email" : "EIEluguB@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_4kbRETKqRyl9F65MSAY6xa",
      "title" : "Found dead",
      "comment" : "u499PLcInp"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:30.518074Z",
    "updated_at" : "2025-10-31T11:56:30.518074Z",
    "disease_induction_date" : "2025-10-31"
  },
  "measurement" : {
    "id" : "mst_APPSznO0waF6LtDbN10zv",
    "study_id" : "sdy_6MImhj05J8jxvfhllabC4s",
    "animal_id" : "aml_75KnGHoWBOgB81DhfU8g8i",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_6PUISBKLhppPJNjYYAbfDN",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "created_at" : "2025-10-31T11:56:30.590426Z",
    "updated_at" : "2025-10-31T11:56:30.590426Z"
  },
  "user" : {
    "id" : "usr_U17YzPYknSjE8a4vDTWYa",
    "name" : "EoFqW Overwatch",
    "email" : "zrZhLrFD@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:30.342681Z",
    "updated_at" : "2025-10-31T11:56:30.342681Z"
  },
  "treatment" : {
    "id" : "tmt_tO0refYZNBxDchuvpB83A",
    "study_id" : "sdy_6MImhj05J8jxvfhllabC4s",
    "type" : "volume",
    "name" : "qQH1TZHt5K",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "created_at" : "2025-10-31T11:56:30.596064Z",
    "updated_at" : "2025-10-31T11:56:30.596064Z",
    "external_entity_id" : "ZxlG0OyApJ"
  },
  "created_at" : "2025-10-31T11:56:30.601810Z",
  "updated_at" : "2025-10-31T11:56:30.601810Z"
}

List all study dosages

Returns a list of your study dosages.

Path parameters ./api/public/v1/studies/{studyId}/dosages

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of dosages to return per page.

page

The page of dosages to return.

Request

GET /api/public/v1/studies/sdy_4NTBncWYRWItpx35mmgfkf/dosages HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJmNTNkZDgxNC0xYWE3LTQzNGYtODNhZi0wMzcwNzNlZDMzNDYiLCJqdGkiOiJkOTgxNTk0Yy01ZmQ5LTQ3MDQtOTc0OS1lYjUyNDBkMGNjNmIiLCJpYXQiOjE3NjE5MTE3ODgsIm5iZiI6MTc2MTkxMTc4OCwiZXhwIjoxNzYxOTk4MTg4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.cXeSh01-5BAXMThKmLWPtsFQrfh_rkQ_t4hrvS3sTb8cB4iGRCtK0PbZIs2Hd8mwnSK6Zjy5gH29V0OQEPDXOpnDXOBZjvgWTOm1kF2GCu0t0vAS9dCt0fj5qfW_NKyGSzpygsYOnsCGrKOQd7M_rjMjlK0oXchLEwox8NVi5D8PQDbhHzX9-CUdIW2Av8ODMFNB1FUwJLWBeNdmfGaaZUcd2IqBkd6hwn4VXPzD7PUR3HPllAOG4UhNGZjK3GYM7C67fP-XGv1i8IidB4vejhN_cTmU-ZE87IkESvFJb1wdtUSiPykBNdjdhhfaazVdPtibAzf7IRVmNV-C5vGuaVVStRuV2UswqYv80IYUSO7XhJxoTlvZDOBgY3ybemUHnKrfRR7dZ_CAASkwm1oGB7hSQG4iMNYdfO8HyxWVipNgJ1IZ3b66YXL9Kj4aSbHC4dgxmfKkJs1fwntkSARMdrt_taB_kBjjVDohk1EnVk5Gmtl0Ho-P3-jY7hOfpZJJW3oIhh7UU56BStTenqQgoqP6uNfhOKTgSMNi_M1uQ5GuukdEk9slt-4yoyIabCTU0SjZ3csMEZsCmqW0Q1mMVh341gUW2Zv86YrQmji1x3K_axjVxpxm_RX3a1gUECJj4mrbJS0LgzPjiRvxqFqpnN7kuQwNRQ-aeV6zA9W52nU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 5382

{
  "data" : [ {
    "id" : "dsg_77qHDqRNHXsizFbPMIadZR",
    "name" : "Example dosage",
    "dosed_at" : "2025-10-31T11:56:28.379321Z",
    "comments" : "SVVS0038xN",
    "weight_at_dosing" : null,
    "dose" : {
      "unit" : "mg/kg",
      "value" : "1.64",
      "display_unit" : "mg/kg",
      "display_value" : "1.64"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "18.59",
      "display_unit" : "ml/kg",
      "display_value" : "18.59"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "27.10",
      "display_unit" : "mg/ml",
      "display_value" : "27.10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "38.87",
      "display_unit" : "µL",
      "display_value" : "38.87"
    },
    "study" : {
      "id" : "sdy_4NTBncWYRWItpx35mmgfkf",
      "project_id" : "pjt_6cjAVRMnGFg6CvTy3vPUcs",
      "name" : "OI7WpM881i",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "TN1e8zwTlh",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6WEej5lNumXLUkFBhCDtK3",
        "name" : "JHxhEdr6i3",
        "email" : "oW5Riyel@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_7Wqz3sTKX2yrHt3dNndlAH",
        "name" : "CwjPxLT504",
        "email" : "1jRmtDsD@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:28.094916Z",
      "updated_at" : "2025-10-31T11:56:28.094916Z"
    },
    "animal" : {
      "id" : "aml_5o4wif9EfHdzYb5pFM1beD",
      "study_id" : "sdy_4NTBncWYRWItpx35mmgfkf",
      "study_group_id" : "grp_1hghsUhFWK3EGCk1TpTmZY",
      "cage_id" : "cge_1Ri4GgP5xinJV4RwAejSNA",
      "catalog" : "A0000001",
      "name" : "XA7rjoURU3",
      "number" : 1,
      "strain" : "FImfzGqpFC",
      "species" : "u7OelvvHs1",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "V8MBtBIWa2",
      "ear" : "lEN6kaCBtE",
      "tag" : "1PODpgLWvT",
      "donor" : "0KKaDBB0Zr",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_1W75jpJsAIOnidl7PS1TI7",
        "name" : "pYxzoCbGbS",
        "email" : "vnz5KjQy@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_4GlvNBDgcqNwsB3gY6eIpH",
        "title" : "Found dead",
        "comment" : "ch7Ho3Lrje"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:28.260966Z",
      "updated_at" : "2025-10-31T11:56:28.260966Z",
      "disease_induction_date" : "2025-10-31"
    },
    "measurement" : {
      "id" : "mst_4Gvjv6FzHcND8g51XU8y44",
      "study_id" : "sdy_4NTBncWYRWItpx35mmgfkf",
      "animal_id" : "aml_5o4wif9EfHdzYb5pFM1beD",
      "measured_at" : "2025-10-31",
      "calculations" : [ {
        "id" : "vbl_5j6dXITXcvUl3e43AWoN7s",
        "key" : "weight",
        "name" : "Weight",
        "unit" : "g",
        "excluded" : false,
        "value" : "55",
        "formula" : "weight",
        "variables" : [ ]
      } ],
      "created_at" : "2025-10-31T11:56:28.337236Z",
      "updated_at" : "2025-10-31T11:56:28.337236Z"
    },
    "user" : {
      "id" : "usr_51Zz81Myp4JFLrytZmw8z8",
      "name" : "Ij58l Overwatch",
      "email" : "VzEL0u9j@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:28.074495Z",
      "updated_at" : "2025-10-31T11:56:28.074495Z"
    },
    "treatment" : {
      "id" : "tmt_3aMjzEX533JI2LsAXyzdvV",
      "study_id" : "sdy_4NTBncWYRWItpx35mmgfkf",
      "type" : "concentration_vgkg",
      "name" : "mgTTPOhrHH",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "created_at" : "2025-10-31T11:56:28.368842Z",
      "updated_at" : "2025-10-31T11:56:28.368842Z",
      "external_entity_id" : "A18NktgF8H"
    },
    "created_at" : "2025-10-31T11:56:28.379507Z",
    "updated_at" : "2025-10-31T11:56:28.379507Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_4NTBncWYRWItpx35mmgfkf/dosages?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_4NTBncWYRWItpx35mmgfkf/dosages?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_4NTBncWYRWItpx35mmgfkf/dosages",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Measurement

This is an object representing a measurement that has been recorded from an animal on a day. Measurements are created in studies which have a preset, typically for observable data like tumour volume or blood glucose.

Attributes

Path Type Description

id

String

The unique identifier of the measurement.

measured_at

String

The measured at timestamp of the measurement.

calculations

Array

The calculations associated to the measurement.

study

Object

The study of the measurement.

animal

Object

The animal of the measurement.

user

Object

The user that recorded measurement.

created_at

String

The created timestamp of the measurement.

updated_at

String

The last updated timestamp of the measurement.

calculations[].variables

Array

The measurement calculation variables.

Retrieve a study measurement

Retrieves the details of an existing study measurement.

Path parameters ./api/public/v1/studies/{studyId}/measurements/{measurementId}

Parameter Description

studyId

The unique identifier of the study.

measurementId

The unique identifier of the measurement.

Request

GET /api/public/v1/studies/sdy_5cAv05uion5wqP9x71uwAU/measurements/mst_6SmiPZt8LFugVzsuLv5fVw HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzMmMxZTFiNS1hMmQ5LTQ0YzEtOTk1MS0yNjZmMTQ3NjQ2YWUiLCJqdGkiOiJmNTIyNzg2Yi1kZGE5LTQ0OWEtOTZjZC03MWM2Yjk4MWQ2MWQiLCJpYXQiOjE3NjE5MTE3OTgsIm5iZiI6MTc2MTkxMTc5OCwiZXhwIjoxNzYxOTk4MTk4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.K0-nzpAi3l_tvKdKXDMAFOzauJJi4OgdHoDYPI0qVjX4HscZSctzJ7Q43epMGJgJFMdL7wExcW93D9tn6ydy-F50WrJC7pdhZ6uKW7mkjcFIbCpC_CwcNg2IxoJ3PXfvYMr0bAzGWRY983w3nE33-pLOq2nYNbWbpd9B-gv-QrGJuYdBm0tVkAUwf2Q5Ws4LeicMmSKRL43ECfDhvoDFx_Mg4mTXtglQwWEDPhpZqivZ3exXUWAQLTuux6xJaA7W1LA6powMts9U5hErn1YCAD1NEuzhaYYg9LiBEf4QGt0-dnqSEUwti3U-1kEHSWuwSd0CegtUXz9At4CR8Ubv9KdycqEfLgplGeIoj_SRawAIBX3ERnoZvIGlw8Mz70jf955UEsmWfq7Cp7sqiUPQZYkGBJxdIWbWcc_Ig981vS-jsm9IWR9ViaJCNEN5Z1zCNL8f6TH9JzbttS70XCajMl7PJugGmasWD8NxtPYvPZKXxHgIyXXTepTsdQzluDQ5QGCowtC5ii2e50Qm7KOOVv5mx74ugjHZYqpYlw-dMg2OkUXG0Kxrl9Hxb_z9HbanwPqN0kyCeKQRRhdrA_sdakcYewyFHvZIWz65Ezx6a8x92XOH7A6lYYbi7CTtEuuHTzjF4RRZu2dzOJz9Is-zijK_gE_4-4_zXTIx-NPGxlY
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3203

{
  "id" : "mst_6SmiPZt8LFugVzsuLv5fVw",
  "measured_at" : "2025-10-31",
  "calculations" : [ {
    "id" : "vbl_4DrQ3HOparCYAb1Cn421lN",
    "key" : "tumour_volume",
    "name" : "Tumour Volume",
    "unit" : "mm³",
    "excluded" : false,
    "value" : "75",
    "formula" : "(width * width * length) / 2",
    "variables" : [ {
      "id" : "vbl_6A6kWJOiF6ZL1awztkr2h",
      "key" : "width",
      "value" : "5",
      "unit" : "mm"
    }, {
      "id" : "vbl_3f4bBsPIiMPk0N7rrY5kzc",
      "key" : "length",
      "value" : "6",
      "unit" : "mm"
    } ]
  }, {
    "id" : "vbl_1jXoVLUQlDc53A8DLxGmU0",
    "key" : "weight",
    "name" : "Weight",
    "unit" : "g",
    "excluded" : false,
    "value" : "55",
    "formula" : "weight",
    "variables" : [ ]
  } ],
  "study" : {
    "id" : "sdy_5cAv05uion5wqP9x71uwAU",
    "project_id" : "pjt_5iMbICrGyAwFtQmEtemBmB",
    "name" : "JCZDifjnqZ",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "IzSgh9aedE",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_2yt65UT0UHOREQPPHPLxtr",
      "name" : "7GPyGvNu7K",
      "email" : "KoyVY81l@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_5HecCDTEBIC5bX3oT5r7V3",
      "name" : "Fj41DPJyFb",
      "email" : "stRzuKeF@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:38.714416Z",
    "updated_at" : "2025-10-31T11:56:38.714416Z"
  },
  "animal" : {
    "id" : "aml_5BaEnk3Xa9zDawz5dp4MIT",
    "study_id" : "sdy_5cAv05uion5wqP9x71uwAU",
    "study_group_id" : "grp_5TrTAwtWy7PyacuRxQKifB",
    "cage_id" : "cge_41fz40nNJahM2vZrmH4Ry3",
    "catalog" : "A0000001",
    "name" : "pZJ2b8eN1O",
    "number" : 1,
    "strain" : "1SBm9t10TW",
    "species" : "if0gFSLfHk",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "d01xeZd69O",
    "ear" : "MXmImnNl4x",
    "tag" : "W4PEehWzLs",
    "donor" : "3xLzexkoSJ",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_6O2E6GVOnBGynSdeJjz0Gs",
      "name" : "2sqEaNweX5",
      "email" : "OpniZ9H6@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_2R43s8MyRk4YPIrm44mMuY",
      "title" : "Found dead",
      "comment" : "DN1EBE4K6W"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:38.876605Z",
    "updated_at" : "2025-10-31T11:56:38.876605Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_7jBx7rDUPQrRzSAyfgScqW",
    "name" : "1jr5b Overwatch",
    "email" : "xM31RaQE@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:38.697755Z",
    "updated_at" : "2025-10-31T11:56:38.697755Z"
  },
  "created_at" : "2025-10-31T11:56:38.947485Z",
  "updated_at" : "2025-10-31T11:56:38.947485Z"
}

List all study measurements

Returns a list of your study measurements.

Path parameters ./api/public/v1/studies/{studyId}/measurements

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of measurements to return per page.

page

The page of measurements to return.

measured_at

Filter measurements to return by date (yyyy-mm-dd).

Request

GET /api/public/v1/studies/sdy_59o9ZcEwmuOkoy6i13jp6R/measurements HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJiNzYxYmMxOC0wYWYwLTQ3NGYtODM0YS01YTllOWIzMTY0NzMiLCJqdGkiOiI3NjkyZDdiOS1hNjYwLTQ1MjQtYjQ4NS1hZWY3M2MxZGM4MTMiLCJpYXQiOjE3NjE5MTE3OTcsIm5iZiI6MTc2MTkxMTc5NywiZXhwIjoxNzYxOTk4MTk3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.ldeLvF-Cyya3xSq2YbfAKobt5Y9wqw-fmpvz0g_M_9TvH0q7SB8gSyuYM_9Fioovew3_Esk0ULUvBaUO3moWYWwi3CAxO8yUAx_y6iTZYxqM0bcpiHaUr0hjFplzxn9iDNLkc6vEnz5RgpChlY8b_b55mMSlKzpkNsP6xlKXkhCDgEDfPnkr829TsJLuUEvmK9I_g9sL0ksvLiuMfIpyP7qvJqjEhwIFUnZka7nDdwCxv4lQ9NWrp-7YAFuvu09UFq3P0QRvRnO-I2ifwBdDQB2Bp62K9b6FwdBv65rWh9uxELQOXwxEOISjz19oI-e0M-oGMYDO5UPR0-ECIPcwX6VaXhDbX2DM-yvdGOsdafqW-tKEpGuS5Ndg3zM62i957aQghEUNwJX9jjnhW099m9UE3X96tvHRaNn2JR43hiHC9EXeOUpk-o2o66_gnRKcz2xrQpLRcxd0NnVDbhidqiMq8MQxYUOf8PVzjlWhGVeDccGOoL9Ywj-PYTintO3719AcCcL4dciIpRjmhmm_NAc5p3LhfO6Qzxduv0MehSOBrr0IPxl8GmZrwdkq3KCGDhFk9kVmXdwQnT4wBmHkcN_-xfnrQrQCUjjqgqTE_K-QmRpDiHyfQV_dukIqvACGuEDD6D-irhrLyulS0jXCsPnZAEEYgdA72uDwimgQitY
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 7376

{
  "data" : [ {
    "id" : "mst_83Ar6rDGL1LypYuyMl8vw",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_5xRrKFu0WwTSLLQOJ9W4Em",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "75",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_2dLppBSxSesUfLXaA03fCc",
        "key" : "width",
        "value" : "5",
        "unit" : "mm"
      }, {
        "id" : "vbl_3jlj4NfQqEGoWECKPSiHBl",
        "key" : "length",
        "value" : "6",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_3SLv0A7yOQWsJ7gedU5Cwb",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_59o9ZcEwmuOkoy6i13jp6R",
      "project_id" : "pjt_6mpwjRfFddLcZbuQlcwgun",
      "name" : "wjGG9EQa4o",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "2tOu9EH8qZ",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2t3W6FwxhZKnW2HDqP517u",
        "name" : "48L91R9SY8",
        "email" : "Aq2RwDrm@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_PUomFrrVwgnoBQmL635JD",
        "name" : "LxpcWpjBPv",
        "email" : "a7yVwL4D@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:37.689527Z",
      "updated_at" : "2025-10-31T11:56:37.689527Z"
    },
    "animal" : {
      "id" : "aml_7VCJ8vUWm2daNAFGu35D1K",
      "study_id" : "sdy_59o9ZcEwmuOkoy6i13jp6R",
      "study_group_id" : "grp_15r3fVgsjljA3wdiNoPOhG",
      "cage_id" : "cge_4Scoo92bK3DBPGyomnppc9",
      "catalog" : "A0000001",
      "name" : "k6IyDWOF9M",
      "number" : 1,
      "strain" : "SRaWsTixOQ",
      "species" : "BUoR25g2JI",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "85VbLo8Xzw",
      "ear" : "4dX7oYt63Q",
      "tag" : "h2LyaLz7pO",
      "donor" : "wdapSLbOeu",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_5idN0HpfTq8xxAa29caLQ2",
        "name" : "80kBlHVldi",
        "email" : "HSVuQATZ@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_aDmUtBEziLzUdCTkMxseu",
        "title" : "Found dead",
        "comment" : "l2H9DWKGkw"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:37.844069Z",
      "updated_at" : "2025-10-31T11:56:37.844069Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_2P26JF7BJ6q88jMmtiCMEJ",
      "name" : "F80w0 Overwatch",
      "email" : "pxwP1ULE@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:37.676971Z",
      "updated_at" : "2025-10-31T11:56:37.676971Z"
    },
    "created_at" : "2025-10-31T11:56:37.916689Z",
    "updated_at" : "2025-10-31T11:56:37.916689Z"
  }, {
    "id" : "mst_1KeV5QpnGglBzpzfB3HJGT",
    "measured_at" : "2025-10-30",
    "calculations" : [ {
      "id" : "vbl_F8TBaYVK3hbE4DCSD4kOs",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "196",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_5vcrrF25ZaqrCpwTyHp3Zm",
        "key" : "width",
        "value" : "7",
        "unit" : "mm"
      }, {
        "id" : "vbl_2EBP2jpy7B4Ml30eOanYUO",
        "key" : "length",
        "value" : "8",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_KtE2ryKfGXhTM71TNrJNa",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "56",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_59o9ZcEwmuOkoy6i13jp6R",
      "project_id" : "pjt_6mpwjRfFddLcZbuQlcwgun",
      "name" : "wjGG9EQa4o",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "2tOu9EH8qZ",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_2t3W6FwxhZKnW2HDqP517u",
        "name" : "48L91R9SY8",
        "email" : "Aq2RwDrm@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_PUomFrrVwgnoBQmL635JD",
        "name" : "LxpcWpjBPv",
        "email" : "a7yVwL4D@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:37.689527Z",
      "updated_at" : "2025-10-31T11:56:37.689527Z"
    },
    "animal" : {
      "id" : "aml_7VCJ8vUWm2daNAFGu35D1K",
      "study_id" : "sdy_59o9ZcEwmuOkoy6i13jp6R",
      "study_group_id" : "grp_15r3fVgsjljA3wdiNoPOhG",
      "cage_id" : "cge_4Scoo92bK3DBPGyomnppc9",
      "catalog" : "A0000001",
      "name" : "k6IyDWOF9M",
      "number" : 1,
      "strain" : "SRaWsTixOQ",
      "species" : "BUoR25g2JI",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "85VbLo8Xzw",
      "ear" : "4dX7oYt63Q",
      "tag" : "h2LyaLz7pO",
      "donor" : "wdapSLbOeu",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_5idN0HpfTq8xxAa29caLQ2",
        "name" : "80kBlHVldi",
        "email" : "HSVuQATZ@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_aDmUtBEziLzUdCTkMxseu",
        "title" : "Found dead",
        "comment" : "l2H9DWKGkw"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:37.844069Z",
      "updated_at" : "2025-10-31T11:56:37.844069Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_2P26JF7BJ6q88jMmtiCMEJ",
      "name" : "F80w0 Overwatch",
      "email" : "pxwP1ULE@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:37.676971Z",
      "updated_at" : "2025-10-31T11:56:37.676971Z"
    },
    "created_at" : "2025-10-31T11:56:37.921523Z",
    "updated_at" : "2025-10-31T11:56:37.921523Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_59o9ZcEwmuOkoy6i13jp6R/measurements?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_59o9ZcEwmuOkoy6i13jp6R/measurements?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_59o9ZcEwmuOkoy6i13jp6R/measurements",
    "to" : 2,
    "total" : 2,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Observation

Retrieves the details of an existing study observation.

Attributes

Path Type Description

id

String

The unique identifier of the observation.

glossary_id

String

The unique identifier of the glossary item.

title

String

The title of the glossary item.

text

String

Text related to the observation.

type

String

The type of observation recorded.

value

String

The value of the observation taken.

observed_at

String

The timestamp of when the observation occurred.

study

Object

The study of the measurement.

animal

Object

The animal of the measurement.

user

Object

The user that recorded measurement.

created_at

String

The created timestamp of the project.

updated_at

String

The last updated timestamp of the project.

Retrieve a study observation

Retrieves the details of an existing study observation.

Path parameters ./api/public/v1/studies/{studyId}/observations/{observationId}

Parameter Description

studyId

The unique identifier of the study.

observationId

The unique identifier of the observation.

Request

GET /api/public/v1/studies/sdy_7OcbarJhouXBsd0AXAxOd9/observations/obs_4Yc0ugwVD2V5PuZ5Yh1NlN HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJiMWU3NDhmNy1hOTk1LTRlNDItODdkMy0yODk3MGU5M2ZmNTciLCJqdGkiOiJlYjhkODE0Yi1jODEzLTQyYjUtYmI1Ni1jOGZjNzcwYjM5ODIiLCJpYXQiOjE3NjE5MTE4MDUsIm5iZiI6MTc2MTkxMTgwNSwiZXhwIjoxNzYxOTk4MjA1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.kYHi7-Wkq_wbaCw4N28Qfo7EAE9hBFTxJca_SQFSnfT2YrcIFEN0nNmya6L2VdikK8Xkw9jLzQUz76q5z_GSt9ZYFZRbOkR_sIywRAigAecNnD5m2DGLFn0WuJSWm5NEgTiUbHi8Jq_Z9XvGt-VnR_trPW9yxnmwD5xiJ7_tTxj-G0FH85VJQ9Dii-oV5MoXBRFHGedkNfShnVHbrNfaucvQGAs_5B05w9mOc_Gjad7_4OAeaF-As6ydRsQOxyuboMzss6RRtXkOzZq3P0INVRVy90XdfRxMrhTu4MheHyAbVAbueKt8wfaEfVX8VYA26nG6-5Z0lyi2xcAb5GvZIiqvhvDpwT4dBqkYjk7nxIjWPa6dXts_Z_GHvTELVly7vCMhHKt0SQ2yFRizJE3HHodU62tPoy-Nn01EHeitvmV-fAwYGM6b1YmVXn47C69iKnfZG25-u1LOBG5ibDAXEVQCAldFvBk5-ozp2-8b-T_y39zEmL-DMaI-F72ohsRriOx6drZHo8o377M5-EI11EOcXfC2UxAf9_KTwcBqfDyjTVVdgKqwm-DcSiVdIjKE5PRKOEyS9-WOvwdcp6fnu0FRWR7A0q57UeRW37asW3VtAXfwI4kbt-Wrinb9VX-fd1x42WnSz0mIx7K9WIMqX9Nj5wX9xTPKFWED9nwdr5M
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2677

{
  "id" : "obs_4Yc0ugwVD2V5PuZ5Yh1NlN",
  "glossary_id" : "gly_3HfkFNpV7siXwEq3pL8EsY",
  "title" : "Observation Glossary",
  "text" : "Example text",
  "type" : "severity",
  "value" : "Severe",
  "observed_at" : "2025-10-31T11:56:45.503059Z",
  "study" : {
    "id" : "sdy_7OcbarJhouXBsd0AXAxOd9",
    "project_id" : "pjt_54XyBmEbTMTN1tLkw7A0Kv",
    "name" : "SdtGe8JZr7",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "CfbxXAualq",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_6s9uXaRc57K5eAKkPTw6sS",
      "name" : "Xl0JlYUbYP",
      "email" : "ZxAcg4Kr@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3jPWlGT2P76qBXB5XPw3x4",
      "name" : "rgHF7KenG4",
      "email" : "3rpfakGb@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:45.273682Z",
    "updated_at" : "2025-10-31T11:56:45.273682Z"
  },
  "animal" : {
    "id" : "aml_5YV0YJhP90SwZRmX94QkeM",
    "study_id" : "sdy_7OcbarJhouXBsd0AXAxOd9",
    "study_group_id" : "grp_3wWEJysTVNjZLITChhaqDr",
    "cage_id" : "cge_2CseIUdrQHM4TOQRVuQG5q",
    "catalog" : "A0000001",
    "name" : "tttAfg8RwO",
    "number" : 1,
    "strain" : "We3hWYcXDv",
    "species" : "WyYpZyiUfM",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "BV3IE9jVGd",
    "ear" : "GYnJrWaUQh",
    "tag" : "MvvN1snSQL",
    "donor" : "xLQ8mloKMj",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_2ffHPAkMwtOvoZJCRmUumV",
      "name" : "3TVx0VXQA4",
      "email" : "Aza4kvNj@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_6DHt52tVytzj9j9Byfhc5H",
      "title" : "Found dead",
      "comment" : "xFbblwm0pa"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:45.429497Z",
    "updated_at" : "2025-10-31T11:56:45.429497Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_4kk9knFSwwur4geU17c7RO",
    "name" : "BlWgc Overwatch",
    "email" : "zyqA05B9@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:56:45.257497Z",
    "updated_at" : "2025-10-31T11:56:45.257497Z"
  },
  "created_at" : "2025-10-31T11:56:45.503070Z",
  "updated_at" : "2025-10-31T11:56:45.503070Z"
}

List all study observations

Returns a list of your study observations.

Path parameters ./api/public/v1/studies/{studyId}/observations

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of observations to return per page.

page

The page of observations to return.

Request

GET /api/public/v1/studies/sdy_11xrm28RfSo7BlpVC71Ikc/observations HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2MjM2OTc2ZS1jYjUwLTRhZGYtYmIzNC1kODM1ZDdlMTI1ZjEiLCJqdGkiOiIzMWRiMDRkNC0zMmZiLTRkY2EtOTNhMC0yZWMzNjgzNDQ3NTMiLCJpYXQiOjE3NjE5MTE4MDcsIm5iZiI6MTc2MTkxMTgwNywiZXhwIjoxNzYxOTk4MjA3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.aT168TWDvbMRP5GR5ZkDFH7EXxnpQx-IZWGOP551_woRTQqXvUsPQyaY-xvBw2Kk-NNmlydlimHD_0zcBiaKoT_ixfS5PANo4H3l0RQrqkSm282GzfcQZFf707hxtZJn1yNn6i9wt9QhwHu0Y0OAbpOLpTb8Uk4YHTTBUIlKsdp089KwumUPlaAtAKmxGpteby6hMh1JFGbdCnoyqKiS4bjEHUuNsBc-6LzLrDMv9NYP-0812DF6a9bhgKoZe8Kvi4M6r6o1cKFrPvKDHhV_8oEjZsHCpNguR874MttSQbrRLQEJSSz8FJuaEa6sYLd3hCPoVEgdqSYVN4fcKBLS6t7NnXCXFZ8oNmDljlqOwA8snifA3V9nQAei0QYVyYFUkKO44HCLsp-UCszaDYqBSqolJHjEUF-n-iSkIA6SjJ49toSXaNB3FEghxT16tR0bO_hn5zjwV1wCAkLi4N75jUw-DLNpb0St7UoJvNOL9KLVYwjmtPJJch7eFxFrGfoPvnuy64OaPm7uXRldbEOQYxH_Eek8bpiIhwBwpM5B22aOse8pxnVM8CA4TizH-Nw22ejfSAoZzZ_eHFe9axcYeoa3svJM2SPd0Eo11HqdsEu6SW-O3TXsagr91RaqMWv38UeIcDNJ1vAv-F1b5Zc9X6gOOt_10sy23ll_9hDUc04
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3374

{
  "data" : [ {
    "id" : "obs_4QQxOu4BzN7FHaXHqEqS2H",
    "glossary_id" : "gly_66RZDujxT5spYN3WH770qZ",
    "title" : "Observation Glossary",
    "text" : "Example text",
    "type" : "severity",
    "value" : "Severe",
    "observed_at" : "2025-10-31T11:56:47.499166Z",
    "study" : {
      "id" : "sdy_11xrm28RfSo7BlpVC71Ikc",
      "project_id" : "pjt_1GB7za59ELujEqXHRHMPDP",
      "name" : "Ob6o8Wgjwg",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "FVdycemGDX",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1UFNlKJWipETIr2uFLE0s4",
        "name" : "ud4cbNXYJ7",
        "email" : "WnApQYva@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3UmNo5urpzKuwqKZJgKcU",
        "name" : "9MOpIE07ad",
        "email" : "iUKLGPVB@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:47.274657Z",
      "updated_at" : "2025-10-31T11:56:47.274657Z"
    },
    "animal" : {
      "id" : "aml_27C2RPkUnrHeUZZ0RVGdLb",
      "study_id" : "sdy_11xrm28RfSo7BlpVC71Ikc",
      "study_group_id" : "grp_71G6HNdUFx9uEgCmCKy1U8",
      "cage_id" : "cge_7bAS4BG9u0qUvVfQ8wbu6Y",
      "catalog" : "A0000001",
      "name" : "5Y1RgIwhkP",
      "number" : 1,
      "strain" : "wWll6zJ8SM",
      "species" : "iHwV7XRwLh",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "UnWxgKVYJ5",
      "ear" : "a85K0IMlzb",
      "tag" : "70zWLQOUJk",
      "donor" : "okVa3Rw73u",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_20Um3ctQxoeRrJQeYcncqa",
        "name" : "O01Ii4PwLx",
        "email" : "jlvVLxDQ@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_3gceDIVBH0TpG7hv4mk8c3",
        "title" : "Found dead",
        "comment" : "FQCe1l3N1A"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:47.427971Z",
      "updated_at" : "2025-10-31T11:56:47.427971Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_6wRsmUzD3KcIiPW5gQ2xfX",
      "name" : "j7hKG Overwatch",
      "email" : "E4y1HKgq@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:56:47.258438Z",
      "updated_at" : "2025-10-31T11:56:47.258438Z"
    },
    "created_at" : "2025-10-31T11:56:47.499197Z",
    "updated_at" : "2025-10-31T11:56:47.499197Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_11xrm28RfSo7BlpVC71Ikc/observations?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_11xrm28RfSo7BlpVC71Ikc/observations?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_11xrm28RfSo7BlpVC71Ikc/observations",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Preset

Study group preset blurb.

Attributes

Path Type Description

name

String

The name of the study preset.

calculations

Array

The calculations associated to the study.

study

Object

The study of the study preset.

Retrieve the study preset

Retrieves the details of the study preset.

Path parameters ./api/public/v1/studies/{studyId}/preset

Parameter Description

studyId

The unique identifier of the study.

Request

GET /api/public/v1/studies/sdy_1lwyoUX174686JptmvqhcJ/preset HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJmYjc3YWNlYy1mZDU0LTQ4YTYtOWNkNi00MWYzMDdhNGI4NzAiLCJqdGkiOiIzMDU0MjQyZS0zNjdjLTRlODUtOGEwNy03ZTI4NTliYTM5ZDIiLCJpYXQiOjE3NjE5MTE4MjcsIm5iZiI6MTc2MTkxMTgyNywiZXhwIjoxNzYxOTk4MjI3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.D357cqMKL0EzdPTDPFiG9FN3eXQcAEKUiL9y-Z-9P99xIQq4_-PwEgbcnB8ubdiBareaK63zsl7PSDRz_8EGmk3LvQ7GaDzr7wld2SV96mh8eQnseJ2Dex6FdaAUuQYyOe-2yNzC9HLdxAREBkQVvJU-Q6Bugu5g0Vrg0q83kdTiIn2s63TosduL_bx5kfjp7nqfQudSD4TUY4gxTXHx6e2EvW17ik_pDv6QLYCrDfJuB7X6XLcn4aJ7lV30qaiJTmKZI06wFG80CbHDavV7Cv1-H7LZGvtYBotos8gI62JY6OvCgw7LlgnuSC9ZYbelqORn0CBZ18TzvrQhae5Sxmdvt6XugqfKj9-UmIGOyJtUklyZ52p5s1J7tb-DZ7FeIg2XKkl0_UG7F9LBIN8kRVhIJG12ZW8LldvkZ_WwLjpIppHEBm8W9m92cAnZ3is_rQucBPfhVt8DuB1-OfFzzI6R8wFIREV3SL-A0mWbw5fJXZYMFNBReTUT3Xkbu_568WdvaTIfX8apy8Xmm5cBRtkA8H-lfvdEY3KcFnpgPFC4ZmPXhC8Ht6CmB-sZekoNkqvhTiP9PysBxHw4kDbHoqtNMQ261X5ZXbhFnYuHXNv6GcsPF8h0ltAyBzx5ZSBJ6a4smpakx-_qTjmVLVC0dj83M0G_5h3tZ3gAYdw9JTU
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1449

{
  "name" : "Subcutaneous Tumor - Two variable",
  "calculations" : [ {
    "key" : "tumour_volume",
    "name" : "Tumour vol.",
    "unit" : "mm³",
    "formula" : "(width * width * length) / 2",
    "measurements" : [ {
      "key" : "width",
      "name" : "Width",
      "unit" : "mm"
    }, {
      "key" : "length",
      "name" : "Length",
      "unit" : "mm"
    } ]
  }, {
    "key" : "weight",
    "name" : "Weight",
    "unit" : "g",
    "formula" : "weight",
    "measurements" : [ {
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g"
    } ]
  } ],
  "study" : {
    "id" : "sdy_1lwyoUX174686JptmvqhcJ",
    "project_id" : "pjt_6nSQZXOzkFs8jnPUqANSqo",
    "name" : "oO8NONmJ6d",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "1XjEV7vtci",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_7j5BqEZ59VFBv7xboKl5R2",
      "name" : "oYG8LosmE1",
      "email" : "viXFujVm@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_31gQNBUhZpszy5VSQdZxtX",
      "name" : "r1X804Fpas",
      "email" : "uk969E4G@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:07.110522Z",
    "updated_at" : "2025-10-31T11:57:07.110522Z"
  }
}

Study Request

This is an object representing a request on a study. You can retrieve it to see the request identifier, users, groups and the fields relating to those groups.

Retrieve a study request

Retrieves the details of an existing study request.

Path parameters ./api/public/v1/studies/{studyId}/requests/{requestId}

Parameter Description

studyId

The unique identifier of the study.

requestId

The unique identifier of the request.

Request

GET /api/public/v1/studies/sdy_6WxglekfFTHF60bsKnHgh6/requests/req_5VkK2B3nJje7rYCoIxNMHr HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhMzhmZWQwYi05NjA5LTQ1OTktOTcxYy1hZWY3NWVkYzcwYzYiLCJqdGkiOiI3M2YyNWJlMC1jY2IyLTQyYTEtYjhmMy1jYzViMDY3YWVjYmYiLCJpYXQiOjE3NjE5MTE4MTEsIm5iZiI6MTc2MTkxMTgxMSwiZXhwIjoxNzYxOTk4MjExLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.OzyGhtG2KZQk3iQfokSQ0VEqUGcgrN5nmPHW561bKN7b0mj26nlCZ8Go10vlb3p7WrdWLjTypcQ4WnRxnOfKmzckxBOLqa71k9snCbGbeDlXp-ogcUQSlPpQx-ud9miaP6nGlDCPMVCXVHEULiqXd3WUkPPkGm1qaIoWSD9JyUenDwObK-EoCaxyY4tEt9Itb_IMgFmEaA_OnTuLo8PWlY9pU9jUuzCOuQEBoRIkKWfkwitFxzAf0vK7E7rNMHmG0BdFKHyiW_pGg87EdsgJO76PncmJkjeUrKq1E75LTrjTEDIZpU4_ttmPVH4WA6KMEYt18rVijlaXlu4TNL6y2m-_o4uFxCsUb0Wt_H-WiNY7rYVfISIBSQCKC_JNi9zv89Qwp_7GwOGbNOZJVtsadCfgNpRFYtcMQMn2POcIdaMgPrhteb4F9xvJJOUorNSQVWCVeccdSk3PJxIzw01ZWeUSSTyJZx54BeiozPPsBEQQ_UgwSVJQAodSFqot8ou9DLBa0cha1shBgGyD9lzM19_-YppRJ_hnLI711sGNAcB49-IEUq_WAKgd_5x7UuGsHHwQFEDgVb-MRaQVlDALRprTpWI6e2EzOexaKGcAo3dsJ6yl_kgS9G7AuUdH4OHtsUkydOrsSSZPanNFZLaTZ74fxY5O1OjBd44UcxGuyBg
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1369

{
  "id" : "req_5VkK2B3nJje7rYCoIxNMHr",
  "user_id" : "usr_3Noelg3449NynKbAWnQ9bp",
  "assigned_user_id" : "usr_3Noelg3449NynKbAWnQ9bp",
  "status" : "pending",
  "due_date" : "2025-10-31",
  "groups" : [ {
    "ref" : "yHRiq07h2O",
    "label" : "S5LI6LY8RB"
  } ],
  "fields" : [ {
    "group_ref" : "yHRiq07h2O",
    "label" : "USuvfxTScb",
    "value" : "WiM5eSoPeu",
    "options" : [ null ]
  } ],
  "study" : {
    "id" : "sdy_6WxglekfFTHF60bsKnHgh6",
    "project_id" : "pjt_6pByP6DItk5zFekOHusOHC",
    "name" : "vlM1jLMTqw",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "A9ybSJdg8Z",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_5WBFs36xIsJwFQQRCewhYn",
      "name" : "6M5krYMtgt",
      "email" : "xXrbNEzl@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3qO8TGBanhvKg5whBcik65",
      "name" : "Vycai5kkfX",
      "email" : "IACk4mvz@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:51.707648Z",
    "updated_at" : "2025-10-31T11:56:51.707648Z"
  },
  "created_at" : "2025-10-31T11:56:51.856595Z",
  "updated_at" : "2025-10-31T11:56:51.856595Z"
}

List all study requests

Returns a list of your study requests.

Path parameters ./api/public/v1/studies/{studyId}/requests

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of samples to return per page.

page

The page of samples to return.

Request

GET /api/public/v1/studies/sdy_wo3Jf3sMwAHJasDc8m7QV/requests HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwZGEwZjdiMi03MGY3LTQ0ZTYtYjhhNi0yYzNmMGFjZTAyY2YiLCJqdGkiOiI3ZmNjNDE4Ni1hZmNjLTRmYjMtYWU2ZS1lMGU1MzMyZDI1NzAiLCJpYXQiOjE3NjE5MTE4MTEsIm5iZiI6MTc2MTkxMTgxMSwiZXhwIjoxNzYxOTk4MjExLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.eYmHbOCkiuaowzQQgvBzDbbGXLDgkKrsoWv5aKov2ynKz9pbj6nuIJ6CyP2RlyotBxRrmfEOL47nKfOn_S6JKMGchjozPhWMKX8IwfaWvfUEFcI89C0-7eFqc1tu8ohVotDORPpMYttzrD5LEiFZjNPgH9oQQ3tFBqrmYFqv_P7CQKTNHp2R9JWKWeoQAPcazC_HGFjxFd0PZoYlUjPu0kjMO2ermDSbudaRatfkoSHjYqp2oy3YBUe9L5gI4x9ps8CkfcqfrgjB3H9maxzxEB73vStd_nN-FAg9qNF0NQv8MZUqwWLa-kO8ZKnZwcGlF34eJ1pWNSPI2cc-OvMYMG73I1zdtq7H-uHf9jOQn2y_XY7nCWwuZRvt35JhEdHXqCreMOX1h8j5pmtv4E-C5oVUK8Qho2K5OTbT4go_liELu9UDhQGvxokrhlBzXb764kRR3gGxpEmiaXHU2BokcIXzdhDwP5ZkaYV4b3Ee7jMKQuq9LMutk3-0LFrZPmEE77r5zAvBZ8vd1SMgmm6aRDKdDtPydLgsRLStxc4VjiGdFBD-eSAyVlbn4J9bwqmh6WMPOZsFpSCTyFh5PvL9M5XnhrcIU5Tn9ptmO_Nuvht7KmW39PChoDa6fqhHL8yAsf0BWq5i9PPiQvXZZt0ILZFs4J1eJX56y3DI9tMLWpM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1969

{
  "data" : [ {
    "id" : "req_6PJoUAqVG7lSMce9SOdbIc",
    "user_id" : "usr_2MKKshzRqfnvIj6WlGel1p",
    "assigned_user_id" : "usr_2MKKshzRqfnvIj6WlGel1p",
    "status" : "pending",
    "due_date" : "2025-10-31",
    "groups" : [ {
      "ref" : "6inxEnBdW3",
      "label" : "FLE5tIjDy4"
    } ],
    "fields" : [ {
      "group_ref" : "6inxEnBdW3",
      "label" : "NIQBsFvn80",
      "value" : "x5toYvFvr9",
      "options" : [ null ]
    } ],
    "study" : {
      "id" : "sdy_wo3Jf3sMwAHJasDc8m7QV",
      "project_id" : "pjt_1t2KveK4MgXYuvWCN4Hcjl",
      "name" : "w0eRwuwK8r",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "rbJ2TaPGak",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_7VOT5KFOM7iaIMmirMLfYF",
        "name" : "kV62zLArMu",
        "email" : "qYVI3d23@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_6lZz6NGVyKpRQ2ndUyGlIl",
        "name" : "rQ2sz70Rr0",
        "email" : "aKopXeCX@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:51.456492Z",
      "updated_at" : "2025-10-31T11:56:51.456492Z"
    },
    "created_at" : "2025-10-31T11:56:51.599343Z",
    "updated_at" : "2025-10-31T11:56:51.599343Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_wo3Jf3sMwAHJasDc8m7QV/requests?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_wo3Jf3sMwAHJasDc8m7QV/requests?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_wo3Jf3sMwAHJasDc8m7QV/requests",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Request Sample

This is an object representing a sample such as blood or tissue collected from an animal in your facility. You can retrieve it to see the sample identifier, type, status (collected, planned, cancelled), timepoint, details like volume or mass and any metadata assigned.

Retrieve a study request sample

Retrieves the details of an existing study request sample.

Path parameters ./api/public/v1/studies/{studyId}/requests/{requestId}/samples/{sampleId}

Parameter Description

studyId

The unique identifier of the study.

requestId

The unique identifier of the request.

sampleId

The unique identifier of the sample.

Request

GET /api/public/v1/studies/sdy_4DLis9PCgsDM2tE0Q0Ept3/requests/req_n2hCTUUHaObzZsOnAY9Jb/samples/spl_AKPoLRbAPT490UwoerQD2 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxOTAyMmFhOC1hZmUyLTQ2MjEtODhjOC1kYjBhNzZlMjlmODciLCJqdGkiOiI4YjBhOWE5My1lYTM4LTQxZTgtODA2ZS03YWIzY2E2MDkzZDUiLCJpYXQiOjE3NjE5MTE4MTUsIm5iZiI6MTc2MTkxMTgxNSwiZXhwIjoxNzYxOTk4MjE1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Q0hM0ONiSlJnwJkx6buPK0ewk3eJ-NwsDSfZ_7V7szJaC2PJr-OfpkQnYVkNUuS7cl1m94B2GiqY42qez3ls2VEVoXrqVSERMn3jrzZ42N9iri_nte5WIlgvZIxNCdjvW02BgbkqQJjNTBprTXl-n2WTPlnorL0oAUkmgRPCI07UdIfhNA-7zd06EAn_1hIVKe0gW3WUvAnAKJoGKCcGP6WVUOdhS4rqrDOoWbIG2mYfQ1C2_GpkMBvBWRUTWpjfQxpPdtzHxK3C6_DSce2SBcgYJ6I49yvuzKBhTGtXpOHPJ41HmBwcSW_f_pTjDX1ovSAA_VO8ib5zn2SUPlHh4ORrmgqO9ECRJorLr26NKH1XCm-aiIZjdbye6sPRhvDwyAwT5uOINBRYt00xjge6Ci4UUucRpJPYbzc0hJfbol4UM3upHmLx6EiMS0QhlBPmaO02yjueGXX-OopGS6pDQeo12nNhvQ6hpd1F2h9yXrHDNnbRHtvgprqqulK7-FBnrO6GnH3XBxsNb5oza5Dph8LyQsUdIbR_OHMhTQkWkU7rRNPw2cfmeR-peP3TrtmiQdnjv1ZStLOb73ZkzBomBfbgU5qc3e5m-CNdOQgqNyVcWUxbiaKs0k-XKIaZR9YzJTQOtOF-0ZMdaq7rcsgleZh_aH6viAyfus4fyBLcd1c
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2821

{
  "id" : "spl_AKPoLRbAPT490UwoerQD2",
  "sample_id" : "S730182562",
  "type" : "Blood",
  "label" : "BLOOD",
  "status" : "collected",
  "timepoint" : "PT15M",
  "collected_at" : "2025-10-31T13:56:55.788405Z",
  "details" : [ {
    "key" : "volume",
    "unit" : "ml",
    "value" : "5"
  } ],
  "comments" : "A blood sample",
  "metadata" : {
    "sample-internal-id-893331890" : "SMPL-1234"
  },
  "study" : {
    "id" : "sdy_4DLis9PCgsDM2tE0Q0Ept3",
    "project_id" : "pjt_1QA2OtpZP2dXHUmyHihxbR",
    "name" : "GalEK5qglZ",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "jdIfY7U1vV",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_37MVl18VuECpDl6JCygwMg",
      "name" : "X9uLxKR87c",
      "email" : "ZqBbbcPI@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_20SFK8eEmLjUdN6eWTGguK",
      "name" : "BV2IBw0uV1",
      "email" : "jUh9a0uZ@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:55.354224Z",
    "updated_at" : "2025-10-31T11:56:55.354224Z"
  },
  "animal" : {
    "id" : "aml_2cz5SZwcmfLZYg5FUACCiL",
    "study_id" : "sdy_4DLis9PCgsDM2tE0Q0Ept3",
    "study_group_id" : "grp_6gRJnWVjtqj16dYEQGh486",
    "cage_id" : "cge_78RgwpcAWECxXjoZMnCRb1",
    "catalog" : "A0000001",
    "name" : "UiNRQmpBTK",
    "number" : 1,
    "strain" : "xDV75odDSV",
    "species" : "SHjc6TxPy7",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "erHA95m2rb",
    "ear" : "MD7x6mqqu3",
    "tag" : "FndzU7P00D",
    "donor" : "HSXVuVMRHO",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_1510PyYZCxSboctNlcLZv9",
      "name" : "rK6ENzUaKU",
      "email" : "OzHBBy7G@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_3EfxQEQn1mgGQ10DVRFSt4",
      "title" : "Found dead",
      "comment" : "MPUBjYX0qL"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:55.512272Z",
    "updated_at" : "2025-10-31T11:56:55.512272Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_1bxJSoeQb5p61uS1l33sl6",
    "name" : "CIXWSZNFVE",
    "email" : "78oLz1da@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "vUyIHvTiGN" : "BBoTL6jPzw"
    },
    "created_at" : "2025-10-31T11:56:55.780508Z",
    "updated_at" : "2025-10-31T11:56:55.780508Z"
  },
  "created_at" : "2025-10-31T11:56:55.788463Z",
  "updated_at" : "2025-10-31T11:56:55.788463Z"
}

List all study request samples

Returns a list of your study request samples.

Path parameters ./api/public/v1/studies/{studyId}/requests/{requestId}/samples

Parameter Description

studyId

The unique identifier of the study.

requestId

The unique identifier of the request.

Query parameters

Parameter Description

perPage

The number of samples to return per page.

page

The page of samples to return.

sort

Sort samples based on an attribute (animal, cage, date, group sample, study or type).

order

The order in which the samples will be sorted (asc or desc).

metadata

Filter samples to return by metadata value

type

Filter samples to return based on sample type.

Request

GET /api/public/v1/studies/sdy_6iBpQdorrmgZFfbJqECZM1/requests/req_bChtiBCK7jNS1dsCEPhgK/samples HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzNTliZDgzNC1mNDZhLTRkMzYtODAyZC1iMDcxMmYwYzU3ZjgiLCJqdGkiOiJjOTI0MGVjNy0zNzdhLTQ5OTQtYTlmOS00YjhhY2MzOTk2N2UiLCJpYXQiOjE3NjE5MTE4MTUsIm5iZiI6MTc2MTkxMTgxNSwiZXhwIjoxNzYxOTk4MjE1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.XvF4S608pBxAGsSdDUqN-M0miDottQSDRSC9RAaFnZWrRrUNWniZ4RmyatdP0gqhxN9K-Jk2zcrrnMmMvtyYD5Q7yTX91doJUXAxdjYJFax9XXUEQehKjzcuLWh-jXSuhk83xR9TxwvR1ulI5fgHZPlqUf81CIhShVkrpxihL856lP5F_-qUTCi5GwSyG8kNTPIuLaqHeFhdqFs9SvpASzUe2D4aRnl4hYiCy-lNzTylAmfNtKC4sfJV68VVhxWe1jSi-c_XZbjse-j226q3py1C2BZSwmUV0ly34J_ObA5yo5bVj325VuuWLd4CbTrCuC3P5brqZZmuMNlKNtDjELtYG_jMZRnXxNlHfMYf6QVeT56FlGtksQ166Jt1cid_B8m8AXl4X4Yqh-A1wJYExw4AQ_Km0AH3mRywuthRMM2FJuhHnJkN2yV69YpH3FPXkYShNp81gjvnoQtLEbNIGdUQtxMMUqbMKzx9dFkD7-0VzfUGZ2bZMHRXoHAa-7nV8kl0WkByJ5ykPE8p1Wz5f8JmZXK_Qt4ZILlleh15G_AqzsxpViBz0p2VQKQkJ4zuEjKQ0k_pCa-Bp4-OiQF9xQZqOi7z7RQQwM15q6qO7_rVVLdjB0LU7x8enxc2WwiUXYCER1sMOX6bfkwy080k0saI5WFQd43SHjdMJ0meLYY
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3628

{
  "data" : [ {
    "id" : "spl_6m5Manse9wQQiAjYjFr2Iz",
    "sample_id" : "S395980549",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:56:55.244828Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-1970977777" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_6iBpQdorrmgZFfbJqECZM1",
      "project_id" : "pjt_4HY6rMRB4MaPvL2lqfPKsW",
      "name" : "mszCtptbwm",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "PRg70aHa7c",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_3fQwUVAXVIcDI3NqYFcV9a",
        "name" : "RUCplQFWmX",
        "email" : "4SNKI5CW@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_4qvrFrwFPhXMpBvM82jX1D",
        "name" : "iTD2iN1o6h",
        "email" : "YjY5IKta@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:54.813038Z",
      "updated_at" : "2025-10-31T11:56:54.813038Z"
    },
    "animal" : {
      "id" : "aml_6Qh5tUNMOxJ7Oh62fXcPnB",
      "study_id" : "sdy_6iBpQdorrmgZFfbJqECZM1",
      "study_group_id" : "grp_28mdIfFgIgWBduFiaCeTAT",
      "cage_id" : "cge_2S46gnBLYzLBfBYDSiubmp",
      "catalog" : "A0000001",
      "name" : "CrusS29PHa",
      "number" : 1,
      "strain" : "TbcPySKw9b",
      "species" : "Z9zWz1NoWL",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "1PvDV6xdHL",
      "ear" : "Thhfl2Y3q4",
      "tag" : "jQUW7Me9T7",
      "donor" : "v7JYw8UXhJ",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_7iWg9VWYnUdUgXNXYUWcos",
        "name" : "E3YTo3HFbu",
        "email" : "j42UE96F@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_ccwEBC8MJ1sp3GwKdRhew",
        "title" : "Found dead",
        "comment" : "6nbReCmXhw"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:55.101218Z",
      "updated_at" : "2025-10-31T11:56:55.101218Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_5q2Ji7rmFAJQX2aMzQawjX",
      "name" : "vyWexwDXa2",
      "email" : "b9Jpm92G@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "1JmiG20uQF" : "9cDGcYVUCu"
      },
      "created_at" : "2025-10-31T11:56:55.234934Z",
      "updated_at" : "2025-10-31T11:56:55.234934Z"
    },
    "created_at" : "2025-10-31T11:56:55.244872Z",
    "updated_at" : "2025-10-31T11:56:55.244872Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_6iBpQdorrmgZFfbJqECZM1/requests/req_bChtiBCK7jNS1dsCEPhgK/samples?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_6iBpQdorrmgZFfbJqECZM1/requests/req_bChtiBCK7jNS1dsCEPhgK/samples?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_6iBpQdorrmgZFfbJqECZM1/requests/req_bChtiBCK7jNS1dsCEPhgK/samples",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Sample

This is an object representing a sample such as blood or tissue collected from an animal enrolled in a study. You can retrieve it to see the sample identifier, type, details like volume or mass and any metadata assigned.

Retrieve a study sample

Retrieves the details of an existing study sample.

Path parameters ./api/public/v1/studies/{studyId}/samples/{sampleId}

Parameter Description

studyId

The unique identifier of the study.

sampleId

The unique identifier of the sample.

Request

GET /api/public/v1/studies/sdy_5YbP9e2LKBPoksaJuhLr3T/samples/spl_1G9QJHRvKsRk41HVdRGzA HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIwYTg0ZTQ0NC1kYzU1LTQ4M2EtYjc4Mi04ZTQxYzYzODVjYjgiLCJqdGkiOiJiOWNjY2U2ZC1jNWIyLTRmNDMtYWQ0Ny0xMzMzOTNhNDY3YWMiLCJpYXQiOjE3NjE5MTE4MTcsIm5iZiI6MTc2MTkxMTgxNywiZXhwIjoxNzYxOTk4MjE3LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.XCgiaQ90G0PqNN4AXcbcZSIpKP5ohl7X61qzC6FZ3zEPIlObzDxSKdVee1AlfdLYSSsmwFET7mewb8mCPMpdRVFCFpKxfDbQlPE-518rKVBi3UBNJUtehmiY-l6lTSPbz4fYfLon3noDKE_b05XoUu8qKD52J92ty-zJc_TQUGDVyAtL1p6HcOqzPmNY4sZ03gw57inu4ztUv8nsJD3k_HY906xHy1fZJlbbmMuTI0X2ojbXvy8G88AOsBvLka_Kpo3ZG23jJvFovajCSa5gfJoO0wQyxW3PbxU4Je8Y1qKqbk5PEBTJUYxFMRFk0xLsGSzioefuYD1-KAm_mru-qNC0dHvBTl409cKE_y2S40ONHfHKLZc1HZCWUIkkmZws1JVbKrYtiDscSBuCOzpz_bPL9XAf67udXtdw5qoQZP3meE40BfHhi2JsLIMr1IoKIPUqYJ9O54YhfiVDv3U12VVYRPmCvZWhBqUuBjVTn5WofYfqh0AwTyecGooygEDMCpM-S2QUa76HCG8EclVXLL_OOx5h4DU-0W6POOdD6lc5jAeKlXNW7ljK8NUXNfPK6iMJVXsTwHopvfIHWTXP-253P0jro52MvSBxvadPk3TKD35iUTLe-7gPlx7gRRVh75j1Sk--dYi0hWQuKxfRRAGC1NaJkXWu4wARp6KJ1lM
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2820

{
  "id" : "spl_1G9QJHRvKsRk41HVdRGzA",
  "sample_id" : "S691520104",
  "type" : "Blood",
  "label" : "BLOOD",
  "status" : "collected",
  "timepoint" : "PT15M",
  "collected_at" : "2025-10-31T13:56:57.717837Z",
  "details" : [ {
    "key" : "volume",
    "unit" : "ml",
    "value" : "5"
  } ],
  "comments" : "A blood sample",
  "metadata" : {
    "sample-internal-id-1394264040" : "SMPL-1234"
  },
  "study" : {
    "id" : "sdy_5YbP9e2LKBPoksaJuhLr3T",
    "project_id" : "pjt_7EzlD7ogdXUmfOSCuN4aPs",
    "name" : "BBQrdhZA9e",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "4Vh64A4Q5Q",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_1Co0kHp2wpfeKzAgeMtHiT",
      "name" : "ek2KDx6AAl",
      "email" : "cdBnPFyP@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_6lBoeEmtovchNKEBpkEAhZ",
      "name" : "B4iTAKFgfU",
      "email" : "CuWXSJUs@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:56:57.421852Z",
    "updated_at" : "2025-10-31T11:56:57.421852Z"
  },
  "animal" : {
    "id" : "aml_1AbRmYFQhyIQQ1DZA4O250",
    "study_id" : "sdy_5YbP9e2LKBPoksaJuhLr3T",
    "study_group_id" : "grp_7I6CT1aGXXw1BBdc5chTgP",
    "cage_id" : "cge_40VnzyZILNtkE0jeKDoIC",
    "catalog" : "A0000001",
    "name" : "gpTSXOROII",
    "number" : 1,
    "strain" : "koxcXZMTnT",
    "species" : "mAHP3KT144",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "J5eYkx0GVc",
    "ear" : "lS502Uk9wf",
    "tag" : "MguQ2WxS55",
    "donor" : "Q8nHTq76aP",
    "tracking_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_6gHx8ToAnx02Uyg4Bxjnf8",
      "name" : "dWLemQbgJ3",
      "email" : "cGa3vY0x@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_7WFPrHPlHcvi6RYr4TspGu",
      "title" : "Found dead",
      "comment" : "9YHqcy9jDe"
    },
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "created_at" : "2025-10-31T11:56:57.574144Z",
    "updated_at" : "2025-10-31T11:56:57.574144Z",
    "disease_induction_date" : "2025-10-31"
  },
  "user" : {
    "id" : "usr_ltvrdGeffMocpfDRkx5aq",
    "name" : "nczVRObJbv",
    "email" : "lXlWry0h@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "tevOKtPkLg" : "QE4dFfPzSS"
    },
    "created_at" : "2025-10-31T11:56:57.707706Z",
    "updated_at" : "2025-10-31T11:56:57.707706Z"
  },
  "created_at" : "2025-10-31T11:56:57.717879Z",
  "updated_at" : "2025-10-31T11:56:57.717879Z"
}

List all study samples

Returns a list of your study samples.

Path parameters ./api/public/v1/studies/{studyId}/samples

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of samples to return per page.

page

The page of samples to return.

sort

Sort samples based on an attribute (animal, cage, date, group sample, study or type).

order

The order in which the samples will be sorted (asc or desc).

animal_id

Filter samples to return based on animal.

metadata

Filter samples to return by metadata value

type

Filter samples to return based on sample type.

Request

GET /api/public/v1/studies/sdy_dw48Dt3OcAtfzsJeIuK0c/samples HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhZDc2OTY3Ni1jMmE2LTQ3NDktOTYxMS0wN2M2Y2U0OTliNmYiLCJqdGkiOiIyZmExM2JjYi0zN2ZlLTQ4MDQtODg5My1iY2I5NmZiMTUxMzkiLCJpYXQiOjE3NjE5MTE4MTksIm5iZiI6MTc2MTkxMTgxOSwiZXhwIjoxNzYxOTk4MjE5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.Whql9XTsRHSWIneeUzI1cke7H1iLM8bK9pe53tUdu28okO9lojOajpvdC93i5KWYr7aiKQYBWAN11XeIInRHKO3OwAOPZUW_VQRASjtFz1IianhAFqGnYFjXn390r3kPCY2214tzbsZkxuCf1Ier4KgCpo0xXa2jJ3e8Fh5SWkjjU2IShaNQmwQEZsD0dK0zA9Fdpmwekle020dSh05DvR6OkmbqlTDPSmKN9UbF0DrLd4uWlAWZK0bgF6rQHknwd9SrTwNYzUuQPXNOQs8VC7iRY62l01e2A9mAa0ao62NRobZOFMxlyJykg4yE58tP0Sx0IshVUd7QJHOhlBEpC7j_NpnrBxu5D8cxDRvDEVn1skOagN1UCFhdYvewjQOLeY8f4yCts9ERegjf47t7bCBePB677EozIqc0eHQahL8gCRQL15q3tXFxqqcdOpfabJbLfPnJf62I1RSmxNtUQXnlPlhARijC3JKYxKhreiRnBvEYQz9IlZB88Xpb4j3K3XVYDiWOOGGN7JVYT5tWp1IZGOw8OWxZJ4Lv1WN2g8BZU8oI7oe6p81JvMUhymrO42Mfc6BvqgzABAw3p33wNoEjX-d-aE4dDqbc-NJALaxooGX5sp0fIRWbpI3vI3K8Gzo65LzYIW4ZmGi8I5croJdfZC2SpS3O3Z7hSnrKvXE
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 3518

{
  "data" : [ {
    "id" : "spl_5KvHj7frSTnIRlwb434URH",
    "sample_id" : "S736412652",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:56:59.149474Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-617793657" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_dw48Dt3OcAtfzsJeIuK0c",
      "project_id" : "pjt_3ZNM8Myb6Ycty4uEZw0Kfd",
      "name" : "fMGGVsEFob",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "6LjORsg54R",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6Hguu3IWc2o8gfCSBoGuYR",
        "name" : "LnKXJhuxrK",
        "email" : "J7uzz3CV@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5reh3vntOHf6qkpqpBQx87",
        "name" : "O78qHRkLVX",
        "email" : "tdtGIy9d@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:56:58.811008Z",
      "updated_at" : "2025-10-31T11:56:58.811008Z"
    },
    "animal" : {
      "id" : "aml_7YCUPGj5Eggaul2ouuzHVm",
      "study_id" : "sdy_dw48Dt3OcAtfzsJeIuK0c",
      "study_group_id" : "grp_1VC8Mx0adwlUbQl27BcDep",
      "cage_id" : "cge_1VsPiJYLa3GIE5TfaVDEzU",
      "catalog" : "A0000001",
      "name" : "zQJ8xE0unR",
      "number" : 1,
      "strain" : "OV5dYUFqRq",
      "species" : "n2gWwiTbvz",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "ZaPSeWJY2N",
      "ear" : "xwB1LrtVZV",
      "tag" : "dgPGL1wg2E",
      "donor" : "bJqPPS7b6n",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_4bXZHIG1Iu4wN4EQRfrB9S",
        "name" : "oS35chmsAa",
        "email" : "C3fSC7BF@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_6T8y923f9sbxENmNEW67Ed",
        "title" : "Found dead",
        "comment" : "18chDRi9ao"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:56:58.990336Z",
      "updated_at" : "2025-10-31T11:56:58.990336Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3Wb9RHoENc5Ebzs71u9XP6",
      "name" : "OXwX2ZVQWn",
      "email" : "4AiKJEaO@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "niami887ol" : "w42Eqp5pTb"
      },
      "created_at" : "2025-10-31T11:56:59.140511Z",
      "updated_at" : "2025-10-31T11:56:59.140511Z"
    },
    "created_at" : "2025-10-31T11:56:59.149547Z",
    "updated_at" : "2025-10-31T11:56:59.149547Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_dw48Dt3OcAtfzsJeIuK0c/samples?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_dw48Dt3OcAtfzsJeIuK0c/samples?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_dw48Dt3OcAtfzsJeIuK0c/samples",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study Treatment

This is an object representing a treatment entity. You can retrieve it to see the treatment’s attributes.

Attributes

Path Type Description

id

String

The unique identifier of the treatment.

type

String

The name of the treatment type.

name

String

The name of the treatment.

external_entity_id

String

The external identifier of the treatment.

dose

Object

The dose concentration associated with the treatment.

dose_volume

Object

The dose volume associated with the treatment.

stock

Object

The stock concentration associated with the treatment.

volume

Object

The volume of the treatment.

metadata

Object

The metadata associated to the treatment.

study

Object

The study associated with the treatment.

created_at

String

The created timestamp of the treatment.

updated_at

String

The last updated timestamp of the treatment.

Retrieve a study treatment

Retrieves the details of an existing study treatment.

Path parameters ./api/public/v1/studies/{studyId}/treatments/{treatmentId}

Parameter Description

studyId

The unique identifier of the study.

treatmentId

The unique identifier of the treatment.

Request

GET /api/public/v1/studies/sdy_72ePIk0WhqrIZPmOunHGR8/treatments/tmt_2XlBcywu6pScpKTmut5lUj HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI0MWQ3NzgwMi0xM2RiLTRmMTYtYTQyOS02YTVlODA0YmZmZmEiLCJqdGkiOiJjNWQwNTI1MS1jYWM0LTQ0ZDItYTdjOC02NDQyZmU3OGIwMWUiLCJpYXQiOjE3NjE5MTE4MzEsIm5iZiI6MTc2MTkxMTgzMSwiZXhwIjoxNzYxOTk4MjMxLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.IFcukUbK0TBRARXvbkA6aT334k1buUFg9wFlJSLn2zpYAKJmFOYVuJI4zU_Q6kv-8BnnV6b6mFNuMSLe-OR6aSL6Fh64SNltDgMU-7g35cJP0Jv8D9pCN91C-cfsLcylQCiOa2RqQfERHwTn2TPsUzTdhVCePTCB5CyxZUHnUzRRY1Ai5tx3rC86DVUbOgKgYxfjev5UotkGcnHHvBPdXlxuB_O9xHZxthLIvmuOCF9FGvosSEndMRmM2Qi7KQrM8kFhrOqC_qtm4-x2vkypjXXmtHEp2FRT23DV950Z_fhu-LMs12AjETJfIMqwSDytC9Nk9FR3JcdCq28uCQKL7dQuM0hommZTmCvlttM1ZksLQ9Qoi6A3gHC8yY-Wf8q1QtKQNTdocYBSI_OvTGsJf1cEH-u4hnagqJd9K4B--MG3yXfBw-SbkqCUqop61kVdqctZK_bWS9sl3u5LYRZ1XhV4LmsQ8CTW0Qb5wk2Tmx20hmrFfIbnjtKRzUYfYfgbGAZogWIjnf5y0W86nuvL-0TGbVDistlRZw-2KaaBj9cCAWRBaFFIe4hgXRp9yQnVZuxBJ9HIxqFROduFdlPONPGiREkBEwmmHTSnh3NbIcICJmpmR5Gg4Bvb05IiT8__uJncLuUBLy7QjeFC7zrID36GsomjrBgzLHrdRNECUcI
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1634

{
  "id" : "tmt_2XlBcywu6pScpKTmut5lUj",
  "type" : "dose_volume",
  "name" : "Tm1HOJDile",
  "external_entity_id" : "xLE0WPEe2j",
  "dose" : {
    "unit" : "mg/kg",
    "value" : "5",
    "display_unit" : "mg/kg",
    "display_value" : "5"
  },
  "dose_volume" : {
    "unit" : "ml/kg",
    "value" : "15",
    "display_unit" : "ml/kg",
    "display_value" : "15"
  },
  "stock" : {
    "unit" : "mg/ml",
    "value" : "10",
    "display_unit" : "mg/ml",
    "display_value" : "10"
  },
  "volume" : {
    "unit" : "µL",
    "value" : "8",
    "display_unit" : "µL",
    "display_value" : "8"
  },
  "metadata" : {
    "treatment-internal-id" : "TREATMENT-1234"
  },
  "study" : {
    "id" : "sdy_72ePIk0WhqrIZPmOunHGR8",
    "project_id" : "pjt_5wS1vAw4Sz9sGMPSGCSsSk",
    "name" : "bELLkoHumi",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "fWqGfNJ9nX",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_77dZJKc58WHx8ALZhX3mUY",
      "name" : "Yha4TciDnF",
      "email" : "r0CopI5v@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_7Aj59elvyz2efBGe8peexJ",
      "name" : "vWLFRijAz7",
      "email" : "hRx44MEy@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:11.589685Z",
    "updated_at" : "2025-10-31T11:57:11.589685Z"
  },
  "created_at" : "2025-10-31T11:57:11.814422Z",
  "updated_at" : "2025-10-31T11:57:11.814422Z"
}

List all study treatments

Returns a list of your study treatments.

Query parameters

Parameter Description

perPage

The number of measurements to return per page.

page

The page of measurements to return.

metadata

Filter studies to return by metadata value

Request

GET /api/public/v1/studies/sdy_4We9wXHyuyoOEWebihnkK0/treatments HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2ZGQ3NDQ1NS04ZWFhLTQwOTktODg4My0yY2VjMTEzZDA2YjkiLCJqdGkiOiIxMzBjOGE2OS1hNjMzLTQ3NDktYjFkZS0wY2ViMjI1OTliMzUiLCJpYXQiOjE3NjE5MTE4MzEsIm5iZiI6MTc2MTkxMTgzMSwiZXhwIjoxNzYxOTk4MjMxLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.l7i2iZzdcgTgB_jM8Ls53K2DmeSJ0GQBnLKOmnFZ0-yOHQtjYMsN3-RUjcPwdOT8wQFrrsLkKBne4N25sXbyw3qup0Hn_jp8CHnp2otLKrUUOMdQBcs16NLrLfu7EPe48lOy8oxTO7e-UWPfJR5JayR6NpNpxLZwHWp47bSniPwn26x1OenjMaBIu51WUOxuWaP5MyZc3ALiVoXyEFyQA8YBCMATN4eieFSZYU89B5vzkeNj7A3jhiPaQqSS1uWE2KKhZ9cS0E9rm_aINxcAnPSwqC_jtND7OHV7OWYTYh8gBDC9Q02VwWfN8GaYOke4QegbbAMzDG8VSmrVG1o5X5ldtGB5sslKxu2OrEsRyuz1QERqwF4LRRoFBkte-0o1YvxX1QDvmHzNvp75aHrQFL57E-mPNKAAOzw8an_n9REXhnPhIzx0y7Y660AZ9i0AczJStY-gyZCIQe9IZb8mKRNxQy4HhNucBPxKuHQdcS7meWr7chM8DSxGZCWIpqp1ErJRv6UaQd0hRjOkBnBWYziIGqELvvdk98RQohtjgE99KbdVGdKKQdsozz0NF2yOwFveUmwUW2U5sn__HWkEnEHh_6YeXrxXliQNbGokMETvQXZUX7eM4ReVU9X7pmGRWSOD-YaPH30jw8GCpIQTfYk1xnAvDsiyWBjTV6Iy1VY
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 2283

{
  "data" : [ {
    "id" : "tmt_3mzGk6XL7FGx43d23AU7YU",
    "type" : "concentration_mlkg",
    "name" : "IrgldtDsbX",
    "external_entity_id" : "mUvCAGuXci",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "study" : {
      "id" : "sdy_4We9wXHyuyoOEWebihnkK0",
      "project_id" : "pjt_6zKshX6milDtuSmWymqDET",
      "name" : "UnaHDiIASt",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "kZ2FFeWJTc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1XzSxp6ox4BBfdXbX3dRMW",
        "name" : "N9K1lEOQ0N",
        "email" : "WBFdeA3D@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_294I9TuMYzSGZzZmUftNuv",
        "name" : "dBOduIXY9i",
        "email" : "SYyZGHkb@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:11.324860Z",
      "updated_at" : "2025-10-31T11:57:11.324860Z"
    },
    "created_at" : "2025-10-31T11:57:11.554417Z",
    "updated_at" : "2025-10-31T11:57:11.554417Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_4We9wXHyuyoOEWebihnkK0/treatments?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_4We9wXHyuyoOEWebihnkK0/treatments?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_4We9wXHyuyoOEWebihnkK0/treatments",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Study User

This is an object representing a user who has been invited to study. You can retrieve it to see the user’s name, email, access to the study and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the study user.

name

String

The name of the study user.

email

String

The email of the study user.

timezone

String

The timezone of the study user.

type

String

The type of user on the study.

access

String

The permission of the user on the study.

study

Object

The study associated to the study user.

Create a study user

Create a user on the study.

Path parameters ./api/public/v1/studies/{studyId}/users/{userId}

Parameter Description

studyId

The unique identifier of the study.

userId

The unique identifier of the user.

Fields

Path Type Description

access

String

The permission of the user on the study.

Request

POST /api/public/v1/studies/sdy_4S1ipsoXXVJZ5Rtm1oBJgm/users/usr_3R215O17Ynao6ud5WpcOIK HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI2MWE5ZDE1Ni04YmE4LTRiODMtOWRlNS1iNWE2OTlhM2I5MTEiLCJqdGkiOiI5NWUzYjQ1My1mNjFkLTRmZjQtOThlYS1kNTdiMDdiNGM2ZTgiLCJpYXQiOjE3NjE5MTE4MjksIm5iZiI6MTc2MTkxMTgyOSwiZXhwIjoxNzYxOTk4MjI5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.CvpBuQv8aqiO7p_zxLb280j9ZeLJQuvVxpXPi0SRLEiAnnRYRWC3zw9AwtxIZiMTliU8HrqN2K1RWgykZiOOb8fwsJDbgTjCGjA8mw83-GIPO9kSDLSjuydqdD7nu0gI5r8EBjIz673ADMkW0g1elvPK7n_3UfIAoZASWe7f9NeXVDOZvVVttrVH9CUrBBPJO9tI9sV5a45R_rCbv_D1UNCV1xQ5FyBfaGIHnDJwQ3luuUWGKupzN08VifiRdEHESIaxOcjIAcINcVyJEoJOltHu6PJZvkaQt0wd_rceqEvuqDTka5Q6h4kRcAJ_Nln9-WX7HXG6YnHwPp7q-fKNh3FUbqC1kGrqyLYhr3RQRMhGhNWyqqzz_vl4KNXisZM-aAjhuCTpumH_H3zMEXx_t1EBvLs71UIG41KCNPf5baxEmHJn2R3L7UgsPGLbDAM1jW-FckQk7hr3Azodx8HRS0JDlQSpywPAmLmGbZsC0pWuAPBKm2dcmQ3CeWQ9h5wOVQSPOJKikoibhkx4q3GFVAasRjDVPNJpYLA_G3IWf7MdtWYNCbC3iWFXqSj6lJbWYCHls_oFQUNxZXC1qiT7Rz6sCX9tKz5aFPTJs-sMekteFHb_r_Ax3rCQ6H2RkdF_yodAv5UoiOZB_O_QrK0c-lPo6cah_MEkyj_nQwX81Ec
Content-Length: 23
Host: localhost:8080

{
  "access" : "read"
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1034

{
  "id" : "usr_3R215O17Ynao6ud5WpcOIK",
  "name" : "moG1lImgLz",
  "email" : "l9wvpiN0@benchling.com",
  "timezone" : "UTC",
  "type" : "team",
  "access" : "read",
  "study" : {
    "id" : "sdy_4S1ipsoXXVJZ5Rtm1oBJgm",
    "project_id" : "pjt_1A0nxlTll166Soe85TrLNJ",
    "name" : "Yl6c3JPejL",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "daMHu4B0tq",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_59v6jVR90L1gj1oEkEt2dc",
      "name" : "UjP6aFtYEj",
      "email" : "Enw2iX1A@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3l3ZnsqcxS9Ovo0gqgUOsh",
      "name" : "sBPMpK68h2",
      "email" : "jtMVtjt6@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:08.915080Z",
    "updated_at" : "2025-10-31T11:57:08.915080Z"
  }
}

Retrieve a study user

Retrieves the details of an existing study user. You need only supply the unique user identifier that was returned upon study user creation.

Path parameters ./api/public/v1/studies/{studyId}/users/{userId}

Parameter Description

studyId

The unique identifier of the study.

userId

The unique identifier of the study user.

Request

GET /api/public/v1/studies/sdy_3Yiyu4vYG53VF8aGZojxyC/users/usr_6okMrbApkGAcJtmIL9ZkRU HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhYjc3ZWY3ZS1mOThlLTRmOTAtYmRmNy1iYTE4NjQ3MDdmYjAiLCJqdGkiOiJjNDAxMDMwNy1lYWU0LTQ1NWUtODAzZC1iNDhmNzZjNGJlODUiLCJpYXQiOjE3NjE5MTE4MjgsIm5iZiI6MTc2MTkxMTgyOCwiZXhwIjoxNzYxOTk4MjI4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.S8RphbEfiaSMDQ85VYQFe30QlOdr0tELy5N5U0TfLnGU3UR29Qkm1PUXG56hwd0vVDl2p7-uhsvptzaMtXE9pomWQ1nXXTi0rcWWHQkmUtyuPGTVW2ZRR_1IDh-5yhIcg8UnZbqZG3099AWcQEKE-zmTmgxXfytQv42r0_EbVhtsogkT9unZ19MC0ptPYYC1zKmu--ue5Kwuqv_YxsGPkeKxSwQqWTqHDbTt5FLFR_SLTFiU6gF99-Zj4tD0nHQBzMhMG3O79mn7XuMS88Q1u6Z7ptQ2ydSyc7xUhqyXYegSyA2_Ny3m93EvhLH-AkuD6Kh96h4-bt8GdVJn90gSDUZo3SfY_6Al4S8sQP3v8agTC870FMZJxO4_tBMtQNfQjretOPMBsT6hBClKrQEwF-r0tYoBVE5I54MkYT3qj3uH5JKhhkEDFjEE1qLQiJdwgAbcsY1P42IoBf3T5w57vIGmmjGftBCNw22hiNY_n7G7htUlrdgQ-7x_omUoZk9iZnX5NLj97GofcBNjtNZnatzHN5fyd33BvBsZx6o111-KcCwwt9FPAktnzw2hEgCUd8CWAkdGqGJzrAg4JMr21OucpN23P0ssLWAJv7dSR5JbyMhPE-QF5o-v3FNqHWIDnSXfffsMkf62wr95ZuYffync4cySyiYunKCOjtGWgPc
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1037

{
  "id" : "usr_6okMrbApkGAcJtmIL9ZkRU",
  "name" : "Z5oF1u8W9s",
  "email" : "B6bTvlEK@benchling.com",
  "timezone" : "UTC",
  "type" : "author",
  "access" : "write",
  "study" : {
    "id" : "sdy_3Yiyu4vYG53VF8aGZojxyC",
    "project_id" : "pjt_6jnWasCmfiC9YVyRgMD28e",
    "name" : "e3VQnzZAV7",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "tMD2AqcTUw",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_6okMrbApkGAcJtmIL9ZkRU",
      "name" : "Z5oF1u8W9s",
      "email" : "B6bTvlEK@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3FYHVQwscrb1Dr82ri5bTm",
      "name" : "Y1m7vt5RgB",
      "email" : "9RUmwNDk@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:08.197868Z",
    "updated_at" : "2025-10-31T11:57:08.197868Z"
  }
}

Update a study user

Update a user on the study.

Path parameters ./api/public/v1/studies/{studyId}/users/{userId}

Parameter Description

studyId

The unique identifier of the study.

userId

The unique identifier of the user.

Fields

Path Type Description

access

String

The permission of the user on the study.

Request

PATCH /api/public/v1/studies/sdy_1CRWkvfarOtLDO0o1Z5eth/users/usr_6P6c0Wsytv5m4Hp1gcF9Ly HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI3ZjQ0YWVkYy1lOTk5LTRjYmMtYjQyOS1hMjhmMDRjZmNjZjciLCJqdGkiOiJkZWVlNGFmMS0wMTE1LTQ2OGMtODVjMy1jZDlhYTIxZTExNzEiLCJpYXQiOjE3NjE5MTE4MjksIm5iZiI6MTc2MTkxMTgyOSwiZXhwIjoxNzYxOTk4MjI5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.jmnuqUQQLPdnZLTw8c0OXqbtxnQVsq7VK3ApiAc9o2g2JhqXo4dhgNzGrc3elIKxr-FHcFisLm-TxDKsfFZ8Jw8Hmgix2I98MdynN_Ta0rNhRtHH5LOhEraSjytdA9KwbeHlgwPHQpGF8OQcdAMcf2dTq-VVPigqSm5naDStwGUzmOWpaPy53AgyGC8lYdUpUHLBJtxkELxXUzeDS26FLRpr6VncUWkH-9piy2gmtJdsoSUJ8J-eXS5vf0bkOmDEXLhRDuQWnMGr2eiLJAO_zjaItRGtyiTmJu-r2VcnzmClHC-W2o9Q0YmmhKgcbvWOk2_hrLqdD1BVf6lb5IqW13SbAd2cc6xY9zJSvPDeMNDs-5kcyuW81jYORKL7XRubOaA_ekvTYvvkF8-xK7qeCGO6kDtnK2hIKOMDOUsUThKfH396wI7hdEUm1OACNrHYDcyQ1TLqzTkOc164CoK2OWEZ-bNV8IsfIiIeyNWMs9Cwho7mEl5OoHkzZOlasZzNmqOOecdGZlJUzMrJY94eoSkGHuXyIvzjVoXE9KCHLdAyATwc7zm2KzGV7tnZtUcbpK9poJxA_sbKsX8_UOb2vmmAMdxh8DYEOmHRdZYprGubwxXGpSgVrs94xaKX3bq-hlR_qrALeNIzTJQ9gE4lx7a9Ve38iYEQGm9Vw5VISSg
Content-Length: 23
Host: localhost:8080

{
  "access" : "read"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1036

{
  "id" : "usr_6P6c0Wsytv5m4Hp1gcF9Ly",
  "name" : "PlX3jv2XmM",
  "email" : "8v9X2NGk@benchling.com",
  "timezone" : "UTC",
  "type" : "author",
  "access" : "read",
  "study" : {
    "id" : "sdy_1CRWkvfarOtLDO0o1Z5eth",
    "project_id" : "pjt_6gwuSRqdDwSoKCejCUw92o",
    "name" : "MX92xcNuze",
    "code" : "CD-25-445",
    "type" : "internal",
    "started_on" : "2025-10-31",
    "status" : "in_progress",
    "description" : "V7XjoQYJQG",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_1CmZng6LPWmDJurCev3WWB",
      "name" : "7z5bYFcsIn",
      "email" : "f7Ij9uMS@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_6XB3uzLAwjQ2Gv4KgXTxjg",
      "name" : "VoLRS1b5TL",
      "email" : "hgvLtNVy@benchling.com",
      "timezone" : "UTC"
    },
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:09.490316Z",
    "updated_at" : "2025-10-31T11:57:09.490316Z"
  }
}

List all study users

Returns a list of your study users.

Path parameters ./api/public/v1/studies/{studyId}/users

Parameter Description

studyId

The unique identifier of the study.

Query parameters

Parameter Description

perPage

The number of study users to return per page.

page

The page of study users to return.

Request

GET /api/public/v1/studies/sdy_3RlruJkmlqH0XOFw6SwmLf/users HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI1NTJhNDYxNC0xMDRiLTRhYTktODA3Ny05YmZiYjRjZDA2NzYiLCJqdGkiOiI3MDMxMGE0MC03YmM0LTQ5ZDgtODcwNy0wYWUyYWEwN2E4YWMiLCJpYXQiOjE3NjE5MTE4MjgsIm5iZiI6MTc2MTkxMTgyOCwiZXhwIjoxNzYxOTk4MjI4LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.U97pdryJPf_Tp6tAtT_oFtiWsQqyOmVSB0lNOK_j87iwnlrB1l2WA3yUkzri_7mDBpOTUXxMHty43iXgA_5csC-bYOt7oGF_Ypd972y_E3HgOMB1iIGOrQbz0MkuQcbWd634fbfj2KQHu0UB8lGTircXyzSTCtyT2VDKgMczAi6wL6sodz9H4B_tZWEwsAcPTccaVKvflCnA6t7TPzCcJTunqojNXmRZJOH8BuM7rQUZRllEZcqEf68HJX08iYtB68jG5MHzzQRMIHEz5zLGqjK244vlCnQ5SVeQJ7ioWhaAHvwild5hvvh3aKJx4jlTuxHD1uHhq3rno2POUNHhHur35Ko0gSU6eOsGHAXFV7AFOTLUawZREVmaWchx3oqeCgniM_iwP9uk1RXvkZ1Z6F1TmLCkWKuQkWHHBgcrJp4MxI3TpNeFO2CJrVHLJD6UyTE67FjNEiKVHQx6uXXB8u_hAs072vP9-E2RRx5OZ3Jd2TAFVi8_vbpUDt4V5gNB0MFLhlc4ofEhodRrdU7E-sP27UMaXYzWqUavSnQW9oosecsmkwLJ4utud1uQBcCANZa75a6p_CQngSYykbsRRwX6rflvlQyg7ElcQ0tMEWKDkVniZtrNB8_razGFmMVRSmiqEbC-TB8hWy4vtTOVdjWrIsP9KsXT_i5SihSscUA
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 4943

{
  "data" : [ {
    "id" : "usr_1s8AVb15BC50cnNruHFMeO",
    "name" : "r9f24ykDYx",
    "email" : "3ooXwqHL@benchling.com",
    "timezone" : "UTC",
    "type" : "author",
    "access" : "write",
    "study" : {
      "id" : "sdy_3RlruJkmlqH0XOFw6SwmLf",
      "project_id" : "pjt_4rC7n2EYLTZWXsENyUV46g",
      "name" : "piKlVGhEQ9",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "xKxlgQBacc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1s8AVb15BC50cnNruHFMeO",
        "name" : "r9f24ykDYx",
        "email" : "3ooXwqHL@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3TjPFMmED43PdBXXC8XvO3",
        "name" : "UYjwnpe3PB",
        "email" : "LuDENWxr@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:07.878432Z",
      "updated_at" : "2025-10-31T11:57:07.878432Z"
    }
  }, {
    "id" : "usr_3TjPFMmED43PdBXXC8XvO3",
    "name" : "UYjwnpe3PB",
    "email" : "LuDENWxr@benchling.com",
    "timezone" : "UTC",
    "type" : "owner",
    "access" : "write",
    "study" : {
      "id" : "sdy_3RlruJkmlqH0XOFw6SwmLf",
      "project_id" : "pjt_4rC7n2EYLTZWXsENyUV46g",
      "name" : "piKlVGhEQ9",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "xKxlgQBacc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1s8AVb15BC50cnNruHFMeO",
        "name" : "r9f24ykDYx",
        "email" : "3ooXwqHL@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3TjPFMmED43PdBXXC8XvO3",
        "name" : "UYjwnpe3PB",
        "email" : "LuDENWxr@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:07.878432Z",
      "updated_at" : "2025-10-31T11:57:07.878432Z"
    }
  }, {
    "id" : "usr_3ff7seVJM2X9zvh9kCGeXA",
    "name" : "S7oPmkWUPY",
    "email" : "SFKHFr7a@benchling.com",
    "timezone" : "UTC",
    "type" : "team",
    "access" : "read",
    "study" : {
      "id" : "sdy_3RlruJkmlqH0XOFw6SwmLf",
      "project_id" : "pjt_4rC7n2EYLTZWXsENyUV46g",
      "name" : "piKlVGhEQ9",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "xKxlgQBacc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1s8AVb15BC50cnNruHFMeO",
        "name" : "r9f24ykDYx",
        "email" : "3ooXwqHL@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3TjPFMmED43PdBXXC8XvO3",
        "name" : "UYjwnpe3PB",
        "email" : "LuDENWxr@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:07.878432Z",
      "updated_at" : "2025-10-31T11:57:07.878432Z"
    }
  }, {
    "id" : "usr_1rO4nUvNpPhTVlPKrIqvqs",
    "name" : "nlfvdkDeJJ",
    "email" : "Xhwjkz9u@benchling.com",
    "timezone" : "UTC",
    "type" : "team",
    "access" : "write",
    "study" : {
      "id" : "sdy_3RlruJkmlqH0XOFw6SwmLf",
      "project_id" : "pjt_4rC7n2EYLTZWXsENyUV46g",
      "name" : "piKlVGhEQ9",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "xKxlgQBacc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1s8AVb15BC50cnNruHFMeO",
        "name" : "r9f24ykDYx",
        "email" : "3ooXwqHL@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3TjPFMmED43PdBXXC8XvO3",
        "name" : "UYjwnpe3PB",
        "email" : "LuDENWxr@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:07.878432Z",
      "updated_at" : "2025-10-31T11:57:07.878432Z"
    }
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/studies/sdy_3RlruJkmlqH0XOFw6SwmLf/users?page=1",
    "last" : "http://localhost:8080/api/public/v1/studies/sdy_3RlruJkmlqH0XOFw6SwmLf/users?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/studies/sdy_3RlruJkmlqH0XOFw6SwmLf/users",
    "to" : 4,
    "total" : 4,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a study user

Removes a user from the study.

Path parameters ./api/public/v1/studies/{studyId}/users/{userId}

Parameter Description

studyId

The unique identifier of the study.

userId

The unique identifier of the study user.

Request

DELETE /api/public/v1/studies/sdy_6iZdvnNwr1N6leURv6D8Xk/users/usr_3R3UxEco4i9JeQSlkiDMwF HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJmZTQ0NTU1MC0zNTFmLTRkOTYtODk3Mi0xNWE2OGQ0Njg3MjYiLCJqdGkiOiI5MjAwMDk4Yi1lYTU0LTQ5ZTYtOWRhMC0yYzAzZmUzN2Y5NzQiLCJpYXQiOjE3NjE5MTE4MjksIm5iZiI6MTc2MTkxMTgyOSwiZXhwIjoxNzYxOTk4MjI5LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.V1sLSkPqqmVDi8i_cCPSB6yusyiLY18HD3j1temhnUPJT7nxH6gIfjeH5plvjHGThB5_PkFyZ8pJa-1GGORsjdq_swDp6vpVi792iSnEAvIcFZGsxwyVlzFHh9D3jLU7jBQrxefdx1yveriGkD5xYiZdU5uNcGOwSiIa_oDdvz3TvqT9HmZnrFL-6WBqefcwyPg6GquIb5jrNrOI1v_BzlIfgM9qC5_UYUr3dVG59XG5kFOFDXEF6sUbwwLHQwk-l5u04BjKAF9Y-aXXL_EhrD_xc46MxPveDyzHRLnfE1XbGnx8saS06ynC-eyQvmuXWyq6I9EokF_8J2yhAbRQDG2uyyvEyW2bhYQhu22-WRcXGkhGA2Q-6Syy9UekWZxMgpahVtaQLE9dgo8vgqXI6hBHKjBB4ao-_ps5J0azW2vDGGKCmeKpxWH6d_v4zZlWs6FqOxhb3bFUV3p8icIwlMwBtTVbH_KU7ATj8HY43tkPJPWcKFG2k99GFAZm9HuhdxvpWzllEuvdO8Bgeum2Hm66NLrBwUvr7C_-3jtB2MTom_hz8R3Oo3eThquMkvc-seSBBNaVOSygisiGrv8thotfdL4nWtI8nk_ZnbAIM4GJjLL411iRqmCw4bdw8jsZXutDCAzWKFdrnBIFWGZMIGSdyx0zbnFvXDZsahVxA1g
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

Team Glossary Resources

Team Glossary

The team glossary includes the configuration for each glossary item including—sample type, observation and euthanize reason. This includes the details that are collected from a sample or the scoring method of an observation.

Attributes

Path Type Description

id

String

The unique identifier of the team glossary.

title

String

The title the team glossary.

label

String

The label of the team glossary.

group

String

The group associated to the team glossary.

description

String

The description of the team glossary.

type

String

The type of the team glossary.

options

Object

The options of the team glossary.

Update a team glossary item

Updates the specified team glossary by setting the values of the parameters passed.

Path parameters ./api/public/v1/team-glossary/{teamGlossaryId}

Parameter Description

teamGlossaryId

The unique identifier of the team glossary.

Fields

Path Type Description

type

String

The type of the team glossary.

description

String

The description of the team glossary.

options

Object

The options of the team glossary.

Request

PATCH /api/public/v1/team-glossary/tgy_7Q8ZWYJr1Ut9WBLNfBws1t HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhNzU0NDljNy0wNGYxLTQ1NjgtOGNmNS1hYWUyNGM3OWIxOTAiLCJqdGkiOiIxM2E4MzM1Mi0yNzRiLTQzNWMtOTZjNy02Y2UwNzVmY2I2NmYiLCJpYXQiOjE3NjE5MTE3OTUsIm5iZiI6MTc2MTkxMTc5NSwiZXhwIjoxNzYxOTk4MTk1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.jPC7srcHxFzxi6XnK8VNRxV_dosi-MP-_9p8-b6DNCxEUBMPy1BD8UBJMobq1y1uKI0HJlP8RKnRrEFPLUHFl2bL0H0hW7XIdvNRle7eTvjZNWAEAil5mmXJ0fv5w0zEXcdB4SO70G03O32tNV53g5P3o3WaN_VWebAg7H3tUVjgxSjxwyAMwiN-JLoS4l6iaRnp0Ub7hArMiCi6glhiRDcBoBG92qQRxwFSiSSMC5_RHilDmMKU38KsUejNRjPGX_0dSSEhHtbmD11QLLczDQarG4ARCbIL7hxneZUeEfbRzEhg0BRLTSRhJ68tnIoKEfpgRAidYCoCKXTf_0ucZtZiS0aANJkXlxI8V1muKsIa3XWPD3O682-nYVPOVrDehb8x0kMvHEwaTuHc0P_5Jh65ekBgTgBLhy80eaa34w5zSb1Vs3RYkW9SuBJJSgWIpf7A28Twk2YGjNZyMlqUE0XzvZLH2BY7MFECqbGyCLmr-aWIE861zPq27DPAsHVqIlkYZoFzWguIgWHeW2Yz21Ea-UKkhM2qw9T2ViJb6R-RK7D0kHfKwQANd-Jx_1KSX0fJNacMih6Gi-Tq0EAEMYIx-KrrdCAy9F9UX_IK9eyqd6jywXhITlcHw6eHkSQacYjZ-1MBb6jkS2Woyi8OgTDAd-wlrOlWISS6pdIknCw
Content-Length: 112
Host: localhost:8080

{
  "description" : "1 = it is ok",
  "type" : "numeric",
  "options" : {
    "min" : "1",
    "max" : "6"
  }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 227

{
  "id" : "tgy_7Q8ZWYJr1Ut9WBLNfBws1t",
  "title" : "Coat condition",
  "label" : null,
  "group" : "observations",
  "description" : "1 = it is ok",
  "type" : "numeric",
  "options" : {
    "min" : "1",
    "max" : "6"
  }
}

List all team glossary items

Returns a list of your team glossary.

Query parameters

Parameter Description

perPage

The number of team glossaries to return per page.

page

The page of team glossaries to return.

type

Filter team glossaries by type

Request

GET /api/public/v1/team-glossary HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJjY2U4ZWQ2MS0xYTBlLTQ5NWMtODEyMC01ZWEwN2Y5MmNmY2QiLCJqdGkiOiIyY2QzOGUzMy00OGZkLTQ3YzQtYTJlMC1iMDY3MTUzNTNiMzkiLCJpYXQiOjE3NjE5MTE3OTUsIm5iZiI6MTc2MTkxMTc5NSwiZXhwIjoxNzYxOTk4MTk1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.gypZAE_F_3gvd62gh1hVuLxTaIEbU_qGTS0-kYzy6JLr65gMkjvQjnhJeraDs9fhJg9GLUlQD6Gb2xqOIyATsSwaTriC9HfzZYNUdbPfk9jOSs14qSakXwjip6wBJJQiHBm08H10NbGsbCaZldp3cfAxHrRzZs4Sb68miH30B4wp44Y2t8Ya0OJ9JuiFAPD9z30bBhHyRrz3ZiBEuqxtDJOt8K_xLVWUJAketMHNMHExj8X0Y41xQnF5YGfDkl4ADer9ZrC9F5yWRn0NyRhRI9X0i75G6KffUGFl5XhOl8bVb5YX95Bj7ImU1pG-BR8sPfr3WOAwYAmFnTsfaUAwVlxKTz3fb55t2YakDgf8ymEHgpQU2MayfNjf0RVdV2WLB0iPQqOKyKxplg_r8RC-g2U7n97tXc_iScDYLb2J9aGDJPhrvZtitmJOYcc8dRAoG1-GmsoIoTPJsjM3VUYnuuW29PYOMgITHVPvTPQYtVW17RXIRfsrubTpc2kPxSAzCxGjFBwTw2nmUF4JQ6JDyAMCgYldc0drND539Nevq-gIQgpMt46qtFPQ4Uqrdha9mWhnSoIBbKEfVpbMOVcz3V9O__bFO_dNDpViortFg6VM4CDeKvVQxNDCJhDLApb_nZLxn0iL4_LHGxpDkvnE8ejhtIIvB0P_tlqvwY24P0w
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 667

{
  "data" : [ {
    "id" : "tgy_3wBmCVEoZkmZYbkXpzKHiU",
    "title" : "Coat condition",
    "label" : null,
    "group" : "observations",
    "description" : "0 = it is ok",
    "type" : "numeric",
    "options" : {
      "min" : "0",
      "max" : "6"
    }
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/team-glossary?page=1",
    "last" : "http://localhost:8080/api/public/v1/team-glossary?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/team-glossary",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Delete a team glossary item

Delete a team glossary item.

Path parameters ./api/public/v1/team-glossary/{teamGlossaryId}

Parameter Description

teamGlossaryId

The unique identifier of the team glossary.

Request

DELETE /api/public/v1/team-glossary/tgy_lyHTySCdfBQS5JFQ3pJ3c HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI5MDYwNWU0OC1mMmFjLTQ1ZTAtOGEyMy1kZDI5YmYyMzBlOTciLCJqdGkiOiJkY2Y3ZDQxOS01M2YyLTRmNTEtOGUxYi0wODIyNDUwNWMzMTgiLCJpYXQiOjE3NjE5MTE3OTUsIm5iZiI6MTc2MTkxMTc5NSwiZXhwIjoxNzYxOTk4MTk1LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.iPCI-FZ0yIkzpeq6dJqDR-XnOvne-fGJkgx2qtIf1l4wuyFY7eg91szK3BB8yOypkl0chCJcC5ed5ZpDc5sMEBL6HrK-G-xhHPy4XgRi8OU6Pu9SfjPXEl-Fcm5KanZ-YPNTmT5P0GdpoaYaxNSEyylGgYG01nppcT7EZqc6IjCpG5kDhSnwe5xcagr3-U5yyJZ54aikhFapHOkykGrol5NmSTxHW0csT0HVs_QkfSw-btf_p5ygQ0xeUDzyd0Upl0lLHtMecejrVeQyQrsDXi1wdo4ItWoKk0wTft1v2G4E0gxnnq3Tan11MkdYEaP20cTL48aTMX4ulmhbpOMJxY9e8DDokG3B8qen5nnMdsOlqA5_ooDhnrGGAwRx_xkLqoY9xqDw8KbfktSIYOn1Bjzroyk9u-9zLZaWYXqRaKX62p6eb91x9yqMiWU2CBxhrj-nrae3hfEaXrsGYdiAPopGUU4TAZy0FbXvE9ebS8opOUuKP34Uv4vXTkeRkAELN50BFx-ae5bDkw9sy_cqdD33t8sJGA0zX9yoGE3DNkKxpd2i5ZCyPFDlU0sPAxNRDvfbY9KvUQuJ6Dd6YAfPJkOnMmYobCcULmNxIWmUS8ttHU_u5oQ6OPC399-hf7P0sNKe5qwDd4FoFF8rhO2QRZHFex16YVe2aBCx3iYmpUE
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 22

{
  "deleted" : true
}

User Resources

User

This is an object representing a user who has been invited to your team. You can retrieve it to see the user’s name, email, account status and any metadata assigned.

Attributes

Path Type Description

id

String

The unique identifier of the user.

name

String

The name of the user.

email

String

The email of the user.

timezone

String

The timezone of the user.

status

String

The team status of the user.

metadata

Object

The metadata associated to the user.

created_at

String

The created timestamp of the user.

updated_at

String

The last updated timestamp of the user.

Create a user

Fields

Path Type Description

name

String

The name of the user.

email

String

The email of the user.

timezone

String

The timezone of the user.

metadata

Object

The metadata to be associated the user.

Request

POST /api/public/v1/users HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI5NzZhYzY2Zi0yMzU2LTQ3ZjAtYmNmZC0zNTU4N2YyZTIxOGIiLCJqdGkiOiI4NjBiNmZlMy1hZDZjLTQ1MzAtODIwYS1kYmU0YmNlNWY5MmEiLCJpYXQiOjE3NjE5MTE4MzMsIm5iZiI6MTc2MTkxMTgzMywiZXhwIjoxNzYxOTk4MjMzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.FCO8ENpbW9tbjwU8LMNgjAS7C4LXd0qQOeov4v-qV4nv4zO3EOGb8U-pIBehc5ITFFXpR3qRTeoZ7_dr6l6WM3TuUBj7eeFXClOXOb-NUA3kVcYaxyA00JD1MIKdUiW5ToBbsDTYZZUWhZnxv-_KH1dZYlCVbHUwMWVFSWcfcLufwYGpoCn0JxzrxZyHCyk2tzgFRHePHakLMYdY4jMxJR2Ad9N8b_MxvOnbzEi25F-dnnnkb_zGD7qgcgari5vTU4yeTwUTBUZc11xRxrmrRpOUBwt-6Jqbw2zqyM7qnpO9roQqy6BCZiUf6Z4ghORtKSFwBp0XdrUa6DP_o-XrKLuxIidJ5OE9_9ToZ0zR-xnMuW_h_byEQV9E46kpkBl84-N2ROe-k0FtyoNIy0hHn7VIa3kKrBslNMeAYhEaSe5MwUdBAN-8TJ1Ub0ozqHEmb88RvYaxjUFFrwOjKLqVEGKWbMOTgsosFXzG2FCFQeLKhdv9OgIKQUfzuKrQy8dNqauZENDHTEWyl5mWyzDVvCBeDZ4tzr5DMf0fT5FwYJ4QxMY53q1CX7mSYZLYLgIBpiH17oJl-_ASbl2erracbDX_fdypnyqUkfF-6wahkc45okx8n5OtlgXkT_kGuvn2sMfvfwaUs8rdat71nmp_zJ7mGhFpt2ZZsr6-c6LNni0
Content-Length: 146
Host: localhost:8080

{
  "name" : "pI5Vdk2VxQ",
  "email" : "qdiSOstq@benchling.com",
  "timezone" : "UTC",
  "metadata" : {
    "user-internal-id" : "USER-1234"
  }
}

Response

HTTP/1.1 201 Created
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 305

{
  "id" : "usr_6yU9Lkj0f6m2nb8N5EL8WF",
  "name" : "pI5Vdk2VxQ",
  "email" : "qdiSOstq@benchling.com",
  "timezone" : "UTC",
  "status" : "pending",
  "metadata" : {
    "user-internal-id" : "USER-1234"
  },
  "created_at" : "2025-10-31T11:57:13.385905Z",
  "updated_at" : "2025-10-31T11:57:13.385905Z"
}

Retrieve a user

Retrieves the details of an existing user. You need only supply the unique user identifier that was returned upon user creation.

Path parameters ./api/public/v1/users/{userId}

Parameter Description

userId

The unique identifier of the user.

Request

GET /api/public/v1/users/usr_5ZAWRXmXjkqGwkWx8rAyXp HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyODRlNGRjYi0yNDYxLTQ5YjItYWJhMy04ZGVmYzMyMWVkZmIiLCJqdGkiOiI4MGVhMDg2ZS1lMWZiLTQ1MjUtODcxZC0zZTQxNTNkYTc4MzQiLCJpYXQiOjE3NjE5MTE4MzQsIm5iZiI6MTc2MTkxMTgzNCwiZXhwIjoxNzYxOTk4MjM0LCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.WaO65LpVAxlfM6YS2-yon0G8Z5SroKXF4mhDzyZUV8Fv-4TRl5WjLdjiXIUTXsd2AwSGIllCqDoxUlJTY_Ehl-8QZq628EqWQ7AA2t7F4aZm60DoXZNePU4sqtrT5WhMegCvOA10UkoydVz_dr5AyHpqjP5jj_tBeUMIhPeUDeN1trxQkZwWVIGCf0XmKbQ4QxNMl4ixb5oiBjMlc-E1espURb7hs4wwytOQN1r-1Xk3OsZzG67lZTedlkwDVz1kFS48Xu74i1vGsA93Y8dxZrIavkaaU6GbFh0KzxMkYyH7PGOND9PfqTCUO_LVLovDA-dTEDOxWi1MGqAKhN6rpUErlv-VGcqplISYol8C_4StgLTpbAOg3sRNGh0Pg2ur8CH2yHpHsANUwXhe6JjhUqRAPciZ8yvOP-Gspntxe360DE54WqnN6P_w8cBsRB6UBKTP6kvrMAjc78xqEY6TEyIfmWWuVc7rNLATQ7ytTNL2xR8pOHMf2-Hzdqc7iTDpwVltBkwKCnj1tTI55Ikd7nSK2KVA3USAgNX9mdiaxAcl-WcTU41zXbB4j5VsizCdGTztmhfQiaKJj36mGdlr1uzdAFWs_qUT1w_gFKNsG7ZRmRsDiqNZQCvKM-x5h5mySqoPIkb2olMCQJSAQpwtflJUVOYoytInWnyUl1wmjOs
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 309

{
  "id" : "usr_5ZAWRXmXjkqGwkWx8rAyXp",
  "name" : "aDfG2 Overwatch",
  "email" : "1Xinvwro@benchling.com",
  "timezone" : "UTC",
  "status" : "active",
  "metadata" : {
    "user-internal-id" : "USER-1234"
  },
  "created_at" : "2025-10-31T11:57:14.087595Z",
  "updated_at" : "2025-10-31T11:57:14.087595Z"
}

Update a user

Updates the specified user by setting the values of the parameters passed.

Path parameters ./api/public/v1/users/{userId}

Parameter Description

userId

The unique identifier of the user.

Fields

Path Type Description

name

String

The name of the user.

timezone

String

The timezone of the user.

status

String

The team status of the user.

metadata

Object

The metadata to be associated the user.

Request

PATCH /api/public/v1/users/usr_3RuSVGXRIEwDxLt0mPsPy4 HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIyZTRmODYwYy0wOTQ4LTQxOGMtOWJhZS01ZGQzYjZlNzU4N2UiLCJqdGkiOiJkZjdjMzNkNC00M2I0LTQxNGUtYjQ2NC1lM2YwNjQ1ZWVkMzkiLCJpYXQiOjE3NjE5MTE4MzMsIm5iZiI6MTc2MTkxMTgzMywiZXhwIjoxNzYxOTk4MjMzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.dzKt48rW6EwHPO_Sw-N8nxfv64aWYgjEOube28zabT0aIJTr5_nu2sHrK8NbrBhWcLEv-LYwIM8aONQL3tdSwSmnLu3dt7AB_Jxl3V4A0t4ZJDdgxxYw39OYmCemXlqINRrr7XFTI4sZEtgg1fPgHe2tRL5cBBoyDWBcFsSJb2-fQOZWtZCLfa76rcHRhRAwV7qI0Hk8sxlRx8RTjt-zq567gUiyUf_A0PYJUF3FP2n9tMh20norhR79zNzveG6BZiFrbYZYH7fYvJG-UUJyI6WrdAN2FX87kX3Nw2WBMS3gPxelncUU0NhdM7Qy-2KQn4Hkqx-ZHw0ZWp94ccApWlkA4jbeRciCWIrQs3Y1K0o6S9ly-H6PINsv11XaHonOsslTHkv5MrgZCyJNvASKAghTI0P11Fa9LH5Nrje0C10j0FSL1QTuvEih8kh77V16-qDq3VdVD9QbwYrMXi7IHYaEYlXk_Uxd5LfkyH9njHNEptnrjQJdZR5MumdX73truUSALso6w8GtM0ZLIl1OEwRv0DP7XAWaz8ZPFOf7uzZD3RVipT2wPBI3edbpStWOlX4x5GjffwCEqTTdgTiA1r-wjJmGpBvbOOizXuXTedoS1ZDQpbcIXDoQLxvfnn5bcECqIJMO9DiiMjb-xnFF1mhns9DEjT8GftLOMLOAE60
Content-Length: 150
Host: localhost:8080

{
  "name" : "Benchling In Vivo",
  "timezone" : "Europe/London",
  "status" : "inactive",
  "metadata" : {
    "user-internal-id" : "USER-4321"
  }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 323

{
  "id" : "usr_3RuSVGXRIEwDxLt0mPsPy4",
  "name" : "Benchling In Vivo",
  "email" : "CstKKKc3@benchling.com",
  "timezone" : "Europe/London",
  "status" : "inactive",
  "metadata" : {
    "user-internal-id" : "USER-4321"
  },
  "created_at" : "2025-10-31T11:57:10.826487Z",
  "updated_at" : "2025-10-31T11:57:13.838082Z"
}

List all users

Returns a list of your users.

Query parameters

Parameter Description

perPage

The number of users to return per page.

page

The page of users to return.

name

Filter users to return by name

email

Filter users to return by email

metadata

Filter users to return by metadata value

Request

GET /api/public/v1/users HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIzNmJjMTJlYy1kOWFhLTRhYTgtOWE2NC0xZmM2NmFjZmJjOGIiLCJqdGkiOiIxNGZmOTVhMy1mMzZiLTQ3ZDUtYjdmZS1hNmY2ZWNmZTZlYjkiLCJpYXQiOjE3NjE5MTE4MzMsIm5iZiI6MTc2MTkxMTgzMywiZXhwIjoxNzYxOTk4MjMzLCJzdWIiOiIiLCJzY29wZXMiOlsiKiJdfQ.ZLIepRBGWmjWrZWU5DLiFyWFiIyUs7103SjPIcSXTHYfOSBoI0ixFHtaNbzkn1U-ticfUpMqZLAg4fMf08DORaElEcnJ9Xixw2llTRHd0jXNcrzfZATHjd9XoRQ749-1URbRrHpU2qz9M2C-MX7nhmkIWI5soo9OKVkO-zQ0R99g_hyAWV_nKctLiRQy4iUIHbNX7HzT2_EBYhtJb8tKXFt-oAQMAgk-4sXmqTDyrp03MC7RyRMerYX72XzpgIbniL_nqpEDJPTY-5xxox4Th49-tb4BWezphZND7XJydYnkCs21WA8S3SJKrf77qAzDqnDgnz7JqIwyypn8e4ObeivE2qdaomYv_PyOusH3K_3HaYY3BJjv1ohDsdTTcgu3SE17DvzWKGtruRxQBsozlZiGgHYDfhDOXQ950xFbNSONFScDNzseIa-4ToS9QRULV8kc_neHTYgMgVgG77CubF2s-EpOMl9FgnOS--EQj5frDPwY7dgZO_FjuuR2JLdgvRwj6Q0vbKv8icHOI4B2S2ZZt6GPmkwIkOSU6wv7M8XvuIob8tOhXCsLGW7qUyYaMIhmEYrHjHOvn1jYDhHSXIHAL1mEX3hPny1Ad5tT2SPON3EjUHLDX7NZjJcmWQDpXcz--nCqiHv1LAss5qDCv-arZTQ5r-bZ1ipi0j-Tg0g
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 725

{
  "data" : [ {
    "id" : "usr_22ZEqBmDMdG2R9EZjioP9M",
    "name" : "0J0UF Overwatch",
    "email" : "tz4B9rm2@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:57:13.462174Z",
    "updated_at" : "2025-10-31T11:57:13.462174Z"
  } ],
  "links" : {
    "first" : "http://localhost:8080/api/public/v1/users?page=1",
    "last" : "http://localhost:8080/api/public/v1/users?page=1",
    "prev" : null,
    "next" : null
  },
  "meta" : {
    "from" : 1,
    "path" : "http://localhost:8080/api/public/v1/users",
    "to" : 1,
    "total" : 1,
    "current_page" : 1,
    "last_page" : 1,
    "per_page" : 10
  }
}

Webhooks

Listen for events on your team so your integration can automatically trigger reactions.

Attributes

Path Type Description

id

String

The unique identifier of the webhook event.

client_id

String

The client ID of the API key that triggered the webhook event.

event

String

The name of the webhook event.

version

String

The version of the webhook event.

created_at

String

The created timestamp of the webhook event.

payload

Object

The payload data associated to the webhook event.

Animal

animal.created

Triggered when an animal is created.

{
  "id" : "whe_537599PONuhI4xhMIwvABB",
  "client_id" : "75562fb7-9579-4115-a464-1eb752e5a0eb",
  "event" : "animal.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.689740Z",
  "payload" : {
    "id" : "aml_1LBn9A5UzxtVc9I1ivG7v5",
    "catalog" : "A0000001",
    "name" : "gZISlRGGiL",
    "number" : 1,
    "strain" : "Y6JnFWOqaF",
    "species" : "oQRxfHJ0N3",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "Ws05zcEjCI",
    "ear" : "l8ZK4sgj2q",
    "tag" : "N77PefA33A",
    "donor" : "OBC3wSMeOS",
    "tracking_date" : "2025-10-31",
    "disease_induction_date" : "2025-10-31",
    "terminated_at" : null,
    "terminated_by" : null,
    "terminated_reason" : null,
    "disease_survivor" : null,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "study" : {
      "id" : "sdy_gjMSCShisv4ATQcHzfLFi",
      "project_id" : "pjt_21xgjlwaJRBZcpieTfClpA",
      "name" : "gq9AvrMuzk",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "jPNPKkOcN4",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_4tTJSaM3CSFhw7HpMtW2fc",
        "name" : "esdF3olB8d",
        "email" : "kM1aoBf9@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_262HpYb6AI2EG4iqm84aH4",
        "name" : "w4d0Wy7DNI",
        "email" : "sCSoh1lq@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.502244Z",
      "updated_at" : "2025-10-31T11:57:17.502244Z"
    },
    "study_group" : {
      "id" : "grp_14rqv0nAXpQESqi1vZ2jLs",
      "study_id" : "sdy_gjMSCShisv4ATQcHzfLFi",
      "name" : "EBr4YZEVjG",
      "no" : 500675159,
      "color" : "n72d23Con8",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:57:17.668618Z",
      "updated_at" : "2025-10-31T11:57:17.668618Z"
    },
    "cage" : {
      "id" : "cge_hOpHlETeHPUk6jggrCCMe",
      "study_id" : "sdy_gjMSCShisv4ATQcHzfLFi",
      "name" : "FL3RTqYUFP",
      "catalog" : "C0000001",
      "metadata" : {
        "cage-internal-id" : "CAGE-1234"
      },
      "created_at" : "2025-10-31T11:57:17.657231Z",
      "updated_at" : "2025-10-31T11:57:17.657231Z"
    },
    "created_at" : "2025-10-31T11:57:17.672304Z",
    "updated_at" : "2025-10-31T11:57:17.672304Z"
  }
}

animal.updated

Triggered when an animal is updated.

{
  "id" : "whe_6GvEvgFPc7IGaRoCTGb8Vn",
  "client_id" : "31ae57f1-be44-4c32-9486-a75fd9fd70cd",
  "event" : "animal.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.492536Z",
  "payload" : {
    "id" : "aml_6wWdfA9PYszdkmtP3TU567",
    "catalog" : "A0000001",
    "name" : "rm8dQGWiyl",
    "number" : 1,
    "strain" : "cOm9WjCm5b",
    "species" : "oWYdzGz5fe",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "lPDtjUTKHE",
    "ear" : "pwg5OmmBIY",
    "tag" : "aG8jmmklOd",
    "donor" : "iuK9qX5oUU",
    "tracking_date" : "2025-10-31",
    "disease_induction_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_41t353mZwUqcJqttHmHvt9",
      "name" : "8xN9vwvKmE",
      "email" : "Khs5jvjj@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_b30uf8DYvVCHLeRoeooSi",
      "title" : "Found dead",
      "comment" : "TlX7wvh9fM"
    },
    "disease_survivor" : false,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "study" : {
      "id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "project_id" : "pjt_1xoaahRmkjC3aHKub1C7g6",
      "name" : "43VVy43JiF",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "Nm5VszpORc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1fqmbMgr0U1ZMrikugOQAo",
        "name" : "fRBr22FyDi",
        "email" : "LyNkEe35@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_31upVpHhwINHyjpQ8SV9KW",
        "name" : "dyemNwcHVG",
        "email" : "rUH3yjl2@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.251560Z",
      "updated_at" : "2025-10-31T11:57:15.251560Z"
    },
    "study_group" : {
      "id" : "grp_65VJMy90bAMyger9P7Iikv",
      "study_id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "name" : "NPMflPDgbs",
      "no" : 1399188590,
      "color" : "vqEz7Yezrv",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:57:15.402926Z",
      "updated_at" : "2025-10-31T11:57:15.402926Z"
    },
    "cage" : {
      "id" : "cge_7iYGjNfF577sth8MS8XUQK",
      "study_id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "name" : "4j91myOu6O",
      "catalog" : "C0000001",
      "metadata" : {
        "cage-internal-id" : "CAGE-1234"
      },
      "created_at" : "2025-10-31T11:57:15.395806Z",
      "updated_at" : "2025-10-31T11:57:15.395806Z"
    },
    "created_at" : "2025-10-31T11:57:15.405790Z",
    "updated_at" : "2025-10-31T11:57:15.405790Z"
  }
}

animal.deleted

Triggered when an animal is deleted.

{
  "id" : "whe_5B9QzQzqLFNwRE3x7QDoTG",
  "client_id" : "6cfad7cf-b3c3-490d-a569-9d43301c6678",
  "event" : "animal.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.493892Z",
  "payload" : {
    "id" : "aml_6wWdfA9PYszdkmtP3TU567",
    "catalog" : "A0000001",
    "name" : "rm8dQGWiyl",
    "number" : 1,
    "strain" : "cOm9WjCm5b",
    "species" : "oWYdzGz5fe",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "lPDtjUTKHE",
    "ear" : "pwg5OmmBIY",
    "tag" : "aG8jmmklOd",
    "donor" : "iuK9qX5oUU",
    "tracking_date" : "2025-10-31",
    "disease_induction_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_41t353mZwUqcJqttHmHvt9",
      "name" : "8xN9vwvKmE",
      "email" : "Khs5jvjj@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_b30uf8DYvVCHLeRoeooSi",
      "title" : "Found dead",
      "comment" : "TlX7wvh9fM"
    },
    "disease_survivor" : false,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "study" : {
      "id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "project_id" : "pjt_1xoaahRmkjC3aHKub1C7g6",
      "name" : "43VVy43JiF",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "Nm5VszpORc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1fqmbMgr0U1ZMrikugOQAo",
        "name" : "fRBr22FyDi",
        "email" : "LyNkEe35@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_31upVpHhwINHyjpQ8SV9KW",
        "name" : "dyemNwcHVG",
        "email" : "rUH3yjl2@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.251560Z",
      "updated_at" : "2025-10-31T11:57:15.251560Z"
    },
    "study_group" : {
      "id" : "grp_65VJMy90bAMyger9P7Iikv",
      "study_id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "name" : "NPMflPDgbs",
      "no" : 1399188590,
      "color" : "vqEz7Yezrv",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:57:15.402926Z",
      "updated_at" : "2025-10-31T11:57:15.402926Z"
    },
    "cage" : {
      "id" : "cge_7iYGjNfF577sth8MS8XUQK",
      "study_id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "name" : "4j91myOu6O",
      "catalog" : "C0000001",
      "metadata" : {
        "cage-internal-id" : "CAGE-1234"
      },
      "created_at" : "2025-10-31T11:57:15.395806Z",
      "updated_at" : "2025-10-31T11:57:15.395806Z"
    },
    "created_at" : "2025-10-31T11:57:15.405790Z",
    "updated_at" : "2025-10-31T11:57:15.405790Z"
  }
}

animal.metadata.updated

Triggered when an animal metadata is updated.

{
  "id" : "whe_2g4PrxW5ecNkQR8TlDK0rQ",
  "client_id" : "8197160c-6254-4f6d-bfce-6cf4ad51a524",
  "event" : "animal.metadata.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.494643Z",
  "payload" : {
    "id" : "aml_6wWdfA9PYszdkmtP3TU567",
    "catalog" : "A0000001",
    "name" : "rm8dQGWiyl",
    "number" : 1,
    "strain" : "cOm9WjCm5b",
    "species" : "oWYdzGz5fe",
    "sex" : "m",
    "dob" : "2025-10-30",
    "tail" : "lPDtjUTKHE",
    "ear" : "pwg5OmmBIY",
    "tag" : "aG8jmmklOd",
    "donor" : "iuK9qX5oUU",
    "tracking_date" : "2025-10-31",
    "disease_induction_date" : "2025-10-31",
    "terminated_at" : "2025-10-31",
    "terminated_by" : {
      "id" : "usr_41t353mZwUqcJqttHmHvt9",
      "name" : "8xN9vwvKmE",
      "email" : "Khs5jvjj@benchling.com",
      "timezone" : "UTC"
    },
    "terminated_reason" : {
      "glossary_id" : "gly_b30uf8DYvVCHLeRoeooSi",
      "title" : "Found dead",
      "comment" : "TlX7wvh9fM"
    },
    "disease_survivor" : false,
    "metadata" : {
      "animal-internal-id" : "ANIMAL-1234"
    },
    "study" : {
      "id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "project_id" : "pjt_1xoaahRmkjC3aHKub1C7g6",
      "name" : "43VVy43JiF",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "Nm5VszpORc",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_1fqmbMgr0U1ZMrikugOQAo",
        "name" : "fRBr22FyDi",
        "email" : "LyNkEe35@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_31upVpHhwINHyjpQ8SV9KW",
        "name" : "dyemNwcHVG",
        "email" : "rUH3yjl2@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.251560Z",
      "updated_at" : "2025-10-31T11:57:15.251560Z"
    },
    "study_group" : {
      "id" : "grp_65VJMy90bAMyger9P7Iikv",
      "study_id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "name" : "NPMflPDgbs",
      "no" : 1399188590,
      "color" : "vqEz7Yezrv",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-internal-id" : "GROUP-1234"
      },
      "created_at" : "2025-10-31T11:57:15.402926Z",
      "updated_at" : "2025-10-31T11:57:15.402926Z"
    },
    "cage" : {
      "id" : "cge_7iYGjNfF577sth8MS8XUQK",
      "study_id" : "sdy_2wxiDyMoUsF43rPfOgljNA",
      "name" : "4j91myOu6O",
      "catalog" : "C0000001",
      "metadata" : {
        "cage-internal-id" : "CAGE-1234"
      },
      "created_at" : "2025-10-31T11:57:15.395806Z",
      "updated_at" : "2025-10-31T11:57:15.395806Z"
    },
    "created_at" : "2025-10-31T11:57:15.405790Z",
    "updated_at" : "2025-10-31T11:57:15.405790Z"
  }
}

Animal Dosage

animal.dosage.created

Triggered when an animal dosage is created.

{
  "id" : "whe_1TY2s9Z5ETyhbaxHUTWJZt",
  "client_id" : "555033e7-2bc5-474f-89e5-5c659b92ae6d",
  "event" : "animal.dosage.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.066771Z",
  "payload" : {
    "id" : "dsg_HqrD93co3EjBfGHVAPbaO",
    "name" : "Example dosage",
    "dosed_at" : "2025-10-31T11:57:15.043427Z",
    "comments" : "CkziDxu0Zj",
    "weight_at_dosing" : null,
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5.14",
      "display_unit" : "mg/kg",
      "display_value" : "5.14"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "13.57",
      "display_unit" : "ml/kg",
      "display_value" : "13.57"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "22.05",
      "display_unit" : "mg/ml",
      "display_value" : "22.05"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "31.72",
      "display_unit" : "µL",
      "display_value" : "31.72"
    },
    "study" : {
      "id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "project_id" : "pjt_7FBfhWC2W5tNDVEHPLpMOm",
      "name" : "NVpdmBrIaE",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "RajZkbCMmb",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_tLXbolOaRQL6PGiyUra1j",
        "name" : "ab3IZwzxLd",
        "email" : "x79sBSep@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_4WlsF3N50XgPn7MuKxNI0m",
        "name" : "a9w19jVSvh",
        "email" : "7DGsYpJZ@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.871009Z",
      "updated_at" : "2025-10-31T11:57:14.871009Z"
    },
    "animal" : {
      "id" : "aml_5ZNeCyVRGpZ8NO1yvupU5C",
      "study_id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "study_group_id" : "grp_6xgg6F5PNulJiNuAYPct7p",
      "cage_id" : "cge_1GsYCPl1c5fRJmpGw3ZJGt",
      "catalog" : "A0000001",
      "name" : "7pyI0QGOBC",
      "number" : 1,
      "strain" : "k8mVG1ur2r",
      "species" : "7ZLFcL2QxW",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "tMr4OhH16C",
      "ear" : "AcpgG7n1xX",
      "tag" : "SZBcOKB1NQ",
      "donor" : "peynJrdaE2",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:15.029832Z",
      "updated_at" : "2025-10-31T11:57:15.029832Z",
      "disease_induction_date" : "2025-10-31"
    },
    "measurement" : {
      "id" : "mst_6nN4xASfqD8hGJExBNgsPR",
      "study_id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "animal_id" : "aml_5ZNeCyVRGpZ8NO1yvupU5C",
      "measured_at" : "2025-10-31",
      "calculations" : [ {
        "id" : "vbl_inxsejM9X4MdhVsQBNh9N",
        "key" : "tumour_volume",
        "name" : "Tumour Volume",
        "unit" : "mm³",
        "excluded" : false,
        "value" : "75",
        "formula" : "(width * width * length) / 2",
        "variables" : [ {
          "id" : "vbl_5gcVIm1K1wEKCZkh9QBzkK",
          "key" : "width",
          "value" : "5",
          "unit" : "mm"
        }, {
          "id" : "vbl_46TnhxzaUccm0QcCSZZj14",
          "key" : "length",
          "value" : "6",
          "unit" : "mm"
        } ]
      }, {
        "id" : "vbl_7NU9IwNhsfP0Whr1kBA9bJ",
        "key" : "weight",
        "name" : "Weight",
        "unit" : "g",
        "excluded" : false,
        "value" : "55",
        "formula" : "weight",
        "variables" : [ ]
      } ],
      "created_at" : "2025-10-31T11:57:15.034341Z",
      "updated_at" : "2025-10-31T11:57:15.034341Z"
    },
    "user" : {
      "id" : "usr_3vYIPDmhIO6DZapo61iOaS",
      "name" : "D9lmm Overwatch",
      "email" : "jOL9YVzU@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:57:14.852192Z",
      "updated_at" : "2025-10-31T11:57:14.852192Z"
    },
    "treatment" : {
      "id" : "tmt_3JQj7TIdWvJnm1FJxsbOcg",
      "study_id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "type" : "concentration_vgkg",
      "name" : "MZ4peeLXbT",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "created_at" : "2025-10-31T11:57:15.040777Z",
      "updated_at" : "2025-10-31T11:57:15.040777Z",
      "external_entity_id" : "Mrfgv9OAAJ"
    },
    "created_at" : "2025-10-31T11:57:15.043434Z",
    "updated_at" : "2025-10-31T11:57:15.043434Z"
  }
}

animal.dosage.deleted

Triggered when an animal dosage is deleted.

{
  "id" : "whe_70sVhG39pnH69yTY7vtTh9",
  "client_id" : "ec72f22f-4248-4156-8d9c-f022dffbf6a9",
  "event" : "animal.dosage.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.068125Z",
  "payload" : {
    "id" : "dsg_HqrD93co3EjBfGHVAPbaO",
    "name" : "Example dosage",
    "dosed_at" : "2025-10-31T11:57:15.043427Z",
    "comments" : "CkziDxu0Zj",
    "weight_at_dosing" : null,
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5.14",
      "display_unit" : "mg/kg",
      "display_value" : "5.14"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "13.57",
      "display_unit" : "ml/kg",
      "display_value" : "13.57"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "22.05",
      "display_unit" : "mg/ml",
      "display_value" : "22.05"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "31.72",
      "display_unit" : "µL",
      "display_value" : "31.72"
    },
    "study" : {
      "id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "project_id" : "pjt_7FBfhWC2W5tNDVEHPLpMOm",
      "name" : "NVpdmBrIaE",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "RajZkbCMmb",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_tLXbolOaRQL6PGiyUra1j",
        "name" : "ab3IZwzxLd",
        "email" : "x79sBSep@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_4WlsF3N50XgPn7MuKxNI0m",
        "name" : "a9w19jVSvh",
        "email" : "7DGsYpJZ@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.871009Z",
      "updated_at" : "2025-10-31T11:57:14.871009Z"
    },
    "animal" : {
      "id" : "aml_5ZNeCyVRGpZ8NO1yvupU5C",
      "study_id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "study_group_id" : "grp_6xgg6F5PNulJiNuAYPct7p",
      "cage_id" : "cge_1GsYCPl1c5fRJmpGw3ZJGt",
      "catalog" : "A0000001",
      "name" : "7pyI0QGOBC",
      "number" : 1,
      "strain" : "k8mVG1ur2r",
      "species" : "7ZLFcL2QxW",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "tMr4OhH16C",
      "ear" : "AcpgG7n1xX",
      "tag" : "SZBcOKB1NQ",
      "donor" : "peynJrdaE2",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:15.029832Z",
      "updated_at" : "2025-10-31T11:57:15.029832Z",
      "disease_induction_date" : "2025-10-31"
    },
    "measurement" : {
      "id" : "mst_6nN4xASfqD8hGJExBNgsPR",
      "study_id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "animal_id" : "aml_5ZNeCyVRGpZ8NO1yvupU5C",
      "measured_at" : "2025-10-31",
      "calculations" : [ {
        "id" : "vbl_inxsejM9X4MdhVsQBNh9N",
        "key" : "tumour_volume",
        "name" : "Tumour Volume",
        "unit" : "mm³",
        "excluded" : false,
        "value" : "75",
        "formula" : "(width * width * length) / 2",
        "variables" : [ {
          "id" : "vbl_5gcVIm1K1wEKCZkh9QBzkK",
          "key" : "width",
          "value" : "5",
          "unit" : "mm"
        }, {
          "id" : "vbl_46TnhxzaUccm0QcCSZZj14",
          "key" : "length",
          "value" : "6",
          "unit" : "mm"
        } ]
      }, {
        "id" : "vbl_7NU9IwNhsfP0Whr1kBA9bJ",
        "key" : "weight",
        "name" : "Weight",
        "unit" : "g",
        "excluded" : false,
        "value" : "55",
        "formula" : "weight",
        "variables" : [ ]
      } ],
      "created_at" : "2025-10-31T11:57:15.034341Z",
      "updated_at" : "2025-10-31T11:57:15.034341Z"
    },
    "user" : {
      "id" : "usr_3vYIPDmhIO6DZapo61iOaS",
      "name" : "D9lmm Overwatch",
      "email" : "jOL9YVzU@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:57:14.852192Z",
      "updated_at" : "2025-10-31T11:57:14.852192Z"
    },
    "treatment" : {
      "id" : "tmt_3JQj7TIdWvJnm1FJxsbOcg",
      "study_id" : "sdy_5jCf9C7zL6CgVSDroOmgxm",
      "type" : "concentration_vgkg",
      "name" : "MZ4peeLXbT",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "created_at" : "2025-10-31T11:57:15.040777Z",
      "updated_at" : "2025-10-31T11:57:15.040777Z",
      "external_entity_id" : "Mrfgv9OAAJ"
    },
    "created_at" : "2025-10-31T11:57:15.043434Z",
    "updated_at" : "2025-10-31T11:57:15.043434Z"
  }
}

Animal Measurement

animal.measurement.created

Triggered when an animal measurement is created.

{
  "id" : "whe_2lIGWvbA6BW2SBZsGO5WHe",
  "client_id" : "ffeb2f6b-3822-49e4-a0bd-d8a55d9835c5",
  "event" : "animal.measurement.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.889253Z",
  "payload" : {
    "id" : "mst_XQFEXIdpiNKCwXE3hMlSQ",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_4w0ORFHcXDskbf0PmrtDnX",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "75",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_58GIzlxok5b3MGysL0YMCI",
        "key" : "width",
        "value" : "5",
        "unit" : "mm"
      }, {
        "id" : "vbl_6Zj6MC2Z5ddZzbNuxVqSuw",
        "key" : "length",
        "value" : "6",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_2CvWDQM1qYQZSpjDXmfDD5",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_71dHsHm1nbAv4kD2M6BZht",
      "project_id" : "pjt_4aJXY6R0PLr9p2qfxYJOO8",
      "name" : "5GUlIDcrhT",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "95VD0Rthzs",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6wgVzM5IF71IMMLXGz9TlK",
        "name" : "RBCeFcDoYG",
        "email" : "rbG3eidd@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_253029uZdOZZmztDbg63f3",
        "name" : "c0HXEkpx45",
        "email" : "xxvAVSTu@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.702780Z",
      "updated_at" : "2025-10-31T11:57:17.702780Z"
    },
    "animal" : {
      "id" : "aml_7JNwdcjRwcNZlGYJzT1jVJ",
      "study_id" : "sdy_71dHsHm1nbAv4kD2M6BZht",
      "study_group_id" : "grp_2e4M1lGuAG9nIErshGG0hs",
      "cage_id" : "cge_2rSbOUncR5qgu7UIx1Rhsl",
      "catalog" : "A0000001",
      "name" : "63UTqrP3kx",
      "number" : 1,
      "strain" : "LRBHdVSd9B",
      "species" : "myDgmP1mqB",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "rUh9D5tAzZ",
      "ear" : "DmlkJEr0Je",
      "tag" : "MEnYtxKGqy",
      "donor" : "W0pGeXi85N",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:17.855961Z",
      "updated_at" : "2025-10-31T11:57:17.855961Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3FQVEkiwqU1hqPD5WXx3lB",
      "name" : "DoyHsJlC10",
      "email" : "27IQsyrg@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : null,
      "created_at" : "2025-10-31T11:57:17.695463Z",
      "updated_at" : "2025-10-31T11:57:17.695463Z"
    },
    "created_at" : "2025-10-31T11:57:17.861250Z",
    "updated_at" : "2025-10-31T11:57:17.861250Z"
  }
}

animal.measurement.updated

Triggered when an animal measurement is updated.

{
  "id" : "whe_1untM22JlW6getyKsA94Gb",
  "client_id" : "6f82d6e4-1d35-4fb3-a27b-aa42c75968a7",
  "event" : "animal.measurement.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.890584Z",
  "payload" : {
    "id" : "mst_XQFEXIdpiNKCwXE3hMlSQ",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_4w0ORFHcXDskbf0PmrtDnX",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "75",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_58GIzlxok5b3MGysL0YMCI",
        "key" : "width",
        "value" : "5",
        "unit" : "mm"
      }, {
        "id" : "vbl_6Zj6MC2Z5ddZzbNuxVqSuw",
        "key" : "length",
        "value" : "6",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_2CvWDQM1qYQZSpjDXmfDD5",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_71dHsHm1nbAv4kD2M6BZht",
      "project_id" : "pjt_4aJXY6R0PLr9p2qfxYJOO8",
      "name" : "5GUlIDcrhT",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "95VD0Rthzs",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6wgVzM5IF71IMMLXGz9TlK",
        "name" : "RBCeFcDoYG",
        "email" : "rbG3eidd@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_253029uZdOZZmztDbg63f3",
        "name" : "c0HXEkpx45",
        "email" : "xxvAVSTu@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.702780Z",
      "updated_at" : "2025-10-31T11:57:17.702780Z"
    },
    "animal" : {
      "id" : "aml_7JNwdcjRwcNZlGYJzT1jVJ",
      "study_id" : "sdy_71dHsHm1nbAv4kD2M6BZht",
      "study_group_id" : "grp_2e4M1lGuAG9nIErshGG0hs",
      "cage_id" : "cge_2rSbOUncR5qgu7UIx1Rhsl",
      "catalog" : "A0000001",
      "name" : "63UTqrP3kx",
      "number" : 1,
      "strain" : "LRBHdVSd9B",
      "species" : "myDgmP1mqB",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "rUh9D5tAzZ",
      "ear" : "DmlkJEr0Je",
      "tag" : "MEnYtxKGqy",
      "donor" : "W0pGeXi85N",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:17.855961Z",
      "updated_at" : "2025-10-31T11:57:17.855961Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3FQVEkiwqU1hqPD5WXx3lB",
      "name" : "DoyHsJlC10",
      "email" : "27IQsyrg@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : null,
      "created_at" : "2025-10-31T11:57:17.695463Z",
      "updated_at" : "2025-10-31T11:57:17.695463Z"
    },
    "created_at" : "2025-10-31T11:57:17.861250Z",
    "updated_at" : "2025-10-31T11:57:17.861250Z"
  }
}

animal.measurement.deleted

Triggered when an animal measurement is delete.

{
  "id" : "whe_2uehGusPPlvZPzmYRBVkLW",
  "client_id" : "e73be7e1-9327-452f-a714-44e6739bac31",
  "event" : "animal.measurement.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.891279Z",
  "payload" : {
    "id" : "mst_XQFEXIdpiNKCwXE3hMlSQ",
    "measured_at" : "2025-10-31",
    "calculations" : [ {
      "id" : "vbl_4w0ORFHcXDskbf0PmrtDnX",
      "key" : "tumour_volume",
      "name" : "Tumour Volume",
      "unit" : "mm³",
      "excluded" : false,
      "value" : "75",
      "formula" : "(width * width * length) / 2",
      "variables" : [ {
        "id" : "vbl_58GIzlxok5b3MGysL0YMCI",
        "key" : "width",
        "value" : "5",
        "unit" : "mm"
      }, {
        "id" : "vbl_6Zj6MC2Z5ddZzbNuxVqSuw",
        "key" : "length",
        "value" : "6",
        "unit" : "mm"
      } ]
    }, {
      "id" : "vbl_2CvWDQM1qYQZSpjDXmfDD5",
      "key" : "weight",
      "name" : "Weight",
      "unit" : "g",
      "excluded" : false,
      "value" : "55",
      "formula" : "weight",
      "variables" : [ ]
    } ],
    "study" : {
      "id" : "sdy_71dHsHm1nbAv4kD2M6BZht",
      "project_id" : "pjt_4aJXY6R0PLr9p2qfxYJOO8",
      "name" : "5GUlIDcrhT",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "95VD0Rthzs",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6wgVzM5IF71IMMLXGz9TlK",
        "name" : "RBCeFcDoYG",
        "email" : "rbG3eidd@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_253029uZdOZZmztDbg63f3",
        "name" : "c0HXEkpx45",
        "email" : "xxvAVSTu@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.702780Z",
      "updated_at" : "2025-10-31T11:57:17.702780Z"
    },
    "animal" : {
      "id" : "aml_7JNwdcjRwcNZlGYJzT1jVJ",
      "study_id" : "sdy_71dHsHm1nbAv4kD2M6BZht",
      "study_group_id" : "grp_2e4M1lGuAG9nIErshGG0hs",
      "cage_id" : "cge_2rSbOUncR5qgu7UIx1Rhsl",
      "catalog" : "A0000001",
      "name" : "63UTqrP3kx",
      "number" : 1,
      "strain" : "LRBHdVSd9B",
      "species" : "myDgmP1mqB",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "rUh9D5tAzZ",
      "ear" : "DmlkJEr0Je",
      "tag" : "MEnYtxKGqy",
      "donor" : "W0pGeXi85N",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:17.855961Z",
      "updated_at" : "2025-10-31T11:57:17.855961Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_3FQVEkiwqU1hqPD5WXx3lB",
      "name" : "DoyHsJlC10",
      "email" : "27IQsyrg@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : null,
      "created_at" : "2025-10-31T11:57:17.695463Z",
      "updated_at" : "2025-10-31T11:57:17.695463Z"
    },
    "created_at" : "2025-10-31T11:57:17.861250Z",
    "updated_at" : "2025-10-31T11:57:17.861250Z"
  }
}

Animal Observation

animal.observation.created

Triggered when an animal observation is created.

{
  "id" : "whe_6P4tjL0GIn7hRYwfzfhc2k",
  "client_id" : "cabd179a-47d4-47cf-bc16-ff54e9946757",
  "event" : "animal.observation.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.009864Z",
  "payload" : {
    "id" : "obs_P0reLaTK3BjfE1E5Ixjns",
    "glossary_id" : "gly_3wIiifm2evKqz8jJXKS3Rl",
    "title" : "Observation Glossary",
    "text" : "Example text",
    "type" : "severity",
    "value" : "Severe",
    "observed_at" : "2025-10-31T11:57:15.991657Z",
    "study" : {
      "id" : "sdy_1rAJRwm3B6FTDMbyyBGlRw",
      "project_id" : "pjt_58Q26DYYEHcq0083DKqjwp",
      "name" : "j3fcpVSIu2",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "CodZurMn3X",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6hZcMBWXCM4CmgLi6QlMtI",
        "name" : "w7CfLjxD4C",
        "email" : "5TR4K8TR@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3WePdtCLcypXagyaOnLJxL",
        "name" : "fNgOYoFY5G",
        "email" : "QJHPJz5Z@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.761823Z",
      "updated_at" : "2025-10-31T11:57:15.761823Z"
    },
    "animal" : {
      "id" : "aml_1FWmN8LToZSXJUd7ni6JjL",
      "study_id" : "sdy_1rAJRwm3B6FTDMbyyBGlRw",
      "study_group_id" : "grp_5gLX6ohSn7O7aTNC44peFx",
      "cage_id" : "cge_5zYoA6kDtrroOYoaS0W5qM",
      "catalog" : "A0000001",
      "name" : "qHXuTOKme6",
      "number" : 1,
      "strain" : "dsMVE9wHob",
      "species" : "ojTF47mgAg",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "yTyqvahWpd",
      "ear" : "dvV0zjodPz",
      "tag" : "Fl3PeOqXUe",
      "donor" : "gJSOInw0qK",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_2ULgi401FRc6KnjxWOC8rh",
        "name" : "cgy2xFYi08",
        "email" : "ye59wvVU@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_17XYDkDR91DqDI4nXq7b4w",
        "title" : "Found dead",
        "comment" : "FjqA9winpP"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:15.917449Z",
      "updated_at" : "2025-10-31T11:57:15.917449Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_7WiuDubGGFAp5D3mWdcldk",
      "name" : "PEnVl Overwatch",
      "email" : "vWQB7Q74@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:57:15.746771Z",
      "updated_at" : "2025-10-31T11:57:15.746771Z"
    },
    "created_at" : "2025-10-31T11:57:15.991675Z",
    "updated_at" : "2025-10-31T11:57:15.991675Z"
  }
}

animal.observation.updated

Triggered when an animal observation is updated.

{
  "id" : "whe_2FtF1pYezJnYbbqAeTmVDj",
  "client_id" : "4410d408-afaf-4fa0-a8df-fe4c05e7524d",
  "event" : "animal.observation.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.011409Z",
  "payload" : {
    "id" : "obs_P0reLaTK3BjfE1E5Ixjns",
    "glossary_id" : "gly_3wIiifm2evKqz8jJXKS3Rl",
    "title" : "Observation Glossary",
    "text" : "Example text",
    "type" : "severity",
    "value" : "Severe",
    "observed_at" : "2025-10-31T11:57:15.991657Z",
    "study" : {
      "id" : "sdy_1rAJRwm3B6FTDMbyyBGlRw",
      "project_id" : "pjt_58Q26DYYEHcq0083DKqjwp",
      "name" : "j3fcpVSIu2",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "CodZurMn3X",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6hZcMBWXCM4CmgLi6QlMtI",
        "name" : "w7CfLjxD4C",
        "email" : "5TR4K8TR@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3WePdtCLcypXagyaOnLJxL",
        "name" : "fNgOYoFY5G",
        "email" : "QJHPJz5Z@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.761823Z",
      "updated_at" : "2025-10-31T11:57:15.761823Z"
    },
    "animal" : {
      "id" : "aml_1FWmN8LToZSXJUd7ni6JjL",
      "study_id" : "sdy_1rAJRwm3B6FTDMbyyBGlRw",
      "study_group_id" : "grp_5gLX6ohSn7O7aTNC44peFx",
      "cage_id" : "cge_5zYoA6kDtrroOYoaS0W5qM",
      "catalog" : "A0000001",
      "name" : "qHXuTOKme6",
      "number" : 1,
      "strain" : "dsMVE9wHob",
      "species" : "ojTF47mgAg",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "yTyqvahWpd",
      "ear" : "dvV0zjodPz",
      "tag" : "Fl3PeOqXUe",
      "donor" : "gJSOInw0qK",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_2ULgi401FRc6KnjxWOC8rh",
        "name" : "cgy2xFYi08",
        "email" : "ye59wvVU@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_17XYDkDR91DqDI4nXq7b4w",
        "title" : "Found dead",
        "comment" : "FjqA9winpP"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:15.917449Z",
      "updated_at" : "2025-10-31T11:57:15.917449Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_7WiuDubGGFAp5D3mWdcldk",
      "name" : "PEnVl Overwatch",
      "email" : "vWQB7Q74@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:57:15.746771Z",
      "updated_at" : "2025-10-31T11:57:15.746771Z"
    },
    "created_at" : "2025-10-31T11:57:15.991675Z",
    "updated_at" : "2025-10-31T11:57:15.991675Z"
  }
}

animal.observation.deleted

Triggered when an animal observation is deleted.

{
  "id" : "whe_dQmtHbVb3oMKXTxDGv7Nd",
  "client_id" : "5be2847e-436d-478c-971e-d69cbdd6d337",
  "event" : "animal.observation.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.012061Z",
  "payload" : {
    "id" : "obs_P0reLaTK3BjfE1E5Ixjns",
    "glossary_id" : "gly_3wIiifm2evKqz8jJXKS3Rl",
    "title" : "Observation Glossary",
    "text" : "Example text",
    "type" : "severity",
    "value" : "Severe",
    "observed_at" : "2025-10-31T11:57:15.991657Z",
    "study" : {
      "id" : "sdy_1rAJRwm3B6FTDMbyyBGlRw",
      "project_id" : "pjt_58Q26DYYEHcq0083DKqjwp",
      "name" : "j3fcpVSIu2",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "CodZurMn3X",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6hZcMBWXCM4CmgLi6QlMtI",
        "name" : "w7CfLjxD4C",
        "email" : "5TR4K8TR@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3WePdtCLcypXagyaOnLJxL",
        "name" : "fNgOYoFY5G",
        "email" : "QJHPJz5Z@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.761823Z",
      "updated_at" : "2025-10-31T11:57:15.761823Z"
    },
    "animal" : {
      "id" : "aml_1FWmN8LToZSXJUd7ni6JjL",
      "study_id" : "sdy_1rAJRwm3B6FTDMbyyBGlRw",
      "study_group_id" : "grp_5gLX6ohSn7O7aTNC44peFx",
      "cage_id" : "cge_5zYoA6kDtrroOYoaS0W5qM",
      "catalog" : "A0000001",
      "name" : "qHXuTOKme6",
      "number" : 1,
      "strain" : "dsMVE9wHob",
      "species" : "ojTF47mgAg",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "yTyqvahWpd",
      "ear" : "dvV0zjodPz",
      "tag" : "Fl3PeOqXUe",
      "donor" : "gJSOInw0qK",
      "tracking_date" : "2025-10-31",
      "terminated_at" : "2025-10-31",
      "terminated_by" : {
        "id" : "usr_2ULgi401FRc6KnjxWOC8rh",
        "name" : "cgy2xFYi08",
        "email" : "ye59wvVU@benchling.com",
        "timezone" : "UTC"
      },
      "terminated_reason" : {
        "glossary_id" : "gly_17XYDkDR91DqDI4nXq7b4w",
        "title" : "Found dead",
        "comment" : "FjqA9winpP"
      },
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:15.917449Z",
      "updated_at" : "2025-10-31T11:57:15.917449Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_7WiuDubGGFAp5D3mWdcldk",
      "name" : "PEnVl Overwatch",
      "email" : "vWQB7Q74@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "user-internal-id" : "USER-1234"
      },
      "created_at" : "2025-10-31T11:57:15.746771Z",
      "updated_at" : "2025-10-31T11:57:15.746771Z"
    },
    "created_at" : "2025-10-31T11:57:15.991675Z",
    "updated_at" : "2025-10-31T11:57:15.991675Z"
  }
}

Animal Sample

animal.sample.created

Triggered when an animal sample is created.

{
  "id" : "whe_24itC6Guzzw0haYfaBgWbB",
  "client_id" : "df1af1cd-97e7-4775-a89e-c83cc9fb8f7a",
  "event" : "animal.sample.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.449306Z",
  "payload" : {
    "id" : "spl_3IRUJLS8xJArqnCJstLdVK",
    "sample_id" : "S157259614",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:57:16.431754Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-1237124691" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_1fonuwmOfQeOLIFDEGrq8E",
      "project_id" : "pjt_2ZEZqrfav1Pge2HzJjoDvL",
      "name" : "0nhSscqcNk",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "jZW523cTIb",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6VON2WnBhBuCCTVY8fbfAe",
        "name" : "orNk3UtpJK",
        "email" : "L8896eWi@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3JXHI7aPooc8GEXm19269B",
        "name" : "Cs31A4AviU",
        "email" : "JOpFt8DK@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:16.209014Z",
      "updated_at" : "2025-10-31T11:57:16.209014Z"
    },
    "animal" : {
      "id" : "aml_nWqkKhQuN4hlmSJB2V4In",
      "study_id" : "sdy_1fonuwmOfQeOLIFDEGrq8E",
      "study_group_id" : "grp_2GLe7kua9bzZ7t5pYsxEBF",
      "cage_id" : "cge_bXqmCoQQ15ZT3IKZZoV2U",
      "catalog" : "A0000001",
      "name" : "s1OkDKAKd6",
      "number" : 1,
      "strain" : "4x56767e6V",
      "species" : "0owozIkj5a",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "qqlOaP1OAp",
      "ear" : "R7zCPcyeqQ",
      "tag" : "ZWXzY2hGB0",
      "donor" : "0PRe2dJFka",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:16.361328Z",
      "updated_at" : "2025-10-31T11:57:16.361328Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_qotHj9kZAilq2vzpZoMI9",
      "name" : "HPFOXIzu1v",
      "email" : "5IceOh9N@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "WpbrCIT4wS" : "gAjdFFtxQl"
      },
      "created_at" : "2025-10-31T11:57:16.425078Z",
      "updated_at" : "2025-10-31T11:57:16.425078Z"
    },
    "created_at" : "2025-10-31T11:57:16.431852Z",
    "updated_at" : "2025-10-31T11:57:16.431852Z"
  }
}

animal.sample.updated

Triggered when an animal sample is updated.

{
  "id" : "whe_5yYQIHxcnkSlg0Ln86aK5",
  "client_id" : "39986381-feef-42e6-87ed-ee7126330ffa",
  "event" : "animal.sample.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.450622Z",
  "payload" : {
    "id" : "spl_3IRUJLS8xJArqnCJstLdVK",
    "sample_id" : "S157259614",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:57:16.431754Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-1237124691" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_1fonuwmOfQeOLIFDEGrq8E",
      "project_id" : "pjt_2ZEZqrfav1Pge2HzJjoDvL",
      "name" : "0nhSscqcNk",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "jZW523cTIb",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6VON2WnBhBuCCTVY8fbfAe",
        "name" : "orNk3UtpJK",
        "email" : "L8896eWi@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3JXHI7aPooc8GEXm19269B",
        "name" : "Cs31A4AviU",
        "email" : "JOpFt8DK@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:16.209014Z",
      "updated_at" : "2025-10-31T11:57:16.209014Z"
    },
    "animal" : {
      "id" : "aml_nWqkKhQuN4hlmSJB2V4In",
      "study_id" : "sdy_1fonuwmOfQeOLIFDEGrq8E",
      "study_group_id" : "grp_2GLe7kua9bzZ7t5pYsxEBF",
      "cage_id" : "cge_bXqmCoQQ15ZT3IKZZoV2U",
      "catalog" : "A0000001",
      "name" : "s1OkDKAKd6",
      "number" : 1,
      "strain" : "4x56767e6V",
      "species" : "0owozIkj5a",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "qqlOaP1OAp",
      "ear" : "R7zCPcyeqQ",
      "tag" : "ZWXzY2hGB0",
      "donor" : "0PRe2dJFka",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:16.361328Z",
      "updated_at" : "2025-10-31T11:57:16.361328Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_qotHj9kZAilq2vzpZoMI9",
      "name" : "HPFOXIzu1v",
      "email" : "5IceOh9N@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "WpbrCIT4wS" : "gAjdFFtxQl"
      },
      "created_at" : "2025-10-31T11:57:16.425078Z",
      "updated_at" : "2025-10-31T11:57:16.425078Z"
    },
    "created_at" : "2025-10-31T11:57:16.431852Z",
    "updated_at" : "2025-10-31T11:57:16.431852Z"
  }
}

animal.sample.deleted

Triggered when an animal sample is deleted.

{
  "id" : "whe_2yRDVZGUoSg32NlpKTrYV9",
  "client_id" : "35ad5faf-127d-4e7d-9e15-d9b30530ce06",
  "event" : "animal.sample.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.451366Z",
  "payload" : {
    "id" : "spl_3IRUJLS8xJArqnCJstLdVK",
    "sample_id" : "S157259614",
    "type" : "Blood",
    "label" : "BLOOD",
    "status" : "collected",
    "timepoint" : "PT15M",
    "collected_at" : "2025-10-31T13:57:16.431754Z",
    "details" : [ {
      "key" : "volume",
      "unit" : "ml",
      "value" : "5"
    } ],
    "comments" : "A blood sample",
    "metadata" : {
      "sample-internal-id-1237124691" : "SMPL-1234"
    },
    "study" : {
      "id" : "sdy_1fonuwmOfQeOLIFDEGrq8E",
      "project_id" : "pjt_2ZEZqrfav1Pge2HzJjoDvL",
      "name" : "0nhSscqcNk",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "jZW523cTIb",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_6VON2WnBhBuCCTVY8fbfAe",
        "name" : "orNk3UtpJK",
        "email" : "L8896eWi@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3JXHI7aPooc8GEXm19269B",
        "name" : "Cs31A4AviU",
        "email" : "JOpFt8DK@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:16.209014Z",
      "updated_at" : "2025-10-31T11:57:16.209014Z"
    },
    "animal" : {
      "id" : "aml_nWqkKhQuN4hlmSJB2V4In",
      "study_id" : "sdy_1fonuwmOfQeOLIFDEGrq8E",
      "study_group_id" : "grp_2GLe7kua9bzZ7t5pYsxEBF",
      "cage_id" : "cge_bXqmCoQQ15ZT3IKZZoV2U",
      "catalog" : "A0000001",
      "name" : "s1OkDKAKd6",
      "number" : 1,
      "strain" : "4x56767e6V",
      "species" : "0owozIkj5a",
      "sex" : "m",
      "dob" : "2025-10-30",
      "tail" : "qqlOaP1OAp",
      "ear" : "R7zCPcyeqQ",
      "tag" : "ZWXzY2hGB0",
      "donor" : "0PRe2dJFka",
      "tracking_date" : "2025-10-31",
      "terminated_at" : null,
      "terminated_by" : null,
      "terminated_reason" : null,
      "disease_survivor" : null,
      "metadata" : {
        "animal-internal-id" : "ANIMAL-1234"
      },
      "created_at" : "2025-10-31T11:57:16.361328Z",
      "updated_at" : "2025-10-31T11:57:16.361328Z",
      "disease_induction_date" : "2025-10-31"
    },
    "user" : {
      "id" : "usr_qotHj9kZAilq2vzpZoMI9",
      "name" : "HPFOXIzu1v",
      "email" : "5IceOh9N@benchling.com",
      "timezone" : "UTC",
      "status" : "active",
      "metadata" : {
        "WpbrCIT4wS" : "gAjdFFtxQl"
      },
      "created_at" : "2025-10-31T11:57:16.425078Z",
      "updated_at" : "2025-10-31T11:57:16.425078Z"
    },
    "created_at" : "2025-10-31T11:57:16.431852Z",
    "updated_at" : "2025-10-31T11:57:16.431852Z"
  }
}

Cage

cage.created

Triggered when an cage is created.

{
  "id" : "whe_5BFlignytu74I4xIa8T5aS",
  "client_id" : "ae5405d7-b400-4abb-ba49-ee1e7aaf5b1d",
  "event" : "cage.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:14.591210Z",
  "payload" : {
    "id" : "cge_PIajbpbA0mXxjycJWOL2s",
    "name" : "dpGDTQtf1u",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "study" : {
      "id" : "sdy_46aDsdZ1xbtmZ96bMtOihs",
      "project_id" : "pjt_5asNafazoTG9TU78xIM8vq",
      "name" : "u6e3bjAcuI",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "erpUFt6xpj",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_aZL7ovNpykdPlkCTWNDxK",
        "name" : "rkyLB1hlic",
        "email" : "ewr8OFOY@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2QvTsZZ3KWscx0KwPJStIE",
        "name" : "Vx0WIiFHan",
        "email" : "PeBqwAwI@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.422720Z",
      "updated_at" : "2025-10-31T11:57:14.422720Z"
    },
    "created_at" : "2025-10-31T11:57:14.575692Z",
    "updated_at" : "2025-10-31T11:57:14.575692Z"
  }
}

cage.updated

Triggered when an cage is updated.

{
  "id" : "whe_AtWDQ922Gjp63QYOqL5Gb",
  "client_id" : "ee025f4e-69a2-45ae-b706-a2456aea2596",
  "event" : "cage.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:14.592627Z",
  "payload" : {
    "id" : "cge_PIajbpbA0mXxjycJWOL2s",
    "name" : "dpGDTQtf1u",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "study" : {
      "id" : "sdy_46aDsdZ1xbtmZ96bMtOihs",
      "project_id" : "pjt_5asNafazoTG9TU78xIM8vq",
      "name" : "u6e3bjAcuI",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "erpUFt6xpj",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_aZL7ovNpykdPlkCTWNDxK",
        "name" : "rkyLB1hlic",
        "email" : "ewr8OFOY@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2QvTsZZ3KWscx0KwPJStIE",
        "name" : "Vx0WIiFHan",
        "email" : "PeBqwAwI@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.422720Z",
      "updated_at" : "2025-10-31T11:57:14.422720Z"
    },
    "created_at" : "2025-10-31T11:57:14.575692Z",
    "updated_at" : "2025-10-31T11:57:14.575692Z"
  }
}

cage.deleted

Triggered when an cage is deleted.

{
  "id" : "whe_3dQnDh9BSqzztW5tfMn8gS",
  "client_id" : "79c4d187-d698-45d7-b88b-864f556c102c",
  "event" : "cage.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:14.593365Z",
  "payload" : {
    "id" : "cge_PIajbpbA0mXxjycJWOL2s",
    "name" : "dpGDTQtf1u",
    "catalog" : "C0000001",
    "metadata" : {
      "cage-internal-id" : "CAGE-1234"
    },
    "study" : {
      "id" : "sdy_46aDsdZ1xbtmZ96bMtOihs",
      "project_id" : "pjt_5asNafazoTG9TU78xIM8vq",
      "name" : "u6e3bjAcuI",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "erpUFt6xpj",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_aZL7ovNpykdPlkCTWNDxK",
        "name" : "rkyLB1hlic",
        "email" : "ewr8OFOY@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_2QvTsZZ3KWscx0KwPJStIE",
        "name" : "Vx0WIiFHan",
        "email" : "PeBqwAwI@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.422720Z",
      "updated_at" : "2025-10-31T11:57:14.422720Z"
    },
    "created_at" : "2025-10-31T11:57:14.575692Z",
    "updated_at" : "2025-10-31T11:57:14.575692Z"
  }
}

Species

species.created

Triggered when a species is created.

{
  "id" : "whe_39d7gr7TWRQPCqlKNOgWeM",
  "client_id" : "5e721313-478d-4383-b107-7061b5a63827",
  "event" : "species.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.078156Z",
  "payload" : {
    "id" : "spc_33WTdOwlDT8ZlJTKV21guA",
    "name" : "emuJ0YxXfb",
    "active" : true,
    "created_at" : "2025-10-31T11:57:17.067600Z",
    "updated_at" : "2025-10-31T11:57:17.067600Z"
  }
}

species.updated

Triggered when a species is updated.

{
  "id" : "whe_54QgbMf3p22Dwuw2p9Wana",
  "client_id" : "3e588c91-f70e-4b1c-b2ae-4c9570caef82",
  "event" : "species.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.079537Z",
  "payload" : {
    "id" : "spc_33WTdOwlDT8ZlJTKV21guA",
    "name" : "emuJ0YxXfb",
    "active" : true,
    "created_at" : "2025-10-31T11:57:17.067600Z",
    "updated_at" : "2025-10-31T11:57:17.067600Z"
  }
}

species.deleted

Triggered when a species is deleted.

{
  "id" : "whe_uXhhzkQJIbrZEqKBe9rI5",
  "client_id" : "7ef3283e-5dff-420b-afff-e152c4b62c93",
  "event" : "species.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.082023Z",
  "payload" : {
    "id" : "spc_33WTdOwlDT8ZlJTKV21guA",
    "name" : "emuJ0YxXfb",
    "active" : true,
    "created_at" : "2025-10-31T11:57:17.067600Z",
    "updated_at" : "2025-10-31T11:57:17.067600Z"
  }
}

Strain

strain.created

Triggered when a strain is created.

{
  "id" : "whe_4QoI3oUVOf7Ufi2nQtOk8W",
  "client_id" : "65715b87-850f-4130-b427-35d4d290bad7",
  "event" : "strain.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.891271Z",
  "payload" : {
    "id" : "stn_6b0fHvbUUzfeJLiLJbtbfP",
    "name" : "4bMFPA0Ody",
    "species" : {
      "id" : "spc_1FGJhPg2BpaSQiA50mBVPL",
      "name" : "RjgRoByn0b",
      "active" : true,
      "created_at" : "2025-10-31T11:57:16.879240Z",
      "updated_at" : "2025-10-31T11:57:16.879240Z"
    },
    "active" : true,
    "created_at" : "2025-10-31T11:57:16.880397Z",
    "updated_at" : "2025-10-31T11:57:16.880397Z"
  }
}

strain.updated

Triggered when a strain is updated.

{
  "id" : "whe_53euINekZSU7SEvB0zCix1",
  "client_id" : "b670518e-9c44-4084-ac58-e34f173f213a",
  "event" : "strain.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.892590Z",
  "payload" : {
    "id" : "stn_6b0fHvbUUzfeJLiLJbtbfP",
    "name" : "4bMFPA0Ody",
    "species" : {
      "id" : "spc_1FGJhPg2BpaSQiA50mBVPL",
      "name" : "RjgRoByn0b",
      "active" : true,
      "created_at" : "2025-10-31T11:57:16.879240Z",
      "updated_at" : "2025-10-31T11:57:16.879240Z"
    },
    "active" : true,
    "created_at" : "2025-10-31T11:57:16.880397Z",
    "updated_at" : "2025-10-31T11:57:16.880397Z"
  }
}

strain.deleted

Triggered when a strain is deleted.

{
  "id" : "whe_7T8YnnpA8RjAzkuZs5tpAg",
  "client_id" : "ad361d8d-9346-4f6c-b732-954687c93cfd",
  "event" : "strain.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.893717Z",
  "payload" : {
    "id" : "stn_6b0fHvbUUzfeJLiLJbtbfP",
    "name" : "4bMFPA0Ody",
    "species" : {
      "id" : "spc_1FGJhPg2BpaSQiA50mBVPL",
      "name" : "RjgRoByn0b",
      "active" : true,
      "created_at" : "2025-10-31T11:57:16.879240Z",
      "updated_at" : "2025-10-31T11:57:16.879240Z"
    },
    "active" : true,
    "created_at" : "2025-10-31T11:57:16.880397Z",
    "updated_at" : "2025-10-31T11:57:16.880397Z"
  }
}

Study

study.created

Triggered when a study is created.

{
  "id" : "whe_273eF4vG21NsRAnsDWdJS4",
  "client_id" : "dbd72fb1-0220-4c79-89f7-e620abaec5fd",
  "event" : "study.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.232018Z",
  "payload" : {
    "id" : "sdy_7XhjVJv5dnDA5Dm8WnYOcE",
    "name" : "x9e346ePu3",
    "code" : "CD-25-445",
    "type" : "internal",
    "status" : "in_progress",
    "description" : "I6wjgBfAOa",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_4s69gnlDyzkSPIIPMC2I6I",
      "name" : "jmJuf7uSB3",
      "email" : "NpXMo87v@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3eCBl2FQygSeqvP9FC60ts",
      "name" : "vBTp9UaRO7",
      "email" : "uVV1Q10j@benchling.com",
      "timezone" : "UTC"
    },
    "project" : {
      "id" : "pjt_3MajjibvuI8E2HYhFLaY7k",
      "name" : "xmbODkBFny",
      "metadata" : {
        "project-internal-id" : "PROJ-1234"
      },
      "created_at" : "2025-10-31T11:57:15.074403Z",
      "updated_at" : "2025-10-31T11:57:15.074403Z"
    },
    "started_on" : "2025-10-31",
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:15.077904Z",
    "updated_at" : "2025-10-31T11:57:15.077904Z"
  }
}

study.updated

Triggered when a study is updated.

{
  "id" : "whe_5y2xhVnnJ7ndFAYlh66478",
  "client_id" : "5790bec7-a0d7-487b-ad4a-07c6be9933ec",
  "event" : "study.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.233303Z",
  "payload" : {
    "id" : "sdy_7XhjVJv5dnDA5Dm8WnYOcE",
    "name" : "x9e346ePu3",
    "code" : "CD-25-445",
    "type" : "internal",
    "status" : "in_progress",
    "description" : "I6wjgBfAOa",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_4s69gnlDyzkSPIIPMC2I6I",
      "name" : "jmJuf7uSB3",
      "email" : "NpXMo87v@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3eCBl2FQygSeqvP9FC60ts",
      "name" : "vBTp9UaRO7",
      "email" : "uVV1Q10j@benchling.com",
      "timezone" : "UTC"
    },
    "project" : {
      "id" : "pjt_3MajjibvuI8E2HYhFLaY7k",
      "name" : "xmbODkBFny",
      "metadata" : {
        "project-internal-id" : "PROJ-1234"
      },
      "created_at" : "2025-10-31T11:57:15.074403Z",
      "updated_at" : "2025-10-31T11:57:15.074403Z"
    },
    "started_on" : "2025-10-31",
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:15.077904Z",
    "updated_at" : "2025-10-31T11:57:15.077904Z"
  }
}

study.deleted

Triggered when a study is deleted.

{
  "id" : "whe_1Zw3VDqhxgUYa0R5qTc3Lt",
  "client_id" : "9799beb1-aeed-48cd-abee-49c0e26cbee6",
  "event" : "study.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.234016Z",
  "payload" : {
    "id" : "sdy_7XhjVJv5dnDA5Dm8WnYOcE",
    "name" : "x9e346ePu3",
    "code" : "CD-25-445",
    "type" : "internal",
    "status" : "in_progress",
    "description" : "I6wjgBfAOa",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_4s69gnlDyzkSPIIPMC2I6I",
      "name" : "jmJuf7uSB3",
      "email" : "NpXMo87v@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3eCBl2FQygSeqvP9FC60ts",
      "name" : "vBTp9UaRO7",
      "email" : "uVV1Q10j@benchling.com",
      "timezone" : "UTC"
    },
    "project" : {
      "id" : "pjt_3MajjibvuI8E2HYhFLaY7k",
      "name" : "xmbODkBFny",
      "metadata" : {
        "project-internal-id" : "PROJ-1234"
      },
      "created_at" : "2025-10-31T11:57:15.074403Z",
      "updated_at" : "2025-10-31T11:57:15.074403Z"
    },
    "started_on" : "2025-10-31",
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:15.077904Z",
    "updated_at" : "2025-10-31T11:57:15.077904Z"
  }
}

study.metadata.updated

Triggered when a study metadata is updated.

{
  "id" : "whe_4NA9HIhOKUJtPvRhYPqUzN",
  "client_id" : "ef424263-405c-4d19-8b27-6454445d655d",
  "event" : "study.metadata.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.234632Z",
  "payload" : {
    "id" : "sdy_7XhjVJv5dnDA5Dm8WnYOcE",
    "name" : "x9e346ePu3",
    "code" : "CD-25-445",
    "type" : "internal",
    "status" : "in_progress",
    "description" : "I6wjgBfAOa",
    "timezone" : "America/Los_Angeles",
    "metadata" : {
      "study-internal-id" : "STUDY-1234"
    },
    "author" : {
      "id" : "usr_4s69gnlDyzkSPIIPMC2I6I",
      "name" : "jmJuf7uSB3",
      "email" : "NpXMo87v@benchling.com",
      "timezone" : "UTC"
    },
    "owner" : {
      "id" : "usr_3eCBl2FQygSeqvP9FC60ts",
      "name" : "vBTp9UaRO7",
      "email" : "uVV1Q10j@benchling.com",
      "timezone" : "UTC"
    },
    "project" : {
      "id" : "pjt_3MajjibvuI8E2HYhFLaY7k",
      "name" : "xmbODkBFny",
      "metadata" : {
        "project-internal-id" : "PROJ-1234"
      },
      "created_at" : "2025-10-31T11:57:15.074403Z",
      "updated_at" : "2025-10-31T11:57:15.074403Z"
    },
    "started_on" : "2025-10-31",
    "completed_at" : null,
    "canceled_at" : null,
    "created_at" : "2025-10-31T11:57:15.077904Z",
    "updated_at" : "2025-10-31T11:57:15.077904Z"
  }
}

Study Group

study.group.created

Triggered when a study group is created.

{
  "id" : "whe_5phToa6kgJw2UAucrPcEOx",
  "client_id" : "4349e3da-d2e8-46ba-a494-00ea1f7a0665",
  "event" : "study.group.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.675474Z",
  "payload" : {
    "id" : "grp_4qO5AXjOUd6gVVNivQVKNL",
    "name" : "A",
    "no" : 1,
    "color" : "#34e8eb",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "SYSGROUP-A1"
    },
    "study" : {
      "id" : "sdy_1YXmluy1JcyaQ39JhBEgvx",
      "project_id" : "pjt_eRd53g6oqvwjjkco8jdbM",
      "name" : "Li5PILH2zg",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "mi9BZfIFLX",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_5I9KBHoUbJgrGLGX3qv3tQ",
        "name" : "vZR4SBGf9N",
        "email" : "tHK0JPv0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_7HfTsbw6KSd47X6mPRN7Gv",
        "name" : "MEDsxUxTRt",
        "email" : "1jer17g2@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.508933Z",
      "updated_at" : "2025-10-31T11:57:15.508933Z"
    },
    "created_at" : "2025-10-31T11:57:15.656333Z",
    "updated_at" : "2025-10-31T11:57:15.656333Z"
  }
}

study.group.updated

Triggered when a study group is updated.

{
  "id" : "whe_3H0utbKqX2rFsMbXlw7olU",
  "client_id" : "b461c953-9bd3-4bc4-bdbf-08ea4b90f73b",
  "event" : "study.group.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.676573Z",
  "payload" : {
    "id" : "grp_4qO5AXjOUd6gVVNivQVKNL",
    "name" : "A",
    "no" : 1,
    "color" : "#34e8eb",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "SYSGROUP-A1"
    },
    "study" : {
      "id" : "sdy_1YXmluy1JcyaQ39JhBEgvx",
      "project_id" : "pjt_eRd53g6oqvwjjkco8jdbM",
      "name" : "Li5PILH2zg",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "mi9BZfIFLX",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_5I9KBHoUbJgrGLGX3qv3tQ",
        "name" : "vZR4SBGf9N",
        "email" : "tHK0JPv0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_7HfTsbw6KSd47X6mPRN7Gv",
        "name" : "MEDsxUxTRt",
        "email" : "1jer17g2@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.508933Z",
      "updated_at" : "2025-10-31T11:57:15.508933Z"
    },
    "created_at" : "2025-10-31T11:57:15.656333Z",
    "updated_at" : "2025-10-31T11:57:15.656333Z"
  }
}

study.group.deleted

Triggered when a study group is deleted.

{
  "id" : "whe_1BrhOgeppCqj9DmMXJDPP9",
  "client_id" : "9757350e-9f53-4ec1-9e3a-46016989510a",
  "event" : "study.group.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:15.677206Z",
  "payload" : {
    "id" : "grp_4qO5AXjOUd6gVVNivQVKNL",
    "name" : "A",
    "no" : 1,
    "color" : "#34e8eb",
    "max_animals" : 10,
    "control" : false,
    "metadata" : {
      "study-group-internal-id" : "SYSGROUP-A1"
    },
    "study" : {
      "id" : "sdy_1YXmluy1JcyaQ39JhBEgvx",
      "project_id" : "pjt_eRd53g6oqvwjjkco8jdbM",
      "name" : "Li5PILH2zg",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "mi9BZfIFLX",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_5I9KBHoUbJgrGLGX3qv3tQ",
        "name" : "vZR4SBGf9N",
        "email" : "tHK0JPv0@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_7HfTsbw6KSd47X6mPRN7Gv",
        "name" : "MEDsxUxTRt",
        "email" : "1jer17g2@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:15.508933Z",
      "updated_at" : "2025-10-31T11:57:15.508933Z"
    },
    "created_at" : "2025-10-31T11:57:15.656333Z",
    "updated_at" : "2025-10-31T11:57:15.656333Z"
  }
}

Study Request

study.request.created

Triggered when a request is created.

{
  "id" : "whe_7HAP6YuUu2y8HoURb4llmL",
  "client_id" : "d7893d44-fe36-4b4f-9469-362565d1706d",
  "event" : "study.request.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:14.406448Z",
  "payload" : {
    "id" : "req_35j7tptggbnoPIt73kb6Lp",
    "user_id" : "usr_5GUUM5g0q23q0p9zsqMip1",
    "assigned_user_id" : "usr_5GUUM5g0q23q0p9zsqMip1",
    "status" : "pending",
    "due_date" : "2025-10-31",
    "groups" : [ {
      "ref" : "TqarvgPA4e",
      "label" : "Y7a2YDneBR"
    } ],
    "fields" : [ {
      "group_ref" : "TqarvgPA4e",
      "label" : "0soByvsIfq",
      "value" : "zcPsNrjI44",
      "options" : [ null ]
    } ],
    "study" : {
      "id" : "sdy_5Mxkb9Vnt3iiLNE5dDC9HP",
      "project_id" : "pjt_4uZyuwN4Jw7blEnMAVqcit",
      "name" : "1SyWQ9ikgX",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "A98qbGG5qh",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_xR67m41mn1WI6lpdWQNGe",
        "name" : "OeW2eMugg5",
        "email" : "iwnlYl9K@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5weLJZ8IZSsPVRpdVgUS5M",
        "name" : "3uMifp0sKC",
        "email" : "hCvR58fi@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.162087Z",
      "updated_at" : "2025-10-31T11:57:14.162087Z"
    },
    "created_at" : "2025-10-31T11:57:14.390048Z",
    "updated_at" : "2025-10-31T11:57:14.390048Z"
  }
}

study.request.updated

Triggered when a request is updated.

{
  "id" : "whe_3IurshvnrSswXimBoR0EOw",
  "client_id" : "64477a1d-7368-410a-9dd7-c53754f68293",
  "event" : "study.request.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:14.407663Z",
  "payload" : {
    "id" : "req_35j7tptggbnoPIt73kb6Lp",
    "user_id" : "usr_5GUUM5g0q23q0p9zsqMip1",
    "assigned_user_id" : "usr_5GUUM5g0q23q0p9zsqMip1",
    "status" : "pending",
    "due_date" : "2025-10-31",
    "groups" : [ {
      "ref" : "TqarvgPA4e",
      "label" : "Y7a2YDneBR"
    } ],
    "fields" : [ {
      "group_ref" : "TqarvgPA4e",
      "label" : "0soByvsIfq",
      "value" : "zcPsNrjI44",
      "options" : [ null ]
    } ],
    "study" : {
      "id" : "sdy_5Mxkb9Vnt3iiLNE5dDC9HP",
      "project_id" : "pjt_4uZyuwN4Jw7blEnMAVqcit",
      "name" : "1SyWQ9ikgX",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "A98qbGG5qh",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_xR67m41mn1WI6lpdWQNGe",
        "name" : "OeW2eMugg5",
        "email" : "iwnlYl9K@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5weLJZ8IZSsPVRpdVgUS5M",
        "name" : "3uMifp0sKC",
        "email" : "hCvR58fi@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.162087Z",
      "updated_at" : "2025-10-31T11:57:14.162087Z"
    },
    "created_at" : "2025-10-31T11:57:14.390048Z",
    "updated_at" : "2025-10-31T11:57:14.390048Z"
  }
}

study.request.deleted

Triggered when a request is deleted.

{
  "id" : "whe_6mcov9r10e5SPVC8yKVT6s",
  "client_id" : "ca8a6f2a-ba6a-49fe-9087-490ab680429a",
  "event" : "study.request.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:14.408482Z",
  "payload" : {
    "id" : "req_35j7tptggbnoPIt73kb6Lp",
    "user_id" : "usr_5GUUM5g0q23q0p9zsqMip1",
    "assigned_user_id" : "usr_5GUUM5g0q23q0p9zsqMip1",
    "status" : "pending",
    "due_date" : "2025-10-31",
    "groups" : [ {
      "ref" : "TqarvgPA4e",
      "label" : "Y7a2YDneBR"
    } ],
    "fields" : [ {
      "group_ref" : "TqarvgPA4e",
      "label" : "0soByvsIfq",
      "value" : "zcPsNrjI44",
      "options" : [ null ]
    } ],
    "study" : {
      "id" : "sdy_5Mxkb9Vnt3iiLNE5dDC9HP",
      "project_id" : "pjt_4uZyuwN4Jw7blEnMAVqcit",
      "name" : "1SyWQ9ikgX",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "A98qbGG5qh",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_xR67m41mn1WI6lpdWQNGe",
        "name" : "OeW2eMugg5",
        "email" : "iwnlYl9K@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5weLJZ8IZSsPVRpdVgUS5M",
        "name" : "3uMifp0sKC",
        "email" : "hCvR58fi@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:14.162087Z",
      "updated_at" : "2025-10-31T11:57:14.162087Z"
    },
    "created_at" : "2025-10-31T11:57:14.390048Z",
    "updated_at" : "2025-10-31T11:57:14.390048Z"
  }
}

Study Treatment

study.treatment.created

Triggered when a treatment is created.

{
  "id" : "whe_7KNLvaLrsqD2LmQx74czTG",
  "client_id" : "77772cc4-a387-498b-a157-795e17f81930",
  "event" : "study.treatment.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.719113Z",
  "payload" : {
    "id" : "tmt_1azjCbEBeToP5Dox0qgb5r",
    "type" : "dose_volume",
    "name" : "XBqibzTN47",
    "external_entity_id" : "Wj6AVHavmL",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "study" : {
      "id" : "sdy_3jY5MtBGI1Z37woRJvnlDY",
      "project_id" : "pjt_5XF6IFXif9vv5185ETdpKO",
      "name" : "nG7TMbxPFW",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ENab5vKjKs",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_57eYrxPbm3DqUmBlWdw5DX",
        "name" : "7p9ovuJ7b2",
        "email" : "9xiKQU81@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3R8RnIiy4wI6z3n9q9NE0R",
        "name" : "C6jYktf0ck",
        "email" : "OUk6QLgR@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:16.464439Z",
      "updated_at" : "2025-10-31T11:57:16.464439Z"
    },
    "created_at" : "2025-10-31T11:57:16.700184Z",
    "updated_at" : "2025-10-31T11:57:16.700184Z"
  }
}

study.treatment.updated

Triggered when a treatment is updated.

{
  "id" : "whe_1OafCu2dX3aUys9psEGhiY",
  "client_id" : "75c25b96-11c6-4af2-bed1-655b69585ec6",
  "event" : "study.treatment.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.720687Z",
  "payload" : {
    "id" : "tmt_1azjCbEBeToP5Dox0qgb5r",
    "type" : "dose_volume",
    "name" : "XBqibzTN47",
    "external_entity_id" : "Wj6AVHavmL",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "study" : {
      "id" : "sdy_3jY5MtBGI1Z37woRJvnlDY",
      "project_id" : "pjt_5XF6IFXif9vv5185ETdpKO",
      "name" : "nG7TMbxPFW",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ENab5vKjKs",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_57eYrxPbm3DqUmBlWdw5DX",
        "name" : "7p9ovuJ7b2",
        "email" : "9xiKQU81@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3R8RnIiy4wI6z3n9q9NE0R",
        "name" : "C6jYktf0ck",
        "email" : "OUk6QLgR@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:16.464439Z",
      "updated_at" : "2025-10-31T11:57:16.464439Z"
    },
    "created_at" : "2025-10-31T11:57:16.700184Z",
    "updated_at" : "2025-10-31T11:57:16.700184Z"
  }
}

study.treatment.deleted

Triggered when a treatment is deleted.

{
  "id" : "whe_2tXnS92wxfMrFDfeV1T9rI",
  "client_id" : "2771efa0-e086-43b5-a6d0-9ab0ab443878",
  "event" : "study.treatment.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.721415Z",
  "payload" : {
    "id" : "tmt_1azjCbEBeToP5Dox0qgb5r",
    "type" : "dose_volume",
    "name" : "XBqibzTN47",
    "external_entity_id" : "Wj6AVHavmL",
    "dose" : {
      "unit" : "mg/kg",
      "value" : "5",
      "display_unit" : "mg/kg",
      "display_value" : "5"
    },
    "dose_volume" : {
      "unit" : "ml/kg",
      "value" : "15",
      "display_unit" : "ml/kg",
      "display_value" : "15"
    },
    "stock" : {
      "unit" : "mg/ml",
      "value" : "10",
      "display_unit" : "mg/ml",
      "display_value" : "10"
    },
    "volume" : {
      "unit" : "µL",
      "value" : "8",
      "display_unit" : "µL",
      "display_value" : "8"
    },
    "metadata" : {
      "treatment-internal-id" : "TREATMENT-1234"
    },
    "study" : {
      "id" : "sdy_3jY5MtBGI1Z37woRJvnlDY",
      "project_id" : "pjt_5XF6IFXif9vv5185ETdpKO",
      "name" : "nG7TMbxPFW",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ENab5vKjKs",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_57eYrxPbm3DqUmBlWdw5DX",
        "name" : "7p9ovuJ7b2",
        "email" : "9xiKQU81@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_3R8RnIiy4wI6z3n9q9NE0R",
        "name" : "C6jYktf0ck",
        "email" : "OUk6QLgR@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:16.464439Z",
      "updated_at" : "2025-10-31T11:57:16.464439Z"
    },
    "created_at" : "2025-10-31T11:57:16.700184Z",
    "updated_at" : "2025-10-31T11:57:16.700184Z"
  }
}

study.treatment.assigned

Triggered when a treatment is assigned to a study group.

{
  "id" : "whe_2QqY65JAVL3dHvWhXXEaX9",
  "client_id" : "cbb1dca1-c65e-4019-a702-74580ecce69a",
  "event" : "study.treatment.assigned",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.197932Z",
  "payload" : {
    "treatment" : {
      "id" : "tmt_6cbsybVeBJvykrPl6nQX3Z",
      "type" : "concentration",
      "name" : "O5AJnBDvVl",
      "external_entity_id" : "tYCoUFjJLC",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "study" : {
        "id" : "sdy_2Avg1BD8vOdD3KY0yS8ZAo",
        "project_id" : "pjt_48C2a1uEyzplXY1MK8Fwrx",
        "name" : "eRZzO4n8hu",
        "code" : "CD-25-445",
        "type" : "internal",
        "started_on" : "2025-10-31",
        "status" : "in_progress",
        "description" : "fJQxqxZ6BH",
        "timezone" : "America/Los_Angeles",
        "metadata" : {
          "study-internal-id" : "STUDY-1234"
        },
        "author" : {
          "id" : "usr_7G4VRVHfYLnr2hiiWDW5vx",
          "name" : "76TmHn9vUU",
          "email" : "DBPlgMCI@benchling.com",
          "timezone" : "UTC"
        },
        "owner" : {
          "id" : "usr_2J0sfN3WsblDrlzbPIyEwI",
          "name" : "1fekK44ekr",
          "email" : "g3mtToHP@benchling.com",
          "timezone" : "UTC"
        },
        "completed_at" : null,
        "canceled_at" : null,
        "created_at" : "2025-10-31T11:57:16.037862Z",
        "updated_at" : "2025-10-31T11:57:16.037862Z"
      },
      "created_at" : "2025-10-31T11:57:16.189319Z",
      "updated_at" : "2025-10-31T11:57:16.189319Z"
    },
    "study_group" : {
      "id" : "grp_4V7tV0LO4y6ho9RQRgVh28",
      "name" : "g8Y75rp7sE",
      "no" : 1206691013,
      "color" : "#dc781e",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-external-id" : "GROUP-1234"
      },
      "study" : {
        "id" : "sdy_2Avg1BD8vOdD3KY0yS8ZAo",
        "project_id" : "pjt_48C2a1uEyzplXY1MK8Fwrx",
        "name" : "eRZzO4n8hu",
        "code" : "CD-25-445",
        "type" : "internal",
        "started_on" : "2025-10-31",
        "status" : "in_progress",
        "description" : "fJQxqxZ6BH",
        "timezone" : "America/Los_Angeles",
        "metadata" : {
          "study-internal-id" : "STUDY-1234"
        },
        "author" : {
          "id" : "usr_7G4VRVHfYLnr2hiiWDW5vx",
          "name" : "76TmHn9vUU",
          "email" : "DBPlgMCI@benchling.com",
          "timezone" : "UTC"
        },
        "owner" : {
          "id" : "usr_2J0sfN3WsblDrlzbPIyEwI",
          "name" : "1fekK44ekr",
          "email" : "g3mtToHP@benchling.com",
          "timezone" : "UTC"
        },
        "completed_at" : null,
        "canceled_at" : null,
        "created_at" : "2025-10-31T11:57:16.037862Z",
        "updated_at" : "2025-10-31T11:57:16.037862Z"
      },
      "created_at" : "2025-10-31T11:57:16.182356Z",
      "updated_at" : "2025-10-31T11:57:16.182356Z"
    }
  }
}

study.treatment.unassigned

Triggered when a treatment is unassigned from a study group.

{
  "id" : "whe_6IHJ5rZsWfC7EEBmTbJhha",
  "client_id" : "fba97a1c-f195-4693-9d6a-96fd6cfb6bf6",
  "event" : "study.treatment.unassigned",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:16.199094Z",
  "payload" : {
    "treatment" : {
      "id" : "tmt_6cbsybVeBJvykrPl6nQX3Z",
      "type" : "concentration",
      "name" : "O5AJnBDvVl",
      "external_entity_id" : "tYCoUFjJLC",
      "dose" : {
        "unit" : "mg/kg",
        "value" : "5",
        "display_unit" : "mg/kg",
        "display_value" : "5"
      },
      "dose_volume" : {
        "unit" : "ml/kg",
        "value" : "15",
        "display_unit" : "ml/kg",
        "display_value" : "15"
      },
      "stock" : {
        "unit" : "mg/ml",
        "value" : "10",
        "display_unit" : "mg/ml",
        "display_value" : "10"
      },
      "volume" : {
        "unit" : "µL",
        "value" : "8",
        "display_unit" : "µL",
        "display_value" : "8"
      },
      "metadata" : {
        "treatment-internal-id" : "TREATMENT-1234"
      },
      "study" : {
        "id" : "sdy_2Avg1BD8vOdD3KY0yS8ZAo",
        "project_id" : "pjt_48C2a1uEyzplXY1MK8Fwrx",
        "name" : "eRZzO4n8hu",
        "code" : "CD-25-445",
        "type" : "internal",
        "started_on" : "2025-10-31",
        "status" : "in_progress",
        "description" : "fJQxqxZ6BH",
        "timezone" : "America/Los_Angeles",
        "metadata" : {
          "study-internal-id" : "STUDY-1234"
        },
        "author" : {
          "id" : "usr_7G4VRVHfYLnr2hiiWDW5vx",
          "name" : "76TmHn9vUU",
          "email" : "DBPlgMCI@benchling.com",
          "timezone" : "UTC"
        },
        "owner" : {
          "id" : "usr_2J0sfN3WsblDrlzbPIyEwI",
          "name" : "1fekK44ekr",
          "email" : "g3mtToHP@benchling.com",
          "timezone" : "UTC"
        },
        "completed_at" : null,
        "canceled_at" : null,
        "created_at" : "2025-10-31T11:57:16.037862Z",
        "updated_at" : "2025-10-31T11:57:16.037862Z"
      },
      "created_at" : "2025-10-31T11:57:16.189319Z",
      "updated_at" : "2025-10-31T11:57:16.189319Z"
    },
    "study_group" : {
      "id" : "grp_4V7tV0LO4y6ho9RQRgVh28",
      "name" : "g8Y75rp7sE",
      "no" : 1206691013,
      "color" : "#dc781e",
      "max_animals" : 10,
      "control" : false,
      "metadata" : {
        "study-group-external-id" : "GROUP-1234"
      },
      "study" : {
        "id" : "sdy_2Avg1BD8vOdD3KY0yS8ZAo",
        "project_id" : "pjt_48C2a1uEyzplXY1MK8Fwrx",
        "name" : "eRZzO4n8hu",
        "code" : "CD-25-445",
        "type" : "internal",
        "started_on" : "2025-10-31",
        "status" : "in_progress",
        "description" : "fJQxqxZ6BH",
        "timezone" : "America/Los_Angeles",
        "metadata" : {
          "study-internal-id" : "STUDY-1234"
        },
        "author" : {
          "id" : "usr_7G4VRVHfYLnr2hiiWDW5vx",
          "name" : "76TmHn9vUU",
          "email" : "DBPlgMCI@benchling.com",
          "timezone" : "UTC"
        },
        "owner" : {
          "id" : "usr_2J0sfN3WsblDrlzbPIyEwI",
          "name" : "1fekK44ekr",
          "email" : "g3mtToHP@benchling.com",
          "timezone" : "UTC"
        },
        "completed_at" : null,
        "canceled_at" : null,
        "created_at" : "2025-10-31T11:57:16.037862Z",
        "updated_at" : "2025-10-31T11:57:16.037862Z"
      },
      "created_at" : "2025-10-31T11:57:16.182356Z",
      "updated_at" : "2025-10-31T11:57:16.182356Z"
    }
  }
}

Study User

study.user.created

Triggered when a study user is created.

{
  "id" : "whe_3XOLdiATTVZfQ0G9oa1VnF",
  "client_id" : "0bfd66b0-57e1-456c-9972-f7d12d03cc0a",
  "event" : "study.user.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.394930Z",
  "payload" : {
    "id" : "usr_yr8FCd9IOFRJpn7wgPNJu",
    "name" : "0RPZ21kQlO",
    "email" : "b8ktHYqF@benchling.com",
    "timezone" : "UTC",
    "type" : "author",
    "access" : "write",
    "study" : {
      "id" : "sdy_6y29np17qcg9q7N2nSHOZS",
      "project_id" : "pjt_43DGxsMjsmHQzWs6Pnsqlw",
      "name" : "LHQDVdgaUB",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ViquAxlCBg",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_yr8FCd9IOFRJpn7wgPNJu",
        "name" : "0RPZ21kQlO",
        "email" : "b8ktHYqF@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5v0UZ9OVAuC1GA7MRohSec",
        "name" : "YtweNt8EZo",
        "email" : "xfQv2f2S@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.099170Z",
      "updated_at" : "2025-10-31T11:57:17.099170Z"
    }
  }
}

study.user.updated

Triggered when a study user is updated.

{
  "id" : "whe_6TB1sAyXrf892IEQMwh4jd",
  "client_id" : "e7b3d426-2c57-440f-954c-f3f4073f7412",
  "event" : "study.user.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.396083Z",
  "payload" : {
    "id" : "usr_yr8FCd9IOFRJpn7wgPNJu",
    "name" : "0RPZ21kQlO",
    "email" : "b8ktHYqF@benchling.com",
    "timezone" : "UTC",
    "type" : "author",
    "access" : "write",
    "study" : {
      "id" : "sdy_6y29np17qcg9q7N2nSHOZS",
      "project_id" : "pjt_43DGxsMjsmHQzWs6Pnsqlw",
      "name" : "LHQDVdgaUB",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ViquAxlCBg",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_yr8FCd9IOFRJpn7wgPNJu",
        "name" : "0RPZ21kQlO",
        "email" : "b8ktHYqF@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5v0UZ9OVAuC1GA7MRohSec",
        "name" : "YtweNt8EZo",
        "email" : "xfQv2f2S@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.099170Z",
      "updated_at" : "2025-10-31T11:57:17.099170Z"
    }
  }
}

study.user.deleted

Triggered when a study user is deleted.

{
  "id" : "whe_1JXhkUpf0Ehypl3weqpzYP",
  "client_id" : "c5805e78-0680-40ef-8e7e-ee74e4fdbb57",
  "event" : "study.user.deleted",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.396685Z",
  "payload" : {
    "id" : "usr_yr8FCd9IOFRJpn7wgPNJu",
    "name" : "0RPZ21kQlO",
    "email" : "b8ktHYqF@benchling.com",
    "timezone" : "UTC",
    "type" : "author",
    "access" : "write",
    "study" : {
      "id" : "sdy_6y29np17qcg9q7N2nSHOZS",
      "project_id" : "pjt_43DGxsMjsmHQzWs6Pnsqlw",
      "name" : "LHQDVdgaUB",
      "code" : "CD-25-445",
      "type" : "internal",
      "started_on" : "2025-10-31",
      "status" : "in_progress",
      "description" : "ViquAxlCBg",
      "timezone" : "America/Los_Angeles",
      "metadata" : {
        "study-internal-id" : "STUDY-1234"
      },
      "author" : {
        "id" : "usr_yr8FCd9IOFRJpn7wgPNJu",
        "name" : "0RPZ21kQlO",
        "email" : "b8ktHYqF@benchling.com",
        "timezone" : "UTC"
      },
      "owner" : {
        "id" : "usr_5v0UZ9OVAuC1GA7MRohSec",
        "name" : "YtweNt8EZo",
        "email" : "xfQv2f2S@benchling.com",
        "timezone" : "UTC"
      },
      "completed_at" : null,
      "canceled_at" : null,
      "created_at" : "2025-10-31T11:57:17.099170Z",
      "updated_at" : "2025-10-31T11:57:17.099170Z"
    }
  }
}

User

user.created

Triggered when a user is created on a team.

{
  "id" : "whe_dhvA6aH1Mnq3motFMOQsV",
  "client_id" : "ab59b1e5-05eb-41e7-9fd9-5e3a9a44fa8f",
  "event" : "user.created",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.484741Z",
  "payload" : {
    "id" : "usr_17WaABb4Dx3uLyudmRLyJd",
    "name" : "LGq7I Overwatch",
    "email" : "31yiBptb@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:57:17.463223Z",
    "updated_at" : "2025-10-31T11:57:17.463223Z"
  }
}

user.updated

Triggered when a user is updated on a team.

{
  "id" : "whe_483C02GkjTwmz7FqtyBBZy",
  "client_id" : "3c4ddcea-13dc-4d05-9301-20ab84a4f4cd",
  "event" : "user.updated",
  "version" : "2022-12-14",
  "created_at" : "2025-10-31T11:57:17.486209Z",
  "payload" : {
    "id" : "usr_17WaABb4Dx3uLyudmRLyJd",
    "name" : "LGq7I Overwatch",
    "email" : "31yiBptb@benchling.com",
    "timezone" : "UTC",
    "status" : "active",
    "metadata" : {
      "user-internal-id" : "USER-1234"
    },
    "created_at" : "2025-10-31T11:57:17.463223Z",
    "updated_at" : "2025-10-31T11:57:17.463223Z"
  }
}