GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Delete a payroll

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 Params
string
required

The UUID of the company

string
required

The UUID of the payroll

Query Params
boolean

When true, request an asynchronous delete of the payroll.

Headers
string
enum
Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:
Responses
202

Accepted

204

no content

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json