curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": {
"sections": {}
},
"facets": {}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": { "sections": {} },
"facets": {}
}
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({
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {},
essentials: {sections: {}},
facets: {}
})
};
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([
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
],
'essentials' => [
'sections' => [
]
],
'facets' => [
]
]),
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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\n}"
response = http.request(request)
puts response.read_body{}"<string>""<string>""<string>"Create an asset
Creates an asset — or updates it if Docusnap365 already knows it by
its identity. An AssetBundle is submitted: schemaId determines the
type, objectData follows the type’s data definition. More complete
records are not overwritten by less complete sources.
Permission: Write.
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": {
"sections": {}
},
"facets": {}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": { "sections": {} },
"facets": {}
}
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({
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {},
essentials: {sections: {}},
facets: {}
})
};
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([
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
],
'essentials' => [
'sections' => [
]
],
'facets' => [
]
]),
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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\n}"
response = http.request(request)
puts response.read_body{}"<string>""<string>""<string>"Authorizations
API key from Docusnap365 (Administration › API keys). Read endpoints require the Read permission, write endpoints require Write.
Body
An asset as created or updated. The field names object and objectData are part of the interface.
Type of the asset. Required even if object.schemaId is set.
Correlation ID, optional.
Core data of an asset.
Show child attributes
Show child attributes
Data of the type, following its data definition.
Quick view of the asset.
Show child attributes
Show child attributes
ITAM and ISMS data of the asset, one list per area.
Response
Result of the create or update.
The response is of type object.