Create a test plan

POST/projects/:project_id/test_plans

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

Creates a new test plan within a specific project.

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

PATH PARAMETERS

project_id Unique identifier of the project to create the test plan in.

REQUEST BODY

`title`	Title of the test plan.
`description`	Detailed description of the test plan.
`start_date`	Start date of the test plan as a Unix timestamp.
`end_date`	End date of the test plan as a Unix timestamp.
`label_ids`	Array of label IDs to associate with the test plan.

RESPONSE ATTRIBUTES

`message`	Status message for the request; may be empty.
`data.test_plan.id`	Unique identifier of the created test plan.
`data.test_plan.human_id`	Human-readable identifier of the test plan.
`data.test_plan.title`	Title of the test plan.
`data.test_plan.description`	Description of the test plan.
`data.test_plan.status`	Current status of the test plan.
`data.test_plan.start_date`	Start date of the test plan as a Unix timestamp.
`data.test_plan.end_date`	End date of the test plan as a Unix timestamp.
`data.test_plan.label_ids`	Label IDs associated with the test plan.
`data.test_plan.created_at`	Unix timestamp of when the test plan was created.
`data.test_plan.updated_at`	Unix timestamp of the last update to the test plan.

REQUEST

curl -X POST \
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_plans' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Patient Portal Regression",
    "description": "Full regression cycle for the Q2 patient portal release.",
    "start_date": 1710374400,
    "end_date": 1712966400,
    "label_ids": [
      "3ebf1ec4-f994-4f41-822a-01305e1f78c1"
    ]
  }'

const response = await fetch('https://test-management.testsigma.com/api/v1/projects/:project_id/test_plans', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "title": "Patient Portal Regression",
      "description": "Full regression cycle for the Q2 patient portal release.",
      "start_date": 1710374400,
      "end_date": 1712966400,
      "label_ids": [
          "3ebf1ec4-f994-4f41-822a-01305e1f78c1"
      ]
  })
});
const data = await response.json();

import requests

response = requests.post(
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_plans',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "title": "Patient Portal Regression",
      "description": "Full regression cycle for the Q2 patient portal release.",
      "start_date": 1710374400,
      "end_date": 1712966400,
      "label_ids": [
          "3ebf1ec4-f994-4f41-822a-01305e1f78c1"
      ]
  }
)
data = response.json()

RESPONSE200OK

{
  "message": "",
  "data": {
    "test_plan": {
      "id": "f2a8c1d4-9e63-4b27-8a51-7c0d6e9f3b42",
      "human_id": "HCP-P-1",
      "title": "Patient Portal Regression",
      "description": "Full regression cycle for the Q2 patient portal release.",
      "status": "ACTIVE",
      "start_date": 1710374400,
      "end_date": 1712966400,
      "label_ids": [
        "3ebf1ec4-f994-4f41-822a-01305e1f78c1"
      ],
      "created_at": 1710370000,
      "updated_at": 1710370000
    }
  }
}