Skip to main content

API Changelog version 2.31.0

Will be released on July 21st, 2026

Written by Helyette Mehouelley

Impact level: High

Breaking changes

The liveness fields (in Asset endpoints) and filters (liveness and asset_liveness ) were removed from API responses and query parameters.

Instead, use the improved availability field and filter, It covers the same values as liveness (unknwon , up , down ) plus `banned.

The type to create or update Dynamic Asset Group filters for the availability is now asset_availability .

The field to create AutoTag Policies Filters for the availability is now asset_availability

API Changes

GET /api/auth/asm/cve/

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/asm/cve/count/

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

POST /api/auth/asm/cve/related-assets-count/

  • added the new enum value banned to the query request parameter asset_availability

GET /api/auth/asm/cve/v2/

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/assets/

  • :warning: removed the required property results/items/liveness from the response with the 200 status

  • :warning: deleted the query request parameter liveness

  • added the new optional query request parameter availability

  • added the required property results/items/availability to the response with the 200 status

POST /api/auth/assets/

  • :warning: removed the required property data/liveness from the response with the 201 status

  • added the required property data/availability to the response with the 201 status

GET /api/auth/assets/by-control-warning-impacted

  • :warning: deleted the query request parameter liveness

  • added the new optional query request parameter availability

GET /api/auth/assets/by-types

  • :warning: deleted the query request parameter liveness

  • added the new optional query request parameter availability

GET /api/auth/assets/criticalities

  • :warning: deleted the query request parameter liveness

  • added the new optional query request parameter availability

GET /api/auth/assets/export/json

  • :warning: removed the required property liveness from the response with the 200 status

  • added the required property availability to the response with the 200 status

GET /api/auth/assets/group/

  • :warning: the results/items/asset_group_tags response’s property type changed from object to any for status 200

  • added #/components/schemas/AssetTag to the results/items/asset_group_tags response property allOf list for the response status 200

  • the response property results/items/asset_group_tags became not nullable for the status 200

  • the results/items/assets/items/ response’s property type was narrowed from any to object for status 200

  • added the required property results/items/assets/items/id to the response with the 200 status

  • added the required property results/items/assets/items/outside_business_hours to the response with the 200 status

  • added the required property results/items/assets/items/protection to the response with the 200 status

  • added the required property results/items/assets/items/value to the response with the 200 status

  • added the required property results/items/assets_count to the response with the 200 status

POST /api/auth/assets/group/

  • :warning: the filters/items/ request property type changed from any to object (media type: multipart/form-data)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/json)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/x-www-form-urlencoded)

  • the filters/items/ response’s property type was narrowed from any to object for status 201

GET /api/auth/assets/group/export/csv

  • the filters/items/ response’s property type was narrowed from any to object for status 200

POST /api/auth/assets/group/export/csv

  • :warning: the filters/items/ request property type changed from any to object (media type: application/x-www-form-urlencoded)

  • :warning: the filters/items/ request property type changed from any to object (media type: multipart/form-data)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/json)

  • the filters/items/ response’s property type was narrowed from any to object for status 200

GET /api/auth/assets/group/{id}/

  • the filters/items/ response’s property type was narrowed from any to object for status 200

PATCH /api/auth/assets/group/{id}/

  • :warning: the filters/items/ request property type changed from any to object (media type: multipart/form-data)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/json)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/x-www-form-urlencoded)

  • the filters/items/ response’s property type was narrowed from any to object for status 200

POST /api/auth/assets/group/{id}/filters

  • :warning: removed the enum value asset_liveness of the request property items/type (media type: application/json)

  • :warning: removed the enum value asset_liveness of the request property items/type (media type: application/x-www-form-urlencoded)

  • :warning: removed the enum value asset_liveness of the request property items/type (media type: multipart/form-data)

  • :warning: added #/components/schemas/DynamicAvailabilityFilter to the response body oneOf list for the response status 201

  • added the new asset_availability enum value to the request property items/type (media type: application/json)

  • added the new asset_availability enum value to the request property items/type (media type: application/x-www-form-urlencoded)

  • added the new asset_availability enum value to the request property items/type (media type: multipart/form-data)

  • removed #/components/schemas/DynamicStatusFilter from the response body oneOf list for the response status 201

POST /api/auth/assets/group/{id}/owners

  • :warning: the filters/items/ request property type changed from any to object (media type: multipart/form-data)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/x-www-form-urlencoded)

  • :warning: the filters/items/ request property type changed from any to object (media type: application/json)

  • the filters/items/ response’s property type was narrowed from any to object for status 200

POST /api/auth/assets/ports

  • :warning: removed the required property liveness from the response with the 200 status

  • added the required property availability to the response with the 200 status

GET /api/auth/assets/statistics

  • :warning: deleted the query request parameter liveness

  • added the new optional query request parameter availability

POST /api/auth/assets/tags/policies/{id}/filters/

  • :warning: removed the enum value asset_liveness of the request property filters/field (media type: application/x-www-form-urlencoded)

  • :warning: removed the enum value asset_liveness of the request property filters/field (media type: multipart/form-data)

  • :warning: removed the enum value asset_liveness of the request property filters/field (media type: application/json)

  • :warning: added #/components/schemas/AutoTagFilterAssetAvailability to the results/items/ response property oneOf list for the response status 200

  • added the new asset_availability enum value to the request property filters/field (media type: application/json)

  • added the new asset_availability enum value to the request property filters/field (media type: application/x-www-form-urlencoded)

  • added the new asset_availability enum value to the request property filters/field (media type: multipart/form-data)

  • added asset_availability discriminator mapping keys to the results/items/ response property for the response status 200

  • removed asset_liveness discriminator mapping keys from the results/items/ response property for the response status 200

  • removed #/components/schemas/AutoTagFilterAssetLiveness from the results/items/ response property oneOf list for the response status 200

PATCH /api/auth/assets/tags/policies/{policy_id}/filters/{filter_id}/

  • :warning: removed #/components/schemas/PatchedAutoTagFilterAssetLivenessUpdate from the request body oneOf list (media type: application/json)

  • :warning: removed #/components/schemas/PatchedAutoTagFilterAssetLivenessUpdate from the request body oneOf list (media type: application/x-www-form-urlencoded)

  • :warning: removed #/components/schemas/PatchedAutoTagFilterAssetLivenessUpdate from the request body oneOf list (media type: multipart/form-data)

  • :warning: added #/components/schemas/AutoTagFilterAssetAvailabilityUpdate to the response body oneOf list for the response status 200

  • added asset_availability mapping keys to the request discriminator (media type: application/json)

  • added asset_availability mapping keys to the request discriminator (media type: multipart/form-data)

  • added asset_availability mapping keys to the request discriminator (media type: application/x-www-form-urlencoded)

  • removed asset_liveness mapping keys from the request discriminator (media type: application/json)

  • removed asset_liveness mapping keys from the request discriminator (media type: multipart/form-data)

  • removed asset_liveness mapping keys from the request discriminator (media type: application/x-www-form-urlencoded)

  • added #/components/schemas/PatchedAutoTagFilterAssetAvailabilityUpdate to the request body oneOf list (media type: application/json)

  • added #/components/schemas/PatchedAutoTagFilterAssetAvailabilityUpdate to the request body oneOf list (media type: application/x-www-form-urlencoded)

  • added #/components/schemas/PatchedAutoTagFilterAssetAvailabilityUpdate to the request body oneOf list (media type: multipart/form-data)

  • added asset_availability mapping keys to the response discriminator for the response status 200

  • removed asset_liveness mapping keys from the response discriminator for the response status 200

  • removed #/components/schemas/AutoTagFilterAssetLivenessUpdate from the response body oneOf list for the response status 200

GET /api/auth/assets/v2/

  • endpoint added

GET /api/auth/assets/{id}/

  • :warning: removed the required property liveness from the response with the 200 status

  • added the required property availability to the response with the 200 status

PATCH /api/auth/assets/{id}/

  • :warning: removed the required property liveness from the response with the 200 status

  • added the required property availability to the response with the 200 status

POST /api/auth/assets/{id}/

  • :warning: removed the required property liveness from the response with the 200 status

  • added the required property availability to the response with the 200 status

GET /api/auth/risks/

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/risks/all-opened-count/

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/user/current

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

POST /api/auth/users/

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 201

POST /api/auth/users/import/csv

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/json)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/x-www-form-urlencoded)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: multipart/form-data)

GET /api/auth/users/{id}/

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

POST /api/auth/users/{id}/

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

PUT /api/auth/users/{id}/

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

POST /api/auth/users/{id}/deactivate

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/x-www-form-urlencoded)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/json)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: multipart/form-data)

GET /api/auth/users/{id}/newpwd

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

PUT /api/auth/users/{id}/subscribe-mail

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/json)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/x-www-form-urlencoded)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: multipart/form-data)

POST /api/auth/users/{id}/{object_type}

  • :warning: added the new asset-whitelisting enum value to the emails_subscribed/items/key response property for the response status 200

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: multipart/form-data)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/x-www-form-urlencoded)

  • added the new asset-whitelisting enum value to the request property emails_subscribed/items/key (media type: application/json)

GET /api/auth/vulns/

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/vulns/severities

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/vulns/severities/over-time

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/vulns/severities/statistics

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/vulns/{id}/events

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/vulns/{id}/retests

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/auth/vulns/{id}/tickets

  • :warning: deleted the query request parameter asset_liveness

  • added the new optional query request parameter asset_availability

GET /api/schema/

  • endpoint added

Components

  • removed the schema AssetLivenessEnum

  • removed the schema AutoTagFilterAssetLiveness

  • removed the schema AutoTagFilterAssetLivenessUpdate

  • removed the schema CreateAsset

  • removed the schema DynamicStatusFilter

  • removed the schema PatchedAutoTagFilterAssetLivenessUpdate

  • removed the schema already_reported_response_serializer

  • removed the schema create_asset_response_serializer

Did this answer your question?

Related Articles

Patrowl Help Center
Easily protect what you expose on the Internet