Crear campo personalizado
curl --request POST \
--url https://api.ugps.io/api/asset-custom-fields \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "Código de inventario",
"name": "<string>",
"groupId": "<string>",
"order": 1,
"options": [
{
"label": "<string>",
"value": "<string>",
"status": "active"
}
],
"rules": {
"required": true,
"unique": true,
"minLength": 123,
"maxLength": 123,
"min": 123,
"max": 123,
"maxDecimals": 123,
"minDate": "2023-12-25",
"maxDate": "2023-12-25"
}
}
'import requests
url = "https://api.ugps.io/api/asset-custom-fields"
payload = {
"label": "Código de inventario",
"name": "<string>",
"groupId": "<string>",
"order": 1,
"options": [
{
"label": "<string>",
"value": "<string>",
"status": "active"
}
],
"rules": {
"required": True,
"unique": True,
"minLength": 123,
"maxLength": 123,
"min": 123,
"max": 123,
"maxDecimals": 123,
"minDate": "2023-12-25",
"maxDate": "2023-12-25"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
label: 'Código de inventario',
name: '<string>',
groupId: '<string>',
order: 1,
options: [{label: '<string>', value: '<string>', status: 'active'}],
rules: {
required: true,
unique: true,
minLength: 123,
maxLength: 123,
min: 123,
max: 123,
maxDecimals: 123,
minDate: '2023-12-25',
maxDate: '2023-12-25'
}
})
};
fetch('https://api.ugps.io/api/asset-custom-fields', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ugps.io/api/asset-custom-fields",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'label' => 'Código de inventario',
'name' => '<string>',
'groupId' => '<string>',
'order' => 1,
'options' => [
[
'label' => '<string>',
'value' => '<string>',
'status' => 'active'
]
],
'rules' => [
'required' => true,
'unique' => true,
'minLength' => 123,
'maxLength' => 123,
'min' => 123,
'max' => 123,
'maxDecimals' => 123,
'minDate' => '2023-12-25',
'maxDate' => '2023-12-25'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ugps.io/api/asset-custom-fields"
payload := strings.NewReader("{\n \"label\": \"Código de inventario\",\n \"name\": \"<string>\",\n \"groupId\": \"<string>\",\n \"order\": 1,\n \"options\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\",\n \"status\": \"active\"\n }\n ],\n \"rules\": {\n \"required\": true,\n \"unique\": true,\n \"minLength\": 123,\n \"maxLength\": 123,\n \"min\": 123,\n \"max\": 123,\n \"maxDecimals\": 123,\n \"minDate\": \"2023-12-25\",\n \"maxDate\": \"2023-12-25\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.ugps.io/api/asset-custom-fields")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"label\": \"Código de inventario\",\n \"name\": \"<string>\",\n \"groupId\": \"<string>\",\n \"order\": 1,\n \"options\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\",\n \"status\": \"active\"\n }\n ],\n \"rules\": {\n \"required\": true,\n \"unique\": true,\n \"minLength\": 123,\n \"maxLength\": 123,\n \"min\": 123,\n \"max\": 123,\n \"maxDecimals\": 123,\n \"minDate\": \"2023-12-25\",\n \"maxDate\": \"2023-12-25\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ugps.io/api/asset-custom-fields")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"label\": \"Código de inventario\",\n \"name\": \"<string>\",\n \"groupId\": \"<string>\",\n \"order\": 1,\n \"options\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\",\n \"status\": \"active\"\n }\n ],\n \"rules\": {\n \"required\": true,\n \"unique\": true,\n \"minLength\": 123,\n \"maxLength\": 123,\n \"min\": 123,\n \"max\": 123,\n \"maxDecimals\": 123,\n \"minDate\": \"2023-12-25\",\n \"maxDate\": \"2023-12-25\"\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"id": "6727d4b2c1a8e3f0a9b1c2d3",
"label": "Código de inventario",
"name": "codigo_de_inventario",
"type": "text",
"groupId": "<string>",
"order": 123,
"options": [
{
"value": "taller",
"label": "Taller central",
"status": "active"
}
],
"rules": {
"required": true,
"unique": true,
"minLength": 500,
"maxLength": 500,
"min": 123,
"max": 123,
"maxDecimals": 5,
"minDate": "2020-01-01",
"maxDate": "2030-12-31"
},
"status": "active",
"archivedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}{
"error": "El email es requerido"
}{
"error": "Token inválido o expirado"
}{
"error": "No tiene permisos para realizar esta acción"
}{
"error": "Recurso no encontrado"
}{
"message": "Error interno del servidor"
}Activos - Campos personalizados
Crear campo personalizado
Crea un campo activo. El nombre interno se genera desde la etiqueta si no se envía y queda
fijo. Responde 400 nombrando el conflicto si el nombre interno es reservado (id, name,
plate) o ya lo usa otro campo de la empresa (también uno archivado), si la etiqueta la usa
otro campo activo, si una regla no corresponde al tipo, o si la empresa ya tiene 50 campos
activos.
Permisos requeridos: access_asset_custom_fields (Campos de activos)
POST
/
api
/
asset-custom-fields
Crear campo personalizado
curl --request POST \
--url https://api.ugps.io/api/asset-custom-fields \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "Código de inventario",
"name": "<string>",
"groupId": "<string>",
"order": 1,
"options": [
{
"label": "<string>",
"value": "<string>",
"status": "active"
}
],
"rules": {
"required": true,
"unique": true,
"minLength": 123,
"maxLength": 123,
"min": 123,
"max": 123,
"maxDecimals": 123,
"minDate": "2023-12-25",
"maxDate": "2023-12-25"
}
}
'import requests
url = "https://api.ugps.io/api/asset-custom-fields"
payload = {
"label": "Código de inventario",
"name": "<string>",
"groupId": "<string>",
"order": 1,
"options": [
{
"label": "<string>",
"value": "<string>",
"status": "active"
}
],
"rules": {
"required": True,
"unique": True,
"minLength": 123,
"maxLength": 123,
"min": 123,
"max": 123,
"maxDecimals": 123,
"minDate": "2023-12-25",
"maxDate": "2023-12-25"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
label: 'Código de inventario',
name: '<string>',
groupId: '<string>',
order: 1,
options: [{label: '<string>', value: '<string>', status: 'active'}],
rules: {
required: true,
unique: true,
minLength: 123,
maxLength: 123,
min: 123,
max: 123,
maxDecimals: 123,
minDate: '2023-12-25',
maxDate: '2023-12-25'
}
})
};
fetch('https://api.ugps.io/api/asset-custom-fields', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ugps.io/api/asset-custom-fields",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'label' => 'Código de inventario',
'name' => '<string>',
'groupId' => '<string>',
'order' => 1,
'options' => [
[
'label' => '<string>',
'value' => '<string>',
'status' => 'active'
]
],
'rules' => [
'required' => true,
'unique' => true,
'minLength' => 123,
'maxLength' => 123,
'min' => 123,
'max' => 123,
'maxDecimals' => 123,
'minDate' => '2023-12-25',
'maxDate' => '2023-12-25'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ugps.io/api/asset-custom-fields"
payload := strings.NewReader("{\n \"label\": \"Código de inventario\",\n \"name\": \"<string>\",\n \"groupId\": \"<string>\",\n \"order\": 1,\n \"options\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\",\n \"status\": \"active\"\n }\n ],\n \"rules\": {\n \"required\": true,\n \"unique\": true,\n \"minLength\": 123,\n \"maxLength\": 123,\n \"min\": 123,\n \"max\": 123,\n \"maxDecimals\": 123,\n \"minDate\": \"2023-12-25\",\n \"maxDate\": \"2023-12-25\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.ugps.io/api/asset-custom-fields")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"label\": \"Código de inventario\",\n \"name\": \"<string>\",\n \"groupId\": \"<string>\",\n \"order\": 1,\n \"options\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\",\n \"status\": \"active\"\n }\n ],\n \"rules\": {\n \"required\": true,\n \"unique\": true,\n \"minLength\": 123,\n \"maxLength\": 123,\n \"min\": 123,\n \"max\": 123,\n \"maxDecimals\": 123,\n \"minDate\": \"2023-12-25\",\n \"maxDate\": \"2023-12-25\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ugps.io/api/asset-custom-fields")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"label\": \"Código de inventario\",\n \"name\": \"<string>\",\n \"groupId\": \"<string>\",\n \"order\": 1,\n \"options\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\",\n \"status\": \"active\"\n }\n ],\n \"rules\": {\n \"required\": true,\n \"unique\": true,\n \"minLength\": 123,\n \"maxLength\": 123,\n \"min\": 123,\n \"max\": 123,\n \"maxDecimals\": 123,\n \"minDate\": \"2023-12-25\",\n \"maxDate\": \"2023-12-25\"\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"id": "6727d4b2c1a8e3f0a9b1c2d3",
"label": "Código de inventario",
"name": "codigo_de_inventario",
"type": "text",
"groupId": "<string>",
"order": 123,
"options": [
{
"value": "taller",
"label": "Taller central",
"status": "active"
}
],
"rules": {
"required": true,
"unique": true,
"minLength": 500,
"maxLength": 500,
"min": 123,
"max": 123,
"maxDecimals": 5,
"minDate": "2020-01-01",
"maxDate": "2030-12-31"
},
"status": "active",
"archivedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}{
"error": "El email es requerido"
}{
"error": "Token inválido o expirado"
}{
"error": "No tiene permisos para realizar esta acción"
}{
"error": "Recurso no encontrado"
}{
"message": "Error interno del servidor"
}Authorizations
bearerAuthcookieAuth
Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.
Body
application/json
Maximum string length:
60Example:
"Código de inventario"
Available options:
text, number, date, select, boolean Opcional. Sin él se genera desde la etiqueta (minúsculas, sin tildes, palabras unidas
por _). No se aceptan id, name ni plate.
Pattern:
^[a-z][a-z0-9_]{1,49}$Sin grupo, el campo cae en «General».
Sin orden, va al final de su grupo.
Required range:
x >= 0Obligatorio en select (al menos una opción); no se admite en otros tipos.
Maximum array length:
100Show child attributes
Show child attributes
Reglas enviadas. Al editar se mezclan por clave: una clave con null quita la regla y una
clave ausente queda como estaba. Una regla que no corresponde al tipo, o un rango invertido,
responde 400 nombrando la regla.
Show child attributes
Show child attributes