Skip to main content
POST
/
locations
/
{location_id}
/
asset_types
Add Asset Type
curl --request POST \
  --url https://api.crosoftware.com/v0/locations/{location_id}/asset_types \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "category_id": 123,
  "name": "<string>",
  "quantity": 123,
  "require_numbers": true,
  "weight": "<string>"
}
'
import requests

url = "https://api.crosoftware.com/v0/locations/{location_id}/asset_types"

payload = {
"category_id": 123,
"name": "<string>",
"quantity": 123,
"require_numbers": True,
"weight": "<string>"
}
headers = {
"x-tenant-id": "<x-tenant-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

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

print(response.text)
const options = {
method: 'POST',
headers: {
'x-tenant-id': '<x-tenant-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
category_id: 123,
name: '<string>',
quantity: 123,
require_numbers: true,
weight: '<string>'
})
};

fetch('https://api.crosoftware.com/v0/locations/{location_id}/asset_types', 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.crosoftware.com/v0/locations/{location_id}/asset_types",
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([
'category_id' => 123,
'name' => '<string>',
'quantity' => 123,
'require_numbers' => true,
'weight' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-tenant-id: <x-tenant-id>"
],
]);

$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.crosoftware.com/v0/locations/{location_id}/asset_types"

payload := strings.NewReader("{\n \"category_id\": 123,\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"require_numbers\": true,\n \"weight\": \"<string>\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("x-tenant-id", "<x-tenant-id>")
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.crosoftware.com/v0/locations/{location_id}/asset_types")
.header("x-tenant-id", "<x-tenant-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"category_id\": 123,\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"require_numbers\": true,\n \"weight\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.crosoftware.com/v0/locations/{location_id}/asset_types")

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

request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"category_id\": 123,\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"require_numbers\": true,\n \"weight\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "deleted": true,
  "id": 123,
  "is_default": true,
  "location_id": 123,
  "name": "<string>",
  "quantity": 123,
  "require_numbers": true,
  "valid_trucks": [
    123
  ],
  "weight": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-api-version
string

Version identifier (date format).

x-tenant-id
integer<int64>
required

Tenant identifier. Contact CRO Software for more info if you don't already have this id. See list tenant ids for info on listing the tenants you have access to.

Path Parameters

location_id
integer<int64>
required

Location identifier.

Body

application/json

Create asset type.

category_id
integer<int64>
required

Category identifier.

name
string
required

Asset type name.

quantity
integer
required

Asset type quantity.

require_numbers
boolean
required

Require asset numbers.

weight
string

Response

200 - application/json

Success

Asset type profile.

deleted
boolean
required

Is record deleted (soft delete).

id
integer<int64>
required

Asset type identifier.

is_default
boolean
required

Is asset the default asset.

location_id
integer<int64>
required

Location identifier.

name
string
required

Asset type name.

quantity
integer
required

Asset type quantity.

require_numbers
boolean
required

Require asset numbers.

valid_trucks
integer<int64>[]
required

Truck identifier.

weight
string
required