Skip to content

Code Security

Operations for the Code Security service collection.

LanguageLast Update
Pythonv1.6.6
PowerShell
Go
TypeScript
Rust
Ruby

OperationDescription
CreateBranchConfig
create_branch_config
Create a new branch config
CreateExclusionRule
create_scm_exclusion_rule
Create an exclusion rule
DeleteBranchConfig
delete_branch_config
Delete a branch config, or exclude a specific repository from a connection-level config when repository_id query param is provided
DeleteExclusionRule
delete_scm_exclusion_rule
Delete an exclusion rule
DeleteSCMConnection
delete_scm_connection
Delete an SCM connection
ExchangeGitHubAppCode
exchange_github_app_code
Exchange a GitHub App manifest code or complete registration after installation
GetBranchConfig
get_branch_config
Get branch config for a connection or repository
GetSCMConnection
get_scm_connection
Get an SCM connection by UUID
GetSCMRepositoryAggregates
get_scm_repository_aggregates
Get distinct values with counts for a repository field
ListExclusionRules
list_scm_exclusion_rules
List exclusion rules for a connection
ListSCMConnections
list_scm_connections
List SCM connections for a customer
ListSCMRepositories
list_scm_repositories
List discovered SCM repositories for a customer
RegisterSCMApp
register_scm_app
Register a GitHub App via the wizard flow
TriggerSCMSync
trigger_scm_sync
Trigger an immediate sync for a connection
UpdateBranchConfig
update_branch_config
Update an existing branch config

Create a new branch config

Method POST
Route /scm-integration/entities/branch-configs/v1
Scope Code Security Scm Integration: WRITE
PEP 8 create_branch_config
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.create_branch_config()
print(response)
{}


Create an exclusion rule

Method POST
Route /scm-integration/entities/exclusions/v1
Scope Code Security Scm Integration: WRITE
PEP 8 create_scm_exclusion_rule
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.create_scm_exclusion_rule()
print(response)
{}


Delete a branch config, or exclude a specific repository from a connection-level config when repository_id query param is provided

Method DELETE
Route /scm-integration/entities/branch-configs/v1
Scope Code Security Scm Integration: WRITE
PEP 8 delete_branch_config
ids query · string
Branch config UUID
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(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_branch_config(ids=id_list)
print(response)
{}


Delete an exclusion rule

Method DELETE
Route /scm-integration/entities/exclusions/v1/{id}
Scope Code Security Scm Integration: WRITE
PEP 8 delete_scm_exclusion_rule
id path · string
Exclusion rule UUID
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.delete_scm_exclusion_rule(id="string")
print(response)
{}


Delete an SCM connection

Method DELETE
Route /scm-integration/entities/connections/v1/{uuid}
Scope Code Security Scm Integration: WRITE
PEP 8 delete_scm_connection
uuid path · string
Connection UUID
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.delete_scm_connection(uuid="string")
print(response)
{}


Exchange a GitHub App manifest code or complete registration after installation

Method POST
Route /scm-integration/github-apps/exchange/v1
Scope Code Security Scm Integration: WRITE
PEP 8 exchange_github_app_code
body body · dictionary
Full body payload as JSON formatted dictionary.
code body · string
The code value.
installation_id body · string
The installation_id value.
org body · string
The org value.
state body · string
The state value.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.exchange_github_app_code(code="string",
installation_id="string",
org="string",
state="string")
print(response)
{}


Get branch config for a connection or repository

Method GET
Route /scm-integration/entities/branch-configs/v1
Scope Code Security Scm Integration: READ
PEP 8 get_branch_config
connection_id query · string
Connection UUID
repository_ids query · string
Comma-separated Repository UUIDs (optional, for per-repo or bulk query)
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.get_branch_config(connection_id="string",
repository_ids="string")
print(response)
[
{
"connection_id": "string",
"created_at": "string",
"id": "string",
"mode": "string",
"patterns": [],
"repository_id": "string",
"updated_at": "string"
}
]


Get an SCM connection by UUID

Method GET
Route /scm-integration/entities/connections/v1/{uuid}
Scope Code Security Scm Integration: READ
PEP 8 get_scm_connection
uuid path · string
Connection UUID
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.get_scm_connection(uuid="string")
print(response)
{}


Get distinct values with counts for a repository field

Method GET
Route /scm-integration/aggregates/repositories/values-by-field/v1
Scope Code Security Scm Inventory: READ
PEP 8 get_scm_repository_aggregates
field query · string
Field to aggregate: name, primary_language, visibility, artifact_types, topics, owner_org, default_branch
filter query · string
FQL filter expression to scope aggregation
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.get_scm_repository_aggregates(field="string", filter="string")
print(response)
{}


List exclusion rules for a connection

Method GET
Route /scm-integration/entities/exclusions/v1
Scope Code Security Scm Integration: READ
PEP 8 list_scm_exclusion_rules
connection_id query · string
Connection UUID to list rules for
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.list_scm_exclusion_rules(connection_id="string")
print(response)
{}


List SCM connections for a customer

Method GET
Route /scm-integration/entities/connections/v1
Scope Code Security Scm Integration: READ
PEP 8 list_scm_connections
provider query · string
Filter by provider (github, gitlab, azure_devops)
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.list_scm_connections(provider="string")
print(response)
{}


List discovered SCM repositories for a customer

Method GET
Route /scm-integration/entities/repositories/v1
Scope Code Security Scm Inventory: READ
PEP 8 list_scm_repositories
filter query · string
FQL filter expression
sort query · string
Sort field and direction in field.direction format (e.g. name.asc, created_date.desc)
limit query · integer
Maximum records to return (default 100, max 500)
offset query · integer
Starting offset for pagination
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.list_scm_repositories(filter="string",
sort="string",
limit=integer,
offset=integer)
print(response)
{}


Register a GitHub App via the wizard flow

Method POST
Route /scm-integration/registrations
Scope Code Security Scm Integration: WRITE
PEP 8 register_scm_app
body body · dictionary
Full body payload as JSON formatted dictionary.
app_id body · string
The app_id value.
installation_id body · string
The installation_id value.
org body · string
The org value.
private_key body · string
The private_key value.
webhook_secret body · string
The webhook_secret value.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.register_scm_app(app_id="string",
installation_id="string",
org="string",
private_key="string",
webhook_secret="string")
print(response)
{}


Trigger an immediate sync for a connection

Method POST
Route /scm-integration/entities/connections/v1/{uuid}/sync
Scope Code Security Scm Integration: WRITE
PEP 8 trigger_scm_sync
uuid path · string
Connection UUID
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.trigger_scm_sync(uuid="string")
print(response)
{
"errors": [
{
"code": 0,
"id": "string",
"message": "string"
}
],
"meta": {
"pagination": {
"limit": 0,
"offset": 0,
"total": 0
},
"powered_by": "string",
"query_time": 0.0,
"trace_id": "string",
"writes": {
"resources_affected": 0
}
},
"resources": {}
}


Update an existing branch config

Method PATCH
Route /scm-integration/entities/branch-configs/v1
Scope Code Security Scm Integration: WRITE
PEP 8 update_branch_config
id query · string
Branch config UUID
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CodeSecurity
falcon = CodeSecurity(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.update_branch_config(id="string")
print(response)
{}