Skip to main content
POST
/
api
/
v1
/
assets
/
{id}
cURL
curl --request POST \
  --url https://api.salvy.com.br/api/v1/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enrollmentId": "SLY-12345",
  "category": "notebook",
  "brand": "Dell",
  "model": "XPS 13",
  "vendorName": "Tech Supplier Inc.",
  "serialNumber": "SN1234567890",
  "deviceId": "8A1D30F4-8C87-44CD-A663-2229DE6F64BD",
  "acquisitionDate": "2025-12-10T03:00:00.000Z",
  "acquisitionType": "bought",
  "priceCents": 250000,
  "nfeNumber": "000123456789",
  "contractId": "CT-2024-0001",
  "warrantyExpirationDate": "2025-12-24T03:00:00.000Z",
  "status": "in-use",
  "allocatedLocation": "Sala do RH",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000",
  "employeeAttachedAt": "2025-01-01T00:00:00.000Z",
  "source": "desktop-client",
  "customFields": [
    {
      "label": "<string>",
      "value": "<string>"
    }
  ]
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "enrollmentId": "SLY-12345",
  "status": "in-use",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "source": "desktop-client",
  "customFields": [
    {
      "label": "teste",
      "type": "text",
      "value": "teste"
    }
  ],
  "category": "notebook",
  "brand": "Dell",
  "model": "XPS 13",
  "vendorName": "Tech Supplier Inc.",
  "serialNumber": "SN1234567890",
  "deviceId": "8A1D30F4-8C87-44CD-A663-2229DE6F64BD",
  "acquisitionDate": "2025-12-10T03:00:00.000Z",
  "acquisitionType": "bought",
  "priceCents": 250000,
  "nfeNumber": "000123456789",
  "contractId": "CT-2024-0001",
  "warrantyExpirationDate": "2025-12-24T03:00:00.000Z",
  "allocatedLocation": "Sala do RH",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000",
  "employeeAttachedAt": "2025-01-01T00:00:00.000Z"
}
Este endpoint permite atualizar os dados de um equipamento existente na plataforma Salvy. Forneça o ID do equipamento na URL e os detalhes a serem atualizados no corpo da requisição. Propriedades omitidas permanecerão inalteradas. A resposta retornará os dados atualizados do equipamento.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Body

application/json
​
enrollmentId
string

Número de patrimônio do equipamento

Example:

"SLY-12345"

​
category
string

Categoria do equipamento

Example:

"notebook"

​
brand
string

Marca do equipamento

Example:

"Dell"

​
model
string

Modelo do equipamento

Example:

"XPS 13"

​
vendorName
string

Nome do fornecedor do equipamento

Example:

"Tech Supplier Inc."

​
serialNumber
string

Número de série do equipamento

Example:

"SN1234567890"

​
deviceId
string

ID do dispositivo coletado pelo aplicativo mobile da Salvy

Example:

"8A1D30F4-8C87-44CD-A663-2229DE6F64BD"

​
acquisitionDate
string<date-time>

Data de aquisição do equipamento

Example:

"2025-12-10T03:00:00.000Z"

​
acquisitionType
enum<string>

Tipo de aquisição do equipamento

Available options:
bought,
rented,
other
Example:

"bought"

​
priceCents
number

Preço de aquisição do equipamento em centavos

Example:

250000

​
nfeNumber
string

Número da nota fiscal de aquisição do equipamento

Example:

"000123456789"

​
contractId
string

Identificador do contrato relacionado ao equipamento

Example:

"CT-2024-0001"

​
warrantyExpirationDate
string<date-time>

Data de expiração da garantia do equipamento

Example:

"2025-12-24T03:00:00.000Z"

​
status
enum<string>

Situação do equipamento

Available options:
available,
in-use,
allocated,
maintenance,
broken,
lost,
stolen,
sold,
donated,
discarded,
archived
Example:

"in-use"

​
allocatedLocation
string

Local de alocação do equipamento

Example:

"Sala do RH"

​
employeeId
string

Id do colaborador ao qual o equipamento está associado

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
employeeAttachedAt
string<date-time>

Data de vinculação do colaborador ao equipamento

Example:

"2025-01-01T00:00:00.000Z"

​
source
enum<string>

Fonte de criação do equipamento

Available options:
manual,
sheets-import,
nfe-import,
desktop-client,
mobile-app
Example:

"desktop-client"

​
customFields
object[]

Response

​
id
string
required

Identificador do equipamento na plataforma Salvy (UUID)

Examples:

"123e4567-e89b-12d3-a456-426614174000"

"123e4567-e89b-12d3-a456-426614174001"

​
enrollmentId
string
required

Número de patrimônio do equipamento

Example:

"SLY-12345"

​
status
enum<string>
required

Situação do equipamento

Available options:
available,
in-use,
allocated,
maintenance,
broken,
lost,
stolen,
sold,
donated,
discarded,
archived
Example:

"in-use"

​
createdAt
string<date-time>
required

Data de criação do equipamento

Example:

"2025-01-01T00:00:00.000Z"

​
source
enum<string>
required

Fonte de criação do equipamento

Available options:
manual,
sheets-import,
nfe-import,
desktop-client,
mobile-app
Example:

"desktop-client"

​
customFields
object[]
required

Campos personalizados do equipamento

Example:
[
  {
    "label": "teste",
    "type": "text",
    "value": "teste"
  }
]
​
category
string

Categoria do equipamento

Example:

"notebook"

​
brand
string

Marca do equipamento

Example:

"Dell"

​
model
string

Modelo do equipamento

Example:

"XPS 13"

​
vendorName
string

Nome do fornecedor do equipamento

Example:

"Tech Supplier Inc."

​
serialNumber
string

Número de série do equipamento

Example:

"SN1234567890"

​
deviceId
string

ID do dispositivo coletado pelo aplicativo mobile da Salvy

Example:

"8A1D30F4-8C87-44CD-A663-2229DE6F64BD"

​
acquisitionDate
string<date-time>

Data de aquisição do equipamento

Example:

"2025-12-10T03:00:00.000Z"

​
acquisitionType
enum<string>

Tipo de aquisição do equipamento

Available options:
bought,
rented,
other
Example:

"bought"

​
priceCents
number

Preço de aquisição do equipamento em centavos

Example:

250000

​
nfeNumber
string

Número da nota fiscal de aquisição do equipamento

Example:

"000123456789"

​
contractId
string

Identificador do contrato relacionado ao equipamento

Example:

"CT-2024-0001"

​
warrantyExpirationDate
string<date-time>

Data de expiração da garantia do equipamento

Example:

"2025-12-24T03:00:00.000Z"

​
allocatedLocation
string

Local de alocação do equipamento

Example:

"Sala do RH"

​
employeeId
string

Id do colaborador ao qual o equipamento está associado

Examples:

"123e4567-e89b-12d3-a456-426614174000"

"123e4567-e89b-12d3-a456-426614174001"

​
employeeAttachedAt
string<date-time>

Data de vinculação do colaborador ao equipamento

Example:

"2025-01-01T00:00:00.000Z"