Update BDD test case

Update BDD fields for an existing BDD test case in a project using the BrowserStack Test Management API.

The Update BDD test case API allows you to modify the feature, scenario, or background fields of an existing BDD test case. You can only update these fields if the test case uses the BDD template.

Endpoint

PATCH /projects/:project_id/test-cases/:test_case_id

Use this API to update BDD fields for a test case. The API enforces that only BDD test cases can be updated, and test_steps cannot be modified for BDD test cases.

Request Parameters

Request

curl -X PATCH \
  https://api.browserstack.com/projects/<project_id>/test-cases/<test_case_id> \
  -H 'Content-Type: application/json' \
  -d '{
    "feature": "Login Feature",
    "scenario": "Valid user logs in",
    "background": "User is on login page"
  }'

Response attributes 200 application/json

Response

{
  "test_case": {
    "id": "tc-123",
    "template": "test_case_bdd",
    "feature": "Login Feature",
    "scenario": "Valid user logs in",
    "background": "User is on login page",
    "created_at": "2025-08-21T12:00:00Z",
    "updated_at": "2025-08-21T12:10:00Z"
  }
}