Create test step

POST/test_cases/:test_case_id/test_steps

Base URL https://app.testsigma.com/api/v1

Add a new step to an existing test case.

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

PATH PARAMETERS

test_case_id ID of the test case to add the step to.

REQUEST BODY

`position`	Order position for the step (1-indexed).
`action`	NLP action string that defines what the step does.
`type`	Step type — ACTION or VERIFY.
`disabled`	Set to true to disable the step without deleting it.

RESPONSE ATTRIBUTES

`id`	ID of the newly created step.
`testCaseId`	Parent test case ID.
`position`	Position of the step in the test case.
`action`	The action string.
`type`	Step type.

REQUEST

curl -X POST \
  'https://app.testsigma.com/api/v1/test_cases/:test_case_id/test_steps' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "position": 4,
    "action": "Click on the Login button",
    "type": "ACTION",
    "disabled": false
  }'

const response = await fetch('https://app.testsigma.com/api/v1/test_cases/:test_case_id/test_steps', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "position": 4,
      "action": "Click on the Login button",
      "type": "ACTION",
      "disabled": false
  })
});
const data = await response.json();

import requests

response = requests.post(
  'https://app.testsigma.com/api/v1/test_cases/:test_case_id/test_steps',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "position": 4,
      "action": "Click on the Login button",
      "type": "ACTION",
      "disabled": false
  }
)
data = response.json()

RESPONSE200OK

{
  "id": 504,
  "testCaseId": 200,
  "position": 4,
  "action": "Click on the Login button",
  "type": "ACTION",
  "disabled": false,
  "createdById": 9
}