Core API Endpoints

Bulk Import

post
Path parameters
handlestringRequired
keystringRequired
Body
Responses
204

No content

post
POST /v1/{handle}/projects/{key}/data HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 509

{
  "entities": {
    "executions": {
      "entries": [
        {
          "externalId": "text",
          "caseRef": "text",
          "runRef": "text",
          "source": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    },
    "runs": {
      "entries": [
        {
          "name": "text",
          "externalId": "text",
          "source": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    },
    "folders": {
      "entries": [
        {
          "name": "text",
          "externalId": "text",
          "source": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    },
    "cases": {
      "entries": [
        {
          "name": "text",
          "externalId": "text",
          "source": "text",
          "folderExternalId": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  }
}
204

No content

No content

Templates

get

Retrieves the list of paginated templates for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
namestringOptional
createdByIdsstring[]Optional
creationStartDatestringOptional
creationEndDatestringOptional
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/templates HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new template within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The template data to be created.

namestringRequired

The name of the template.

Responses
200

The newly created template object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/templates HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "name": "text",
  "templateFields": [
    {
      "id": "text",
      "name": "text",
      "dataType": "text",
      "defaultValue": "text",
      "value": "text",
      "options": [
        "text"
      ]
    }
  ]
}
200

The newly created template object.

No content

get

Retrieves a specific template by its ID.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

idstringRequired

The unique identifier of the template.

Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/templates/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

patch

Updates an existing template.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier of the template.

Body

The updated template data.

namestringOptional

The name of the template.

Responses
200

Ok

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/templates/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "name": "text",
  "templateFields": [
    {
      "id": "text",
      "name": "text",
      "dataType": "text",
      "defaultValue": "text",
      "value": "text",
      "options": [
        "text"
      ]
    }
  ]
}
200

Ok

No content

delete

Deletes a template.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier of the template.

Responses
200

Ok

application/json
delete
DELETE /v1/{handle}/projects/{key}/templates/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

{
  "message": "text"
}

Tags

get

Retrieves the list of paginated tags of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
entityTypestringOptional
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/tags HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new tag for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

Body

The tag data to be created.

namestringRequired

The name of the tag.

descriptionstringOptional

The description of the tag.

Responses
200

The newly created tag object.

application/json
Responseany
post
POST /v1/{handle}/tags HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "name": "text",
  "description": "text",
  "entityTypes": [
    "cases"
  ]
}
200

The newly created tag object.

No content

get

Retrieves the details of a specific tag for a user or an organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

idnumber Β· doubleRequired

The unique identifier for the tag.

Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/tags/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

patch
Path parameters
handlestringRequired
idnumber Β· doubleRequired
Body

Data Transfer Object for updating an existing tag.

namestringOptional

The name of the tag.

descriptionstringOptional

The description of the tag.

archivedbooleanOptional

The boolean flag to archive/unarchive a tag.

Responses
200

Ok

application/json
Responseany
patch
PATCH /v1/{handle}/tags/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "name": "text",
  "description": "text",
  "entityTypes": [
    "cases"
  ],
  "archived": true
}
200

Ok

No content

delete
Path parameters
handlestringRequired
idnumber Β· doubleRequired
Responses
200

Ok

application/json
delete
DELETE /v1/{handle}/tags/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

{
  "message": "text"
}

Shared Steps

get

Retrieves the list of paginated shared steps for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/shared-steps HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new shared step within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The shared step data to be created.

namestringRequired

The name of the shared step. This field defines the name or label for the shared step.

Responses
200

The newly created shared step object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/shared-steps HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 258

{
  "name": "text",
  "steps": [
    {
      "id": "text",
      "title": "text",
      "description": "text",
      "expectedResult": "text",
      "children": [
        {
          "id": "text",
          "title": "text",
          "description": "text",
          "expectedResult": "text",
          "children": [
            "[Circular Reference]"
          ],
          "sharedStepUid": 1
        }
      ],
      "sharedStepUid": 1
    }
  ]
}
200

The newly created shared step object.

No content

patch

Updates an existing shared step within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idstringRequired

The unique identifier for the shared step.

Body

The shared step data to be updated.

namestringOptional

The name of the shared step. Optional field that allows you to update the name or label of the shared step.

Responses
200

The updated shared step object.

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/shared-steps/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 258

{
  "name": "text",
  "steps": [
    {
      "id": "text",
      "title": "text",
      "description": "text",
      "expectedResult": "text",
      "children": [
        {
          "id": "text",
          "title": "text",
          "description": "text",
          "expectedResult": "text",
          "children": [
            "[Circular Reference]"
          ],
          "sharedStepUid": 1
        }
      ],
      "sharedStepUid": 1
    }
  ]
}
200

The updated shared step object.

No content

delete

Deletes an existing shared step within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the shared step.

Responses
200

A message indicating the successful deletion of the shared step.

application/json
delete
DELETE /v1/{handle}/projects/{key}/shared-steps/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

A message indicating the successful deletion of the shared step.

{
  "message": "text"
}

Test Runs

get

Retrieves the list of paginated test runs for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/runs HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new test run within a project for a user or organization.

Body
externalIdstringOptional
sourcestringOptional
linkstringOptional
prioritynumber Β· doubleOptional
statusnumber Β· doubleOptional
namestringRequired
descriptionstringOptional
dueAtstring Β· date-timeOptional
tagUidsnumber Β· double[]Optional
configsstring[]Optional
caseUidsnumber Β· double[]Optional
milestoneUidsnumber Β· double[]Optional
Responses
200

The newly created test run object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/runs HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "externalId": "text",
  "source": "text",
  "link": "text",
  "priority": 1,
  "status": 1,
  "name": "text",
  "description": "text",
  "dueAt": "2025-08-21T17:09:29.039Z",
  "tagUids": [
    1
  ],
  "configs": [
    "text"
  ],
  "caseUids": [
    1
  ],
  "milestoneUids": [
    1
  ]
}
200

The newly created test run object.

No content

get

Retrieves the details of a specific test run within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the test run.

Responses
200

The details of the test run.

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/runs/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

The details of the test run.

No content

patch

Updates an existing test run within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the test run.

Body

The template data to be updated.

namestringOptional
descriptionstringOptional
statusnumber Β· doubleOptional
prioritynumber Β· doubleOptional
dueAtstring Β· date-timeOptional
addMilestoneUidsnumber Β· double[]Optional
removeMilestoneUidsnumber Β· double[]Optional
addTagUidsnumber Β· double[]Optional
removeTagUidsnumber Β· double[]Optional
addPlanUidsnumber Β· double[]Optional
removePlanUidsnumber Β· double[]Optional
archivebooleanOptional
configsstring[]Optional
Responses
200

The updated test run object.

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/runs/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 254

{
  "name": "text",
  "description": "text",
  "status": 1,
  "priority": 1,
  "dueAt": "2025-08-21T17:09:29.039Z",
  "addMilestoneUids": [
    1
  ],
  "removeMilestoneUids": [
    1
  ],
  "addTagUids": [
    1
  ],
  "removeTagUids": [
    1
  ],
  "addPlanUids": [
    1
  ],
  "removePlanUids": [
    1
  ],
  "archive": true,
  "configs": [
    "text"
  ]
}
200

The updated test run object.

No content

Test Plans

get

Retrieves the list of paginated test plans for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
statusnumber Β· doubleOptional
prioritynumber Β· doubleOptional
statusUidsnumber Β· double[]Optional

list of statuses to filter by. only plans with statuses here will be returned

priorityUidsnumber Β· double[]Optional

list of priorities to filter by. only plans with the speficied priorities will be returned

archivedbooleanRequired

filter for archived plans

minRunCountnumber Β· doubleRequired

mininum number of runs

maxRunCountnumber Β· doubleOptional

maximum number of test runs

minCreatedAtstringRequired

minimum creation date

maxCreatedAtstringOptional

maximum creation date

minProgressnumber Β· doubleRequired

minimum progress

maxProgressnumber Β· doubleOptional

max progress

tagUidsnumber Β· double[]Optional

list of tags to filter by

milestoneUidsnumber Β· double[]Optional

list of milestones to filter by

projectUidnumber Β· doubleRequired

project to filter by

Responses
200

The list of paginated test plans.

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/plans HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

The list of paginated test plans.

No content

post

Creates a new test plan within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The plan data to be created.

namestringRequired

The name of the plan. This field defines the name or title of the plan.

descriptionstringOptional

A brief description of the plan. Optional field that provides additional context or information about the plan.

milestoneUidsnumber Β· double[]Optional

The milestone UIDs associated with the plan. Optional field that links the plan to one or more milestones. Milestones represent significant points in the project or timeline.

statusnumber Β· doubleOptional

The status of the plan. Optional field that defines the current state of the plan, such as pending, active, or completed, usually represented as a numeric value.

prioritynumber Β· doubleOptional

The priority level of the plan. Optional field that represents the priority of the plan, typically represented as a numeric value (e.g., 1 = high, 2 = medium, 3 = low).

externalIdstringOptional

The external identifier for the plan. Optional field to reference the plan externally, useful for integration with other systems or tools.

sourcestringOptional

The source of the plan. Optional field that provides information about the origin of the plan, such as the tool or platform from which it was created.

tagUidsnumber Β· double[]Optional

The tag UIDs associated with the plan. Optional field to specify the tags linked to the plan. Tags help categorize or label the plan for better organization and filtering.

Responses
200

The newly created plan object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/plans HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 411

{
  "name": "text",
  "description": "text",
  "milestoneUids": [
    1
  ],
  "status": 1,
  "priority": 1,
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "externalId": "text",
  "source": "text",
  "testRuns": [
    {
      "configuration": {
        "type": "matrix",
        "sets": [
          [
            "browser:firefox",
            "browser:safari"
          ],
          [
            "os:windows",
            "os:mac"
          ]
        ]
      },
      "uid": 1
    }
  ],
  "configuration": {
    "type": "matrix",
    "sets": [
      [
        "browser:firefox",
        "browser:safari"
      ],
      [
        "os:windows",
        "os:mac"
      ]
    ]
  },
  "tagUids": [
    1
  ]
}
200

The newly created plan object.

No content

get

Retrieves the details of a specific test plan within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idstringRequired

The unique identifier for the test plan.

Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/plans/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

patch
Path parameters
handlestringRequired
keystringRequired
idnumber Β· doubleRequired
Body

Data Transfer Object for updating an existing plan.

namestringOptional

The name of the plan. Optional field to update the name or title of the plan.

descriptionstringOptional

A brief description of the plan. Optional field to update the description, providing additional context or details about the plan.

tagUidsnumber Β· double[]Optional

The tag UIDs associated with the plan. Optional field to update the tags linked to the plan. Tags help categorize or label the plan for easier organization.

milestoneUidsnumber Β· double[]Optional

The milestone UIDs associated with the plan. Optional field to update the milestones linked to the plan. Milestones represent key points in the project or timeline.

runUidsnumber Β· double[]Optional

The run UIDs associated with the plan. Optional field to update the test runs included in the plan. These are the specific runs that are part of the plan's execution.

statusnumber Β· doubleOptional

The status of the plan. Optional field to update the current state of the plan, such as pending, active, or completed, typically represented by a numeric value.

prioritynumber Β· doubleOptional

The priority level of the plan. Optional field to update the priority of the plan, generally represented as a numeric value (e.g., 1 = high, 2 = medium, 3 = low).

Responses
200

Ok

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/plans/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "name": "text",
  "description": "text",
  "tagUids": [
    1
  ],
  "milestoneUids": [
    1
  ],
  "runUids": [
    1
  ],
  "status": 1,
  "priority": 1
}
200

Ok

No content

Milestones

get

Retrieves the list of paginated milstones for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/milestones HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new test milestone within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The test milestone data to be created.

namestringRequired

The name of the milestone. A string representing the title or label of the milestone.

descriptionstringOptional

The description of the milestone. Optional field that provides additional details or context about the milestone.

startDatestringRequired

The start date of the milestone. A string in ISO 8601 format representing the start date of the milestone (e.g., "2025-03-01T00:00:00Z").

dueAtstringRequired

The due date of the milestone. A string in ISO 8601 format representing the due date or deadline for the milestone (e.g., "2025-04-01T00:00:00Z").

statusnumber Β· doubleRequired

The status of the milestone. A number representing the current status of the milestone (e.g., 1 for "In Progress", 2 for "Completed").

planIdsnumber Β· double[]Optional

The IDs of the plans associated with the milestone. An array of numbers representing the IDs of the plans linked to the milestone.

runIdsnumber Β· double[]Optional

The IDs of the runs associated with the milestone. An array of numbers representing the IDs of the test runs linked to the milestone.

tagUidsnumber Β· double[]Optional

The tag UIDs associated with the milestone. Optional field to specify an array of tag IDs for categorizing or labeling the milestone.

Responses
200

The newly created test milestone object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/milestones HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "name": "text",
  "description": "text",
  "startDate": "text",
  "dueAt": "text",
  "status": 1,
  "planIds": [
    1
  ],
  "runIds": [
    1
  ],
  "tagUids": [
    1
  ]
}
200

The newly created test milestone object.

No content

patch

Updates an existing test milestone within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the milestone.

Body

The milestone data to be updated.

namestringOptional

The name of the milestone. A string representing the title or label of the milestone.

descriptionstringOptional

The description of the milestone. Optional field that provides additional details or context about the milestone.

startDatestringOptional

The start date of the milestone. A string in ISO 8601 format representing the start date of the milestone (e.g., "2025-03-01T00:00:00Z").

dueAtstringOptional

The due date of the milestone. A string in ISO 8601 format representing the due date or deadline for the milestone (e.g., "2025-04-01T00:00:00Z").

statusnumber Β· doubleOptional

The status of the milestone. A number representing the current status of the milestone (e.g., 1 for "In Progress", 2 for "Completed").

planIdsnumber Β· double[]Optional

The IDs of the plans associated with the milestone. An array of numbers representing the IDs of the plans linked to the milestone.

runIdsnumber Β· double[]Optional

The IDs of the runs associated with the milestone. An array of numbers representing the IDs of the test runs linked to the milestone.

tagUidsnumber Β· double[]Optional

The tag UIDs associated with the milestone. Optional field to specify an array of tag IDs for categorizing or labeling the milestone.

archivedbooleanOptional
Responses
200

The updated milestone object.

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/milestones/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 138

{
  "name": "text",
  "description": "text",
  "startDate": "text",
  "dueAt": "text",
  "status": 1,
  "planIds": [
    1
  ],
  "runIds": [
    1
  ],
  "tagUids": [
    1
  ],
  "archived": true
}
200

The updated milestone object.

No content

delete

Deletes an existing test milestone within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the milestone.

Responses
200

A success message.

application/json
delete
DELETE /v1/{handle}/projects/{key}/milestones/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

A success message.

{
  "message": "text"
}

Test Folders

get

Retrieves the list of paginated folders for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization

keystringRequired

The unique identifier for a project

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/folders HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new folder within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The folder data to be created.

namestringRequired

The name of the folder. A string representing the title or label of the folder.

externalIdstringOptional

The external ID of the folder. Optional field to associate the folder with an external identifier, such as from another system or service.

sourcestringOptional

The source of the folder. Optional field to specify the origin or source system of the folder (e.g., "manual", "imported").

parentIdnumber Β· doubleRequired

The parent ID of the folder. A number representing the unique identifier of the parent folder. Used for nesting folders.

projectUidnumber Β· doubleRequired

project the folder belongs to

Responses
200

The newly created folder object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/folders HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "name": "text",
  "externalId": "text",
  "source": "text",
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "parentId": 1,
  "projectUid": 1
}
200

The newly created folder object.

No content

get

Retrieves the details of a specific folder within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization

keystringRequired

The unique identifier for a project

idnumber Β· doubleRequired

The unique identifier for the folder

Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/folders/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

patch

Updates an existing folder within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the folder.

Body

The folder data to be updated.

namestringOptional

The name of the folder. Optional field to update the title or label of the folder.

externalIdstringOptional

The external ID of the folder. Optional field to update the external identifier of the folder.

sourcestringOptional

The source of the folder. Optional field to update the source or origin of the folder.

parentIdnumber Β· doubleOptional

The parent ID of the folder. Optional field to update the unique identifier of the parent folder, allowing for reorganization of folders.

statusnumber Β· doubleOptional

The status of the folder. Optional field to update the current status of the folder.

Responses
200

The updated folder object.

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/folders/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "name": "text",
  "externalId": "text",
  "source": "text",
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "parentId": 1,
  "status": 1
}
200

The updated folder object.

No content

delete

Deletes an existing folder within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the folder.

Responses
200

A success message.

application/json
delete
DELETE /v1/{handle}/projects/{key}/folders/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

A success message.

{
  "message": "text"
}

Test Executions

post

Creates a new test execution within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The execution data to be created.

externalIdstringOptional

The external identifier for the execution. Optional field to specify an external ID for the execution.

sourcestringOptional

The source of the execution. Optional field to specify the source of the execution (e.g., "manual", "automated").

testCaseUidnumber Β· doubleOptional

The unique identifier of the associated test case. Optional field to link the execution to a specific test case.

testCaseRefnumber Β· doubleOptional

The reference number for the associated test case. Optional field to provide an reference number for the test case.

testRunUidnumber Β· doubleOptional

The unique identifier of the associated test run. Optional field to link the execution to a specific test run.

statusnumber Β· doubleOptional

The status of the execution. Optional field to specify the status of the execution (e.g., "not started", "in progress", "completed").

Responses
200

The newly created execution object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/executions HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 257

{
  "externalId": "text",
  "source": "text",
  "testCaseUid": 1,
  "testCaseRef": 1,
  "testRunUid": 1,
  "status": 1,
  "customFields": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "steps": [
    {
      "testStepUid": "text",
      "description": "text",
      "customFields": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}
200

The newly created execution object.

No content

get

Retrieves the details of a specific test execution within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization

keystringRequired

The unique identifier for a project

idnumber Β· doubleRequired

The unique identifier for the test execution

Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/executions/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

patch

Updates an existing execution within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idnumber Β· doubleRequired

The unique identifier for the execution.

Body

The execution data to be updated.

statusnumber Β· doubleOptional

The status of the execution. Optional field to specify the status of the execution.

prioritynumber Β· doubleOptional

The priority of the execution. Optional field to set the priority level of the execution (e.g., high, medium, low).

dueAtstring Β· date-timeOptional

The due date of the execution. Optional field to set the due date for the execution in ISO 8601 format (e.g., "2025-03-10T12:00:00").

assignedTostringOptional

The user assigned to the execution. Optional field to specify the user responsible for the execution.

tagUidsnumber Β· double[]Optional

The tag UIDs associated with the execution. Optional field to associate tags with the execution, represented by their unique identifiers.

namestringOptional

The name of the execution. Optional field to update the name or title of the execution.

templateFieldsanyOptional

The template fields for the execution. Optional field to update or specify template fields associated with the execution.

Responses
200

The updated execution object.

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/executions/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 318

{
  "status": 1,
  "priority": 1,
  "dueAt": "2025-08-21T17:09:29.039Z",
  "assignedTo": "text",
  "tagUids": [
    1
  ],
  "tagReplacements": [
    {
      "newTagUids": [
        1
      ],
      "existingTagUids": [
        1
      ]
    }
  ],
  "name": "text",
  "steps": [
    {
      "description": "text",
      "sharedStepUid": 1,
      "title": "text",
      "expectedResult": "text",
      "uid": "text",
      "position": 1,
      "status": 1
    }
  ],
  "templateFields": null
}
200

The updated execution object.

No content

Custom Fields

get

Retrieves the list of paginated custom fields for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/customFields HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Creates a new custom field within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Body

The custom field data to be created.

namestringRequired

The name of the custom field. A string representing the title or label of the custom field.

typestring Β· enumOptional

The type of the custom field. Optional field to specify the data type of the custom field (e.g., text, number, date). Defaults to undefined if not provided.

Possible values:
sourcestringOptional

The source of the custom field. Optional field to specify the origin or source of the custom field (e.g., "manual", "imported").

optionsstring[]Optional

The options for the custom field. Optional field to define the available choices for the custom field, applicable for certain types like dropdowns or radio buttons. Should be an array of strings representing the options.

Responses
200

The newly created custom field object.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/customFields HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "name": "text",
  "type": "text",
  "source": "text",
  "options": [
    "text"
  ]
}
200

The newly created custom field object.

No content

patch

Updates an existing custom field.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

idstringRequired

The unique identifier of the template.

Body

The updated custom field data.

namestringOptional

The name of the custom field. Optional field to update the title or label of the custom field.

typestring Β· enumOptional

The type of the custom field. Optional field to update the data type of the custom field (e.g., text, number, date).

Possible values:
sourcestringOptional

The source of the custom field. Optional field to update the source or origin of the custom field.

optionsstring[]Optional

The options for the custom field. Optional field to update or add new options for the custom field. Should be an array of strings representing the updated options.

Responses
200

Ok

application/json
Responseany
patch
PATCH /v1/{handle}/projects/{key}/customFields/{id} HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "name": "text",
  "type": "text",
  "source": "text",
  "options": [
    "text"
  ]
}
200

Ok

No content

delete

Deletes a custom field.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

idstringRequired

The unique identifier of the custom field.

Responses
200

A message indicating the successful deletion of the custom field.

application/json
delete
DELETE /v1/{handle}/projects/{key}/customFields/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

A message indicating the successful deletion of the custom field.

{
  "message": "text"
}

Test Cases

get

Retrieves the list of paginated cases for a particular project of a user or organization.

Path parameters
handlestringRequired

The unique identifier for user or an organization.

keystringRequired

The unique identifier for a project.

Query parameters
limitnumber Β· doubleRequired
offsetnumber Β· doubleRequired
qstringOptional
orderBystringOptional
orderstring Β· enumOptionalPossible values:
prioritystringOptional
tagstringOptional
Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/cases HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

post

Create single or bulk test cases into a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

Bodyobject[]

Array of test cases to be created.

customFieldsanyRequired

Custom fields associated with the case. This is an object that contains custom fields relevant to the case. The structure can vary depending on the specific custom fields for the case.

sourcestringOptional

The source from which the case originates. A string that represents the origin or the system from which the case is being created.

namestringRequired

The name of the case. A string that provides the title or label for the case.

prioritynumber Β· doubleOptional

The priority of the case. Optional field to define the importance or urgency of the case. It can be represented numerically (e.g., 1 = high priority).

statusnumber Β· doubleOptional
repoUIDstringOptional

The repository UID where the case is located. A string that uniquely identifies the repository to which the case belongs.

parentIdnumber Β· doubleRequired

The parent case ID. A number that represents the ID of the parent case, allowing the case to be part of a hierarchy or grouping.

externalIdstringOptional

The external ID of the case. A string that represents an external identifier, often used to correlate or link the case with external systems or databases.

projectIdnumber Β· doubleRequired

The project ID to which the case belongs. A string that identifies the project that the case is part of.

templateIdstringOptional

The template ID associated with the case. Optional field to specify a template to be applied to the case. It links the case to a predefined template for consistency in its structure.

tagIdsnumber Β· double[]Optional

The tag IDs associated with the case. Optional field that includes an array of tag IDs to categorize or label the case for better filtering or grouping.

tagsstring[]Optional

list of tag names to be attached to the case, typically used when importing tags

externalCreatedAtstringOptional

external createdAt timestamp

externalUpdatedAtstringOptional

external updatedAt timestamp

statusTextstringOptional

status as text

priorityTextstringOptional

priority as text

createdBystringOptional
createdAtstringOptional
Responses
200

Array of created test cases.

application/json
Responseany
post
POST /v1/{handle}/projects/{key}/cases HTTP/1.1
Host: api.testfiesta.com
Content-Type: application/json
Accept: */*
Content-Length: 335

[
  {
    "customFields": null,
    "source": "text",
    "name": "text",
    "priority": 1,
    "status": 1,
    "repoUID": "text",
    "parentId": 1,
    "steps": [],
    "externalId": "text",
    "projectId": 1,
    "templateId": "text",
    "tagIds": [
      1
    ],
    "tags": [
      "text"
    ],
    "externalCreatedAt": "text",
    "externalUpdatedAt": "text",
    "statusText": "text",
    "priorityText": "text",
    "createdBy": "text",
    "createdAt": "text"
  }
]
200

Array of created test cases.

No content

get

Retrieves the details of a specific test case within a project for a user or organization.

Path parameters
handlestringRequired

The unique identifier for a user or an organization.

keystringRequired

The unique identifier for a project.

idstringRequired

The unique identifier for the test case.

Responses
200

Ok

application/json
Responseany
get
GET /v1/{handle}/projects/{key}/cases/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

No content

delete
Path parameters
handlestringRequired
keystringRequired
idstringRequired
Responses
200

Ok

application/json
delete
DELETE /v1/{handle}/projects/{key}/cases/{id} HTTP/1.1
Host: api.testfiesta.com
Accept: */*
200

Ok

{
  "message": "text"
}

Last updated