---
title: "Start a Fix run for a finding"
method: POST
path: "/experimental/findings-v2/{findingId}/fix"
tags: ["Findings V2"]
---

# Start a Fix run for a finding

`POST /experimental/findings-v2/{findingId}/fix`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/findings-v2/{findingId}/fix`
- Auth: none declared

Starts a cloud agent run that makes the change the instructions describe in the finding's repository and opens a pull request. The run attaches the pull request to the finding's links. Returns the launch run; poll it and its events for progress. Requires a Tessl GitHub App with write access to the repository.

## Path parameters

- `findingId` string, uuid, required

## Headers

- `Authorization` string

## Request body

- object
  - `instructions` string, required: What the agent should change. The Fix page prefills it from the finding's recommendation.
  - `baseBranch` string: Branch the pull request targets. Defaults to the project's Loop branch, then the repository's default branch.

## Response `201`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'launch-run', required
    - `attributes` object, required
      - `workflowId` string, nullable, required
      - `status` union, required
        - 'pending'
        - 'completed'
        - 'failed'
        - 'cancelled'
      - `label` string, nullable, required
      - `createdBy` string, uuid, nullable, required
      - `createdAt` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Default Response
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

## Changes

- **2026-10-16** `322ccb9a2d65`: 2 breaking, 1 info
  - the response's body type changed from `object` to no type for status `403`
  - removed the required property `error` from the response with the `403` status
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `403`
- **2026-10-15** `f06a9f376235`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/findings-v2/:findingId/fix/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/7386f1e6295b?raw)