---
title: "Create and start a new test profile run."
method: PATCH
path: "/test-profile-runs/{testProfileRunId}"
tags: ["TestProfileRun"]
---

# Create and start a new test profile run.

`PATCH /test-profile-runs/{testProfileRunId}`

Create and start a new test profile run with the given test profile run Id.

## Path parameters

- `testProfileRunId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- TestProfileRun — The Test Profile Run Model. Test Profile Run resource enables you to instantiate an already created test profile and run load tests to get recommendations on the optimal configuration for the target resource.
  - `testProfileRunId` string, required — Unique identifier for the test profile run, must contain only lower-case alphabetic, numeric, underscore or hyphen characters.
  - `displayName` string — Display name for the test profile run.
  - `description` string — The test profile run description
  - `testProfileId` string — Associated test profile ID for the test profile run. This is required to create a test profile run and can't be updated.
  - `targetResourceId` string, arm-id — Target resource ID on which the test profile run is created
  - `targetResourceConfigurations` TargetResourceConfigurations — Configurations of a target resource. This varies with the kind of resource.
    - `kind` 'FunctionsFlexConsumption', required — Kind of the resource on which test profile is created.
  - `status` 'ACCEPTED' | 'NOTSTARTED' | 'EXECUTING' | 'DONE' | 'CANCELLING' | 'CANCELLED' | 'FAILED' — Test profile run status.
  - `errorDetails` ErrorDetails[] — Error details if there is any failure in test profile run. These errors are specific to the Test Profile Run.
    - `code` string — Error code if there is any failure in load test run.
    - `message` string — Error details in case test run was not successfully run.
    - `properties` object — A dictionary for storing additional error information for better context. Each key is a property name (e.g., "Description", "Resolution", "Category", "Region"), and its value is an array of strings with relevant details.
  - `startDateTime` string, date-time — The test profile run start DateTime(RFC 3339 literal format).
  - `endDateTime` string, date-time — The test profile run end DateTime(RFC 3339 literal format).
  - `durationInSeconds` integer — Test profile run duration in seconds.
  - `testRunDetails` object — Details of the test runs ran as part of the test profile run. Key is the testRunId of the corresponding testRun.
  - `recommendations` TestProfileRunRecommendation[] — Recommendations provided based on a successful test profile run.
    - `category` 'ThroughputOptimized' | 'CostOptimized', required — Category of Recommendation.
    - `configurations` string[] — List of configurations IDs for which the recommendation is applicable. These are a subset of the provided target resource configurations.
  - `createdDateTime` string, date-time — The creation datetime(RFC 3339 literal format).
  - `createdBy` string — The user that created.
  - `lastModifiedDateTime` string, date-time — The last Modified datetime(RFC 3339 literal format).
  - `lastModifiedBy` string — The user that last modified.

## Other responses

- `201` — The request has succeeded and a new resource has been created as a result.
- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2022-11-01) `778cfdeae65d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/loadtestservice-loadtesting/changes/test-profile-runs/:testProfileRunId/patch.md)

---

[API](https://skmtc.dev/azure/apis/loadtestservice-loadtesting.md) · [All operations](https://skmtc.dev/azure/apis/loadtestservice-loadtesting/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/loadtestservice-loadtesting/revisions/b15721d91722/schema)