create_feature

Create a new feature from a name and Gherkin source.

Create a feature from a name and Gherkin source (Feature: + Scenario:s). It starts as draft — generate its tests afterwards with generate_feature.

Request

POST /api/v1/ops/projects/{project}/features

Parameter	In	Type	Required	Description
project	path	string	yes	The project's public id.
name	body	string	yes	The feature name.
gherkin	body	string	yes	The Gherkin source.

cURL

curl -X POST -H "Authorization: Bearer $TESTVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Login Functionality", "gherkin": "Feature: Login Functionality\n  Scenario: Valid user signs in\n    ..."}' \
  "$TESTVIBE_SERVER/api/v1/ops/projects/$PROJECT/features"

CLI

testvibe features create "Login Functionality" --file login.feature

MCP

Tool create_feature — { "name": "Login Functionality", "gherkin": "Feature: …" }.

Response

201 Created

{ "id": 12 }

Errors

HTTP	When
400 invalid_request	Missing name or Gherkin, or malformed JSON.
404 not_found	No such project in this workspace.