- Checkmarx Documentation
- Checkmarx SAST
- SAST API Guide
- CXSAST (REST) API
- CxSAST (REST) API v1.1
- Schemas
Schemas
Cx.CrossCutting.WebAPIHost.ValueObjects.VersionResponseV1_1
{ "version": "string", "hotFix": "string", "enginePackVersion": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
version | string | false | none | none |
hotFix | string | false | none | none |
enginePackVersion | string | false | none | none |
Cx.Sast.ScanExecution.Presentation.Dtos.SastScansDtoV1_1
{ "id": 0, "project": { "id": 0, "name": "string", "link": { "rel": "string", "uri": "string" } }, "status": { "id": 0, "name": "string", "details": { "stage": "string", "step": "string" } }, "scanType": "Unknown", "comment": "string", "dateAndTime": { "startedOn": "2019-08-24T14:15:22Z", "finishedOn": "2019-08-24T14:15:22Z", "engineStartedOn": "2019-08-24T14:15:22Z", "engineFinishedOn": "2019-08-24T14:15:22Z" }, "resultsStatistics": { "link": { "rel": "string", "uri": "string" } }, "scanState": { "path": "string", "sourceId": "string", "filesCount": 0, "linesOfCode": 0, "failedLinesOfCode": 0, "cxVersion": "string", "languageStateCollection": [ {} ] }, "owner": "string", "origin": "string", "originURL": "string", "initiatorName": "string", "owningTeamId": 0, "isPublic": true, "isLocked": true, "isIncremental": true, "scanRisk": 0, "scanRiskSeverity": 0, "engineServer": { "id": 0, "name": "string", "link": { "rel": "string", "uri": "string" } }, "finishedScanStatus": "None", "partialScanReasons": [ { "abortedMessage": "string", "abortedStatus": "None" } ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | none | none |
project | false | none | none | |
status | false | none | none | |
scanType | string | false | none | none |
comment | string | false | none | none |
dateAndTime | false | none | none | |
resultsStatistics | Cx.Sast.ScanExecution.Presentation.Dtos.ResultsStatisticsLink | false | none | none |
scanState | false | none | none | |
owner | string | false | none | none |
origin | string | false | none | none |
originURL | string | false | none | none |
initiatorName | string | false | none | none |
owningTeamId | integer(int32) | false | none | none |
isPublic | boolean | false | none | none |
isLocked | boolean | false | none | none |
isIncremental | boolean | false | none | none |
scanRisk | integer(int64) | false | none | none |
scanRiskSeverity | integer(int64) | false | none | none |
engineServer | false | none | none | |
finishedScanStatus | string | false | none | none |
partialScanReasons | false | none | none |
Enumerated Values
Property | Value |
---|---|
scanType | Unknown |
scanType | AllScans |
scanType | Regular |
scanType | Subset |
scanType | Partial |
scanType | Running |
finishedScanStatus | None |
finishedScanStatus | Completed |
finishedScanStatus | Partial |
Cx.Sast.ScanExecution.Presentation.Dtos.ProjectDto
{ "id": 0, "name": "string", "link": { "rel": "string", "uri": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | read-only | none |
name | string | false | read-only | none |
link | false | none | none |
Cx.Sast.ScanExecution.Presentation.Dtos.ScanStatusDto
{ "id": 0, "name": "string", "details": { "stage": "string", "step": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | read-only | none |
name | string | false | read-only | none |
details | Cx.Sast.ScanExecution.Presentation.Dtos.ScanStatusDetailsDto | false | none | none |
Cx.Sast.ScanExecution.Presentation.Dtos.DateAndTimeDto
{ "startedOn": "2019-08-24T14:15:22Z", "finishedOn": "2019-08-24T14:15:22Z", "engineStartedOn": "2019-08-24T14:15:22Z", "engineFinishedOn": "2019-08-24T14:15:22Z" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
startedOn | string(date-time) | false | read-only | none |
finishedOn | string(date-time) | false | read-only | none |
engineStartedOn | string(date-time) | false | read-only | none |
engineFinishedOn | string(date-time) | false | read-only | none |
Cx.Sast.ScanExecution.Presentation.Dtos.ResultsStatisticsLink
{ "link": { "rel": "string", "uri": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
link | false | none | none |
Cx.Sast.ScanExecution.Presentation.Dtos.ScanStateDto
{ "path": "string", "sourceId": "string", "filesCount": 0, "linesOfCode": 0, "failedLinesOfCode": 0, "cxVersion": "string", "languageStateCollection": [ { "languageID": 0, "languageName": "string", "languageHash": "string", "stateCreationDate": "2019-08-24T14:15:22Z" } ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
path | string | false | none | none |
sourceId | string | false | none | none |
filesCount | integer(int64) | false | none | none |
linesOfCode | integer(int64) | false | none | none |
failedLinesOfCode | integer(int64) | false | none | none |
cxVersion | string | false | none | none |
languageStateCollection | false | none | none |
Cx.Sast.ScanExecution.Presentation.Dtos.EngineServerDto
{ "id": 0, "name": "string", "link": { "rel": "string", "uri": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | none | none |
name | string | false | none | none |
link | false | none | none |
Cx.Sast.ScanExecution.Domain.Entities.PartialScanDTO
{ "abortedMessage": "string", "abortedStatus": "None" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
abortedMessage | string | false | none | none |
abortedStatus | string | false | none | none |
Enumerated Values
Property | Value |
---|---|
abortedStatus | None |
abortedStatus | Queries |
abortedStatus | Stages |
abortedStatus | QueriesExceededResultThreshold |
Cx.SuperTypes.API.Dtos.LinkDtoBase
{ "rel": "string", "uri": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
rel | string | false | read-only | none |
uri | string | false | read-only | none |
Cx.Sast.ScanExecution.Presentation.Dtos.ScanStatusDetailsDto
{ "stage": "string", "step": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
stage | string | false | read-only | none |
step | string | false | read-only | none |
Cx.Sast.ScanExecution.Domain.Entities.QueryLanguageState
{ "languageID": 0, "languageName": "string", "languageHash": "string", "stateCreationDate": "2019-08-24T14:15:22Z" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
languageID | integer(int32) | false | none | none |
languageName | string | false | none | none |
languageHash | string | false | none | none |
stateCreationDate | string(date-time) | false | none | none |
Cx.Sast.EngineServers.ApplicationContracts.DTOs.EngineServerResponse11Dto
{ "id": 0, "name": "string", "uri": "string", "minLoc": 0, "maxLoc": 0, "maxScans": 0, "cxVersion": "string", "status": "Offline", "link": { "rel": "string", "uri": "string" }, "offlineReasonCode": "Online", "offlineReasonMessage": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | none | none |
name | string | false | none | none |
uri | string | false | none | none |
minLoc | integer(int32) | false | none | none |
maxLoc | integer(int32) | false | none | none |
maxScans | integer(int32) | false | none | none |
cxVersion | string | false | none | none |
status | string | false | none | none |
link | false | none | none | |
offlineReasonCode | string | false | none | none |
offlineReasonMessage | string | false | none | none |
Enumerated Values
Property | Value |
---|---|
status | Offline |
status | Blocked |
status | ScanningAndBlocked |
status | Scanning |
status | Idle |
offlineReasonCode | Online |
offlineReasonCode | CannotAccess |
offlineReasonCode | EngineServerError |
offlineReasonCode | MessageQueueConfigurationIssue |
offlineReasonCode | OnlineButMessageQueueConfigurationValidatationError |
offlineReasonCode | ActiveMQConnectionError |
offlineReasonCode | EngineAndPackVersionMismtach |
offlineReasonCode | EngineDiskSpaceError |
Cx.Sast.EngineServers.ApplicationContracts.DTOs.EngineServerDTO
{ "name": "string", "uri": "string", "minLoc": 0, "maxLoc": 0, "isBlocked": true, "maxScans": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
name | string | true | none | none |
uri | string | true | none | none |
minLoc | integer(int32) | true | none | none |
maxLoc | integer(int32) | true | none | none |
isBlocked | boolean | true | none | none |
maxScans | integer(int32) | false | none | none |
Cx.Sast.EngineServers.Presentation.Dtos.CreateEngineServerDto
{ "id": 0, "link": { "rel": "string", "uri": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | none | none |
link | false | none | none |
Cx.Sast.ScanExecution.Presentation.Dtos.PatchScansQueue
{ "status": "Canceled" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
status | string | true | none | none |
Enumerated Values
Property | Value |
---|---|
status | Empty |
status | Canceled |
status | Postponed |
Cx.SuperTypes.API.Dtos.LinkedResource
{ "id": 0, "link": { "rel": "string", "uri": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int64) | false | none | none |
link | false | none | none |
Cx.Sast.EngineServers.ApplicationContracts.Models.EngineServerPatchModel
{ "name": "string", "uri": "string", "minLoc": 0, "maxLoc": 0, "isBlocked": true, "maxScans": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
name | string | false | none | Engine Server name |
uri | string | false | none | Engine Server Uri |
minLoc | integer(int32) | false | none | Minimum LinesOfCode for the server |
maxLoc | integer(int32) | false | none | Maximum LinesOfCode for the server |
isBlocked | boolean | false | none | Flag to determine if EngineServer is blocked |
maxScans | integer(int32) | false | none | Max concurrent scans |
DataRetention.Presentation.Dto.DataRetentionRequestViewModel
{ "id": 0, "stage": "New", "link": { "rel": "string", "uri": "string" } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | integer(int32) | false | read-only | none |
stage | string | false | read-only | none |
link | false | none | none |
Enumerated Values
Property | Value |
---|---|
stage | New |
stage | Processing |
stage | DeletingZombies |
stage | DeletingDeprecatedScans |
stage | DeletingRetentionScans |
stage | Stopping |
stage | Stopped |
stage | Failed |
stage | Finished |
Cx.Sast.ScanSettings.Presentation.Dtos.ScanSettingsResponseDto
{ "project": { "id": 0, "link": { "rel": "string", "uri": "string" } }, "preset": { "id": 0, "link": { "rel": "string", "uri": "string" } }, "engineConfiguration": { "id": 0, "link": { "rel": "string", "uri": "string" } }, "postScanAction": { "id": 0, "link": { "rel": "string", "uri": "string" } }, "emailNotifications": { "failedScan": [ "string" ], "beforeScan": [ "string" ], "afterScan": [ "string" ] } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
project | false | none | none | |
preset | false | none | none | |
engineConfiguration | false | none | none | |
postScanAction | false | none | none | |
emailNotifications | Cx.Sast.ScanSettings.Presentation.Dtos.EmailNotificationsDto | false | none | none |
Cx.Sast.ScanSettings.Presentation.Dtos.EmailNotificationsDto
{ "failedScan": [ "string" ], "beforeScan": [ "string" ], "afterScan": [ "string" ] }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
failedScan | [string] | false | none | none |
beforeScan | [string] | false | none | none |
afterScan | [string] | false | none | none |
Cx.Sast.ScanSettings.Presentation.Dtos.ScanSettingsRequestDto
{ "projectId": 1, "presetId": 1, "engineConfigurationId": 1, "postScanActionId": 1, "emailNotifications": { "failedScan": [ "string" ], "beforeScan": [ "string" ], "afterScan": [ "string" ] } }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
projectId | integer(int64) | true | none | none |
presetId | integer(int64) | true | none | none |
engineConfigurationId | integer(int64) | true | none | none |
postScanActionId | integer(int64) | false | none | none |
emailNotifications | Cx.Sast.ScanSettings.Presentation.Dtos.EmailNotificationsDto | false | none | none |
Cx.ProjectManagement.Presentation.Dtos.ScanSettingsExtRequestDto1_1
{ "projectId": 1, "overrideProjectSetting": true, "isIncremental": true, "isPublic": true, "forceScan": true, "comment": "string", "presetId": 0, "engineConfigurationId": 0, "postScanActionId": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
projectId | integer(int64) | true | none | Specifies the Unique Id of the specific project to be scanned |
overrideProjectSetting | boolean | false | none | Specifies whether to overwrite project settings to be the default for the next scans .If set to false or empty - do not overwrite project settings. If set to true - overwrite project settings |
isIncremental | boolean | false | none | Specifies whether the scan is incremental of full |
isPublic | boolean | false | none | Specifies whether the requested scan is public or private |
forceScan | boolean | false | none | Specifies whether the code should be scanned regardless of unchanged code |
comment | string | false | none | Specifies the scan comment |
presetId | integer(int64) | false | none | Specify the preset id to use during the scan, 0 = use project’s default |
engineConfigurationId | integer(int64) | false | none | Specify the engine-configuration to use during the scan, 0 = use project’s default |
postScanActionId | integer(int64) | false | none | Specify post action to be executed after scan is completed |
DataRetention.Presentation.Dto.DataRetentionByDatesDto
{ "startDate": "2019-08-24", "endDate": "2019-08-24", "durationLimitInHours": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
startDate | string(date) | true | none | none |
endDate | string(date) | true | none | none |
durationLimitInHours | integer(int64) | false | none | none |
DataRetention.Presentation.Dto.DataRetentionByAmountDto
{ "numOfSuccessfulScansToPreserve": 0, "durationLimitInHours": 0 }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
numOfSuccessfulScansToPreserve | integer(int32) | true | none | none |
durationLimitInHours | integer(int64) | false | none | none |
Cx.CrossCutting.FileSystem.Files.CxFile_System.ByteArray_
{ "name": "string", "content": "string" }
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
name | string | false | none | none |
content | string(byte) | false | none | none |