post
https://app.fracttal.com/api/tasks_types_catalog/
Creates a new value in one of the three auxiliary Task catalogs — Task Type, Classification 1, or Classification 2 — based on the sub-catalog indicated in the type parameter. Acts as a single dispatcher endpoint that routes the creation to the existing logic of each sub-catalog.
General use — no specific add-on required.
POST https://app.fracttal.com/api/tasks_types_catalogInput parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | text | Yes | Target sub-catalog. Valid values: TYPE_TASK (Task Type), GROUP_1 (Classification 1), GROUP_2 (Classification 2). |
description | text | Yes | Value to create in the sub-catalog indicated by type. Maximum length: 200 characters for GROUP_1; 50 characters for TYPE_TASK and GROUP_2. |
Rules fortypeanddescription
- Valid values for
type:TYPE_TASK(Task Type),GROUP_1(Classification 1),GROUP_2(Classification 2). Any other value returns an error (see Errors).- The maximum length of
descriptiondepends on the target sub-catalog: 200 characters forGROUP_1, 50 characters forTYPE_TASKandGROUP_2.- Duplicate validation is per sub-catalog: the same
descriptioncan exist under differenttypevalues without being considered a duplicate (for example, "Corrective" can exist simultaneously asTYPE_TASKand asGROUP_1).
Output parameters
| Parameter | Type | Description |
|---|---|---|
success | boolean | Indicates whether the operation was successful. |
message | text | Descriptive result message. |
total | integer | Number of records affected (1 on successful creation). |
data | object | Contains the created record. |
data.id | integer | Unique identifier of the new record. |
Errors
| Code | Cause |
|---|---|
400 | type is missing, empty, or different from TYPE_TASK, GROUP_1, or GROUP_2. |
400 | description is missing, empty, or made up only of spaces. |
400 | description exceeds the maximum length allowed for the target sub-catalog (200 for GROUP_1, 50 for TYPE_TASK/GROUP_2). |
401 | Invalid, expired, or missing authentication token. |
403 | The authenticated account does not have permission over the Configuration > Catalogs module. |
404 | A description equal (case-insensitive) already exists within the same sub-catalog (type) for the company. |
500 | Unhandled internal error. |
Note on the404codeThis endpoint uses
404to indicate that the value already exists in the sub-catalog, following the dominant convention of other endpoints in the same module — it is not a standard "resource not found"404.
Example
Request body
{
"type": "TYPE_TASK",
"description": "Preventive"
}Response 200
200{
"success": true,
"message": "Registro creado exitosamente",
"total": 1,
"data": {
"id": 145
}
}Response — invalid type (400)
type (400){
"success": false,
"message": "type no es válido. Valores permitidos: TYPE_TASK, GROUP_1, GROUP_2",
"total": 0,
"data": null
}Response — description exceeds maximum length (400)
description exceeds maximum length (400){
"success": false,
"message": "description exceeds maximum length of 50 characters",
"total": 0,
"data": null
}Response — duplicate description within the same sub-catalog (404)
description within the same sub-catalog (404){
"success": false,
"message": "404",
"total": 0,
"data": null
}OpenAPI definition
{
"openapi": "3.1.0",
"info": {
"title": "tareas",
"version": "1-Es"
},
"servers": [
{ "url": "https://app.fracttal.com/api/tasks_types_catalog" }
],
"security": [{}],
"paths": {
"/": {
"post": {
"summary": "Crear un valor en catálogos auxiliares de tareas (tipo, clasificación 1 y 2)",
"description": "",
"operationId": "crear-un-valor-en-catalogos-auxiliares-de-tareas",
"deprecated": false,
"security": []
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}