Skip to main content
PATCH
Update an inventory asset.

Authorizations

X-API-Key
string
header
required

Infrawatch API key. Supply the complete key directly as the header value.

Path Parameters

project_uuid
string<uuid>
required
asset_uuid
string<uuid>
required

Body

application/json

Sparse update. Null clears nullable fields. Status updates drive approved/monitored/ignored/removed/archived state and timestamps.

activity
string | null
Maximum string length: 256
added_by_method
enum<string>
Available options:
manual,
discovery,
auto_discovered,
import,
api,
integration
asn
integer<int64> | null

Must match the ASPLAIN value; updating either field canonicalizes both.

Required range: 1 <= x <= 4294967295
asset_family
string
asset_kind
enum<string>
Available options:
domain,
subdomain,
page,
ssl_certificate,
asn,
ip_block,
ip_address,
contact,
brand_name
asset_type
string | null
brand_main_website_url
string<uri>

Required for brand_name assets and cannot be cleared. Its canonical percent-encoded form must also fit the 2048-character limit.

Maximum string length: 2048
Pattern: ^[hH][tT][tT][pP][sS]?://[^/@\s]+([/?#].*)?$
certificate_issuer
string | null
certificate_not_after
string<date-time> | null
certificate_not_before
string<date-time> | null
certificate_sha256
string | null
Pattern: ^[0-9a-fA-F]{64}$
certificate_subject
string | null
cname_records
string[] | null
contact_email
string<email> | null
contact_name
string | null
contact_type
string | null
discovery_channel
string | null
discovery_provider
string | null
display_name
string | null
dns_a_records
string[] | null
dns_aaaa_records
string[] | null
dns_name
string | null
domain_status
string | null
Maximum string length: 128
favicon_sha256
string | null
Pattern: ^[0-9a-fA-F]{64}$
final_url
string<uri> | null
Maximum string length: 2048
Pattern: ^[hH][tT][tT][pP][sS]?://[^/@\s]+([/?#].*)?$
first_seen_at
string<date-time>
host
string | null
ip
string | null
ip_addresses
string[] | null
ip_block
string | null
last_observed_at
string<date-time> | null
last_seen_at
string<date-time>
metadata
object
name_servers
string[] | null
normalized_value
string
os_family
string | null
owner_group_uuid
string<uuid> | null
owner_membership_uuid
string<uuid> | null
page_sha256
string | null
Pattern: ^[0-9a-fA-F]{64}$
parent_domain
string | null
primary_source_name
string | null
primary_source_ref
string | null
provider
string | null
Maximum string length: 256
registered_at
string<date-time> | null
registrar
string | null
Maximum string length: 512
root_domain
string | null
screenshot_sha256
string | null
Pattern: ^[0-9a-fA-F]{64}$
source_kind
enum<string>
Available options:
manual,
auto_discovered,
import,
api,
integration
status
enum<string>
Available options:
candidate,
approved,
monitored,
ignored,
removed,
archived
title
string | null
Maximum string length: 1024
url
string<uri> | null

HTTP or HTTPS URL without embedded user credentials. For page assets it must match host and cannot be cleared. The canonical percent-encoded URL must also fit the 2048-character limit.

Maximum string length: 2048
Pattern: ^[hH][tT][tT][pP][sS]?://[^/@\s]+([/?#].*)?$
value
string

Response

Inventory asset updated.

asset
object
required