Actualizar un activo por ID

curl --request PUT \
  --url https://api.ugps.io/api/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "icon": {
    "id": "<string>",
    "color": "<string>"
  },
  "mainTrackerId": 123,
  "trackers": [
    {
      "id": 123,
      "platform": "<string>"
    }
  ],
  "plate": "<string>",
  "assetTypeId": "<string>",
  "vehicleTypeId": "<string>",
  "model": "<string>",
  "year": 123,
  "color": "<string>",
  "make": "<string>",
  "chassis": "<string>",
  "motor": "<string>",
  "fuel": "<string>",
  "kilometer": 123,
  "description": "<string>",
  "clientId": "<string>",
  "state": "<string>"
}
'

import requests

url = "https://api.ugps.io/api/assets/{id}"

payload = {
    "name": "<string>",
    "icon": {
        "id": "<string>",
        "color": "<string>"
    },
    "mainTrackerId": 123,
    "trackers": [
        {
            "id": 123,
            "platform": "<string>"
        }
    ],
    "plate": "<string>",
    "assetTypeId": "<string>",
    "vehicleTypeId": "<string>",
    "model": "<string>",
    "year": 123,
    "color": "<string>",
    "make": "<string>",
    "chassis": "<string>",
    "motor": "<string>",
    "fuel": "<string>",
    "kilometer": 123,
    "description": "<string>",
    "clientId": "<string>",
    "state": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    icon: {id: '<string>', color: '<string>'},
    mainTrackerId: 123,
    trackers: [{id: 123, platform: '<string>'}],
    plate: '<string>',
    assetTypeId: '<string>',
    vehicleTypeId: '<string>',
    model: '<string>',
    year: 123,
    color: '<string>',
    make: '<string>',
    chassis: '<string>',
    motor: '<string>',
    fuel: '<string>',
    kilometer: 123,
    description: '<string>',
    clientId: '<string>',
    state: '<string>'
  })
};

fetch('https://api.ugps.io/api/assets/{id}', 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/assets/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'icon' => [
        'id' => '<string>',
        'color' => '<string>'
    ],
    'mainTrackerId' => 123,
    'trackers' => [
        [
                'id' => 123,
                'platform' => '<string>'
        ]
    ],
    'plate' => '<string>',
    'assetTypeId' => '<string>',
    'vehicleTypeId' => '<string>',
    'model' => '<string>',
    'year' => 123,
    'color' => '<string>',
    'make' => '<string>',
    'chassis' => '<string>',
    'motor' => '<string>',
    'fuel' => '<string>',
    'kilometer' => 123,
    'description' => '<string>',
    'clientId' => '<string>',
    'state' => '<string>'
  ]),
  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/assets/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"icon\": {\n    \"id\": \"<string>\",\n    \"color\": \"<string>\"\n  },\n  \"mainTrackerId\": 123,\n  \"trackers\": [\n    {\n      \"id\": 123,\n      \"platform\": \"<string>\"\n    }\n  ],\n  \"plate\": \"<string>\",\n  \"assetTypeId\": \"<string>\",\n  \"vehicleTypeId\": \"<string>\",\n  \"model\": \"<string>\",\n  \"year\": 123,\n  \"color\": \"<string>\",\n  \"make\": \"<string>\",\n  \"chassis\": \"<string>\",\n  \"motor\": \"<string>\",\n  \"fuel\": \"<string>\",\n  \"kilometer\": 123,\n  \"description\": \"<string>\",\n  \"clientId\": \"<string>\",\n  \"state\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.ugps.io/api/assets/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"icon\": {\n    \"id\": \"<string>\",\n    \"color\": \"<string>\"\n  },\n  \"mainTrackerId\": 123,\n  \"trackers\": [\n    {\n      \"id\": 123,\n      \"platform\": \"<string>\"\n    }\n  ],\n  \"plate\": \"<string>\",\n  \"assetTypeId\": \"<string>\",\n  \"vehicleTypeId\": \"<string>\",\n  \"model\": \"<string>\",\n  \"year\": 123,\n  \"color\": \"<string>\",\n  \"make\": \"<string>\",\n  \"chassis\": \"<string>\",\n  \"motor\": \"<string>\",\n  \"fuel\": \"<string>\",\n  \"kilometer\": 123,\n  \"description\": \"<string>\",\n  \"clientId\": \"<string>\",\n  \"state\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/assets/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"icon\": {\n    \"id\": \"<string>\",\n    \"color\": \"<string>\"\n  },\n  \"mainTrackerId\": 123,\n  \"trackers\": [\n    {\n      \"id\": 123,\n      \"platform\": \"<string>\"\n    }\n  ],\n  \"plate\": \"<string>\",\n  \"assetTypeId\": \"<string>\",\n  \"vehicleTypeId\": \"<string>\",\n  \"model\": \"<string>\",\n  \"year\": 123,\n  \"color\": \"<string>\",\n  \"make\": \"<string>\",\n  \"chassis\": \"<string>\",\n  \"motor\": \"<string>\",\n  \"fuel\": \"<string>\",\n  \"kilometer\": 123,\n  \"description\": \"<string>\",\n  \"clientId\": \"<string>\",\n  \"state\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "name": "<string>",
    "icon": {
      "id": "<string>",
      "color": "<string>"
    },
    "mainTrackerId": 123,
    "trackers": [
      {
        "id": 123,
        "platform": "<string>"
      }
    ],
    "plate": "<string>",
    "assetTypeId": "<string>",
    "vehicleTypeId": "<string>",
    "model": "<string>",
    "year": 123,
    "color": "<string>",
    "make": "<string>",
    "chassis": "<string>",
    "motor": "<string>",
    "fuel": "<string>",
    "kilometer": 123,
    "description": "<string>",
    "clientId": "<string>",
    "state": "<string>"
  }
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "Recurso no encontrado"
}

{
  "message": "Error interno del servidor"
}

Activos - Assets

Actualizar un activo por ID

Actualiza un activo existente. Solo se actualizan los campos proporcionados.

Datos que se pueden actualizar:

name (string): Nombre del activo
icon (object): Objeto con id (string) y color (string, formato hexadecimal #RRGGBB o #RGB)
mainTrackerId (number): ID del tracker principal
trackers (array): Array de objetos con id (number) y platform (string)
plate (string): Placa del activo (debe ser única dentro del cliente)
assetTypeId (string): ID del tipo de activo
vehicleTypeId (string): ID del tipo de vehículo
model (string): Modelo del activo
year (number): Año del activo
color (string): Color del activo
make (string): Marca del activo
chassis (string): Número de chasis
motor (string): Número de motor
fuel (string): Tipo de combustible
kilometer (number): Kilometraje
description (string): Descripción adicional
state (string): Estado del activo

Comportamiento automático:

Se valida que la placa y el nombre sean únicos dentro del cliente (si se actualizan)
Si se proporciona un trackerId, se valida que el tracker pertenezca al mismo cliente

Permisos requeridos: access_assets

PUT

api

assets

{id}

Actualizar un activo por ID

curl --request PUT \
  --url https://api.ugps.io/api/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "icon": {
    "id": "<string>",
    "color": "<string>"
  },
  "mainTrackerId": 123,
  "trackers": [
    {
      "id": 123,
      "platform": "<string>"
    }
  ],
  "plate": "<string>",
  "assetTypeId": "<string>",
  "vehicleTypeId": "<string>",
  "model": "<string>",
  "year": 123,
  "color": "<string>",
  "make": "<string>",
  "chassis": "<string>",
  "motor": "<string>",
  "fuel": "<string>",
  "kilometer": 123,
  "description": "<string>",
  "clientId": "<string>",
  "state": "<string>"
}
'

import requests

url = "https://api.ugps.io/api/assets/{id}"

payload = {
    "name": "<string>",
    "icon": {
        "id": "<string>",
        "color": "<string>"
    },
    "mainTrackerId": 123,
    "trackers": [
        {
            "id": 123,
            "platform": "<string>"
        }
    ],
    "plate": "<string>",
    "assetTypeId": "<string>",
    "vehicleTypeId": "<string>",
    "model": "<string>",
    "year": 123,
    "color": "<string>",
    "make": "<string>",
    "chassis": "<string>",
    "motor": "<string>",
    "fuel": "<string>",
    "kilometer": 123,
    "description": "<string>",
    "clientId": "<string>",
    "state": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    icon: {id: '<string>', color: '<string>'},
    mainTrackerId: 123,
    trackers: [{id: 123, platform: '<string>'}],
    plate: '<string>',
    assetTypeId: '<string>',
    vehicleTypeId: '<string>',
    model: '<string>',
    year: 123,
    color: '<string>',
    make: '<string>',
    chassis: '<string>',
    motor: '<string>',
    fuel: '<string>',
    kilometer: 123,
    description: '<string>',
    clientId: '<string>',
    state: '<string>'
  })
};

fetch('https://api.ugps.io/api/assets/{id}', 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/assets/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'icon' => [
        'id' => '<string>',
        'color' => '<string>'
    ],
    'mainTrackerId' => 123,
    'trackers' => [
        [
                'id' => 123,
                'platform' => '<string>'
        ]
    ],
    'plate' => '<string>',
    'assetTypeId' => '<string>',
    'vehicleTypeId' => '<string>',
    'model' => '<string>',
    'year' => 123,
    'color' => '<string>',
    'make' => '<string>',
    'chassis' => '<string>',
    'motor' => '<string>',
    'fuel' => '<string>',
    'kilometer' => 123,
    'description' => '<string>',
    'clientId' => '<string>',
    'state' => '<string>'
  ]),
  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/assets/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"icon\": {\n    \"id\": \"<string>\",\n    \"color\": \"<string>\"\n  },\n  \"mainTrackerId\": 123,\n  \"trackers\": [\n    {\n      \"id\": 123,\n      \"platform\": \"<string>\"\n    }\n  ],\n  \"plate\": \"<string>\",\n  \"assetTypeId\": \"<string>\",\n  \"vehicleTypeId\": \"<string>\",\n  \"model\": \"<string>\",\n  \"year\": 123,\n  \"color\": \"<string>\",\n  \"make\": \"<string>\",\n  \"chassis\": \"<string>\",\n  \"motor\": \"<string>\",\n  \"fuel\": \"<string>\",\n  \"kilometer\": 123,\n  \"description\": \"<string>\",\n  \"clientId\": \"<string>\",\n  \"state\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.ugps.io/api/assets/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"icon\": {\n    \"id\": \"<string>\",\n    \"color\": \"<string>\"\n  },\n  \"mainTrackerId\": 123,\n  \"trackers\": [\n    {\n      \"id\": 123,\n      \"platform\": \"<string>\"\n    }\n  ],\n  \"plate\": \"<string>\",\n  \"assetTypeId\": \"<string>\",\n  \"vehicleTypeId\": \"<string>\",\n  \"model\": \"<string>\",\n  \"year\": 123,\n  \"color\": \"<string>\",\n  \"make\": \"<string>\",\n  \"chassis\": \"<string>\",\n  \"motor\": \"<string>\",\n  \"fuel\": \"<string>\",\n  \"kilometer\": 123,\n  \"description\": \"<string>\",\n  \"clientId\": \"<string>\",\n  \"state\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/assets/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"icon\": {\n    \"id\": \"<string>\",\n    \"color\": \"<string>\"\n  },\n  \"mainTrackerId\": 123,\n  \"trackers\": [\n    {\n      \"id\": 123,\n      \"platform\": \"<string>\"\n    }\n  ],\n  \"plate\": \"<string>\",\n  \"assetTypeId\": \"<string>\",\n  \"vehicleTypeId\": \"<string>\",\n  \"model\": \"<string>\",\n  \"year\": 123,\n  \"color\": \"<string>\",\n  \"make\": \"<string>\",\n  \"chassis\": \"<string>\",\n  \"motor\": \"<string>\",\n  \"fuel\": \"<string>\",\n  \"kilometer\": 123,\n  \"description\": \"<string>\",\n  \"clientId\": \"<string>\",\n  \"state\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "name": "<string>",
    "icon": {
      "id": "<string>",
      "color": "<string>"
    },
    "mainTrackerId": 123,
    "trackers": [
      {
        "id": 123,
        "platform": "<string>"
      }
    ],
    "plate": "<string>",
    "assetTypeId": "<string>",
    "vehicleTypeId": "<string>",
    "model": "<string>",
    "year": 123,
    "color": "<string>",
    "make": "<string>",
    "chassis": "<string>",
    "motor": "<string>",
    "fuel": "<string>",
    "kilometer": 123,
    "description": "<string>",
    "clientId": "<string>",
    "state": "<string>"
  }
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "Recurso no encontrado"
}

{
  "message": "Error interno del servidor"
}

Authorizations

Authorization

string

header

required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Path Parameters

string

required

ID del recurso

Body

application/json

name

string

required

icon

object

required

Show child attributes

mainTrackerId

number

required

trackers

object[]

required

Show child attributes

plate

string

required

assetTypeId

string

required

kind

enum<string>

Familia canonica del activo. Se rellena de forma compatible con tipos antiguos.

Available options:

vehicle,

generic

vehicleTypeId

string

ID del tipo de vehículo asociado al activo (opcional)

model

string

Modelo del activo (opcional)

year

number

color

string

Color del activo (opcional)

make

string

chassis

string

Número de chasis del activo (opcional)

motor

string

Número de motor del activo (opcional)

fuel

string

Tipo de combustible del activo (opcional)

kilometer

number

Kilometraje del activo (opcional)

description

string

Descripción adicional del activo (opcional)

clientId

string

state

string

Estado del activo (opcional)

Response

Activo actualizado exitosamente

status

string

Example:

"success"

data

object

Show child attributes

Obtener un activo por ID Eliminar un activo por ID

⌘I