{
"error": "experiment not found",
"request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}
{
"error": "experiment not found",
"request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}
{
"error": "experiment not found",
"request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}
{
"error": "experiment not found",
"request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}
{
"error": "experiment not found",
"request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}
{
"error": "experiment not found",
"request_id": "req_019462a4-b1c2-7def-8901-23456789abcd"
}
experiments
Update experiment
Modify an existing experiment’s configuration or status.
Updates experiment metadata or inputs. Most fields can only be changed while
the experiment is in Draft or InReview status; naming one on a later status
returns 409 Conflict. webhook_url is the exception and stays editable for
the life of the experiment, so a customer can repoint delivery after
submitting.
Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the /tokens endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use /tokens/attenuate to create restricted tokens for delegation.
Request payload for modifying an existing experiment.
All fields are optional - only provided fields will be updated.
Note: Some modifications may be restricted based on experiment status.
Modifications are only allowed if the experiment request is not yet fulfilled.
Status transitions are handled separately via the /experiments/{id}/confirm
endpoint, which performs the appropriate transition based on current state.
Update experiment parameters (restrictions may apply, only if not fulfilled).
The keys merge into the stored parameters. For enzyme_activity,
enzyme_order replaces the enzyme order: an object with enzyme_id,
purified, conditions (at least 1), biological_replicates (at
least 0) and thermostability, all required. Add-ons are not
available yet, so the order must have conditions 1,
biological_replicates 0, thermostability false and purified only
when the protocol requires it. The replicates reset to the enzyme's
protocol count. A malformed order or an order with add-ons returns
400, and so does enzyme_order on another experiment type.
Update the webhook URL for push notifications. The URL receives an
experiment_update event for every customer-facing update on the
experiment — the same updates that trigger an email notification.
Unlike every other field here, this one can be changed at any status, so
delivery can be repointed after the experiment has been submitted.
Response
Experiment modified successfully or no action taken (e.g., already fulfilled)
Optional message, e.g., if modification is not allowed
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Adaptyv Bio Docs","colors":{"primary":"#5db0dd","light":"#5db0dd","dark":"#5db0dd"},"logo":{"light":"https://mintcdn.com/adaptyv-a4917ef6/3kX9xKvyzUlLV3Dj/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=3kX9xKvyzUlLV3Dj\u0026q=85\u0026s=28a1e3df60674482d4bac1fc9d190568","dark":"https://mintcdn.com/adaptyv-a4917ef6/3kX9xKvyzUlLV3Dj/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=3kX9xKvyzUlLV3Dj\u0026q=85\u0026s=9af068e2ee0cfcd18651c6d5de78183b"},"favicon":"https://mintcdn.com/adaptyv-a4917ef6/3kX9xKvyzUlLV3Dj/favicon.svg?fit=max\u0026auto=format\u0026n=3kX9xKvyzUlLV3Dj\u0026q=85\u0026s=3c844e90e21e045d7ed937e532aa2bdf","background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@adaptyvbio.com","label":"Support"}],"primary":{"type":"button","label":"Test Your Proteins","href":"https://start.adaptyvbio.com"}},"footer":{"socials":{"x":"https://twitter.com/adaptyvbio","linkedin":"https://www.linkedin.com/company/adaptyvbio"}},"integrations":{"posthog":{"apiKey":"phc_BakxHKWkh2YgICIAQeQJuGpagepWpTNHGzWmf6dGAsU"}},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Careers","icon":"users","href":"https://www.adaptyvbio.com/careers"},{"anchor":"Blog","icon":"newspaper","href":"https://www.adaptyvbio.com/blog"},{"anchor":"Experiment Configurator","icon":"flask","href":"https://start.adaptyvbio.com"},{"anchor":"Foundry Portal","icon":"desktop","href":"https://foundry.adaptyvbio.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adaptyv-a4917ef6","hasAudioNarration":false,"actualSubdomain":"adaptyv-a4917ef6","customDomains":["docs.adaptyvbio.com"],"gitSource":{"type":"github","owner":"adaptyvbio","repo":"monorepo","deployBranch":"master","contentDirectory":"apps/docs-public","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af08f401d63cdd7f63d7d99","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API","count":50},{"language":"default","tag":"API Endpoints","count":43},{"language":"default","tag":"Wiki","count":26},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"experiments","count":13},{"language":"default","tag":"Technologies","count":10},{"language":"default","tag":"Proteins","count":9},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Experiment Setup","count":5},{"language":"default","tag":"Experiment Types","count":5}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":false,"enableAskAiSearchBar":false,"deflection":{"enabled":true,"email":"support@adaptyvbio.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".shape-grid{margin:1rem 0 1.5rem}.sg-cards{display:grid;grid-template-columns:repeat(4,1fr);gap:10px}@media (max-width:640px){.sg-cards{grid-template-columns:repeat(2,1fr)}}.sg-card{position:relative;display:block;border:2px solid #e6e8ec;border-radius:10px;padding:7px 7px 5px;background:#fff;cursor:pointer;transition:border-color .12s,box-shadow .12s,background .12s,transform .12s}.sg-radio{position:absolute;width:1px;height:1px;opacity:0;pointer-events:none;margin:0}.sg-card img{width:100%;height:auto;display:block;margin:0}.sg-card span{display:block;font-size:11.5px;font-weight:600;text-align:center;margin-top:5px;line-height:1.25;color:#5b6472}.sg-card:hover,.shape-grid:not(:has(.sg-card:hover)) .sg-card:has(.sg-radio:checked){border-color:#3b6cf0;background:#eef3ff;box-shadow:0 0 0 3px #3b6cf0;transform:translateY(-2px)}.sg-card:hover span,.shape-grid:not(:has(.sg-card:hover)) .sg-card:has(.sg-radio:checked) span{color:#2b56c8}.sg-card:has(.sg-radio:focus-visible){outline:2px solid #3b6cf0;outline-offset:2px}.sg-caption{margin-top:16px;border:1px solid #e6e8ec;border-left:3px solid #3b6cf0;border-radius:8px;padding:14px 16px;min-height:72px}.sg-cap{display:none}.sg-sugg{display:block;margin-top:9px;padding-top:9px;border-top:1px solid #e6e8ec;font-size:.93em}.sg-sugg strong{color:#2b56c8}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"ideal\"] .sg-radio:checked) .sg-cap[data-k=\"ideal\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"no-plateau\"] .sg-radio:checked) .sg-cap[data-k=\"no-plateau\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"flat-dissoc\"] .sg-radio:checked) .sg-cap[data-k=\"flat-dissoc\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"square-wave\"] .sg-radio:checked) .sg-cap[data-k=\"square-wave\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"mass-transport\"] .sg-radio:checked) .sg-cap[data-k=\"mass-transport\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"biphasic\"] .sg-radio:checked) .sg-cap[data-k=\"biphasic\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"drift\"] .sg-radio:checked) .sg-cap[data-k=\"drift\"]{display:block}.shape-grid:not(:has(.sg-card:hover)):has(.sg-card[data-k=\"super-stoich\"] .sg-radio:checked) .sg-cap[data-k=\"super-stoich\"]{display:block}.shape-grid:has(.sg-card[data-k=\"ideal\"]:hover) .sg-cap[data-k=\"ideal\"]{display:block}.shape-grid:has(.sg-card[data-k=\"no-plateau\"]:hover) .sg-cap[data-k=\"no-plateau\"]{display:block}.shape-grid:has(.sg-card[data-k=\"flat-dissoc\"]:hover) .sg-cap[data-k=\"flat-dissoc\"]{display:block}.shape-grid:has(.sg-card[data-k=\"square-wave\"]:hover) .sg-cap[data-k=\"square-wave\"]{display:block}.shape-grid:has(.sg-card[data-k=\"mass-transport\"]:hover) .sg-cap[data-k=\"mass-transport\"]{display:block}.shape-grid:has(.sg-card[data-k=\"biphasic\"]:hover) .sg-cap[data-k=\"biphasic\"]{display:block}.shape-grid:has(.sg-card[data-k=\"drift\"]:hover) .sg-cap[data-k=\"drift\"]{display:block}.shape-grid:has(.sg-card[data-k=\"super-stoich\"]:hover) .sg-cap[data-k=\"super-stoich\"]{display:block}.dark .sg-card{background:#111827;border-color:#243040}.dark .sg-card span{color:#9aa4b2}.dark .sg-caption{border-color:#243040}.dark .sg-sugg{border-top-color:#243040}.dark .sg-sugg strong{color:#9db8ff}.dark .sg-card:hover,.dark .shape-grid:not(:has(.sg-card:hover)) .sg-card:has(.sg-radio:checked){border-color:#6c95ff;background:#17233d;box-shadow:0 0 0 3px #6c95ff}.dark .sg-card:hover span,.dark .shape-grid:not(:has(.sg-card:hover)) .sg-card:has(.sg-radio:checked) span{color:#9db8ff}"}],"page":{"pagePath":"api-reference/experiments/update-experiment","slug":"/api-reference/experiments/update-experiment","pageMetadata":{"title":"Update experiment","description":"Modify an existing experiment's configuration or status.\n\nUpdates experiment metadata or inputs. Most fields can only be changed while\nthe experiment is in Draft or InReview status; naming one on a later status\nreturns 409 Conflict. `webhook_url` is the exception and stays editable for\nthe life of the experiment, so a customer can repoint delivery after\nsubmitting.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json patch /api/v1/experiments/{experiment_id}","href":"/api-reference/experiments/update-experiment","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Modify an existing experiment’s configuration or status.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Updates experiment metadata or inputs. Most fields can only be changed while\\nthe experiment is in Draft or InReview status; naming one on a later status\\nreturns 409 Conflict. \", _jsx(_components.code, {\n children: \"webhook_url\"\n }), \" is the exception and stays editable for\\nthe life of the experiment, so a customer can repoint delivery after\\nsubmitting.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update experiment","description":"Modify an existing experiment's configuration or status.\n\nUpdates experiment metadata or inputs. Most fields can only be changed while\nthe experiment is in Draft or InReview status; naming one on a later status\nreturns 409 Conflict. `webhook_url` is the exception and stays editable for\nthe life of the experiment, so a customer can repoint delivery after\nsubmitting.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json patch /api/v1/experiments/{experiment_id}","href":"/api-reference/experiments/update-experiment","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["experiments"],"summary":"Update experiment","description":"Modify an existing experiment's configuration or status.\n\nUpdates experiment metadata or inputs. Most fields can only be changed while\nthe experiment is in Draft or InReview status; naming one on a later status\nreturns 409 Conflict. `webhook_url` is the exception and stays editable for\nthe life of the experiment, so a customer can repoint delivery after\nsubmitting.","operationId":"modify_exp","parameters":["d32ed730-4455-43eb-b7e0-11d1e47a26ca"],"requestBody":"e55fb39a-6024-4ec2-9f8f-bef930a4ed27","responses":{"200":"be9a6df7-ce7d-4f67-8367-5fc2a342bfd4","400":"a07fdc5e-5d43-4076-86c6-3a0a31859a6b","401":"37126676-37d1-4b79-9763-94a088acf3dd","404":"97f73312-7ffb-4f0e-afdf-61fb5a6e6680","409":"ec5ec9b1-3e8b-463d-a4f8-2d5f560a0328","415":"98a4d814-06e1-4d77-8ac3-1608ecede26b","422":"8528a820-a818-44de-847e-e693cbb2cef5"},"method":"patch","type":"path","servers":["3ae1549d-def4-4e64-a719-6d8a9091873d"],"security":["706b04f2-06cf-4e51-9a6d-81edb857c377"],"path":"/api/v1/experiments/{experiment_id}","baseUrlOptions":["https://devs.adaptyvbio.com/"],"title":"Update experiment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d32ed730-4455-43eb-b7e0-11d1e47a26ca":{"name":"experiment_id","in":"path","description":"Unique experiment request identifier to modify","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Unique experiment request identifier to modify","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Request payload for modifying an existing experiment.\n\nAll fields are optional - only provided fields will be updated.\nNote: Some modifications may be restricted based on experiment status.\nModifications are only allowed if the experiment request is not yet fulfilled.\n\nStatus transitions are handled separately via the `/experiments/{id}/confirm`\nendpoint, which performs the appropriate transition based on current state.","properties":{"antigen_concentrations":{"oneOf":[{"type":"array","items":{"type":"number","format":"double","uniqueKey":"antigen_concentrations.oneOf.0.items.[INDEX]","typeLabel":"number\u003cdouble>"},"description":"Update antigen concentrations (only if not fulfilled)","uniqueKey":"antigen_concentrations.oneOf.0","typeLabel":"number\u003cdouble>[]"},{"type":"null","items":{"type":"number","format":"double"},"description":"Update antigen concentrations (only if not fulfilled)","uniqueKey":"antigen_concentrations.oneOf.1","typeLabel":"null"}],"uniqueKey":"antigen_concentrations","typeLabel":"number\u003cdouble>[] | null"},"description":{"oneOf":[{"type":"string","description":"Update experiment description","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Update experiment description","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"n_replicates":{"oneOf":[{"type":"integer","format":"int32","description":"Update replicate count (only if not fulfilled)","minimum":0,"uniqueKey":"n_replicates.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"Update replicate count (only if not fulfilled)","minimum":0,"uniqueKey":"n_replicates.oneOf.1","typeLabel":"null"}],"uniqueKey":"n_replicates","typeLabel":"integer\u003cint32> | null"},"name":{"oneOf":[{"type":"string","description":"Update experiment name","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Update experiment name","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"parameters":{"oneOf":[{"type":"object","description":"Update experiment parameters (restrictions may apply, only if not fulfilled).\nThe keys merge into the stored parameters. For `enzyme_activity`,\n`enzyme_order` replaces the enzyme order: an object with `enzyme_id`,\n`purified`, `conditions` (at least 1), `biological_replicates` (at\nleast 0) and `thermostability`, all required. Add-ons are not\navailable yet, so the order must have `conditions` 1,\n`biological_replicates` 0, `thermostability` false and `purified` only\nwhen the protocol requires it. The replicates reset to the enzyme's\nprotocol count. A malformed order or an order with add-ons returns\n`400`, and so does `enzyme_order` on another experiment type.","uniqueKey":"parameters.oneOf.0","typeLabel":"object"},{"type":"null","description":"Update experiment parameters (restrictions may apply, only if not fulfilled).\nThe keys merge into the stored parameters. For `enzyme_activity`,\n`enzyme_order` replaces the enzyme order: an object with `enzyme_id`,\n`purified`, `conditions` (at least 1), `biological_replicates` (at\nleast 0) and `thermostability`, all required. Add-ons are not\navailable yet, so the order must have `conditions` 1,\n`biological_replicates` 0, `thermostability` false and `purified` only\nwhen the protocol requires it. The replicates reset to the enzyme's\nprotocol count. A malformed order or an order with add-ons returns\n`400`, and so does `enzyme_order` on another experiment type.","uniqueKey":"parameters.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameters","typeLabel":"object | null"},"sequences":{"oneOf":[{"type":"array","items":{"type":"object","description":"Represents a biological sequence to be tested in an experiment.\n\nEach sequence represents an antibody or protein to be tested in the experiment.\n\n# Example\n\n```json\n{\n \"name\": \"mAb1\",\n \"aa_string\": \"EVQLVESGGGLVQPGGSLRLSCAASGFTFS...\",\n \"control\": false\n}\n```","required":["aa_string"],"properties":{"aa_string":{"type":"string","description":"Protein/peptide sequence in standard single-letter amino acid format.\n\nValid characters: A,C,D,E,F,G,H,I,K,L,M,N,P,Q,R,S,T,V,W,Y and colon for multichain.","example":"EVQLVESGGGLVQPGGSLRLSCAAS","isRequired":true,"uniqueKey":"sequences.oneOf.0.items.[INDEX].aa_string","typeLabel":"string"},"control":{"type":"boolean","description":"Whether the sequence should be treated as a control well","uniqueKey":"sequences.oneOf.0.items.[INDEX].control","typeLabel":"boolean"},"metadata":{"description":"Arbitrary metadata supplied by the customer (tag locations, notes)","uniqueKey":"sequences.oneOf.0.items.[INDEX].metadata","typeLabel":"any"},"name":{"oneOf":[{"type":"string","description":"Optional name for the sequence (e.g., \"mAb1\", \"scFv-001\")","example":"mAb1","uniqueKey":"sequences.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional name for the sequence (e.g., \"mAb1\", \"scFv-001\")","example":"mAb1","uniqueKey":"sequences.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"sequences.oneOf.0.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"sequences.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Replace sequence list (only if not fulfilled)","uniqueKey":"sequences.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","description":"Represents a biological sequence to be tested in an experiment.\n\nEach sequence represents an antibody or protein to be tested in the experiment.\n\n# Example\n\n```json\n{\n \"name\": \"mAb1\",\n \"aa_string\": \"EVQLVESGGGLVQPGGSLRLSCAASGFTFS...\",\n \"control\": false\n}\n```","required":["aa_string"],"properties":{"aa_string":{"type":"string","description":"Protein/peptide sequence in standard single-letter amino acid format.\n\nValid characters: A,C,D,E,F,G,H,I,K,L,M,N,P,Q,R,S,T,V,W,Y and colon for multichain.","example":"EVQLVESGGGLVQPGGSLRLSCAAS"},"control":{"type":"boolean","description":"Whether the sequence should be treated as a control well"},"metadata":{"description":"Arbitrary metadata supplied by the customer (tag locations, notes)"},"name":{"oneOf":[{"type":"string","description":"Optional name for the sequence (e.g., \"mAb1\", \"scFv-001\")","example":"mAb1"},{"type":"null","description":"Optional name for the sequence (e.g., \"mAb1\", \"scFv-001\")","example":"mAb1"}]}}},"description":"Replace sequence list (only if not fulfilled)","uniqueKey":"sequences.oneOf.1","typeLabel":"null"}],"uniqueKey":"sequences","typeLabel":"object[] | null"},"target_id":{"oneOf":[{"type":"string","description":"Change the experiment's catalog target (only while the experiment is editable).\n\n- omitted: keep the current target\n- `null`: clear the target\n- a catalog product UUID (as returned by `GET /targets`): set the target to that product","uniqueKey":"target_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Change the experiment's catalog target (only while the experiment is editable).\n\n- omitted: keep the current target\n- `null`: clear the target\n- a catalog product UUID (as returned by `GET /targets`): set the target to that product","uniqueKey":"target_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"target_id","typeLabel":"string | null"},"webhook_url":{"oneOf":[{"type":"string","description":"Update the webhook URL for push notifications. The URL receives an\n`experiment_update` event for every customer-facing update on the\nexperiment — the same updates that trigger an email notification.\n\nUnlike every other field here, this one can be changed at any status, so\ndelivery can be repointed after the experiment has been submitted.","uniqueKey":"webhook_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Update the webhook URL for push notifications. The URL receives an\n`experiment_update` event for every customer-facing update on the\nexperiment — the same updates that trigger an email notification.\n\nUnlike every other field here, this one can be changed at any status, so\ndelivery can be repointed after the experiment has been submitted.","uniqueKey":"webhook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_url","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"antigen_concentrations":[123],"description":"\u003cstring>","n_replicates":1,"name":"\u003cstring>","parameters":{},"sequences":[{"aa_string":"EVQLVESGGGLVQPGGSLRLSCAAS","control":true,"metadata":"\u003cunknown>","name":"mAb1"}],"target_id":"\u003cstring>","webhook_url":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"be9a6df7-ce7d-4f67-8367-5fc2a342bfd4":{"description":"Experiment modified successfully or no action taken (e.g., already fulfilled)","content":{"application/json":{"schema":{"type":"object","description":"Response confirming experiment modification.","required":["id","updated"],"properties":{"id":{"type":"string","description":"Experiment identifier that was modified","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"updated":{"type":"boolean","description":"Indicates if any changes were applied","isRequired":true,"uniqueKey":"updated","typeLabel":"boolean"},"message":{"oneOf":[{"type":"string","description":"Optional message, e.g., if modification is not allowed","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional message, e.g., if modification is not allowed","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","updated":true,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a07fdc5e-5d43-4076-86c6-3a0a31859a6b":{"description":"Invalid modification request, including a malformed `parameters.enzyme_order` or a replacement sequence list containing duplicates — two sequences sharing normalized residues and tag location (Fabs exempt); also a malformed body, or `Content-Type: application/json` declared with no body sent","content":{"application/json":{"schema":{"type":"object","description":"Error response body returned by all endpoints on 4xx/5xx failures.\n\nEvery error response contains a human-readable message and the request ID\nfor support correlation. The `request_id` is also returned in the\n`x-request-id` response header.","required":["error","request_id"],"properties":{"error":{"type":"string","description":"Human-readable error description.","example":"experiment not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"request_id":{"type":"string","description":"Request identifier for support correlation (also in `x-request-id` header).","example":"req_019462a4-b1c2-7def-8901-23456789abcd","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"experiment not found","request_id":"req_019462a4-b1c2-7def-8901-23456789abcd"}}},"exampleType":"generated"}},"exampleType":"generated"},"37126676-37d1-4b79-9763-94a088acf3dd":{"description":"Invalid or missing authentication token","content":{"application/json":{"schema":{"type":"object","description":"Error response body returned by all endpoints on 4xx/5xx failures.\n\nEvery error response contains a human-readable message and the request ID\nfor support correlation. The `request_id` is also returned in the\n`x-request-id` response header.","required":["error","request_id"],"properties":{"error":{"type":"string","description":"Human-readable error description.","example":"experiment not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"request_id":{"type":"string","description":"Request identifier for support correlation (also in `x-request-id` header).","example":"req_019462a4-b1c2-7def-8901-23456789abcd","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"experiment not found","request_id":"req_019462a4-b1c2-7def-8901-23456789abcd"}}},"exampleType":"generated"}},"exampleType":"generated"},"97f73312-7ffb-4f0e-afdf-61fb5a6e6680":{"description":"Experiment request not found","content":{"application/json":{"schema":{"type":"object","description":"Error response body returned by all endpoints on 4xx/5xx failures.\n\nEvery error response contains a human-readable message and the request ID\nfor support correlation. The `request_id` is also returned in the\n`x-request-id` response header.","required":["error","request_id"],"properties":{"error":{"type":"string","description":"Human-readable error description.","example":"experiment not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"request_id":{"type":"string","description":"Request identifier for support correlation (also in `x-request-id` header).","example":"req_019462a4-b1c2-7def-8901-23456789abcd","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"experiment not found","request_id":"req_019462a4-b1c2-7def-8901-23456789abcd"}}},"exampleType":"generated"}},"exampleType":"generated"},"ec5ec9b1-3e8b-463d-a4f8-2d5f560a0328":{"description":"Modification not allowed (e.g., request already fulfilled)","content":{"application/json":{"schema":{"type":"object","description":"Error response body returned by all endpoints on 4xx/5xx failures.\n\nEvery error response contains a human-readable message and the request ID\nfor support correlation. The `request_id` is also returned in the\n`x-request-id` response header.","required":["error","request_id"],"properties":{"error":{"type":"string","description":"Human-readable error description.","example":"experiment not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"request_id":{"type":"string","description":"Request identifier for support correlation (also in `x-request-id` header).","example":"req_019462a4-b1c2-7def-8901-23456789abcd","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"experiment not found","request_id":"req_019462a4-b1c2-7def-8901-23456789abcd"}}},"exampleType":"generated"}},"exampleType":"generated"},"98a4d814-06e1-4d77-8ac3-1608ecede26b":{"description":"No body was sent, or a body was sent under a content type other than `application/json`. A JSON body is required; every field is optional, so send `{}` if you have nothing to change","content":{"application/json":{"schema":{"type":"object","description":"Error response body returned by all endpoints on 4xx/5xx failures.\n\nEvery error response contains a human-readable message and the request ID\nfor support correlation. The `request_id` is also returned in the\n`x-request-id` response header.","required":["error","request_id"],"properties":{"error":{"type":"string","description":"Human-readable error description.","example":"experiment not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"request_id":{"type":"string","description":"Request identifier for support correlation (also in `x-request-id` header).","example":"req_019462a4-b1c2-7def-8901-23456789abcd","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"experiment not found","request_id":"req_019462a4-b1c2-7def-8901-23456789abcd"}}},"exampleType":"generated"}},"exampleType":"generated"},"8528a820-a818-44de-847e-e693cbb2cef5":{"description":"Well-formed JSON that does not fit `ModifyExpRequest`","content":{"application/json":{"schema":{"type":"object","description":"Error response body returned by all endpoints on 4xx/5xx failures.\n\nEvery error response contains a human-readable message and the request ID\nfor support correlation. The `request_id` is also returned in the\n`x-request-id` response header.","required":["error","request_id"],"properties":{"error":{"type":"string","description":"Human-readable error description.","example":"experiment not found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"request_id":{"type":"string","description":"Request identifier for support correlation (also in `x-request-id` header).","example":"req_019462a4-b1c2-7def-8901-23456789abcd","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"experiment not found","request_id":"req_019462a4-b1c2-7def-8901-23456789abcd"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"706b04f2-06cf-4e51-9a6d-81edb857c377":{"adaptyv_biscuits_v0":{"type":"http","scheme":"bearer","bearerFormat":"Adaptyv Biscuits v0","description":"Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the `/tokens` endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use `/tokens/attenuate` to create restricted tokens for delegation.","scopes":[],"schemeName":"adaptyv_biscuits_v0"}}},"servers":{"3ae1549d-def4-4e64-a719-6d8a9091873d":{"url":"https://devs.adaptyvbio.com/","description":"Production API (Public)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Adaptyv Biscuits v0","description":"Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the `/tokens` endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use `/tokens/attenuate` to create restricted tokens for delegation.","scopes":[],"schemeName":"adaptyv_biscuits_v0"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the `/tokens` endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use `/tokens/attenuate` to create restricted tokens for delegation.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"adaptyv_biscuits_v0","name":"Authorization"}],"title":"adaptyv_biscuits_v0"}]},"originalFileLocation":"https://devs.adaptyvbio.com/api/v1/openapi.json"},"subdomain":"adaptyv-a4917ef6","siteName":"Adaptyv Bio Docs","title":"Update experiment - Adaptyv Bio Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-08T15:03:33.513Z","originalFileLocation":"api-reference/experiments/update-experiment.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Modify an existing experiment\u0026#x27;s configuration or status. Updates experiment metadata or inputs. Most fields can only be changed while the experiment is in Draft or InReview status; naming one on a later status returns 409 Conflict. webhook_url is the exception and stays editable for the life of the experiment, so a customer can repoint delivery after submitting.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Adaptyv Bio Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update experiment - Adaptyv Bio Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Modify an existing experiment\u0026#x27;s configuration or status. Updates experiment metadata or inputs. Most fields can only be changed while the experiment is in Draft or InReview status; naming one on a later status returns 409 Conflict. webhook_url is the exception and stays editable for the life of the experiment, so a customer can repoint delivery after submitting.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Adaptyv Bio Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adaptyv-a4917ef6.mintlify.site/_mintlify/api/og/v2?division=experiments\u0026amp;title=Update+experiment\u0026amp;description=Modify+an+existing+experiment%27s+configuration+or+status.%0A%0AUpdates+experiment+metadata+or+inputs.+Most+fields+can+only+be+changed+while%0Athe+experiment+is+in+Draf\u0026amp;theme=43e189271cead89711960f8b\u0026amp;signature=f92358365c642872380e8913116014ccf5c43b4192fc1536877f0b26b11b6785\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update experiment - Adaptyv Bio Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Modify an existing experiment\u0026#x27;s configuration or status. Updates experiment metadata or inputs. Most fields can only be changed while the experiment is in Draft or InReview status; naming one on a later status returns 409 Conflict. webhook_url is the exception and stays editable for the life of the experiment, so a customer can repoint delivery after submitting.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adaptyv-a4917ef6.mintlify.site/_mintlify/api/og/v2?division=experiments\u0026amp;title=Update+experiment\u0026amp;description=Modify+an+existing+experiment%27s+configuration+or+status.%0A%0AUpdates+experiment+metadata+or+inputs.+Most+fields+can+only+be+changed+while%0Athe+experiment+is+in+Draf\u0026amp;theme=43e189271cead89711960f8b\u0026amp;signature=f92358365c642872380e8913116014ccf5c43b4192fc1536877f0b26b11b6785\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/adaptyv-a4917ef6/zzyucPz0fZkqpoJX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Adaptyv Bio Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5db0dd\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/experiments/update-experiment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.adaptyvbio.com/#organization\",\"name\":\"Adaptyv Bio Docs\",\"url\":\"https://docs.adaptyvbio.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/adaptyv-a4917ef6/3kX9xKvyzUlLV3Dj/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=3kX9xKvyzUlLV3Dj\u0026q=85\u0026s=28a1e3df60674482d4bac1fc9d190568\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.adaptyvbio.com#website\",\"name\":\"Adaptyv Bio Docs\",\"url\":\"https://docs.adaptyvbio.com\",\"publisher\":{\"@id\":\"https://docs.adaptyvbio.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment#webpage\",\"url\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment\",\"name\":\"Update experiment\",\"description\":\"Modify an existing experiment's configuration or status. Updates experiment metadata or inputs. Most fields can only be changed while the experiment is in Draft or InReview status; naming one on a later status returns 409 Conflict. webhook_url is the exception and stays editable for the life of the experiment, so a customer can repoint delivery after submitting.\",\"dateModified\":\"2026-11-08T15:03:33.513Z\",\"isPartOf\":{\"@id\":\"https://docs.adaptyvbio.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.adaptyvbio.com/api-reference/experiments/list-experiments\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"experiments\",\"item\":\"https://docs.adaptyvbio.com/api-reference/experiments/list-experiments\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update experiment\",\"item\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment#apireference\",\"headline\":\"Update experiment\",\"name\":\"Update experiment\",\"description\":\"Modify an existing experiment's configuration or status. Updates experiment metadata or inputs. Most fields can only be changed while the experiment is in Draft or InReview status; naming one on a later status returns 409 Conflict. webhook_url is the exception and stays editable for the life of the experiment, so a customer can repoint delivery after submitting.\",\"url\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adaptyvbio.com/api-reference/experiments/update-experiment#webpage\"},\"dateModified\":\"2026-11-08T15:03:33.513Z\",\"publisher\":{\"@id\":\"https://docs.adaptyvbio.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.adaptyvbio.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Adaptyv Bio Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Adaptyv Bio Docs","nav":{"global":{"anchors":[{"anchor":"Careers","icon":"users","href":"https://www.adaptyvbio.com/careers"},{"anchor":"Blog","icon":"newspaper","href":"https://www.adaptyvbio.com/blog"},{"anchor":"Experiment Configurator","icon":"flask","href":"https://start.adaptyvbio.com"},{"anchor":"Foundry Portal","icon":"desktop","href":"https://foundry.adaptyvbio.com"}]},"tabs":[{"tab":"Documentation","icon":"file-lines","pages":[{"title":"Documentation","href":"/docs/getting-started/introduction"}]},{"tab":"Wiki","icon":"book","pages":[{"title":"Wiki","href":"/wiki/technologies/cell-free-protein-expression"}]},{"tab":"Guides","icon":"lightbulb","pages":[{"title":"Guides","href":"/guides/improve-protein-expression"}]},{"tab":"API","icon":"code","groups":[{"group":"Getting Started","pages":[{"title":"Foundry API","href":"/api-reference/api-introduction"},{"title":"MCP Server","href":"/api-reference/mcp-server"},{"title":"Integrator \u0026 Partner Guide","href":"/api-reference/integrator-partner-guide"}]},{"group":"Payments","pages":[{"title":"Payments Overview","href":"/api-reference/payments/overview"},{"title":"Pay by hosted invoice","href":"/api-reference/payments/pay-hosted-invoice"},{"title":"Pay with x402 (exact)","href":"/api-reference/payments/pay-x402-exact"},{"title":"Pay with a Shared Payment Token (MPP-SPT)","href":"/api-reference/payments/pay-mpp-spt"}]},{"group":"API Endpoints","pages":[{"group":"experiments","pages":[{"title":"List experiments","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments","href":"/api-reference/experiments/list-experiments"},{"title":"Create experiment","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/experiments","href":"/api-reference/experiments/create-experiment"},{"title":"Estimate experiment cost","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/experiments/cost-estimate","href":"/api-reference/experiments/estimate-experiment-cost"},{"title":"Get experiment","description":"Returns full metadata for an experiment: workflow status, target and\nsequence details, assay parameters, and billing references.\n\nPoll this endpoint to track progress. When `stripe_quote_url` appears,\nfetch quote details via `/experiments/{id}/quote`. After confirmation,\n`stripe_invoice_url` provides a direct link to the invoice. The `results_status` field\nsignals data availability: `None` (pending), `Partial` (preliminary),\nor `All` (complete). Query `/results` filtered by experiment to retrieve\ndata once results are available.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}","href":"/api-reference/experiments/get-experiment"},{"title":"Update experiment","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json patch /api/v1/experiments/{experiment_id}","href":"/api-reference/experiments/update-experiment"},{"title":"Get experiment invoice","description":"Returns invoice metadata for a confirmed experiment, including the\nhosted payment URL. Available once `stripe_invoice_url` appears in the\nexperiment detail; timing depends on organization billing settings.\n\nAn invoice exists only after the quote has been accepted. Until then this\nreturns `404`, and the message names the confirm call to make instead of\npolling here.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}/invoice","href":"/api-reference/experiments/get-experiment-invoice"},{"title":"Get experiment quote","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}/quote","href":"/api-reference/experiments/get-experiment-quote"},{"title":"Accept an experiment's quote and create an invoice","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/experiments/{experiment_id}/quote/confirm","href":"/api-reference/experiments/accept-an-experiments-quote-and-create-an-invoice"},{"title":"Get experiment quote PDF","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}/quote/pdf","href":"/api-reference/experiments/get-experiment-quote-pdf"},{"title":"List results for an experiment","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}/results","href":"/api-reference/experiments/list-results-for-an-experiment"},{"title":"List sequences for an experiment","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}/sequences","href":"/api-reference/experiments/list-sequences-for-an-experiment"},{"title":"Submit experiment","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/experiments/{experiment_id}/submit","href":"/api-reference/experiments/submit-experiment"},{"title":"List experiment updates","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/experiments/{experiment_id}/updates","href":"/api-reference/experiments/list-experiment-updates"}]},{"group":"feedback","pages":[{"title":"Submit feedback, bug reports, or feature requests","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/feedback/submit","href":"/api-reference/feedback/submit-feedback-bug-reports-or-feature-requests"}]},{"group":"info","pages":[{"title":"Liveness probe","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/info/health","href":"/api-reference/info/liveness-probe"},{"title":"Database connectivity probe","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/info/health-db","href":"/api-reference/info/database-connectivity-probe"}]},{"group":"invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Get invoice","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/invoices/{invoice_id}","href":"/api-reference/invoices/get-invoice"},{"title":"Pay invoice","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/invoices/{invoice_id}/pay","href":"/api-reference/invoices/pay-invoice"},{"title":"Get invoice PDF","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/invoices/{invoice_id}/pdf","href":"/api-reference/invoices/get-invoice-pdf"}]},{"group":"quotes","pages":[{"title":"List quotes","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/quotes","href":"/api-reference/quotes/list-quotes"},{"title":"Get quote","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/quotes/{quote_id}","href":"/api-reference/quotes/get-quote"},{"title":"Accept quote","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/quotes/{quote_id}/confirm","href":"/api-reference/quotes/accept-quote"},{"title":"Reject quote","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/quotes/{quote_id}/reject","href":"/api-reference/quotes/reject-quote"}]},{"group":"results","pages":[{"title":"List results","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/results","href":"/api-reference/results/list-results"},{"title":"Get result","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/results/{result_id}","href":"/api-reference/results/get-result"}]},{"group":"sequences","pages":[{"title":"List sequences","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/sequences","href":"/api-reference/sequences/list-sequences"},{"title":"Add sequences to experiment","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/sequences","href":"/api-reference/sequences/add-sequences-to-experiment"},{"title":"Get sequence","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/sequences/{sequence_id}","href":"/api-reference/sequences/get-sequence"}]},{"group":"targets","pages":[{"title":"List targets","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/targets","href":"/api-reference/targets/list-targets"},{"title":"List custom target requests","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/targets/request-custom","href":"/api-reference/targets/list-custom-target-requests"},{"title":"Submit custom target request","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/targets/request-custom","href":"/api-reference/targets/submit-custom-target-request"},{"title":"Get custom target request","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/targets/request-custom/{request_id}","href":"/api-reference/targets/get-custom-target-request"},{"title":"Get target","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/targets/{target_id}","href":"/api-reference/targets/get-target"}]},{"group":"tokens","pages":[{"title":"List tokens","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/tokens","href":"/api-reference/tokens/list-tokens"},{"title":"Attenuate token","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/tokens/attenuate","href":"/api-reference/tokens/attenuate-token"},{"title":"Revoke the calling token and its entire lineage","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/tokens/revoke","href":"/api-reference/tokens/revoke-the-calling-token-and-its-entire-lineage"}]},{"group":"updates","pages":[{"title":"List updates","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/updates","href":"/api-reference/updates/list-updates"}]},{"group":"webhooks","pages":[{"title":"List the organization's webhook registrations.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/webhooks","href":"/api-reference/webhooks/list-the-organizations-webhook-registrations"},{"title":"Register a webhook for the organization.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json post /api/v1/webhooks","href":"/api-reference/webhooks/register-a-webhook-for-the-organization"},{"title":"Remove a webhook registration.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json delete /api/v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/remove-a-webhook-registration"},{"title":"Modify a webhook registration, including rotating or clearing its secret.","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json patch /api/v1/webhooks/{webhook_id}","href":"/api-reference/webhooks/modify-a-webhook-registration-including-rotating-or-clearing-its-secret"}]},{"group":"whoami","pages":[{"title":"Who am I","deprecated":null,"version":null,"openapi":"https://devs.adaptyvbio.com/api/v1/openapi.json get /api/v1/whoami","href":"/api-reference/whoami/who-am-i"}]}]}]},{"tab":"Changelog","icon":"newspaper","pages":[{"title":"Changelog","href":"/changelog/changelog"}]}]},"basePath":"","title":"Update experiment - Adaptyv Bio Docs","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}