Create or update asset
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811922L"
}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811922L" }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '9e2b7c11-1111-2222-3333-444455556666',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811922L'}
})
};
fetch('https://api.docusnap365.com/api/v1/asset', 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.docusnap365.com/api/v1/asset",
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([
'id' => '9e2b7c11-1111-2222-3333-444455556666',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811922L'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.docusnap365.com/api/v1/asset"
payload := strings.NewReader("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.docusnap365.com/api/v1/asset")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docusnap365.com/api/v1/asset")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:rest-request-quota-exceeded",
"title": "Request quota exceeded",
"status": 429,
"detail": "The request quota of 10000 requests per period is exhausted until 2026-10-17T09:52:44.0000000+00:00.",
"instance": "/api/v1/assets",
"errorCode": "REST_REQUEST_QUOTA_EXCEEDED",
"errors": [
{
"code": "REST_REQUEST_QUOTA_EXCEEDED",
"data": {
"requestsLimit": 10000,
"requestsUsed": 10000,
"quotaResetAt": "2026-10-17T09:52:44+00:00"
}
}
],
"traceId": "00-…"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}Assets
Create or update asset
Creates an asset – or updates it if Docusnap365 already knows it by its
identity. You pass an AssetBundle: schemaId sets the type,
objectData follows its data definition. More complete records
(completenessLevel) are not overwritten by less complete sources.
The API answers 201 when the asset was created and 200 when it was
updated. Whether the asset was saved is stated in isSuccess.
Permission: Read and Write.
POST
/
asset
Create or update asset
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811922L"
}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811922L" }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '9e2b7c11-1111-2222-3333-444455556666',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811922L'}
})
};
fetch('https://api.docusnap365.com/api/v1/asset', 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.docusnap365.com/api/v1/asset",
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([
'id' => '9e2b7c11-1111-2222-3333-444455556666',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811922L'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.docusnap365.com/api/v1/asset"
payload := strings.NewReader("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.docusnap365.com/api/v1/asset")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docusnap365.com/api/v1/asset")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:rest-request-quota-exceeded",
"title": "Request quota exceeded",
"status": 429,
"detail": "The request quota of 10000 requests per period is exhausted until 2026-10-17T09:52:44.0000000+00:00.",
"instance": "/api/v1/assets",
"errorCode": "REST_REQUEST_QUOTA_EXCEEDED",
"errors": [
{
"code": "REST_REQUEST_QUOTA_EXCEEDED",
"data": {
"requestsLimit": 10000,
"requestsUsed": 10000,
"quotaResetAt": "2026-10-17T09:52:44+00:00"
}
}
],
"traceId": "00-…"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}Authorizations
API key from Docusnap365 (Administration › Integrations › API Keys). Read endpoints require the access Read, write endpoints Read and Write.
Body
application/json
An asset when creating or updating. The field names object and objectData are part of the interface.
Type of the asset. Required, even if object.schemaId is set.
Freely chosen identifier of the request. Not stored; it comes back as idPair.fakeId. One is generated if omitted.
An asset's core fields when writing.
Show child attributes
Show child attributes
The type's data, following its data definition. Replaced in full, not merged; left unchanged if omitted, {} empties it.
The asset's quick info.
Show child attributes
Show child attributes
The asset's ITAM and ISMS data, one list per area.
Show child attributes
Show child attributes
Response
Asset updated.