---
title: "Delete a payroll"
method: DELETE
path: "/v1/companies/{company_id}/payrolls/{payroll_id}"
tags: ["Payrolls"]
---

# Delete a payroll

`DELETE /v1/companies/{company_id}/payrolls/{payroll_id}`

This endpoint allows you to delete an **unprocessed** payroll.

By default the payroll and associated data is deleted synchronously. To request an asynchronous delete, use the `async=true` query parameter. In both cases validation of ability to delete will be performed and an Unprocessable Entity error will be returned if the payroll is not able to be deleted. A successful synchronous delete will return `204/No Content`. When a payroll has been enqueued for asynchronous deletion, `202/Accepted` will be returned.

scope: `payrolls:run`

## Path parameters

- `company_id` string, required
- `payroll_id` string, required

## Query parameters

- `async` boolean

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `202`

Accepted

## Other responses

- `204` — no content
- `404` — Not Found

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)