Skip to content

Content Update Policies

The Content Update Policies service collection provides operations for managing content update policies in your CrowdStrike Falcon environment. Search for policy members and policies, perform actions on policies, set precedence, create, delete, and update policies, and query pinnable content versions.

LanguageLast Update
Pythonv1.5.1
PowerShellv2.2.9
Gov0.20.0
TypeScriptv0.6.0
Rustv0.7.0
Rubyv1.2.0
OperationDescription
queryCombinedContentUpdatePolicyMembers
query_policy_members_combined
Search for members of a Content Update Policy in your environment by providing an FQL filter and paging details. Returns a set of host details which match the filter criteria.
queryCombinedContentUpdatePolicies
query_policies_combined
Search for Content Update Policies in your environment by providing an FQL filter and paging details. Returns a set of Content Update Policies which match the filter criteria.
performContentUpdatePoliciesAction
perform_action
Perform the specified action on the Content Update Policies specified in the request.
setContentUpdatePoliciesPrecedence
set_precedence
Sets the precedence of Content Update Policies based on the order of IDs specified in the request. The first ID specified will have the highest precedence and the last ID specified will have the lowest. You must specify all non-Default Policies when updating precedence.
getContentUpdatePolicies
get_policies
Retrieve a set of Content Update Policies by specifying their IDs.
createContentUpdatePolicies
create_policies
Create Content Update Policies by specifying details about the policy to create.
deleteContentUpdatePolicies
delete_policies
Delete a set of Content Update Policies by specifying their IDs.
updateContentUpdatePolicies
update_policies
Update Content Update Policies by specifying the ID of the policy and details to update.
queryContentUpdatePolicyMembers
query_policy_members
Search for members of a Content Update Policy in your environment by providing an FQL filter and paging details. Returns a set of Agent IDs which match the filter criteria.
queryPinnableContentVersions
query_pinnable_content_versions
Search for content versions available for pinning given the category.
queryContentUpdatePolicies
query_policies
Search for Content Update Policies in your environment by providing an FQL filter and paging details. Returns a set of Content Update Policy IDs which match the filter criteria.

Search for members of a Content Update Policy in your environment by providing an FQL filter and paging details. Returns a set of host details which match the filter criteria.

GET /policy/combined/content-update-members/v1
Scope Content Update Policy: READ Consumes · Produces application/json
PEP 8 query_policy_members_combined
NameTypeData typeDescription
idquerystringThe ID of the Content Update Policy to search for members of.
filterquerystringThe filter expression that should be used to limit the results.
offsetqueryintegerThe offset to start retrieving records from.
limitqueryintegerThe maximum records to return. [1-5000]
sortquerystringThe property to sort by.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_policy_members_combined(id="string",
filter="string",
offset=integer,
limit=integer,
sort="string")
print(response)

Search for Content Update Policies in your environment by providing an FQL filter and paging details. Returns a set of Content Update Policies which match the filter criteria.

GET /policy/combined/content-update/v1
Scope Content Update Policy: READ Consumes · Produces application/json
PEP 8 query_policies_combined
NameTypeData typeDescription
filterquerystringThe filter expression that should be used to limit the results.
offsetqueryintegerThe offset to start retrieving records from.
limitqueryintegerThe maximum records to return. [1-5000]
sortquerystringThe property to sort by.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_policies_combined(filter="string",
offset=integer,
limit=integer,
sort="string")
print(response)

Perform the specified action on the Content Update Policies specified in the request.

POST /policy/entities/content-update-actions/v1
Scope Content Update Policy: WRITE Consumes · Produces application/json
PEP 8 perform_action
NameTypeData typeDescription
action_namequerystringThe action to perform. Allowed values: add-host-group, disable, enable, override-allow, override-pause, override-revert, remove-host-group, remove-pinned-content-version, set-pinned-content-version
action_parametersquerydictionary or list of dictionariesAction specific parameter options.
bodybodydictionaryFull body payload as JSON formatted dictionary.
idsbodystring or list of stringsContent update policy IDs to perform action against.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.perform_action(action_name="string",
action_parameters=[{"key": "value"}],
ids=id_list)
print(response)

Sets the precedence of Content Update Policies based on the order of IDs specified in the request. The first ID specified will have the highest precedence and the last ID specified will have the lowest. You must specify all non-Default Policies when updating precedence.

POST /policy/entities/content-update-precedence/v1
Scope Content Update Policy: WRITE Consumes · Produces application/json
PEP 8 set_precedence
NameTypeData typeDescription
bodybodydictionaryFull body payload as JSON formatted dictionary.
idsbodystring or list of stringsID list in precedence order.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.set_precedence(ids=id_list)
print(response)

Retrieve a set of Content Update Policies by specifying their IDs.

GET /policy/entities/content-update/v1
Scope Content Update Policy: READ Consumes · Produces application/json
PEP 8 get_policies
NameTypeData typeDescription
idsquerystring or list of stringsContent update policy IDs to return.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.get_policies(ids=id_list)
print(response)

Create Content Update Policies by specifying details about the policy to create.

POST /policy/entities/content-update/v1
Scope Content Update Policy: WRITE Consumes · Produces application/json
PEP 8 create_policies
NameTypeData typeDescription
bodybodydictionaryFull body payload as JSON formatted dictionary.
descriptionbodystringContent Update policy description.
namebodystringContent Update policy name.
settingsbodydictionaryContent Update policy settings.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.create_policies(description="string",
name="string",
settings={})
print(response)

Delete a set of Content Update Policies by specifying their IDs.

DELETE /policy/entities/content-update/v1
Scope Content Update Policy: WRITE Consumes · Produces application/json
PEP 8 delete_policies
NameTypeData typeDescription
idsquerystring or list of stringsContent update policy IDs to remove.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.delete_policies(ids=id_list)
print(response)

Update Content Update Policies by specifying the ID of the policy and details to update.

PATCH /policy/entities/content-update/v1
Scope Content Update Policy: WRITE Consumes · Produces application/json
PEP 8 update_policies
NameTypeData typeDescription
bodybodydictionaryFull body payload as JSON formatted dictionary.
descriptionbodystringContent Update policy description.
idbodystringContent Update policy ID to update.
namebodystringContent Update policy name.
settingsbodydictionaryContent Update policy settings.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
resources = [
{
"description": "string",
"id": "string",
"name": "string",
"settings": {
"ring_assignment_settings": ["string"]
}
}
]
response = falcon.update_policies(resources=resources)
print(response)

Search for members of a Content Update Policy in your environment by providing an FQL filter and paging details. Returns a set of Agent IDs which match the filter criteria.

GET /policy/queries/content-update-members/v1
Scope Content Update Policy: READ Consumes · Produces application/json
PEP 8 query_policy_members
NameTypeData typeDescription
idquerystringThe ID of the Content Update Policy to search for members of.
filterquerystringThe filter expression that should be used to limit the results.
offsetqueryintegerThe offset to start retrieving records from.
limitqueryintegerThe maximum records to return. [1-5000]
sortquerystringThe property to sort by.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_policy_members(id="string",
filter="string",
offset=integer,
limit=integer,
sort="string")
print(response)

Search for content versions available for pinning given the category.

GET /policy/queries/content-update-pin-versions/v1
Scope Content Update Policy: READ Consumes · Produces application/json
PEP 8 query_pinnable_content_versions
NameTypeData typeDescription
categoryquerystringContent category. Valid values: rapid_response_al_bl_listing, sensor_operations, system_critical, vulnerability_management
sortquerystringThe value to sort returned content versions by. Defaults to deployed_timestamp.desc. Available values: deployed_timestamp.asc, deployed_timestamp.desc
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_pinnable_content_versions(category="string",
sort="string")
print(response)

Search for Content Update Policies in your environment by providing an FQL filter and paging details. Returns a set of Content Update Policy IDs which match the filter criteria.

GET /policy/queries/content-update/v1
Scope Content Update Policy: READ Consumes · Produces application/json
PEP 8 query_policies
NameTypeData typeDescription
filterquerystringThe filter expression that should be used to limit the results.
offsetqueryintegerThe offset to start retrieving records from.
limitqueryintegerThe maximum records to return. [1-5000]
sortquerystringThe property to sort by.
parametersquerydictionaryFull set of query string parameters in a JSON formatted dictionary.
from falconpy import ContentUpdatePolicies
falcon = ContentUpdatePolicies(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_policies(filter="string",
offset=integer,
limit=integer,
sort="string")
print(response)