Skip to content
Testsigma DOCS
Login Book a demo

Update test run case status

PUT/projects/:project_id/test_runs/:test_run_id/test_cases

Base URL  https://test-management.testsigma.com/api/v1

Updates the execution status of one or more test cases within a test run.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →

PATH PARAMETERS

project_idUnique identifier of the project the test run belongs to.
test_run_idIdentifier of the test run whose test cases are updated.

REQUEST BODY

test_run_casesArray of test case updates to apply.
test_run_cases[].test_case_idUnique identifier of the test case to update.
test_run_cases[].test_run_status_idIdentifier of the status to set for the test case.
test_run_cases[].user_idUnique identifier of the user executing the test case.
test_run_cases[].descriptionAdditional details about the test case execution.

RESPONSE ATTRIBUTES

messageConfirmation message for the update; may be empty.
data.test_run_cases[].test_case_idUnique identifier of the updated test case.
data.test_run_cases[].test_run_status_idIdentifier of the status applied to the test case.
data.test_run_cases[].user_idUnique identifier of the user who executed the test case.
data.test_run_cases[].updated_atUnix timestamp of when the test case was updated.
REQUEST
curl -X PUT \
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_runs/:test_run_id/test_cases' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "test_run_cases": [
      {
        "test_case_id": "1c4a6347-dec5-4f8e-8b6c-cda33c37c9ce",
        "test_run_status_id": "0ba381b5-c018-40c6-b6fa-10d6e556ef9d",
        "user_id": "05782b39-7a2c-4e91-9d6b-8f1340c2ab5e",
        "description": "Test case completed successfully"
      }
    ]
  }'
const response = await fetch('https://test-management.testsigma.com/api/v1/projects/:project_id/test_runs/:test_run_id/test_cases', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "test_run_cases": [
          {
              "test_case_id": "1c4a6347-dec5-4f8e-8b6c-cda33c37c9ce",
              "test_run_status_id": "0ba381b5-c018-40c6-b6fa-10d6e556ef9d",
              "user_id": "05782b39-7a2c-4e91-9d6b-8f1340c2ab5e",
              "description": "Test case completed successfully"
          }
      ]
  })
});
const data = await response.json();
import requests

response = requests.put(
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_runs/:test_run_id/test_cases',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "test_run_cases": [
          {
              "test_case_id": "1c4a6347-dec5-4f8e-8b6c-cda33c37c9ce",
              "test_run_status_id": "0ba381b5-c018-40c6-b6fa-10d6e556ef9d",
              "user_id": "05782b39-7a2c-4e91-9d6b-8f1340c2ab5e",
              "description": "Test case completed successfully"
          }
      ]
  }
)
data = response.json()
RESPONSE200OK
{
  "message": "Test run cases updated successfully.",
  "data": {
    "test_run_cases": [
      {
        "test_case_id": "1c4a6347-dec5-4f8e-8b6c-cda33c37c9ce",
        "test_run_status_id": "0ba381b5-c018-40c6-b6fa-10d6e556ef9d",
        "user_id": "05782b39-7a2c-4e91-9d6b-8f1340c2ab5e",
        "updated_at": 1710761600
      }
    ]
  }
}