Skip to main content
DELETE
Delete a pipeline stage

Authorizations

Authorization
string
header
required

Company-scoped API key. Production keys are prefixed sk_live_, sandbox keys sk_test_, each followed by 22 base62 characters (pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the TapTalent dashboard under Account Settings → Developers → API Key Management; a key is shown once at generation and old keys are invalidated immediately on regeneration.

Path Parameters

stageId
integer
required

The unique identifier of the stage to delete.

Body

application/json

Request body for deleting a pipeline stage. Note this body is carried on a DELETE request; some HTTP clients strip DELETE bodies — verify your client transmits it.

pipelineId
integer
required

The unique identifier of the pipeline.

Example:

123

newStageId
integer
required

The stage ID where candidates from the deleted stage should be moved.

Example:

790

Response

Stage deleted. Candidates from the deleted stage have been moved to newStageId and the remaining stages have been reordered sequentially.

status
enum<string>
required
Available options:
success
message
string
required

Human-readable confirmation message.

Example:

"Stage deleted successfully"