CrowdStrike Falcon CrowdStrike Subreddit

Using the Case Management service collection

Uber class support Service class support Documentation Version Page Updated

Table of Contents

Operation IDDescription
aggregates_file_details_post_v1
PEP 8aggregates_file_details_post_v1
Get file details aggregates as specified via json in the request body.
combined_file_details_get_v1
PEP 8query_file_details
Query file details
entities_file_details_get_v1
PEP 8get_file_details
Get file details by id
entities_file_details_patch_v1
PEP 8update_file_details
Update file details
entities_files_bulk_download_post_v1
PEP 8bulk_download_files
Download multiple existing file from case as a ZIP
entities_files_download_get_v1
PEP 8download_existing_files
Download existing file from case
entities_files_upload_post_v1
PEP 8upload_file
Upload file for case
entities_files_delete_v1
PEP 8delete_file_details
Delete file details by id
queries_file_details_get_v1
PEP 8query_file_detail_ids
Query for ids of file details
entities_get_rtr_file_metadata_post_v1
PEP 8get_rtr_file_metadata
Get metadata for a file via RTR without retrieving it
entities_retrieve_rtr_file_post_v1
PEP 8retrieve_rtr_file
Retrieve a file from host using RTR and add it to a case
entities_retrieve_rtr_recent_file_post_v1
PEP 8retrieve_rtr_recent_file
Retrieve a recently fetched RTR file and add it to a case
aggregates_notification_groups_post_v1
PEP 8get_notification_groups_aggregation
Get notification groups aggregations
aggregates_notification_groups_post_v2
PEP 8get_notification_groups_aggregation_v2
Get notification groups aggregations
aggregates_slas_post_v1
PEP 8get_sla_aggregations
Get SLA aggregations
aggregates_templates_post_v1
PEP 8get_template_aggregations
Get templates aggregations
aggregates_access_tags_post_v1
PEP 8get_access_tag_aggregations
Get access tag aggregates
entities_access_tags_get_v1
PEP 8get_access_tags
Get access tags
entities_fields_get_v1
PEP 8get_fields
Get fields by ID
entities_notification_groups_get_v1
PEP 8get_notification_groups
Get notification groups by ID
entities_notification_groups_post_v1
PEP 8create_notification_group
Create notification group
entities_notification_groups_patch_v1
PEP 8update_notification_group
Update notification group
entities_notification_groups_delete_v1
PEP 8delete_notification_group
Delete notification groups by ID
entities_notification_groups_get_v2
PEP 8get_notification_groups_v2
Get notification groups by ID
entities_notification_groups_post_v2
PEP 8create_notification_group_v2
Create notification group
entities_notification_groups_patch_v2
PEP 8update_notification_group_v2
Update notification group
entities_notification_groups_delete_v2
PEP 8delete_notification_group_v2
Delete notification groups by ID
entities_slas_get_v1
PEP 8get_slas
Get SLAs by ID
entities_slas_post_v1
PEP 8create_sla
Create SLA
entities_slas_patch_v1
PEP 8update_sla
Update SLA
entities_slas_delete_v1
PEP 8delete_sla
Delete SLAs
entities_template_snapshots_get_v1
PEP 8get_template_snapshots
Get template snapshots
entities_templates_export_get_v1
PEP 8export_templates
Export templates to files in a zip archive
entities_templates_import_post_v1
PEP 8import_template
Import a template from a file
entities_templates_get_v1
PEP 8get_templates
Get templates by ID
entities_templates_post_v1
PEP 8create_template
Create template
entities_templates_patch_v1
PEP 8update_template
Update template
entities_templates_delete_v1
PEP 8delete_templates
Delete templates
queries_access_tags_get_v1
PEP 8query_access_tags
Query access tags
queries_fields_get_v1
PEP 8query_fields
Query fields
queries_notification_groups_get_v1
PEP 8query_notification_groups
Query notification groups
queries_notification_groups_get_v2
PEP 8query_notification_groups_v2
Query notification groups
queries_slas_get_v1
PEP 8query_slas
Query SLAs
queries_template_snapshots_get_v1
PEP 8query_template_snapshots
Query template snapshots
queries_templates_get_v1
PEP 8query_templates
Query templates
entities_alert_evidence_post_v1
PEP 8add_case_alert_evidence
Adds the given list of alert evidence to the specified case
entities_case_tags_post_v1
PEP 8add_case_tags
Adds the given list of tags to the specified case
entities_case_tags_delete_v1
PEP 8delete_case_tags
Removes the specified tags from the specified case
entities_cases_put_v2
PEP 8create_case
Creates the given Case
entities_cases_post_v2
PEP 8get_cases
Retrieves all Cases given their IDs
entities_cases_patch_v2
PEP 8update_case_fields
Updates given fields on the specified case
entities_event_evidence_post_v1
PEP 8add_case_event_evidence
Adds the given list of event evidence to the specified case
queries_cases_get_v1
PEP 8query_case_ids
Retrieves all Cases IDs that match a given query

Passing credentials

WARNING

client_id and client_secret are keyword arguments that contain your CrowdStrike API credentials. Please note that all examples below do not hard code these values. (These values are ingested as strings.)

CrowdStrike does not recommend hard coding API credentials or customer identifiers within source code.

aggregates_file_details_post_v1

Get file details aggregates as specified via json in the request body.

PEP8 method name

aggregates_file_details_post_v1

Endpoint

MethodRoute
POST/case-files/aggregates/file-details/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
filterService Class SupportUber Class SupportquerystringFQL filter expression.
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.aggregates_file_details_post_v1(ids=id_list,
                                                  filter="string"
                                                  )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.aggregates_file_details_post_v1(ids=id_list,
                                                  filter="string"
                                                  )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("aggregates_file_details_post_v1",
                          ids="string",
                          filter="string",
                          body={}
                          )

print(response)

Back to Table of Contents

combined_file_details_get_v1

Query file details

PEP8 method name

query_file_details

Endpoint

MethodRoute
GET/case-files/combined/file-details/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 10.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_file_details(filter="string",
                                     limit=10,
                                     offset=integer
                                     )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.combined_file_details_get_v1(filter="string",
                                               limit=10,
                                               offset=integer
                                               )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("combined_file_details_get_v1",
                          filter="string",
                          limit=10,
                          offset=integer
                          )

print(response)

Back to Table of Contents

entities_files_upload_post_v1

Upload file for case

PEP8 method name

upload_file

Endpoint

MethodRoute
POST/case-files/entities/files/upload/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: multipart/form-data
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
case_idService Class SupportUber Class SupportformDatastringCase ID for the file.
descriptionService Class SupportUber Class SupportformDatastringDescription of the file.
fileService Class SupportUber Class SupportformDatafileLocal file to Upload.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.upload_file(file="path/to/file.txt",
                              case_id="CASE_ID",
                              description="File description"
                              )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_files_upload_post_v1(file="path/to/file.txt",
                                                case_id="CASE_ID",
                                                description="File description"
                                                )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_files_upload_post_v1",
                          file="path/to/file.txt",
                          case_id="CASE_ID",
                          description="File description"
                          )

print(response)

Back to Table of Contents

entities_file_details_patch_v1

Update file details

PEP8 method name

update_file_details

Endpoint

MethodRoute
PATCH/case-files/entities/file-details/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
descriptionService Class SupportNo Uber Class SupportbodystringFile details description.
idService Class SupportNo Uber Class SupportbodystringFile details ID.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.update_file_details(id="file_id",
                                      description="Updated file description"
                                      )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_file_details_patch_v1(id="file_id",
                                                 description="Updated file description"
                                                 )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "id": "file_id",
    "description": "Updated file description"
}


response = falcon.command("entities_file_details_patch_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_file_details_get_v1

Get file details by id

PEP8 method name

get_file_details

Endpoint

MethodRoute
GET/case-files/entities/file-details/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_file_details(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_file_details_get_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_file_details_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_files_bulk_download_post_v1

Download multiple existing file from case as a ZIP

PEP8 method name

bulk_download_files

Endpoint

MethodRoute
POST/case-files/entities/files/bulk-download/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/octet-stream

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
idsService Class SupportNo Uber Class Supportbodystring or list of stringsList of files to download.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.bulk_download_files(ids=["file_id_1", "file_id_2", "file_id_3"])
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_files_bulk_download_post_v1(ids=["file_id_1", "file_id_2", "file_id_3"])
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "ids": ["file_id_1", "file_id_2", "file_id_3"]
}

response = falcon.command("entities_files_bulk_download_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_files_download_get_v1

Download existing file from case

PEP8 method name

download_existing_files

Endpoint

MethodRoute
GET/case-files/entities/files/download/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/octet-stream

Keyword Arguments

NameServiceUberTypeData typeDescription
idService Class SupportUber Class SupportquerystringResource ID.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.download_existing_files(id="FILE_ID")
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_files_download_get_v1(id="FILE_ID")
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_files_download_get_v1",
                          id="FILE_ID"
                          )

print(response)

Back to Table of Contents

entities_files_delete_v1

Delete file details by id

PEP8 method name

delete_file_details

Endpoint

MethodRoute
DELETE/case-files/entities/files/v1

Required Scope

case-templates:write

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_file_details(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_files_delete_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_files_delete_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

queries_file_details_get_v1

Query for ids of file details

PEP8 method name

query_file_detail_ids

Endpoint

MethodRoute
GET/case-files/queries/file-details/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 10.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_file_detail_ids(filter="string",
                                        limit=10,
                                        offset=integer
                                        )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_file_details_get_v1(filter="string",
                                              limit=10,
                                              offset=integer
                                              )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_file_details_get_v1",
                          filter="string",
                          limit=10,
                          offset=integer
                          )

print(response)

Back to Table of Contents

entities_get_rtr_file_metadata_post_v1

Get metadata for a file via RTR without retrieving it.

PEP8 method name

get_rtr_file_metadata

Endpoint

MethodRoute
POST/case-files/entities/get-rtr-file-metadata/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
aidService Class SupportNo Uber Class SupportbodystringThe agent ID of the host to retrieve file metadata from.
file_pathService Class SupportNo Uber Class SupportbodystringThe path to the file on the host.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_rtr_file_metadata(aid="AGENT_ID",
                                        file_path="/path/to/file"
                                        )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_get_rtr_file_metadata_post_v1(aid="AGENT_ID",
                                                          file_path="/path/to/file"
                                                          )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "aid": "AGENT_ID",
    "file_path": "/path/to/file"
}

response = falcon.command("entities_get_rtr_file_metadata_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_retrieve_rtr_file_post_v1

Retrieve a file from host using RTR and add it to a case.

PEP8 method name

retrieve_rtr_file

Endpoint

MethodRoute
POST/case-files/entities/retrieve-rtr-file/v1

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
aidService Class SupportNo Uber Class SupportbodystringThe agent ID of the host to retrieve the file from.
case_idService Class SupportNo Uber Class SupportbodystringThe ID of the case to add the file to.
descriptionService Class SupportNo Uber Class SupportbodystringA description of the file being retrieved.
file_pathService Class SupportNo Uber Class SupportbodystringThe path to the file on the host.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.retrieve_rtr_file(aid="AGENT_ID",
                                    case_id="CASE_ID",
                                    description="File description",
                                    file_path="/path/to/file"
                                    )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_retrieve_rtr_file_post_v1(aid="AGENT_ID",
                                                      case_id="CASE_ID",
                                                      description="File description",
                                                      file_path="/path/to/file"
                                                      )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "aid": "AGENT_ID",
    "case_id": "CASE_ID",
    "description": "File description",
    "file_path": "/path/to/file"
}

response = falcon.command("entities_retrieve_rtr_file_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_retrieve_rtr_recent_file_post_v1

Retrieve a recently fetched RTR file and add it to a case.

PEP8 method name

retrieve_rtr_recent_file

Endpoint

MethodRoute
POST/case-files/entities/retrieve-rtr-recent-file/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
aidService Class SupportNo Uber Class SupportbodystringThe agent ID of the host.
case_idService Class SupportNo Uber Class SupportbodystringThe ID of the case to add the file to.
descriptionService Class SupportNo Uber Class SupportbodystringA description of the file being retrieved.
session_idService Class SupportNo Uber Class SupportbodystringThe RTR session ID for the file retrieval.
sha256Service Class SupportNo Uber Class SupportbodystringThe SHA256 hash of the file to retrieve.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.retrieve_rtr_recent_file(aid="AGENT_ID",
                                           case_id="CASE_ID",
                                           description="File description",
                                           session_id="SESSION_ID",
                                           sha256="SHA256_HASH"
                                           )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_retrieve_rtr_recent_file_post_v1(aid="AGENT_ID",
                                                             case_id="CASE_ID",
                                                             description="File description",
                                                             session_id="SESSION_ID",
                                                             sha256="SHA256_HASH"
                                                             )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "aid": "AGENT_ID",
    "case_id": "CASE_ID",
    "description": "File description",
    "session_id": "SESSION_ID",
    "sha256": "SHA256_HASH"
}

response = falcon.command("entities_retrieve_rtr_recent_file_post_v1", body=body_payload)

print(response)

Back to Table of Contents

aggregates_notification_groups_post_v1

Get notification groups aggregations

PEP8 method name

get_notification_groups_aggregation

Endpoint

MethodRoute
POST/casemgmt/aggregates/notification-groups/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
date_rangesService Class SupportNo Uber Class Supportbodydictionary or listDate range timeframe.
fieldService Class SupportNo Uber Class SupportbodystringField to retrieve.
filterService Class SupportNo Uber Class SupportbodystringFQL syntax.
fromService Class SupportNo Uber Class Supportbodyinteger
nameService Class SupportNo Uber Class Supportbodystring
sizeService Class SupportNo Uber Class Supportbodyinteger
sortService Class SupportNo Uber Class SupportbodystringField to sort on.
typeService Class SupportNo Uber Class Supportbodystring

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_notification_groups_aggregation(date_ranges=[
                                                          {
                                                              "from": "2024-01-01T00:00:00Z",
                                                              "to": "2024-12-31T23:59:59Z"
                                                          }
                                                      ],
                                                      field="status",
                                                      filter="string",
                                                      name="string",
                                                      size=0,
                                                      sort="string",
                                                      type="terms"
                                                      )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.aggregates_notification_groups_post_v1(date_ranges=[
                                                            {
                                                                "from": "2024-01-01T00:00:00Z",
                                                                "to": "2024-12-31T23:59:59Z"
                                                            }
                                                         ],
                                                         field="status",
                                                         filter="string",
                                                         name="string",
                                                         size=0,
                                                         sort="string",
                                                         type="terms"
                                                         )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "date_ranges": [
        {
            "from": "2024-01-01T00:00:00Z",
            "to": "2024-12-31T23:59:59Z"
        }
    ],
    "field": "status",
    "filter": "string",
    "from": integer,
    "name": "string",
    "size": integer,
    "sort": "string",
    "type": "terms"
}

response = falcon.command("aggregates_notification_groups_post_v1", body=body_payload)

print(response)

Back to Table of Contents

aggregates_notification_groups_post_v2

Get notification groups aggregations

PEP8 method name

get_notification_groups_aggregation_v2

Endpoint

MethodRoute
POST/casemgmt/aggregates/notification-groups/v2

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
date_rangesService Class SupportNo Uber Class Supportbodydictionary or listDate range timeframe.
fieldService Class SupportNo Uber Class SupportbodystringField to retrieve.
filterService Class SupportNo Uber Class SupportbodystringFQL syntax.
fromService Class SupportNo Uber Class Supportbodyinteger
nameService Class SupportNo Uber Class Supportbodystring
sizeService Class SupportNo Uber Class Supportbodyinteger
sortService Class SupportNo Uber Class SupportbodystringField to sort on.
typeService Class SupportNo Uber Class Supportbodystring

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_notification_groups_aggregation_v2(date_ranges=[
                                                             {
                                                                 "from": "2024-01-01T00:00:00Z",
                                                                 "to": "2024-12-31T23:59:59Z"
                                                             }
                                                         ],
                                                         field="status",
                                                         filter="string",
                                                         name="string",
                                                         size=0,
                                                         sort="string",
                                                         type="terms"
                                                         )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.aggregates_notification_groups_post_v2(date_ranges=[
                                                             {
                                                                 "from": "2024-01-01T00:00:00Z",
                                                                 "to": "2024-12-31T23:59:59Z"
                                                             }
                                                         ],
                                                         field="status",
                                                         filter="string",
                                                         name="string",
                                                         size=0,
                                                         sort="string",
                                                         type="terms"
                                                         )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "date_ranges": [
        {
            "from": "2024-01-01T00:00:00Z",
            "to": "2024-12-31T23:59:59Z"
        }
    ],
    "field": "status",
    "filter": "string",
    "from": integer,
    "name": "string",
    "size": integer,
    "sort": "string",
    "type": "terms"
}

response = falcon.command("aggregates_notification_groups_post_v2", body=body_payload)

print(response)

Back to Table of Contents

aggregates_slas_post_v1

Get SLA aggregations

PEP8 method name

get_sla_aggregations

Endpoint

MethodRoute
POST/casemgmt/aggregates/slas/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
date_rangesService Class SupportNo Uber Class Supportbodydictionary or listDate range timeframe.
fieldService Class SupportNo Uber Class SupportbodystringField to retrieve.
filterService Class SupportNo Uber Class SupportbodystringFQL syntax.
fromService Class SupportNo Uber Class Supportbodyinteger
nameService Class SupportNo Uber Class Supportbodystring
sizeService Class SupportNo Uber Class Supportbodyinteger
sortService Class SupportNo Uber Class SupportbodystringField to sort on.
typeService Class SupportNo Uber Class Supportbodystring

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_sla_aggregations(date_ranges=[
                                          {
                                              "from": "2024-01-01T00:00:00Z",
                                              "to": "2024-12-31T23:59:59Z"
                                          }
                                       ],
                                       field="status",
                                       filter="string",
                                       name="string",
                                       size=0,
                                       sort="string",
                                       type="terms"
                                       )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.aggregates_slas_post_v1(date_ranges=[
                                             {
                                                 "from": "2024-01-01T00:00:00Z",
                                                 "to": "2024-12-31T23:59:59Z"
                                              }
                                          ],
                                          field="status",
                                          filter="string",
                                          name="string",
                                          size=0,
                                          sort="string",
                                          type="terms"
                                          )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "date_ranges": [
        {
            "from": "2024-01-01T00:00:00Z",
            "to": "2024-12-31T23:59:59Z"
        }
    ],
    "field": "status",
    "filter": "string",
    "from": integer,
    "name": "string",
    "size": integer,
    "sort": "string",
    "type": "terms"
}

response = falcon.command("aggregates_slas_post_v1", body=body_payload)

print(response)

Back to Table of Contents

aggregates_templates_post_v1

Get templates aggregations

PEP8 method name

get_template_aggregations

Endpoint

MethodRoute
POST/casemgmt/aggregates/templates/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
date_rangesService Class SupportNo Uber Class Supportbodydictionary or listDate range timeframe.
fieldService Class SupportNo Uber Class SupportbodystringField to retrieve.
filterService Class SupportNo Uber Class SupportbodystringFQL syntax.
fromService Class SupportNo Uber Class Supportbodyinteger
nameService Class SupportNo Uber Class Supportbodystring
sizeService Class SupportNo Uber Class Supportbodyinteger
sortService Class SupportNo Uber Class SupportbodystringField to sort on.
typeService Class SupportNo Uber Class Supportbodystring

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_template_aggregations(date_ranges=[
                                                {
                                                    "from": "2024-01-01T00:00:00Z",
                                                    "to": "2024-12-31T23:59:59Z"
                                                }
                                            ],
                                            field="status",
                                            filter="string",
                                            name="string",
                                            size=0,
                                            sort="string",
                                            type="terms"
                                            )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.aggregates_templates_post_v1(date_ranges=[
                                                  {
                                                      "from": "2024-01-01T00:00:00Z",
                                                      "to": "2024-12-31T23:59:59Z"
                                                  }
                                               ],
                                               field="status",
                                               filter="string",
                                               name="string",
                                               size=0,
                                               sort="string",
                                               type="terms"
                                               )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "date_ranges": [
        {
            "from": "2024-01-01T00:00:00Z",
            "to": "2024-12-31T23:59:59Z"
        }
    ],
    "field": "status",
    "filter": "string",
    "from": integer,
    "name": "string",
    "size": integer,
    "sort": "string",
    "type": "terms"
}

response = falcon.command("aggregates_templates_post_v1", body=body_payload)

print(response)

Back to Table of Contents

aggregates_access_tags_post_v1

Get access tag aggregates.

PEP8 method name

get_access_tag_aggregations

Endpoint

MethodRoute
POST/casemgmt/aggregates/access-tags/v1

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
date_rangesService Class SupportNo Uber Class Supportbodydictionary or listDate range timeframe.
fieldService Class SupportNo Uber Class SupportbodystringField to retrieve.
filterService Class SupportNo Uber Class SupportbodystringFQL syntax.
fromService Class SupportNo Uber Class Supportbodyinteger
nameService Class SupportNo Uber Class Supportbodystring
sizeService Class SupportNo Uber Class Supportbodyinteger
sortService Class SupportNo Uber Class SupportbodystringField to sort on.
typeService Class SupportNo Uber Class Supportbodystring

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_access_tag_aggregations(date_ranges=[
                                                  {
                                                      "from": "2024-01-01T00:00:00Z",
                                                      "to": "2024-12-31T23:59:59Z"
                                                  }
                                              ],
                                              field="status",
                                              filter="string",
                                              name="string",
                                              size=0,
                                              sort="string",
                                              type="terms"
                                              )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.aggregates_access_tags_post_v1(date_ranges=[
                                                      {
                                                          "from": "2024-01-01T00:00:00Z",
                                                          "to": "2024-12-31T23:59:59Z"
                                                      }
                                                  ],
                                                  field="status",
                                                  filter="string",
                                                  name="string",
                                                  size=0,
                                                  sort="string",
                                                  type="terms"
                                                  )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "date_ranges": [
        {
            "from": "2024-01-01T00:00:00Z",
            "to": "2024-12-31T23:59:59Z"
        }
    ],
    "field": "status",
    "filter": "string",
    "from": integer,
    "name": "string",
    "size": integer,
    "sort": "string",
    "type": "terms"
}

response = falcon.command("aggregates_access_tags_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_access_tags_get_v1

Get access tags.

PEP8 method name

get_access_tags

Endpoint

MethodRoute
GET/casemgmt/entities/access-tags/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_access_tags(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_access_tags_get_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_access_tags_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_notification_groups_get_v1

Get notification groups by ID

PEP8 method name

get_notification_groups

Endpoint

MethodRoute
GET/casemgmt/entities/notification-groups/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_notification_groups(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_notification_groups_get_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_notification_groups_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_notification_groups_post_v1

Create notification group

PEP8 method name

create_notification_group

Endpoint

MethodRoute
POST/casemgmt/entities/notification-groups/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
channelsService Class SupportNo Uber Class Supportbodylist of dictionariesThe notification group channel configuration parameters.
descriptionService Class SupportNo Uber Class SupportbodystringNotification group description.
nameService Class SupportNo Uber Class SupportbodystringNotification group name.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels = [
    {
        "config_id": "string",
        "config_name": "string",
        "recipients": [
            "string"
        ],
        "severity": "string",
        "type": "email"
    }
]

response = falcon.create_notification_group(channels=channels,
                                            description="string",
                                            name="string"
                                            )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels = [
    {
        "config_id": "string",
        "config_name": "string",
        "recipients": [
            "string"
        ],
        "severity": "string",
        "type": "email"
    }
]

response = falcon.entities_notification_groups_post_v1(channels=channels,
                                                       description="string",
                                                       name="string"
                                                       )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "channels": [
        {
            "config_id": "string",
            "config_name": "string",
            "recipients": [
                "string"
            ],
            "severity": "string",
            "type": "email"
        }
    ],
    "description": "string",
    "name": "string"
}

response = falcon.command("entities_notification_groups_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_notification_groups_patch_v1

Update notification group

PEP8 method name

update_notification_group

Endpoint

MethodRoute
PATCH/casemgmt/entities/notification-groups/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
channelsService Class SupportNo Uber Class Supportbodylist of dictionariesThe notification group channel configuration parameters.
descriptionService Class SupportNo Uber Class SupportbodystringNotification group description.
idService Class SupportNo Uber Class SupportbodystringThe ID of the notification group.
nameService Class SupportNo Uber Class SupportbodystringNotification group name.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels = [
    {
        "config_id": "string",
        "config_name": "string",
        "recipients": [
            "string"
        ],
        "severity": "string",
        "type": "email"
    }
]

response = falcon.update_notification_group(channels=channels,
                                            description="string",
                                            id="string",
                                            name="string"
                                            )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )
channels = [
    {
        "config_id": "string",
        "config_name": "string",
        "recipients": [
            "string"
        ],
        "severity": "string",
        "type": "email"
    }
]

response = falcon.entities_notification_groups_patch_v1(channels=channels,
                                                        description="string",
                                                        id="string",
                                                        name="string"
                                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "channels": [
        {
        "config_id": "string",
        "config_name": "string",
        "recipients": [
            "string"
        ],
        "severity": "string",
        "type": "email"
        }
    ],
    "description": "string",
    "id": "string",
    "name": "string"
}

response = falcon.command("entities_notification_groups_patch_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_notification_groups_delete_v1

Delete notification groups by ID

PEP8 method name

delete_notification_group

Endpoint

MethodRoute
DELETE/casemgmt/entities/notification-groups/v1

Required Scope

case-templates:write

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_notification_group(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_notification_groups_delete_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_notification_groups_delete_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_notification_groups_get_v2

Get notification groups by ID

PEP8 method name

get_notification_groups_v2

Endpoint

MethodRoute
GET/casemgmt/entities/notification-groups/v2

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_notification_groups_v2(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_notification_groups_get_v2(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_notification_groups_get_v2",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_notification_groups_post_v2

Create notification group

PEP8 method name

create_notification_group_v2

Endpoint

MethodRoute
POST/casemgmt/entities/notification-groups/v2

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
channelsService Class SupportNo Uber Class Supportbodylist of dictionariesThe notification group channel configuration parameters.
descriptionService Class SupportNo Uber Class SupportbodystringNotification group description.
nameService Class SupportNo Uber Class SupportbodystringNotification group name.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels = [
    {
        "config_id": "string",
        "config_name": "string",
        "params": {},
        "type": "email"
    }
]

response = falcon.create_notification_group_v2(channels=channels,
                                               description="string",
                                               name="string"
                                               )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels = [
    {
        "config_id": "string",
        "config_name": "string",
        "params": {},
        "type": "email"
    }
]

response = falcon.entities_notification_groups_post_v2(channels=channels,
                                                       description="string",
                                                       name="string"
                                                       )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "channels": [
        {
        "config_id": "string",
        "config_name": "string",
        "params": {},
        "type": "email"
        }
    ],
    "description": "string",
    "name": "string"
}


response = falcon.command("entities_notification_groups_post_v2", body=body_payload)

print(response)

Back to Table of Contents

entities_notification_groups_patch_v2

Update notification group

PEP8 method name

update_notification_group_v2

Endpoint

MethodRoute
PATCH/casemgmt/entities/notification-groups/v2

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
channelsService Class SupportNo Uber Class Supportbodylist of dictionariesThe notification group channel configuration parameters.
descriptionService Class SupportNo Uber Class SupportbodystringNotification group description.
nameService Class SupportNo Uber Class SupportbodystringNotification group name.
idService Class SupportNo Uber Class SupportbodystringThe ID of the notification group.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels=[
    {
        "config_id": "string",
        "config_name": "string",
        "params": {},
        "type": "email"
    }
]

response = falcon.update_notification_group_v2(channels=channels,
                                               description="string",
                                               name="string",
                                               id="string"
                                               )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

channels=[
    {
        "config_id": "string",
        "config_name": "string",
        "params": {},
        "type": "email"
    }
]

response = falcon.entities_notification_groups_patch_v2(channels=channels,
                                                        description="string",
                                                        name="string",
                                                        id="string"
                                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "channels": [
        {
        "config_id": "string",
        "config_name": "string",
        "params": {},
        "type": "email"
        }
    ],
    "description": "string",
    "name": "string",
    "id": "string"
}

response = falcon.command("entities_notification_groups_patch_v2", body=body_payload)

print(response)

Back to Table of Contents

entities_notification_groups_delete_v2

Delete notification groups by ID

PEP8 method name

delete_notification_group_v2

Endpoint

MethodRoute
DELETE/casemgmt/entities/notification-groups/v2

Required Scope

case-templates:write

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_notification_group_v2(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_notification_groups_delete_v2(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_notification_groups_delete_v2",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_fields_get_v1

Get fields by ID

PEP8 method name

get_fields

Endpoint

MethodRoute
GET/casemgmt/entities/fields/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_fields(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_fields_get_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_fields_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_slas_get_v1

Get SLAs by ID

PEP8 method name

get_slas

Endpoint

MethodRoute
GET/casemgmt/entities/slas/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_slas(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_slas_get_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_slas_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_slas_post_v1

Create SLA

PEP8 method name

create_sla

Endpoint

MethodRoute
POST/casemgmt/entities/slas/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
descriptionService Class SupportNo Uber Class SupportbodystringThe description of the SLA.
goalsService Class SupportNo Uber Class Supportbodylist of dictionariesThe SLA goals.
nameService Class SupportNo Uber Class SupportbodystringThe name of the SLA.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

goals = [
    {
        "duration_seconds": integer,
        "escalation_policy": {
            "steps": [
                {
                    "escalate_after_seconds": integer,
                    "notification_group_id": "string"
                }
            ]
        },
        "type": "string"
    }
]

response = falcon.create_sla(description="string",
                             goals=goals,
                             name="string"
                             )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

goals = [
    {
        "duration_seconds": integer,
        "escalation_policy": {
            "steps": [
                {
                    "escalate_after_seconds": integer,
                    "notification_group_id": "string"
                }
            ]
        },
        "type": "string"
    }
]

response = falcon.entities_slas_post_v1(description="string",
                                        goals=goals,
                                        name="string"
                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "description": "string",
    "goals": [
        {
        "duration_seconds": integer,
        "escalation_policy": {
            "steps": [
            {
                "escalate_after_seconds": integer,
                "notification_group_id": "string"
            }
            ]
        },
        "type": "string"
        }
    ],
    "name": "string"
}


response = falcon.command("entities_slas_post_v1", body=body_payload)
print(response)

Back to Table of Contents

entities_slas_patch_v1

Update SLA

PEP8 method name

update_sla

Endpoint

MethodRoute
PATCH/casemgmt/entities/slas/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
descriptionService Class SupportNo Uber Class SupportbodystringThe description of the SLA.
goalsService Class SupportNo Uber Class Supportbodylist of dictionariesThe SLA goals.
idService Class SupportNo Uber Class SupportbodystringThe ID of the SLA to update.
nameService Class SupportNo Uber Class SupportbodystringThe name of the SLA.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

goals = [
    {
        "duration_seconds": integer,
        "escalation_policy": {
            "steps": [
                {
                    "escalate_after_seconds": integer,
                    "notification_group_id": "string"
                }
            ]
        },
        "type": "string"
    }
]

response = falcon.update_sla(description="string",
                             goals=goals,
                             name="string"
                             )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

goals = [
    {
        "duration_seconds": integer,
        "escalation_policy": {
            "steps": [
                {
                    "escalate_after_seconds": integer,
                    "notification_group_id": "string"
                }
            ]
        },
        "type": "string"
    }
]

response = falcon.entities_slas_patch_v1(description="string",
                                         goals=goals,
                                         name="string"
                                         )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "description": "string",
    "goals": [
        {
        "duration_seconds": integer,
        "escalation_policy": {
            "steps": [
            {
                "escalate_after_seconds": integer,
                "notification_group_id": "string"
            }
            ]
        },
        "type": "string"
        }
    ],
    "name": "string"
}

response = falcon.command("entities_slas_patch_v1", body=body_payload)
print(response)

Back to Table of Contents

entities_slas_delete_v1

Delete SLAs

PEP8 method name

delete_sla

Endpoint

MethodRoute
DELETE/casemgmt/entities/slas/v1

Required Scope

case-templates:write

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_sla(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_slas_delete_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_slas_delete_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_template_snapshots_get_v1

Get template snapshots

PEP8 method name

get_template_snapshots

Endpoint

MethodRoute
GET/casemgmt/entities/template-snapshots/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsSnapshot IDs.
template_idsService Class SupportUber Class Supportquerystring or list of stringsRetrieves the latest snapshot for all Template IDs.
versionsService Class SupportUber Class Supportqueryinteger or list of integersRetrieve a specific version of the template from the parallel array template_ids. A value of zero will return the latest snapshot.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

snapshot_ids = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.get_template_snapshots(ids=snapshot_ids)
print(response)

template_ids = ['template1', 'template2']

response = falcon.get_template_snapshots(template_ids=template_ids)
print(response)

template_ids = ['template1', 'template2']
versions = [1, 0]

response = falcon.get_template_snapshots(template_ids=template_ids,
                                         versions=versions)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

snapshot_ids = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_template_snapshots_get_v1(ids=snapshot_ids)
print(response)

response = falcon.entities_template_snapshots_get_v1(template_ids=['template1', 'template2'])
print(response)

response = falcon.entities_template_snapshots_get_v1(template_ids=['template1', 'template2'],
                                                     versions=[1, 0])
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_template_snapshots_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )
print(response)

response = falcon.command("entities_template_snapshots_get_v1",
                          template_ids=["template1", "template2"]
                          )
print(response)

response = falcon.command("entities_template_snapshots_get_v1",
                          template_ids=["template1", "template2"],
                          versions=[1, 0]
                          )
print(response)

Back to Table of Contents

entities_templates_export_get_v1

Export templates to files in a zip archive

PEP8 method name

export_templates

Endpoint

MethodRoute
GET/casemgmt/entities/templates/export/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsTemplate IDs.
filterService Class SupportUber Class SupportquerystringFQL filter expression.
formatService Class SupportUber Class SupportquerystringExport file format. Valid values: yaml, json. Default: yaml.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

template_ids = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.export_templates(ids=template_ids, format="yaml")
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

template_ids = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_templates_export_get_v1(ids=template_ids, format="yaml")
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_templates_export_get_v1",
                          ids=["ID1", "ID2", "ID3"],
                          format="yaml"
                          )

print(response)

Back to Table of Contents

entities_templates_import_post_v1

Import a template from a file

PEP8 method name

import_template

Endpoint

MethodRoute
POST/casemgmt/entities/templates/import/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: multipart/form-data
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
fileService Class SupportUber Class SupportformDatafileLocal file to import.
dry_runService Class SupportUber Class SupportformDatabooleanRun validation only.
dataService Class SupportUber Class SupportformDatadictionaryFull formData payload as a dictionary. Not required when using other keywords.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.import_template(file=("template.yaml", open("template.yaml", "rb")),
                                  dry_run=boolean
                                  )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_templates_import_post_v1(file=("template.yaml", open("template.yaml", "rb")),
                                                    dry_run=boolean
                                                    )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_templates_import_post_v1",
                          file=("template.yaml", open("template.yaml", "rb")),
                          dry_run=boolean
                          )

print(response)

Back to Table of Contents

entities_templates_get_v1

Get templates by ID

PEP8 method name

get_templates

Endpoint

MethodRoute
GET/casemgmt/entities/templates/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_templates(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_templates_get_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_templates_get_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

entities_templates_post_v1

Create template

PEP8 method name

create_template

Endpoint

MethodRoute
POST/casemgmt/entities/templates/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
descriptionService Class SupportNo Uber Class SupportbodystringTemplate description.
fieldsService Class SupportNo Uber Class Supportbodylist of dictionariesTemplate fields configuration.
nameService Class SupportNo Uber Class SupportbodystringTemplate name.
sla_idService Class SupportNo Uber Class SupportbodystringSLA ID for the template.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

fields = [
    {
        "data_type": "string",
        "default_value": "string",
        "input_type": "string",
        "multivalued": boolean,
        "name": "string",
        "options": [
            {
                "value": "string"
            }
        ],
        "required": boolean
    }
]

response = falcon.create_template(description="string",
                                  fields=fields,
                                  name="string",
                                  sla_id="string"
                                  )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

fields = [
    {
        "data_type": "string",
        "default_value": "string",
        "input_type": "string",
        "multivalued": boolean,
        "name": "string",
        "options": [
            {
                "value": "string"
            }
        ],
        "required": boolean
    }
]

response = falcon.entities_templates_post_v1(description="string",
                                             fields=fields,
                                             name="string",
                                             sla_id="string"
                                             )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "description": "string",
    "fields": [
        {
        "data_type": "string",
        "default_value": "string",
        "input_type": "string",
        "multivalued": boolean,
        "name": "string",
        "options": [
            {
            "value": "string"
            }
        ],
        "required": boolean
        }
    ],
    "name": "string",
    "sla_id": "string"
}

response = falcon.command("entities_templates_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_templates_patch_v1

Update template

PEP8 method name

update_template

Endpoint

MethodRoute
PATCH/casemgmt/entities/templates/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
fieldsService Class SupportNo Uber Class Supportbodylist of dictionariesThe template fields configuration.
descriptionService Class SupportNo Uber Class SupportbodystringTemplate description.
idService Class SupportNo Uber Class SupportbodystringThe ID of the template to update.
sla_idService Class SupportNo Uber Class SupportbodystringThe ID of the SLA.
nameService Class SupportNo Uber Class SupportbodystringTemplate name.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

fields = [
    {
        "data_type": "string",
        "default_value": "string",
        "input_type": "string",
        "multivalued": boolean,
        "name": "string",
        "options": [
            {
                "value": "string"
            }
        ],
        "required": boolean
    }
]

response = falcon.update_template(description="string",
                                  fields=fields,
                                  id="string",
                                  name="string",
                                  sla_id="string"
                                  )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

fields = [
    {
        "data_type": "string",
        "default_value": "string",
        "input_type": "string",
        "multivalued": boolean,
        "name": "string",
        "options": [
            {
                "value": "string"
            }
        ],
        "required": boolean
    }
]

response = falcon.entities_templates_patch_v1(description="string",
                                              fields=fields,
                                              id="string",
                                              name="string",
                                              sla_id="string"
                                              )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "description": "string",
    "fields": [
        {
        "data_type": "string",
        "default_value": "string",
        "input_type": "string",
        "multivalued": boolean,
        "name": "string",
        "options": [
            {
            "value": "string"
            }
        ],
        "required": boolean
        }
    ],
    "id": "string",
    "name": "string",
    "sla_id": "string"
}
response = falcon.command("entities_templates_patch_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_templates_delete_v1

Delete templates

PEP8 method name

delete_templates

Endpoint

MethodRoute
DELETE/casemgmt/entities/templates/v1

Required Scope

case-templates:write

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idsService Class SupportUber Class Supportquerystring or list of stringsResource IDs.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(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_templates(ids=id_list)
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.entities_templates_delete_v1(ids=id_list)
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_templates_delete_v1",
                          ids=["ID1", "ID2", "ID3"]
                          )

print(response)

Back to Table of Contents

queries_access_tags_get_v1

Query access tags.

PEP8 method name

query_access_tags

Endpoint

MethodRoute
GET/casemgmt/queries/access-tags/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
afterService Class SupportUber Class SupportquerystringPagination token.
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
sortService Class SupportUber Class SupportquerystringSort expression.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_access_tags(filter="string",
                                    sort="string",
                                    limit=integer,
                                    after="string"
                                    )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_access_tags_get_v1(filter="string",
                                             sort="string",
                                             limit=integer,
                                             after="string"
                                             )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_access_tags_get_v1",
                          filter="string",
                          sort="string",
                          limit=integer,
                          after="string"
                          )

print(response)

Back to Table of Contents

queries_fields_get_v1

Query fields

PEP8 method name

query_fields

Endpoint

MethodRoute
GET/casemgmt/queries/fields/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_fields(filter="string",
                               limit=integer,
                               offset=integer
                               )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_fields_get_v1(filter="string",
                                        limit=integer,
                                        offset=integer
                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_fields_get_v1",
                          filter="string",
                          limit=integer,
                          offset=integer
                          )

print(response)

Back to Table of Contents

queries_notification_groups_get_v1

Query notification groups

PEP8 method name

query_notification_groups

Endpoint

MethodRoute
GET/casemgmt/queries/notification-groups/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
sortService Class SupportUber Class SupportquerystringSort expression.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_notification_groups(filter="string",
                                            sort="string",
                                            limit=integer,
                                            offset=integer
                                            )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_notification_groups_get_v1(filter="string",
                                                     sort="string",
                                                     limit=integer,
                                                     offset=integer
                                                     )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_notification_groups_get_v1",
                          filter="string",
                          sort="string",
                          limit=integer,
                          offset=integer
                          )

print(response)

Back to Table of Contents

queries_notification_groups_get_v2

Query notification groups

PEP8 method name

query_notification_groups_v2

Endpoint

MethodRoute
GET/casemgmt/queries/notification-groups/v2

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
sortService Class SupportUber Class SupportquerystringSort expression.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_notification_groups_v2(filter="string",
                                               sort="string",
                                               limit=integer,
                                               offset=integer
                                               )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_notification_groups_get_v2(filter="string",
                                                     sort="string",
                                                     limit=integer,
                                                     offset=integer
                                                     )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_notification_groups_get_v2",
                          filter="string",
                          sort="string",
                          limit=integer,
                          offset=integer
                          )

print(response)

Back to Table of Contents

queries_slas_get_v1

Query SLAs

PEP8 method name

query_slas

Endpoint

MethodRoute
GET/casemgmt/queries/slas/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
sortService Class SupportUber Class SupportquerystringSort expression.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_slas(filter="string",
                             sort="string",
                             limit=integer,
                             offset=integer
                             )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_slas_get_v1(filter="string",
                                      sort="string",
                                      limit=integer,
                                      offset=integer
                                      )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_slas_get_v1",
                          filter="string",
                          sort="string",
                          limit=integer,
                          offset=integer
                          )

print(response)

Back to Table of Contents

queries_template_snapshots_get_v1

Query template snapshots

PEP8 method name

query_template_snapshots

Endpoint

MethodRoute
GET/casemgmt/queries/template-snapshots/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_template_snapshots(filter="string",
                                           limit=integer,
                                           offset=integer
                                           )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_template_snapshots_get_v1(filter="string",
                                                    limit=integer,
                                                    offset=integer
                                                    )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_template_snapshots_get_v1",
                          filter="string",
                          limit=integer,
                          offset=integer
                          )

print(response)

Back to Table of Contents

queries_templates_get_v1

Query templates

PEP8 method name

query_templates

Endpoint

MethodRoute
GET/casemgmt/queries/templates/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFQL filter expression.
limitService Class SupportUber Class SupportqueryintegerPage size. Maximum value is 200.
offsetService Class SupportUber Class SupportqueryintegerPage offset.
sortService Class SupportUber Class SupportquerystringSort expression.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_templates(filter="string",
                                  sort="string",
                                  limit=integer,
                                  offset=integer
                                  )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_templates_get_v1(filter="string",
                                           sort="string",
                                           limit=integer,
                                           offset=integer
                                           )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_templates_get_v1",
                          filter="string",
                          sort="string",
                          limit=integer,
                          offset=integer
                          )

print(response)

Back to Table of Contents

entities_alert_evidence_post_v1

Adds the given list of alert evidence to the specified case.

PEP8 method name

add_case_alert_evidence

Endpoint

MethodRoute
POST/cases/entities/alert-evidence/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
alertsService Class SupportNo Uber Class Supportbodylist of dictionariesThe alert IDs.
idService Class SupportNo Uber Class SupportbodystringThe specified case ID.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.add_case_alert_evidence(alerts=[{"id": "string"}],
                                          id="string"
                                          )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_alert_evidence_post_v1(alerts=[{"id": "string"}],
                                                  id="string"
                                                  )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "alerts": [
        {
        "id": "string"
        }
    ],
    "id": "string"
}

response = falcon.command("entities_alert_evidence_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_case_tags_post_v1

Adds the given list of tags to the specified case.

PEP8 method name

add_case_tags

Endpoint

MethodRoute
POST/cases/entities/case-tags/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
tagsService Class SupportNo Uber Class Supportbodyarray of stringsThe given list of tags.
idService Class SupportNo Uber Class SupportbodystringThe specified case ID.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.add_case_tags(id="string",
                                tags=["string"]
                                )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_case_tags_post_v1(id="string",
                                             tags=["string"]
                                             )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "id": "string",
    "tags": [
        "string"
    ]
}
response = falcon.command("entities_case_tags_post_v1", body=body_payload)

print(response)

Back to Table of Contents

entities_case_tags_delete_v1

Removes the specified tags from the specified case.

PEP8 method name

delete_case_tags

Endpoint

MethodRoute
DELETE/cases/entities/case-tags/v1

Required Scope

case-templates:write

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idService Class SupportUber Class SupportquerystringThe ID of the case to remove tags from.
tagService Class SupportUber Class Supportquerystring or list of stringsThe tag to remove from the case.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.delete_case_tags(id="case_id_here",
                                   tag=["tag1", "tag2"]
                                   )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_case_tags_delete_v1(id="case_id_here",
                                               tag=["tag1", "tag2"]
                                               )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("entities_case_tags_delete_v1",
                          id="case_id_here",
                          tag=["tag1", "tag2"]
                          )

print(response)

Back to Table of Contents

entities_cases_put_v2

Creates the given Case

PEP8 method name

create_case

Endpoint

MethodRoute
PUT/cases/entities/cases/v2

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload as a dictionary. Not required if using other keywords.
assigned_to_user_uuidService Class SupportNo Uber Class SupportbodystringUUID of the user to assign the case to.
descriptionService Class SupportNo Uber Class SupportbodystringThe description of the case.
evidenceService Class SupportNo Uber Class SupportbodydictionaryThe case evidence info.
nameService Class SupportNo Uber Class SupportbodystringThe name of the case.
severityService Class SupportNo Uber Class SupportbodyintegerThe severity level of the case.
statusService Class SupportNo Uber Class SupportbodystringThe current status of the case.
tagsService Class SupportNo Uber Class Supportbodylist of stringsThe tags to be attached to the case.
templateService Class SupportNo Uber Class SupportbodydictionaryThe template case to utilize.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

evidence = {
    "alerts": [
        {
            "id": "alert_id_123"
        }
    ],
    "events": [
        {
            "id": "event_id_456"
        }
    ],
    "leads": [
        {
            "id": "lead_id_789"
        }
    ]
}

response = falcon.create_case(assigned_to_user_uuid="12345678-1234-1234-1234-123456789012",
                              description="Detailed description of the case",
                              evidence=evidence,
                              name="New Security Case",
                              severity=integer,
                              status="new",
                              tags=["security", "incident"],
                              template={"id": "template_id_abc"}
                              )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

evidence = {
    "alerts": [
        {
            "id": "alert_id_123"
        }
    ],
    "events": [
        {
            "id": "event_id_456"
        }
    ],
    "leads": [
        {
            "id": "lead_id_789"
        }
    ]
}

response = falcon.entities_cases_put_v2(assigned_to_user_uuid="12345678-1234-1234-1234-123456789012",
                                        description="Detailed description of the case",
                                        evidence=evidence,
                                        name="New Security Case",
                                        severity=integer,
                                        status="new",
                                        tags=["security", "incident"],
                                        template={"id": "template_id_abc"}
                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "assigned_to_user_uuid": "12345678-1234-1234-1234-123456789012",
    "description": "Detailed description of the case",
    "evidence": {
        "alerts": [
            {
                "id": "alert_id_123"
            }
        ],
        "events": [
            {
                "id": "event_id_456"
            }
        ],
        "leads": [
            {
                "id": "lead_id_789"
            }
        ]
    },
    "name": "New Security Case",
    "severity": 3,
    "status": "new",
    "tags": [
        "security",
        "incident"
    ],
    "template": {
        "id": "template_id_abc"
    }
}

response = falcon.command("entities_cases_put_v2", body=body_payload)

print(response)

Back to Table of Contents

entities_cases_post_v2

Retrieves all Cases given their IDs.

PEP8 method name

get_cases

Endpoint

MethodRoute
POST/cases/entities/cases/v2

Required Scope

case-templates:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
idsService Class SupportNo Uber Class Supportbodystring or list of stringsThe case IDs.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.get_cases(ids=["case_id_1", "case_id_2", "case_id_3"])
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_cases_post_v2(ids=["case_id_1", "case_id_2", "case_id_3"])
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "ids": ["case_id_1", "case_id_2", "case_id_3"]
}

response = falcon.command("entities_cases_post_v2", body=body_payload)

print(response)

Back to Table of Contents

entities_cases_patch_v2

Updates given fields on the specified case.

PEP8 method name

update_case_fields

Endpoint

MethodRoute
PATCH/cases/entities/cases/v2

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload as a dictionary. Not required if using other keywords.
expected_consistency_versionService Class SupportNo Uber Class SupportbodyintegerThe consistency version.
expected_versionService Class SupportNo Uber Class SupportbodyintegerThe version.
fieldsService Class SupportNo Uber Class SupportbodydictionaryThe updated given fields for the specified case.
idService Class SupportNo Uber Class SupportbodystringThe specified case ID.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

fields = { 
    "assigned_to_user_uuid": "12345678-1234-1234-1234-123456789012",
    "custom_fields": [
        {
            "id": "custom_field_1",
            "values": [
                "custom_value_1",
                "custom_value_2"
            ]
        }
    ],
    "description": "Updated case description",
    "name": "Updated Case Name",
    "remove_user_assignment": boolean,
    "severity": 2,
    "slas_active": boolean,
    "status": "in_progress",
    "template": {
        "id": "template_id_abc"
    }
}

response = falcon.update_case_fields(expected_consistency_version=0,
                                     expected_version=1,
                                     fields=fields,
                                     id="case_id_here"
                                     )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

fields = { 
    "assigned_to_user_uuid": "12345678-1234-1234-1234-123456789012",
    "custom_fields": [
        {
            "id": "custom_field_1",
            "values": [
                "custom_value_1",
                "custom_value_2"
            ]
        }
    ],
    "description": "Updated case description",
    "name": "Updated Case Name",
    "remove_user_assignment": boolean,
    "severity": 2,
    "slas_active": boolean,
    "status": "in_progress",
    "template": {
        "id": "template_id_abc"
    }
}

response = falcon.entities_cases_patch_v2(expected_consistency_version=0,
                                          expected_version=1,
                                          fields=fields,
                                          id="case_id_here"
                                          )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "expected_consistency_version": integer,
    "expected_version": 1,
    "fields": {
        "assigned_to_user_uuid": "12345678-1234-1234-1234-123456789012",
        "custom_fields": [
            {
                "id": "custom_field_1",
                "values": [
                    "custom_value_1",
                    "custom_value_2"
                ]
            }
        ],
        "description": "Updated case description",
        "name": "Updated Case Name",
        "remove_user_assignment": boolean,
        "severity": 2,
        "slas_active": boolean,
        "status": "in_progress",
        "template": {
            "id": "template_id_abc"
        }
    },
    "id": "case_id_here"
}

response = falcon.command("entities_cases_patch_v2", body=body_payload)

print(response)

Back to Table of Contents

entities_event_evidence_post_v1

Adds the given list of event evidence to the specified case.

PEP8 method name

add_case_event_evidence

Endpoint

MethodRoute
POST/cases/entities/event-evidence/v1

Required Scope

case-templates:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format
eventsService Class SupportNo Uber Class Supportbodylist of dictionariesThe event evidence field.
idService Class SupportNo Uber Class SupportbodystringThe specified case id.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.add_case_event_evidence(events=[{"id": "string"}],
                                          id="string"
                                          )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.entities_event_evidence_post_v1(events=[{"id": "string"}],
                                                  id="string"
                                                  )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "events": [
        {
        "id": "string"
        }
    ],
    "id": "string"
}

response = falcon.command("entities_event_evidence_post_v1", body=body_payload)

print(response)

Back to Table of Contents

queries_cases_get_v1

Retrieves all Cases IDs that match a given query.

PEP8 method name

query_case_ids

Endpoint

MethodRoute
GET/cases/queries/cases/v1

Required Scope

case-templates:read

Content-Type

  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
filterService Class SupportUber Class SupportquerystringFilter Cases using a query in Falcon Query Language (FQL). Filter fields can be any keyword field that is part of #domain.Case. An asterisk wildcard * includes all results. Empty value means to not filter on anything. Most commonly used filter fields that supports exact match: cid, id. Most commonly used filter fields that supports wildcard (*): assigned_to_name, assigned_to_uuid. Most commonly filter fields that supports range comparisons (>, <, >=, <=): created_timestamp, updated_timestamp. All filter fields and operations support negation (!). The full list of valid filter options is extensive. Review it in our documentation inside the Falcon console.
limitService Class SupportUber Class SupportqueryintegerThe maximum number of Cases to return in this response (default: 100; max: 10000). Use this parameter together with the offset parameter to manage pagination of the results.
offsetService Class SupportUber Class SupportqueryintegerThe first case to return, where 0 is the latest case. Use with the offset parameter to manage pagination of results.
qService Class SupportUber Class SupportquerystringSearch all Case metadata for the provided string.
sortService Class SupportUber Class SupportquerystringSort parameter takes the form <field|direction>. Direction can be either asc (ascending) or desc (descending) order. For example: status|asc or status|desc. The sorting fields can be any keyword field that is part of #domain.Case except for the text based fields. Most commonly used fields are status, cid, created_timestamp, updated_timestamp, assigned_to_name, assigned_to_userid, assigned_to_uuid, tags. If the fields are missing from the Cases, the service will fallback to its default ordering.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format. Not required when using other keywords.

Usage

Service class example (PEP8 syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.query_case_ids(filter="status:'new'",
                                 limit=integer,
                                 offset=integer,
                                 sort="created_timestamp|desc",
                                 q="search_term"
                                 )
print(response)
Service class example (Operation ID syntax)
from falconpy import CaseManagement

# Do not hardcode API credentials!
falcon = CaseManagement(client_id=CLIENT_ID,
                        client_secret=CLIENT_SECRET
                        )

response = falcon.queries_cases_get_v1(filter="status:'new'",
                                       limit=integer,
                                       offset=integer,
                                       sort="created_timestamp|desc",
                                       q="search_term"
                                       )
print(response)
Uber class example
from falconpy import APIHarnessV2

# Do not hardcode API credentials!
falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("queries_cases_get_v1",
                          filter="status:'new'",
                          limit=integer,
                          offset=integer,
                          sort="created_timestamp|desc",
                          q="search_term"
                          )

print(response)

Back to Table of Contents