# Retry opening a generated regression test pull request

POST

/projects/{projectId}/findings/{findingId}/regression-tests/{runId}/retry-publication

```js
const url = 'https://zkao.io/api/v1/projects/example/findings/example/regression-tests/example/retry-publication';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request POST \
  --url https://zkao.io/api/v1/projects/example/findings/example/regression-tests/example/retry-publication \
  --header 'Authorization: Bearer <token>'
```

* Production`zkao.io/api/v1/projects/{projectId}/findings/{findingId}/regression-tests/{runId}/retry-publication`
* Staging`staging.zkao.io/api/v1/projects/{projectId}/findings/{findingId}/regression-tests/{runId}/retry-publication`

Requires scope: `regression-tests:write` and current GitHub write access. Retries a failed publication using the saved test. Does not rerun the agent or reserve another generation budget. Generation failures require a new paid attempt.

## Authorizations

* **[bearerAuth](https://docs.staging.zkao.io/api/#bearerauth)**

## Parameters

### Path Parameters

* **projectId**

  required

  string

* **findingId**

  required

  string

  The finding id, or the `ZK-` label shown on the finding page (the id’s last eight characters, prefix optional). A label that matches more than one finding in the project is refused with `409 conflict`; use the full id.

* **runId**

  required

  string

## Responses

### 202

Publication queued.

application/json

object

* **id**

  required

  string

* **findingId**

  required

  string

* **status**

  required

  string

  Allowed values: QUEUED RUNNING BLOCKED READY PUBLISHED PUBLICATION_FAILED FAILED CANCELLED

* **creditBudget**

  required

  integer

  \>= 1

* **targetBranch**

  required

  string

* **targetCommit**

  required

  string

* **auditedCommit**

  required

  string

* **summary**

  required

  string | null

* **pullRequestUrl**

  required

  string | null format: uri

* **audited**

  required

  Any of:

  object

  object

  * **commit**

    required

    string

    /^\[a-f0-9]{40}$/

  * **outcome**

    required

    string

    Allowed values: assertion_failed passed blocked not_run

  * **command**

    required

    string

  * **summary**

    required

    string

  null

  null

* **target**

  required

  Any of:

  object

  object

  * **commit**

    required

    string

    /^\[a-f0-9]{40}$/

  * **outcome**

    required

    string

    Allowed values: assertion_failed passed blocked not_run

  * **command**

    required

    string

  * **summary**

    required

    string

  null

  null

* **createdAt**

  required

  string format: date-time

* **completedAt**

  required

  string | null format: date-time

##### Example

```json
{
  "status": "QUEUED",
  "audited": {
    "outcome": "assertion_failed"
  },
  "target": {
    "outcome": "assertion_failed"
  }
}
```

### 401

Missing, malformed, expired, or revoked token

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

### 403

The token lacks the required scope

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

### 404

Resource not in this token’s project or repo allowlist

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

### 409

A compare-and-set (`expectedContent`) missed: the guidance changed since it was read. Re-read the current guidance and retry.

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

### 429

Rate limited. Either the token’s spend limit for the current period is reached (on launch), or the token is sending too many requests. Wait the number of seconds in the `Retry-After` header before retrying.

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

#### Headers

* **Retry-After**

  integer

  Seconds to wait before retrying.
