Create a XC status

QA Environment

https://qa-api.kiolinkapp.com

POST

/v1/xc/statuses

XC Statuses

Last modified:2026-09-26 20:21:45

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-status-create

Creates a new XC status (Kanban column). code and name are required; code must be unique across all statuses. Note: id is generated server-side and must not be sent in the request body, even though the shared schema below (also used for responses) lists it as required.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Body Params application/jsonRequired

Example

{
    "code": "FIRMA",
    "name": "Firma",
    "description": "La solicitud está en firma de contrato",
    "order_index": 5,
    "category": "POST_SOW",
    "salesforce_stage_code": "SF_SIGNATURE"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qa-api.kiolinkapp.com/v1/xc/statuses' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "code": "FIRMA",
    "name": "Firma",
    "description": "La solicitud está en firma de contrato",
    "order_index": 5,
    "category": "POST_SOW",
    "salesforce_stage_code": "SF_SIGNATURE"
}'

Responses

🟢201

application/json

The newly created status.

Bodyapplication/json

Example

{
    "id": "xcs_uKwYYmF2N9p2fmQW",
    "code": "RECIBIDO",
    "name": "Recibido",
    "description": "Se ha recibido la solicitud XC",
    "order_index": null,
    "category": null,
    "salesforce_stage_code": null
}

Modified at 2026-09-26 20:21:45

Get a XC status

Update a XC status