Update samples

Deprecated

This endpoint is deprecated and may be removed in a future release.

This endpoint was deprecated on 2026-02-12.

It is scheduled for sunset on 2027-01-31.

Description#

Updates multiple samples, with the requestBody of each specifying columns to update by their IDs. Columns not included in the request remain as-is.

POST /prototype/platform/audits/{auditId}/procedures/{procedureId}/matrices/{matrixId}/samples/update

Required OAuth Scopes

graph:write

Parameters#

Parameter	In	Type	Required	Description
X-Version	header	string	false	Version of the API (2022-01-01)
auditId	path	string	true	The unique identifier of the audit
procedureId	path	string	true	The unique identifier of the procedure
matrixId	path	string	true	The unique identifier of the matrix
body	body	MatrixSamples	true	Details about the samples to update

Body parameter example#

[
  {
    "dataValues": [
      {
        "column": "6d870cd1-7bbe-4b14-b85d-f152913b068c",
        "value": "23897"
      }
    ],
    "id": "3dd42da0-3543-4e03-ac4a-2ddefebe27d6",
    "resultValues": [
      {
        "column": "674a9283-fd03-425d-bd62-0552263699e2",
        "value": "PASS"
      }
    ]
  },
  {
    "dataValues": [
      {
        "column": "6d870cd1-7bbe-4b14-b85d-f152913b068c",
        "value": "9125"
      }
    ],
    "id": "4ee53eb1-3543-4e03-ac4a-3eef0fcf38e7",
    "resultValues": [
      {
        "column": "674a9283-fd03-425d-bd62-0552263699e2",
        "value": "FAIL"
      }
    ]
  }
]

Code Samples#

curl

curl -X POST https://api.app.wdesk.com/prototype/platform/audits/{auditId}/procedures/{procedureId}/matrices/{matrixId}/samples/update \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2022-01-01'

httpie

http POST https://api.app.wdesk.com/prototype/platform/audits/{auditId}/procedures/{procedureId}/matrices/{matrixId}/samples/update \
    X-Version:2022-01-01 \
    Content-Type:application/json \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=POST "https://api.app.wdesk.com/prototype/platform/audits/{auditId}/procedures/{procedureId}/matrices/{matrixId}/samples/update" \
    --output-document -  \ 
    --header 'Content-Type: application/json' \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2022-01-01'

python

import requests

headers = {
  'X-Version': '2022-01-01',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api.app.wdesk.com/prototype/platform/audits/{auditId}/procedures/{procedureId}/matrices/{matrixId}/samples/update', headers = headers)

print(r.headers['Location'])