Skip to main content
PATCH
/
v3
/
lab_tests
/
{lab_test_id}
from vital.client import Vital
from vital.environment import VitalEnvironment


client = Vital(
  api_key="YOUR_API_KEY",
  environment=VitalEnvironment.SANDBOX
)

data = client.lab_tests.update_lab_test(
    lab_test_id="<lab_test_id>",
    name="<name>",
    active=<True>,
)

{
  "id": "5af405fc-fafb-49e8-b0bf-fe9d91df6a7d",
  "slug": "a94e3005-new-test",
  "name": "New test",
  "sample_type": "serum",
  "method": "at_home_phlebotomy",
  "price": 0.0,
  "is_active": true,
  "status": "active",
  "fasting": false,
  "lab": {
    "id": 26,
    "slug": "quest",
    "name": "Quest",
    "first_line_address": "100 Tri State International #100",
    "city": "Lincolnshire",
    "zipcode": "60069",
    "collection_methods": ["at_home_phlebotomy", "walk_in_test"],
    "sample_types": ["serum", "saliva", "urine"]
  },
  "markers": [
    {
      "id": 6859,
      "name": "17-Hydroxyprogesterone",
      "slug": "17-hydroxyprogesterone",
      "description": "17-Hydroxyprogesterone",
      "lab_id": 26,
      "provider_id": "17180",
      "type": "biomarker",
      "unit": null,
      "price": "N/A",
      "aoe": null,
      "a_la_carte_enabled": true
    },
    {
      "id": 8213,
      "name": "17-Hydroxypregnenolone",
      "slug": "17-hydroxypregnenolone",
      "description": "17-Hydroxypregnenolone",
      "lab_id": 26,
      "provider_id": "8352",
      "type": "biomarker",
      "unit": null,
      "price": "N/A",
      "aoe": null,
      "a_la_carte_enabled": true
    }
  ],
  "is_delegated": false,
  "auto_generated": false
}

from vital.client import Vital
from vital.environment import VitalEnvironment


client = Vital(
  api_key="YOUR_API_KEY",
  environment=VitalEnvironment.SANDBOX
)

data = client.lab_tests.update_lab_test(
    lab_test_id="<lab_test_id>",
    name="<name>",
    active=<True>,
)

{
  "id": "5af405fc-fafb-49e8-b0bf-fe9d91df6a7d",
  "slug": "a94e3005-new-test",
  "name": "New test",
  "sample_type": "serum",
  "method": "at_home_phlebotomy",
  "price": 0.0,
  "is_active": true,
  "status": "active",
  "fasting": false,
  "lab": {
    "id": 26,
    "slug": "quest",
    "name": "Quest",
    "first_line_address": "100 Tri State International #100",
    "city": "Lincolnshire",
    "zipcode": "60069",
    "collection_methods": ["at_home_phlebotomy", "walk_in_test"],
    "sample_types": ["serum", "saliva", "urine"]
  },
  "markers": [
    {
      "id": 6859,
      "name": "17-Hydroxyprogesterone",
      "slug": "17-hydroxyprogesterone",
      "description": "17-Hydroxyprogesterone",
      "lab_id": 26,
      "provider_id": "17180",
      "type": "biomarker",
      "unit": null,
      "price": "N/A",
      "aoe": null,
      "a_la_carte_enabled": true
    },
    {
      "id": 8213,
      "name": "17-Hydroxypregnenolone",
      "slug": "17-hydroxypregnenolone",
      "description": "17-Hydroxypregnenolone",
      "lab_id": 26,
      "provider_id": "8352",
      "type": "biomarker",
      "unit": null,
      "price": "N/A",
      "aoe": null,
      "a_la_carte_enabled": true
    }
  ],
  "is_delegated": false,
  "auto_generated": false
}

Authorizations

​
x-vital-api-key
string
header
required

Vital Team API Key

Path Parameters

​
lab_test_id
string<uuid>
required

Body

application/json
​
name
string | null
​
active
boolean | null

Response

Successful Response

​
id
string<uuid>
required
​
slug
string
required
​
name
string
required
​
sample_type
enum<string>
required
Available options:
dried_blood_spot,
arm_collector,
serum,
saliva,
urine
​
method
enum<string>
required
Available options:
testkit,
walk_in_test,
at_home_phlebotomy,
on_site_collection
​
price
number
required
​
is_active
boolean
required

Deprecated. Use status instead.

​
status
enum<string>
required
Available options:
active,
pending_approval,
inactive
​
lab
ClientFacingLab · object
required
Example:
{
  "city": "San Francisco",
  "collection_methods": ["testkit"],
  "first_line_address": "123 Main St",
  "id": 1,
  "name": "LabCorp",
  "sample_types": ["saliva"],
  "slug": "labcorp",
  "zipcode": "91789"
}
​
markers
ClientFacingMarker · object[] | null
required
​
fasting
boolean
default:false

Defines whether a lab test requires fasting.

​
is_delegated
boolean
default:false
deprecated

Deprecated and always false. Delegation is now at the lab account level. Used to denote whether a lab test requires using non-Vital physician networks.

​
auto_generated
boolean
default:false

Whether the lab test was auto-generated by Vital

​
has_collection_instructions
boolean | null

Whether or not the lab test has collection instructions.

​
common_tat_days
integer | null

The common turnaround time in days for the lab test. This is the expected time for the lab to process the test and return results.

​
worst_case_tat_days
integer | null

The worst-case turnaround time in days for the lab test. This is the maximum time the lab may take to process the test and return results.