Delete a XC status

QA Environment

https://qa-api.kiolinkapp.com

DELETE

/v1/xc/statuses/{id}

XC Statuses

Last modified:2026-09-25 18:12:20

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-status-delete

Permanently deletes an XC status by its ID. If any XC request currently has this status, its current_status_id is set to null (ON DELETE SET NULL). If this status appears in any status-history record, the deletion is rejected with a database foreign-key error (ON DELETE RESTRICT) rather than a friendly application error.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://qa-api.kiolinkapp.com/v1/xc/statuses/xcs_TGJm3SEHdcjHVBnQ' \
--header 'authorization: <api-key>'

Responses

🟢200

application/json

Status deleted. Any XC request referencing it via current_status_id has that field set to null (ON DELETE SET NULL); deletion fails with a database error if the status is referenced by any xc_status_histories.new_status_id (ON DELETE RESTRICT).

Bodyapplication/json

Example

{
    "deleted": true
}

🟠404

Modified at 2026-09-25 18:12:20

Update a XC status

Overview