{"swagger":"2.0","info":{"version":"v3","title":"Fortify on Demand Web API Explorer"},"host":"api.ams.fortify.com","schemes":["https"],"paths":{"/api/v3/api-keys":{"get":{"tags":["ApiKeyManagement"],"summary":"Returns a list of API keys","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_GetApiKeys","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApiKeyListResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["ApiKeyManagement"],"summary":"Creates a new API key","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_PostApiKey","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"PostApiKeyRequest model","required":true,"schema":{"$ref":"#/definitions/ApiKeyRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/PostApiKeyResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/api-keys/{apiKeyId}":{"get":{"tags":["ApiKeyManagement"],"summary":"Returns an API key","description":"Allowed Scopes: api-tenant,","operationId":"ApiKeyManagementV3_GetApiKey","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","description":"The Api Key id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApiKey"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["ApiKeyManagement"],"summary":"Updates an existing API key","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_PutApiKey","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","description":"The Api Key id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PostApiKeyRequest model","required":true,"schema":{"$ref":"#/definitions/ApiKeyRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/ApiKeyResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["ApiKeyManagement"],"summary":"Deletes the given ApiKey","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_DeleteApiKey","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","description":"The api key id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DeleteApiKeyResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/DeleteApiKeyResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/api-keys/{apiKeyId}/newsecret":{"post":{"tags":["ApiKeyManagement"],"summary":"Creates a new secret for an existing api key","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_PostNewSecret","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","description":"The Api Key id","required":true,"type":"integer","format":"int32"}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/PostApiKeyResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/api-keys/{apiKeyId}/application-access":{"get":{"tags":["ApiKeyManagement"],"summary":"Returns a list of Applications assigned to an API Key","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_GetAssignedApplicationsToApiKey","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","description":"Api Key Id","required":true,"type":"integer","format":"int32"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApiKeyApplicationListResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["ApiKeyManagement"],"summary":"Assign applications to API Key","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_ApplicationAccess","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","required":true,"type":"integer","format":"int32"},{"name":"model","in":"body","required":true,"schema":{"$ref":"#/definitions/ApiKeyApplicationAccessRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/ApiKeyResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/api-keys/{apiKeyId}/unassign-application-access":{"put":{"tags":["ApiKeyManagement"],"summary":"Unassign applications to API Key","description":"Allowed Scopes: api-tenant","operationId":"ApiKeyManagementV3_UnassignApplicationAccess","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"apiKeyId","in":"path","required":true,"type":"integer","format":"int32"},{"name":"model","in":"body","required":true,"schema":{"$ref":"#/definitions/ApiKeyUnassignApplicationsRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/ApiKeyResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}":{"get":{"tags":["Applications"],"summary":"Retrieves an individual application by id","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplication","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/Application"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["Applications"],"summary":"Update an application","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_PutApplication","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"The application data","required":true,"schema":{"$ref":"#/definitions/PutApplicationRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutApplicationResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PutApplicationResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PutApplicationResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["Applications"],"summary":"Deletes an application","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_Delete","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DeleteApplicationResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/DeleteApplicationResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications":{"get":{"tags":["Applications"],"summary":"Retrieve a collection of applications","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplications","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: applicationDescription, attributes","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"},{"name":"modifiedStartDate","in":"query","description":"The modifiedĀ on or after date.","required":false,"type":"string","format":"date-time"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApplicationListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Applications"],"summary":"Create a new application and release","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_PostApplication","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"The application data","required":true,"schema":{"$ref":"#/definitions/PostApplicationRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/PostApplicationResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/auto-report":{"get":{"tags":["Applications"],"summary":"Returns the associated auto-run report type for the application.","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetAutoReport","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetAutoReportResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Applications"],"summary":"Set-up the associated auto-run report for the application","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_PostAutoReport","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"The auto report data","required":true,"schema":{"$ref":"#/definitions/PostAutoReportRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostAutoReportResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PostAutoReportResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/users":{"get":{"tags":["Applications"],"summary":"Returns a list of users that have access to the application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationUsers","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetApplicationUsersResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/user-groups":{"get":{"tags":["Applications"],"summary":"Returns a list of user groups that have access to the application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationUserGroups","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetApplicationUserGroupsResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/owners":{"get":{"tags":["Applications"],"summary":"Returns a list of users that can be set as an application owner","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationOwners","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApplicationUserListResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/user-permissions":{"get":{"tags":["Applications"],"summary":"Returns the permissions the current user has for the application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationUserPermissions","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApplicationUserPermissions"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/releases":{"get":{"tags":["Applications"],"summary":"Returns a list of releases for the given application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationReleases","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: suspended","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"},{"name":"modifiedStartDate","in":"query","description":"The modified on or after date.","required":false,"type":"string","format":"date-time"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ReleaseListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/issue-count-by-severity":{"get":{"tags":["Applications"],"summary":"Retrieves number of issues by severity for an application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationIssueCount","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApplicationIssueCountListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/scans":{"get":{"tags":["Applications"],"summary":"Returns a list of scans for the given application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetScansByApplicationId","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ScanListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/bug-tracker":{"get":{"tags":["Applications"],"summary":"Returns the bug tracker settings for the given application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationBugTracker","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ApplicationBugTracker"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/microservices":{"get":{"tags":["Applications"],"summary":"Retrieves a list of Microservices for an application","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ApplicationsV3_GetApplicationMicroservices","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"includeReleases","in":"query","description":"Value defaults to true if not specified.","required":false,"type":"boolean"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/MicroserviceListResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Applications"],"summary":"Add a Microservice to an application","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_PostApplicationMicroservice","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"The microservice data","required":true,"schema":{"$ref":"#/definitions/PostMicroserviceRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostMicroserviceResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/microservices/{microserviceId}":{"put":{"tags":["Applications"],"summary":"Edit a Microservice for an application","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_PutApplicationMicroservice","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"microserviceId","in":"path","description":"The microservice id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"The microservice data","required":true,"schema":{"$ref":"#/definitions/PostMicroserviceRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostMicroserviceResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["Applications"],"summary":"Delete a Microservice for an application","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ApplicationsV3_DeleteApplicationMicroservice","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"microserviceId","in":"path","description":"The microservice id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostMicroserviceResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/audittemplates":{"get":{"tags":["Applications"],"summary":"Returns a list of audit templates for the given application","description":"Allowed Scopes: api-tenant, manage-issues","operationId":"ApplicationsV3_GetAuditTemplates","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"},{"name":"scanType","in":"query","description":"The scan type
Values can be obtained by calling GET /api/v3/lookup-items?type=ScanTypes","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/AuditTemplateListResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["Applications"],"summary":"Creates/Update Audit templates for the given application","description":"Allowed Scopes: api-tenant, manage-issues","operationId":"ApplicationsV3_PutApplicationAuditTemplates","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","required":true,"type":"integer","format":"int32"},{"name":"auditTemplatesRequest","in":"body","required":true,"schema":{"type":"array","items":{"$ref":"#/definitions/PutAuditTemplateFilterRequest"}}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/AuditTemplateResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/AuditTemplateResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/{applicationId}/vulnerabilities/{Id}":{"get":{"tags":["Applications"],"summary":"Returns a list of vulnerabilities with matching InstanceId","description":"Allowed Scopes: api-tenant, view-issues","operationId":"ApplicationsV3_GetVulnerabilityInstancesinApplicationByVulnerabilityId","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"applicationId","in":"path","description":"The application Id","required":true,"type":"integer","format":"int32"},{"name":"Id","in":"path","description":"The Issue id","required":true,"type":"integer","format":"int32"},{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value.\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2.\r\n
Filtering is not supported for the following fields: auditPendingAuditorStatus, auditPendingSuppression, checkId, closedDate, closedStatus, falsePositiveChallenge, instanceId, pci1_2, sink, source, stig6, suppressedBy, timeToFixDays","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"},{"name":"includeFixed","in":"query","description":"Indicates if items that have been fixed should be included in the return value. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"includeSuppressed","in":"query","description":"Indicates if items that have been suppressed should be included in the return value. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"keywordSearch","in":"query","description":"Used for keyword searches","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetVulnerabilitiesResponseVulnerabilityDTOLight"}},"202":{"description":"Accepted","schema":{"$ref":"#/definitions/ErrorResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/attributes":{"get":{"tags":["Attributes"],"summary":"Retrieve a list of attributes","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"AttributesV3_GetAttribute","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: picklistValues","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/AttributeItemListResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Attributes"],"summary":"Create a new attribute","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"AttributesV3_PostAttribute","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"The attribute data","required":true,"schema":{"$ref":"#/definitions/PostAttributeRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/PostAttributeResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/attributes/{attributeId}":{"put":{"tags":["Attributes"],"summary":"Update an attribute","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"AttributesV3_PutAttribute","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"attributeId","in":"path","description":"The attribute id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"The attribute data","required":true,"schema":{"$ref":"#/definitions/PutAttributeRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutAttributeResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PutAttributeResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PutAttributeResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["Attributes"],"summary":"Deletes an attribute","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"AttributesV3_Delete","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"attributeId","in":"path","description":"The attribute id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DeleteApplicationResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/DeleteApplicationResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/audittemplate/globalaudittemplates":{"get":{"tags":["AuditTemplate"],"summary":"Returns a list of global audit templates","description":"Allowed Scopes: api-tenant, manage-issues","operationId":"AuditTemplateV3_GetGlobalAuditTemplates","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanType","in":"query","description":"The scan type
Values can be obtained by calling GET /api/v3/lookup-items?type=ScanTypes","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/AuditTemplateListResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["AuditTemplate"],"summary":"Creates/Update Global Audit templates","description":"Allowed Scopes: api-tenant, manage-issues","operationId":"AuditTemplateV3_PutGlobalAuditTemplates","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"auditTemplatesRequest","in":"body","required":true,"schema":{"type":"array","items":{"$ref":"#/definitions/PutAuditTemplateFilterRequest"}}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/AuditTemplateResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/AuditTemplateResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/scan-setup":{"get":{"tags":["DastAutomatedScans"],"summary":"Get Dast Automated scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DastAutomatedScansV3_GetDastAutomatedScanSetup","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetDastAutomatedScanSetupResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/website-scan-setup":{"put":{"tags":["DastAutomatedScans"],"summary":"Saves Dast Automated Website scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DastAutomatedScansV3_PutDastAutomatedWebsiteScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDastAutomatedWebsiteScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDastAutomatedWebsiteScanSetupRequest"}}],"responses":{"200":{"description":"Ok"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/workflow-scan-setup":{"put":{"tags":["DastAutomatedScans"],"summary":"Saves Dast Automated Workflow scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DastAutomatedScansV3_PutDastAutomatedWorkflowScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDastAutomatedWorkflowScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDastAutomatedWorkflowScanSetupRequest"}}],"responses":{"200":{"description":"Ok"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden","schema":{"$ref":"#/definitions/ErrorResponse"}},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/openapi-scan-setup":{"put":{"tags":["DastAutomatedScans"],"summary":"Saves Dast Automated Open API scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DastAutomatedScansV3_PutDastAutomatedOpenApiScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDastAutomatedOpenApiScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDastAutomatedOpenApiScanSetupRequest"}}],"responses":{"200":{"description":"Ok"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden","schema":{"$ref":"#/definitions/ErrorResponse"}},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/graphql-scan-setup":{"put":{"tags":["DastAutomatedScans"],"summary":"Saves Dast Automated GraphQL scan setup details","operationId":"DastAutomatedScansV3_PutDastAutomatedGraphQlScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDastAutomatedGraphQLScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDastAutomatedGraphQLScanSetupRequest"}}],"responses":{"200":{"description":"Ok"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden","schema":{"$ref":"#/definitions/ErrorResponse"}},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/grpc-scan-setup":{"put":{"tags":["DastAutomatedScans"],"summary":"Saves Dast Automated GRPC scan setup details","operationId":"DastAutomatedScansV3_PutDastAutomatedGrpcScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDastAutomatedGrpcScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDastAutomatedGrpcScanSetupRequest"}}],"responses":{"200":{"description":"Ok"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden","schema":{"$ref":"#/definitions/ErrorResponse"}},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/postman-scan-setup":{"put":{"tags":["DastAutomatedScans"],"summary":"Saves Dast Automated Postman scan setup details","operationId":"DastAutomatedScansV3_PutDastAutomatedPostmanScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDastAutomatedPostmanScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDastAutomatedPostmanScanSetupRequest"}}],"responses":{"200":{"description":"Ok"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden","schema":{"$ref":"#/definitions/ErrorResponse"}},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/scan-setup/file-upload":{"patch":{"tags":["DastAutomatedScans"],"summary":"Uploads a Dast Automated file to release","operationId":"DastAutomatedScansV3_PatchDastAutomatedScanFileUpload","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID","required":true,"type":"integer","format":"int32"},{"name":"dastFileType","in":"query","description":"DAST Automated file type","required":true,"type":"string","enum":["OpenAPIDefinition","PostmanCollection","GraphQLDefinition","GRPCDefinition","WorkflowDrivenMacro","LoginMacro"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PatchDastAutomatedScanManifestResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dast-automated-scans/start-scan":{"post":{"tags":["DastAutomatedScans"],"summary":"Starts a DAST Automated scan using the current scan setup settings","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DastAutomatedScansV3_StartDastAutomatedScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release ID of the scan to start","required":true,"type":"integer","format":"int32"},{"name":"networkName","in":"query","description":"Network Name","required":false,"type":"string"},{"name":"fallbackToActiveEntitlement","in":"query","description":"Use existing active entitlement if specified entitlement is expired. Value defaults to true if not specified.","required":false,"type":"boolean"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/StartDastAutomatedScanResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dynamic-scans/scan-setup":{"get":{"tags":["DynamicScans"],"summary":"Get dynamic scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DynamicScansV3_GetDynamicScanSetup","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetDynamicScanSetupResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["DynamicScans"],"summary":"Saves dynamic scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DynamicScansV3_PutDynamicScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutDynamicScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutDynamicScanSetupRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutDynamicScanSetupResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PutDynamicScanSetupResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PutDynamicScanSetupResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dynamic-scans/scan-setup/manifest":{"patch":{"tags":["DynamicScans"],"summary":"Uploads a web service manifest to the release","operationId":"DynamicScansV3_PatchDynamicScanManifestSetup","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"webServiceFileType","in":"query","description":"The web service type","required":true,"type":"string","enum":["Postman","OpenApi","GraphQL","Grpc","WSDL"]},{"name":"postmanFileType","in":"query","description":"Select a file type (Workflow, Auth, Environment, or Globals). \r\nWorkflow file is required. Defaults to Workflow if not specified.","required":false,"type":"string","enum":["Workflow","Auth","Environment","Globals"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PatchDynamicScanSetupManifestResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PatchDynamicScanSetupManifestResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PatchDynamicScanSetupManifestResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dynamic-scans/start-scan":{"post":{"tags":["DynamicScans"],"summary":"Starts a dynamic scan using the current scan setup settings","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DynamicScansV3_StartDynamicScan","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release Id of the scan to start","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"Options for starting the scan","required":true,"schema":{"$ref":"#/definitions/StartDynamicScanRequest"}},{"name":"networkName","in":"query","description":"Network Name","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/StartDynamicScanResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/dynamic-scans/import-scan":{"put":{"tags":["DynamicScans"],"summary":"Saves the contents to import scan file","description":"Allowed Scopes: api-tenant, start-scans","operationId":"DynamicScansV3_PutImportScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release Id of the scan to import","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"fileLength","in":"query","description":"The number of bytes of the file being imported","required":true,"type":"integer","format":"int64"},{"name":"importScanSessionId","in":"query","description":"The unique importScanSessionId to use for the session provided by GET /api/v3/releases/{releaseId}/import-scan-session-id","required":true,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutImportScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/dynamic-scans/dynamic-to-dast":{"put":{"tags":["DynamicScans"],"summary":"Switches Dynamic Scan Setup to Dast Automated","operationId":"DynamicScansV3_PutDynamicSetupDetailsToDastAutomated","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutDynamicToDastAutomatedResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/dynamic-scans/parse-totp-qr":{"post":{"tags":["DynamicScans"],"summary":"Parses a TOTP QR code image and extracts the TOTP secret.","operationId":"DynamicScansV3_ParseTotpQrCode","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"TOTP secret extracted","schema":{"$ref":"#/definitions/ParseTotpQrResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PutDynamicScanSetupResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/eventlogs/download":{"get":{"tags":["EventLogs"],"summary":"Download the last 24 hours of event log data in csv format","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"EventLogsV3_Download","consumes":[],"produces":["application/x-download"],"responses":{"200":{"description":"Ok","schema":{"type":"file"}},"204":{"description":"NoContent"},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/fortify-on-demand-connect-networks":{"get":{"tags":["FortifyOnDemandConnectNetworks"],"summary":"Retrieve a list of Fortify on Demand Connect networks","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"FortifyOnDemandConnectNetworksV3_GetNetworks","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/FortifyConnectApiNetworkListResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/lookup-items":{"get":{"tags":["LookupItems"],"summary":"Returns a list of lookup items for the given type.","description":"Allowed Scopes: api-tenant, view-tenant-data\r\n \r\nFor LanguageLevels, the group field indicates the TechnologyTypeId.","operationId":"LookupItemsV3_GetLookupItems","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"type","in":"query","description":"The type of lookup items to return","required":false,"type":"string","enum":["All","AnalysisStatusTypes","ApplicationTypes","ApiRoles","AssessmentTypes","AttributeDataTypes","AttributeTypes","AuditActionTypes","AuditPreferenceTypes","AuditTemplateConditionTypes","BusinessCriticalityTypes","ConcurrentRequestThreadsTypes","DataExportTypes","DayOfWeekTypes","DastAutomatedScanPolicies","DastAutomatedScanTypes","DynamicMobileScanTypeAuditTemplateFieldTypes","DynamicScanAuthenticationTypes","DynamicScanEnvironmentFacingTypes","DynamicScanWebServiceTypes","EntitlementFrequencyTypes","GeoLocations","LanguageLevels","MobileScanAuditPreferenceTypes","MobileScanEnvironmentTypes","MobileScanExternalDeviceTypes","MobileScanFrameworkTypes","MobileScanPlatformTypes","MobileScanRoleTypes","MultiFactorAuthorizationTypes","NetworkAuthenticationType","NotificationTriggerTypes","OpenSourceScanTypeAuditTemplateFieldTypes","PassFailReasonTypes","RepeatScheduleTypes","ReportFormats","ReportStatusTypes","ReportTemplateTypes","ReportTypes","Roles","ScanMethodTypes","ScanPreferenceTypes","ScanStatusTypes","ScanTypes","SDLCStatusTypes","StartScanMethodTypes","StaticScanTypeAuditTemplateFieldTypes","TechnologyTypes","TimeZones","TwoFactorInboxes","VulnerabilitySeverityTypes","SastScanPolicies"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/LookupItemListResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/mobile-scans/scan-setup":{"get":{"tags":["MobileScans"],"summary":"Get mobile scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"MobileScansV3_GetMobileScanSetup","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/MobileScanSetup"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["MobileScans"],"summary":"Saves mobile scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"MobileScansV3_PutMobileScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutMobileScanRequest model","required":true,"schema":{"$ref":"#/definitions/PutMobileScanSetupRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutMobileScanSetupResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PutMobileScanSetupResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PutMobileScanSetupResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/mobile-scans/start-scan":{"post":{"tags":["MobileScans"],"summary":"Starts a mobile scan for the given release","description":"Allowed Scopes: api-tenant, start-scans","operationId":"MobileScansV3_Scan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"startDate","in":"query","description":"The start date for the scan in MM/dd/yyyy HH:mm format","required":true,"type":"string","format":"date-time"},{"name":"assessmentTypeId","in":"query","description":"The assessment type id for the scan
Values can be obtained by calling GET /api/v3/releases/{releaseId}/assessment-types","required":true,"type":"integer","format":"int32"},{"name":"frameworkType","in":"query","description":"The framework type id. Only iOS and Android are supported at this time","required":true,"type":"string","enum":["iOS","Android"]},{"name":"timeZone","in":"query","description":"The time zone
Values can be obtained by calling GET /api/v3/lookup-items?type=TimeZones","required":true,"type":"string"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"entitlementId","in":"query","description":"The entitlement id to consume","required":true,"type":"integer","format":"int32"},{"name":"entitlementFrequencyType","in":"query","description":"The entitlement frequency type","required":true,"type":"string","enum":["SingleScan","Subscription"]},{"name":"fileName","in":"query","description":"The uploaded file name with extension","required":false,"type":"string"},{"name":"isRemediationScan","in":"query","description":"Indicates if the scan is a remediation scan. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"isBundledAssessment","in":"query","description":"Indicates if the assessment is a bundled assessment. If not supplied legacy behavior will apply. Value defaults to null if not specified.","required":false,"type":"boolean"},{"name":"parentAssessmentTypeId","in":"query","description":"The parent assessment type id for the bundled assessment. If not supplied legacy behavior will apply","required":false,"type":"integer","format":"int32"},{"name":"scanMethodType","in":"query","description":"The method of starting a scan","required":false,"type":"string","enum":["IDE","CICD","Other","API"]},{"name":"scanTool","in":"query","description":"The tool used for scanning","required":false,"type":"string"},{"name":"scanToolVersion","in":"query","description":"The version for the scan tool used for scanning","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostMobileScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/mobile-scans/import-scan":{"put":{"tags":["MobileScans"],"summary":"Saves the contents to import scan file","description":"Allowed Scopes: api-tenant, start-scans","operationId":"MobileScansV3_PutImportScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release Id of the scan to import","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"fileLength","in":"query","description":"The number of bytes of the file being imported","required":true,"type":"integer","format":"int64"},{"name":"importScanSessionId","in":"query","description":"The unique importScanSessionId to use for the session provided by GET /api/v3/releases/{releaseId}/import-scan-session-id","required":true,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutImportScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/multi-factor-authorization-code":{"post":{"tags":["MultiFactorAuthorizationCode"],"summary":"Send an Authorization code","operationId":"MultiFactorAuthorizationCodeV3_Post","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"the username, password, and authorization method","required":true,"schema":{"$ref":"#/definitions/PostMultiFactorAuthorizationCodeRequest"}}],"responses":{"204":{"description":"NoContent"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/notifications/unread":{"get":{"tags":["Notifications"],"summary":"Get a list of unread notifications","description":"Allowed Scopes: api-tenant, manage-notifications","operationId":"NotificationsV3_GetUnreadNotifications","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/NotificationListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/notifications/read":{"get":{"tags":["Notifications"],"summary":"Get a list of read notifications","description":"Allowed Scopes: api-tenant, manage-notifications","operationId":"NotificationsV3_GetReadNotifications","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/NotificationListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/notifications/markasread":{"post":{"tags":["Notifications"],"summary":"Marks the notification(s) as read","description":"Allowed Scopes: api-tenant, manage-notifications","operationId":"NotificationsV3_MarkNotificaitonsAsRead","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"MarkNotificaitonsAsReadRequest model","required":true,"schema":{"$ref":"#/definitions/MarkNotificaitonsAsReadRequest"}}],"responses":{"204":{"description":"NoContent"},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/applications/open-source-components":{"get":{"tags":["OpenSourceComponents"],"summary":"Retrieve a collection of open source components.","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"OpenSourceComponentsV3_GetOpenSourceComponents","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"openSourceScanType","in":"query","description":"The source of component data.","required":false,"type":"string","enum":["Sonatype","CycloneDx","Debricked"]},{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: licenses, packageUrl, vulnerabilityCounts","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"},{"name":"returnTotalComponentCount","in":"query","description":"If true return the total number of components. Default is true.","required":false,"type":"boolean"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/OpenSourceComponentListResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/open-source-scans/{scanId}/sbom":{"get":{"tags":["OpenSourceComponents"],"summary":"Download the Open Source SBOM file","description":"Allowed Scopes: api-tenant, view-issues","operationId":"OpenSourceComponentsV3_DownloadOpenSourceSbomFile","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"},{"name":"format","in":"query","description":"The format of the SBOM file (e.g., \"CycloneDx\" or \"SPDx\")","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"type":"string"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized","schema":{"$ref":"#/definitions/ErrorResponse"}},"403":{"description":"Forbidden"},"404":{"description":"NotFound","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/open-source-scans/start-scan":{"post":{"tags":["OpenSourceScans"],"summary":"Start an open source scan","description":"Allowed Scopes: api-tenant, start-scans","operationId":"OpenSourceScansV3_StartScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostStartScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/personal-access-tokens/{personalAccessTokenId}":{"get":{"tags":["PersonalAccessTokens"],"summary":"Get a specific personal access token","description":"Allowed Scopes: api-tenant","operationId":"PersonalAccessTokensV3_GetPersonalAccessToken","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"personalAccessTokenId","in":"path","description":"The personal access token id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PersonalAccessTokenModel"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError"}}},"put":{"tags":["PersonalAccessTokens"],"summary":"Update an existing personal access token","description":"Allowed Scopes: api-tenant","operationId":"PersonalAccessTokensV3_PutPersonalAccessToken","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"personalAccessTokenId","in":"path","description":"The personal access token ID","required":true,"type":"integer","format":"int32"},{"name":"request","in":"body","description":"Request containing the updated token information","required":true,"schema":{"$ref":"#/definitions/PutPersonalAccessTokenRequest"}}],"responses":{"200":{"description":"Ok"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}},"delete":{"tags":["PersonalAccessTokens"],"summary":"Deletes a personal access token","description":"Allowed Scopes: api-tenant","operationId":"PersonalAccessTokensV3_DeletePersonalAccessToken","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"personalAccessTokenId","in":"path","description":"The personal access token ID","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError"}}}},"/api/v3/personal-access-tokens":{"get":{"tags":["PersonalAccessTokens"],"summary":"Returns a list of personal access tokens.","description":"Allowed Scopes: api-tenant\r\n \r\nFor security leads the returned list includes all personal access tokens in the tenant. Users in other roles can only query their own personal access tokens.","operationId":"PersonalAccessTokensV3_GetPersonalAccessTokens","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
The supported field names are name and userName. Note that filtering on userName is only available to security leads.\r\n
Filtering is not supported for the following fields: allowedScopes, id, isAuthorized, lastSuccessfulLoginDate, lastSuccessfulLoginIpAddress, secretExpirationDate, secretLifetimeDays, userId","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PersonalAccessTokenModelListResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"500":{"description":"InternalServerError"}}},"post":{"tags":["PersonalAccessTokens"],"summary":"Creates a personal access token.","description":"Allowed Scopes: api-tenant\r\n \r\nThe reqeust body should include either secretLifetimeDays or secretExpirationDate. If both are specified secretLifetimeDays is ignored.","operationId":"PersonalAccessTokensV3_PostPersonalAccessToken","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"request","in":"body","required":true,"schema":{"$ref":"#/definitions/PostPersonalAccessTokenRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/CreatePersonalAccessTokenResult"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError"}}}},"/api/v3/personal-access-tokens/{personalAccessTokenId}/secret":{"put":{"tags":["PersonalAccessTokens"],"summary":"Creates a new personal access token secret.","description":"Allowed Scopes: api-tenant\r\n \r\nCreating a new personal access token secret will void the current secret.\r\n \r\nThe reqeust body should include either secretLifetimeDays or secretExpirationDate. If both are specified secretLifetimeDays is ignored.","operationId":"PersonalAccessTokensV3_PutPersonalAccessTokenSecret","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"personalAccessTokenId","in":"path","description":"The personal access token ID","required":true,"type":"integer","format":"int32"},{"name":"request","in":"body","description":"Request containing secret lifetime or expiration date","required":true,"schema":{"$ref":"#/definitions/PutPersonalAccessTokenSecretRequest"}}],"responses":{"200":{"description":"OK","schema":{"$ref":"#/definitions/CreatePersonalAccessTokenResult"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}":{"get":{"tags":["Releases"],"summary":"Returns the specific release","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ReleasesV3_GetRelease","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/Release"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["Releases"],"summary":"Updates an existing release","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ReleasesV3_PutRelease","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutReleaseRequest model","required":true,"schema":{"$ref":"#/definitions/PutReleaseRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutReleaseResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/PutReleaseResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PutReleaseResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["Releases"],"summary":"Deletes the given release","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ReleasesV3_DeleteRelease","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DeleteReleaseResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/DeleteReleaseResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases":{"get":{"tags":["Releases"],"summary":"Returns a list of releases","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ReleasesV3_GetReleases","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: suspended","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"},{"name":"modifiedStartDate","in":"query","description":"The modifiedĀ on or after date.","required":false,"type":"string","format":"date-time"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ReleaseListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Releases"],"summary":"Creates a new release","description":"Allowed Scopes: api-tenant, manage-apps","operationId":"ReleasesV3_PostRelease","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"PostReleaseRequest model","required":true,"schema":{"$ref":"#/definitions/PostReleaseRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/PostReleaseResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/scans/{scanId}/polling-summary":{"get":{"tags":["Releases"],"summary":"Returns Scan status for a specific scan","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ReleasesV3_GetReleaseScanByScanId","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PollingScanSummary"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/fpr":{"get":{"tags":["Releases"],"summary":"Get the fpr for the given release","description":"Allowed Scopes: api-tenant, view-issues","operationId":"ReleasesV3_GetReleasesFPR","consumes":[],"produces":["application/octet-stream"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"scanType","in":"query","description":"The scan type","required":true,"type":"string","enum":["Static","Dynamic","Mobile","Monitoring","Network","OpenSource","SASTAviator"]}],"responses":{"200":{"description":"Ok","schema":{"type":"file"}},"202":{"description":"Accepted","schema":{"$ref":"#/definitions/ErrorResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/category-rollups":{"get":{"tags":["Releases"],"summary":"List and count of vulnerabilities categories, by severity for this release","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ReleasesV3_CategoryRollups","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"showFixed","in":"query","description":"Indicates of vulnerabilities marked as fixed should be included. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"vulnerabilitiesSeverityType","in":"query","required":false,"type":"string","enum":["Low","Medium","High","Critical","Best_Practice","Info"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/CategoryRollupsResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/scans/{scanId}":{"get":{"tags":["Releases"],"summary":"Returns summary information for the requested scan id","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ReleasesV3_GetReleaseScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/Scan"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/scans":{"get":{"tags":["Releases"],"summary":"Get a list of scans for a release","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ReleasesV3_GetScansByReleaseId","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ScanListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/audit-action":{"post":{"tags":["Releases"],"summary":"Sets the audit action for the given release","description":"Allowed Scopes: api-tenant, manage-issues","operationId":"ReleasesV3_PostAuditAction","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PostAuditActionRequest model","required":true,"schema":{"$ref":"#/definitions/PostAuditActionRequest"}}],"responses":{"204":{"description":"NoContent"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/audit-options":{"get":{"tags":["Releases"],"summary":"Get audit options for the given release","description":"Allowed Scopes: api-tenant, manage-issues","operationId":"ReleasesV3_GetAuditOptions","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetAuditOptionsResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/static-scan-options":{"get":{"tags":["Releases"],"summary":"Get a list of options available for starting a static scan","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ReleasesV3_GetStaticScanOptions","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"technologyStack","in":"query","description":"The technology stack
Values can be obtained by calling GET /api/v3/lookup-items?type=TechnologyTypes","required":false,"type":"string"},{"name":"languageLevel","in":"query","description":"The language level
Values can be obtained by calling GET /api/v3/lookup-items?type=LanguageLevels","required":false,"type":"string"},{"name":"assessmentTypeId","in":"query","description":"The assessment type id for the scan
Values can be obtained by calling GET /api/v3/releases/{releaseId}/assessment-types
If this parameter is supplied entitlementFrequencyType is also required","required":false,"type":"integer","format":"int32"},{"name":"entitlementFrequencyType","in":"query","description":"The entitlement frequency type
If this parameter is supplied assessmentTypeId is also required","required":false,"type":"string","enum":["SingleScan","Subscription"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetStaticScanOptionsResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/assessment-types":{"get":{"tags":["Releases"],"summary":"Get a list of available assessment types for the given release","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ReleasesV3_GetAssessmentTypes","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"scanType","in":"query","description":"The scan type","required":true,"type":"string","enum":["Static","Dynamic","Mobile","Monitoring","Network","OpenSource","SASTAviator"]},{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: suspended","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ReleaseAssessmentTypeListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/import-scan-session-id":{"get":{"tags":["Releases"],"summary":"Initiates an import scan session","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ReleasesV3_GetImportScanSessionId","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release Id of the scan to import","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetImportScanSessionIdResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/open-source-scans/import-cyclonedx-sbom":{"put":{"tags":["Releases"],"summary":"Imports a CycloneDx Software Bill of Materials (SBOM)","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ReleasesV3_PutImportScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"importScanSessionId","in":"query","description":"The unique importScanSessionId to use for the session provided by GET /api/v3/releases/{releaseId}/import-scan-session-id","required":true,"type":"string"},{"name":"releaseId","in":"path","required":true,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutImportScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/scans/{scanId}/cancel-scan":{"post":{"tags":["Releases"],"summary":"Cancels a scan","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ReleasesV3_PostCancelScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"202":{"description":"Accepted","schema":{"$ref":"#/definitions/PostCancelScanResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/static-scan-bsi-token":{"get":{"tags":["Releases"],"summary":"Get the build server integration token for the given release","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ReleasesV3_GetStaticScanBSIToken","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetStaticScanBSITokenResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports/{reportId}":{"get":{"tags":["Reports"],"summary":"Get report summary data for the given report","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_GetReport","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"reportId","in":"path","description":"The report id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/Report"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["Reports"],"summary":"Delete a report","description":"Allowed Scopes: api-tenant, manage-reports","operationId":"ReportsV3_Delete","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"reportId","in":"path","description":"The report id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DeleteReportResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports":{"get":{"tags":["Reports"],"summary":"Get a list of report summary data","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_GetReports","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ReportListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Reports"],"summary":"Create a new report","description":"Allowed Scopes: api-tenant, manage-reports","operationId":"ReportsV3_PostReport","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"PostReportRequest model","required":true,"schema":{"$ref":"#/definitions/PostReportRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostReportResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports/{reportId}/download":{"get":{"tags":["Reports"],"summary":"Download the report in binary format","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_Download","consumes":[],"produces":["application/octet-stream"],"parameters":[{"name":"reportId","in":"path","description":"The report id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"type":"file"}},"400":{"description":"BadRequest"},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports/dataexports":{"get":{"tags":["Reports"],"summary":"Get a list of export report summary data","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_GetDataExports","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DataExportListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["Reports"],"summary":"Create a new data export","description":"Allowed Scopes: api-tenant, manage-reports","operationId":"ReportsV3_PostDataExport","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"PostDataExportRequest model","required":true,"schema":{"$ref":"#/definitions/PostDataExportRequest"}}],"responses":{"200":{"description":"OK","schema":{"type":"object"}},"202":{"description":"Accepted","schema":{"$ref":"#/definitions/PostDataExportResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports/dataexports/{dataExportId}/download":{"get":{"tags":["Reports"],"summary":"Download the export report in binary format","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_DownloadExport","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"dataExportId","in":"path","description":"The data export id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"type":"string"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports/dataexports/templates":{"get":{"tags":["Reports"],"summary":"Get a list of data export templates","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_GetDataExportTemplates","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DataExportTemplateListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/reports/dataexports/{dataExportId}":{"get":{"tags":["Reports"],"summary":"Get data export details","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ReportsV3_GetDataExport","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"dataExportId","in":"path","description":"The data export id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DataExport"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans":{"get":{"tags":["Scans"],"summary":"Returns a list of scans","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ScansV3_GetScans","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"startedOnStartDate","in":"query","description":"The started on start date.","required":false,"type":"string","format":"date-time"},{"name":"startedOnEndDate","in":"query","description":"The started on end date.","required":false,"type":"string","format":"date-time"},{"name":"completedOnStartDate","in":"query","description":"The completed on start date.","required":false,"type":"string","format":"date-time"},{"name":"completedOnEndDate","in":"query","description":"The completed on end date.","required":false,"type":"string","format":"date-time"},{"name":"modifiedStartDate","in":"query","description":"The modifiedĀ on or after date.","required":false,"type":"string","format":"date-time"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ScanListResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans/{scanId}/summary":{"get":{"tags":["Scans"],"summary":"Returns summary information for the requested scan id","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ScansV3_GetScanSummary","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ScanSummary"}},"202":{"description":"Accepted"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans/{scanId}/manifest":{"get":{"tags":["Scans"],"summary":"Download the scan manifest","description":"Allowed Scopes: api-tenant, view-apps","operationId":"ScansV3_DownloadManifest","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"type":"string"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans/{scanId}/site-tree":{"get":{"tags":["Scans"],"summary":"Get the site tree","description":"Allowed Scopes: api-tenant, view-reports","operationId":"ScansV3_GetSiteTree","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/SiteTreeListResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans/{scanId}/static-source-file":{"get":{"tags":["Scans"],"summary":"Download the static scan source file","description":"Allowed Scopes: api-tenant, start-scans","operationId":"ScansV3_DownloadStaticScanSourceFile","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"type":"string"}},"401":{"description":"Unauthorized","schema":{"$ref":"#/definitions/ErrorResponse"}},"403":{"description":"Forbidden"},"404":{"description":"NotFound","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans/{scanId}/fpr":{"get":{"tags":["Scans"],"summary":"Download the FPR file for the given ScanId","description":"Allowed Scopes: api-tenant, view-issues","operationId":"ScansV3_GetFPRByScanId","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"scanId","in":"path","description":"The scan id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"type":"string"}},"202":{"description":"Accepted","schema":{"$ref":"#/definitions/ErrorResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/scans/{scanId}/mobile-scans/payload-validation-results":{"get":{"tags":["Scans"],"summary":"Returns mobile validation status and results","description":"
Values can be obtained by calling GET /api/v3/releases/{releaseId}/assessment-types","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"entitlementId","in":"query","description":"The entitlement id to consume","required":true,"type":"integer","format":"int32"},{"name":"entitlementFrequencyType","in":"query","description":"The entitlement frequency type","required":true,"type":"string","enum":["SingleScan","Subscription"]},{"name":"technologyStack","in":"query","description":"The technology stack
Values can be obtained by calling GET /api/v3/lookup-items?type=TechnologyTypes","required":false,"type":"string"},{"name":"languageLevel","in":"query","description":"The language level
Values can be obtained by calling GET /api/v3/lookup-items?type=LanguageLevels","required":false,"type":"string"},{"name":"isRemediationScan","in":"query","description":"Indicates of the scan is a remediation scan. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"doSonatypeScan","in":"query","description":"Obsolete. Use doOpenSourceScan instead. This parameter may be removed in a future release. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"excludeThirdPartyLibs","in":"query","description":"Indicates if third party libraries should be excluded. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"scanPreferenceType","in":"query","description":"This parameter is depcrecated.","required":false,"type":"string","enum":["Standard","Express"]},{"name":"auditPreferenceType","in":"query","description":"The audit preference type","required":false,"type":"string","enum":["Manual","Automated"]},{"name":"fallbackToActiveEntitlement","in":"query","description":"Use existing active entitlement if specified entitlement is expired. Value defaults to true if not specified.","required":false,"type":"boolean"},{"name":"sastScanPolicy","in":"query","description":"The SAST policy used for a scan","required":false,"type":"string","enum":["Security","DevOps","Classic","FoD_Legacy_"]},{"name":"isBundledAssessment","in":"query","description":"Indicates if the assessment is a bundled assessment. If not supplied legacy behavior will apply. Value defaults to null if not specified.","required":false,"type":"boolean"},{"name":"parentAssessmentTypeId","in":"query","description":"The parent assessment type id for the bundled assessment. If not supplied legacy behavior will apply","required":false,"type":"integer","format":"int32"},{"name":"notes","in":"query","description":"The notes about the scan.","required":false,"type":"string"},{"name":"scanMethodType","in":"query","description":"The method of starting a scan","required":false,"type":"string","enum":["IDE","CICD","Other","API"]},{"name":"scanTool","in":"query","description":"The tool used for scanning","required":false,"type":"string"},{"name":"scanToolVersion","in":"query","description":"The version for the scan tool used for scanning","required":false,"type":"string"},{"name":"doOpenSourceScan","in":"query","description":"Indicates if an open source scan should be included. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"doBinaryScan","in":"query","description":"Indicates that mixed mode scanning should be used. Value defaults to null if not specified.","required":false,"type":"boolean"},{"name":"includeFortifyAviator","in":"query","description":"Indicates whether Fortify Remediation Aviator Addon Service is requested. Value defaults to null if not specified.","required":false,"type":"boolean"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostStartScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/static-scans/start-scan-with-defaults":{"post":{"tags":["StaticScans"],"summary":"Start a static scan using the default settings","description":"Allowed Scopes: api-tenant, start-scans","operationId":"StaticScansV3_StartScanWithDefaults","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"isRemediationScan","in":"query","description":"Indicates of the scan is a remediation scan. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"notes","in":"query","description":"The notes about the scan.","required":false,"type":"string"},{"name":"scanMethodType","in":"query","description":"The method of starting a scan","required":false,"type":"string","enum":["IDE","CICD","Other","API"]},{"name":"scanTool","in":"query","description":"The tool used for scanning","required":false,"type":"string"},{"name":"scanToolVersion","in":"query","description":"The version for the scan tool used for scanning","required":false,"type":"string"},{"name":"fallbackToActiveEntitlement","in":"query","description":"Use existing active entitlement if specified entitlement is expired. Value defaults to true if not specified.","required":false,"type":"boolean"},{"name":"sastScanPolicy","in":"query","description":"The SAST scan policy to use","required":false,"type":"string","enum":["Security","DevOps","Classic","FoD_Legacy_"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostStartScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/static-scans/start-scan-advanced":{"post":{"tags":["StaticScans"],"summary":"Start a static scan using advanced options","description":"Allowed Scopes: api-tenant, start-scans","operationId":"StaticScansV3_StartScanAdvanced","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"entitlementPreferenceType","in":"query","description":"The entitlement preference type","required":true,"type":"string","enum":["SingleScanOnly","SubscriptionOnly","SingleScanFirstThenSubscription","SubscriptionFirstThenSingleScan"]},{"name":"purchaseEntitlement","in":"query","description":"Indicates if an entitlement should be purchased if one is not available. Value defaults to true if not specified.","required":true,"type":"boolean"},{"name":"remdiationScanPreferenceType","in":"query","description":"The remdiation scan preference type","required":true,"type":"string","enum":["RemediationScanIfAvailable","RemediationScanOnly","NonRemediationScanOnly"]},{"name":"inProgressScanActionType","in":"query","description":"The action to take for in-progress scans for the given release","required":true,"type":"string","enum":["DoNotStartScan","CancelInProgressScan","Queue"]},{"name":"scanMethodType","in":"query","description":"The method of starting a scan","required":true,"type":"string","enum":["IDE","CICD","Other","API"]},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"bsiToken","in":"query","description":"The build server integration token for the release","required":false,"type":"string"},{"name":"notes","in":"query","description":"The notes about the scan.","required":false,"type":"string"},{"name":"scanTool","in":"query","description":"The tool used for scanning","required":false,"type":"string"},{"name":"scanToolVersion","in":"query","description":"The version for the scan tool used for scanning","required":false,"type":"string"},{"name":"entitlementId","in":"query","description":"The entitlement id to consume","required":false,"type":"integer","format":"int32"},{"name":"fallbackToActiveEntitlement","in":"query","description":"Use existing active entitlement if specified entitlement is expired. Value defaults to true if not specified.","required":false,"type":"boolean"},{"name":"includeFortifyAviator","in":"query","description":"Indicates whether Fortify Remediation Aviator Addon Service is requested. Value defaults to null if not specified.","required":false,"type":"boolean"},{"name":"doOpenSourceScan","in":"query","description":"Indicates if an open source scan should be included. Value defaults to false if not specified.","required":false,"type":"boolean"},{"name":"assessmentTypeId","in":"query","description":"The assessment type id for the scan
Values can be obtained by calling GET /api/v3/releases/{releaseId}/assessment-types","required":false,"type":"integer","format":"int32"},{"name":"auditPreferenceType","in":"query","description":"The audit preference type","required":false,"type":"string","enum":["Manual","Automated"]},{"name":"sastScanPolicy","in":"query","description":"The SAST scan policy to use","required":false,"type":"string","enum":["Security","DevOps","Classic","FoD_Legacy_"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PostStartScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/static-scans/import-scan":{"put":{"tags":["StaticScans"],"summary":"Saves the contents to import scan file","description":"Allowed Scopes: api-tenant, start-scans","operationId":"StaticScansV3_PutImportScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release Id of the scan to import","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"fileLength","in":"query","description":"The number of bytes of the file being imported","required":true,"type":"integer","format":"int64"},{"name":"importScanSessionId","in":"query","description":"The unique importScanSessionId to use for the session provided by GET /api/v3/releases/{releaseId}/import-scan-session-id","required":true,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutImportScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/releases/{releaseId}/static-scans/scan-setup":{"get":{"tags":["StaticScans"],"summary":"Get static scan setup details","description":"Allowed Scopes: api-tenant, start-scans","operationId":"StaticScansV3_GetStaticScanSetup","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/StaticScanSetup"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["StaticScans"],"summary":"Saves static scan setup details","description":"Allowed Scopes: api-tenant, start-scans.","operationId":"StaticScansV3_PutStaticScanSetup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"The release id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutStaticScanSetupRequest model","required":true,"schema":{"$ref":"#/definitions/PutStaticScanSetupRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutStaticScanSetupResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/PutStaticScanSetupResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/releases/{releaseId}/static-scans/import-sarif":{"put":{"tags":["StaticScans"],"summary":"Imports a Static Analysis Resource Interchange Format (SARIF) file","description":"Allowed Scopes: api-tenant, start-scans","operationId":"StaticScansV3_PutImportSarifScan","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"releaseId","in":"path","description":"Release Id of the scan to import","required":true,"type":"integer","format":"int32"},{"name":"fragNo","in":"query","description":"-1 indicates the fragment of bytes has been sent. The value starts with 0 and increments by 1 for each fragment of bytes sent","required":true,"type":"integer","format":"int64"},{"name":"offset","in":"query","description":"The offset of the bytes sent. 0 indicates the first bytes","required":true,"type":"integer","format":"int64"},{"name":"fileLength","in":"query","description":"The number of bytes of the file being imported","required":true,"type":"integer","format":"int64"},{"name":"importScanSessionId","in":"query","description":"The unique importScanSessionId to use for the session provided by GET /api/v3/releases/{releaseId}/import-scan-session-id","required":true,"type":"string"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/ImportSarifScanResponse"}},"202":{"description":"Accepted"},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"NotFound"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/api/v3/tenant-entitlements":{"get":{"tags":["TenantEntitlements"],"summary":"Returns a list of active tenant entitlements","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"TenantEntitlementsV3_Get","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetTenantEntitlementResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/tenant-open-source-entitlements":{"get":{"tags":["TenantEntitlements"],"summary":"Returns a list of active open source entitlements for tenant","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"TenantEntitlementsV3_GetOpenSourceEntitlements","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetTenantOpenSourceEntitlementsResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/tenant-heat-maps":{"get":{"tags":["TenantHeatMaps"],"summary":"Retrieve a list of tenant heat map values","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"TenantHeatMapsV3_GetTenantHeatMap","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"sdlcStatus","in":"query","description":"SDLC status of releases to include.","required":true,"type":"string","enum":["Production","QA","Development","Retired"]},{"name":"daysFrom","in":"query","description":"Days back to get data","required":false,"type":"integer","format":"int32"},{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/TenantHeatMap"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/tenants/features":{"get":{"tags":["Tenants"],"summary":"Get tenant features","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"TenantsV3_GetFeatures","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/TenantFeatureListResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/tenants":{"get":{"tags":["Tenants"],"summary":"Get tenant data","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"TenantsV3_GetTenant","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GetTenantResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/tenant-summary":{"get":{"tags":["TenantSummary"],"summary":"Retrieves a summary of the tenant","description":"Allowed Scopes: api-tenant, view-tenant-data","operationId":"TenantSummaryV3_GetTenantSummary","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"daysFrom","in":"query","description":"Days back to look","required":false,"type":"integer","format":"int32"},{"name":"sdlcStatus","in":"query","description":"The SDLC Status to retrieve information about","required":false,"type":"string","enum":["Production","QA","Development","Retired"]}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/TenantSummaryListResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-application-access/{userId}":{"get":{"tags":["UserApplicationAccess"],"summary":"Get a list of applications a user has access to","description":"Allowed Scopes: api-tenant, view-users","operationId":"UserApplicationAccessV3_GetUserApplicationAccess","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userId","in":"path","description":"The user id can be obtained by calling GET /api/v3/users","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/UserApplicationAccessListResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["UserApplicationAccess"],"summary":"Create user access for the given user and application(s)","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserApplicationAccessV3_PostUserApplicationAccess","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userId","in":"path","description":"The user id can be obtained by calling GET /api/v3/users","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PostUserApplicationAccessRequest model","required":true,"schema":{"$ref":"#/definitions/PostUserApplicationAccessRequest"}}],"responses":{"202":{"description":"Accepted"},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-application-access/{userId}/{applicationId}":{"delete":{"tags":["UserApplicationAccess"],"summary":"Delete user access for the given user and application","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserApplicationAccessV3_DeleteUserApplicationAccess","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userId","in":"path","description":"The user id can be obtained by calling GET /api/v3/users","required":true,"type":"integer","format":"int32"},{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"202":{"description":"Accepted"},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-group-application-access/{userGroupId}":{"get":{"tags":["UserGroupApplicationAccess"],"summary":"Get a list of applications a user group has access to","description":"Allowed Scopes: api-tenant, view-users","operationId":"UserGroupApplicationAccessV3_GetUserGroupApplicationAccess","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userGroupId","in":"path","description":"The user group id can be obtained by calling GET/api/v3/user-management/user-groups","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/UserGroupApplicationAccessListResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["UserGroupApplicationAccess"],"summary":"Create user group access for the given user group and application","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserGroupApplicationAccessV3_PostUserGroupApplicationAccess","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userGroupId","in":"path","description":"The user group id can be obtained by calling GET/api/v3/user-management/user-groups","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PostUserGroupApplicationAccessRequest model","required":true,"schema":{"$ref":"#/definitions/PostUserGroupApplicationAccessRequest"}}],"responses":{"202":{"description":"Accepted"},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-group-application-access/{userGroupId}/{applicationId}":{"delete":{"tags":["UserGroupApplicationAccess"],"summary":"Delete user group access for the given user group and application","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserGroupApplicationAccessV3_DeleteUserGroupApplicationAccess","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userGroupId","in":"path","description":"The user group id can be obtained by calling GET/api/v3/user-management/user-groups","required":true,"type":"integer","format":"int32"},{"name":"applicationId","in":"path","description":"The application id","required":true,"type":"integer","format":"int32"}],"responses":{"202":{"description":"Accepted"},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-management/user-groups":{"get":{"tags":["UserManagement"],"summary":"Get a list of user groups","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserManagementV3_GetUserGroups","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n
Field name and value should be separated by a colon (:).\r\n
Multiple fields should be separated by a plus (+). Multiple fields are treated as an AND condition. Example, fieldname1:value+fieldname2:value\r\n
Multiple values for a field should be separated by a pipe (|). Mulitple values for a field are treated as an OR condition. Example, fieldname1:value1|value2\r\n
Filtering is not supported for the following fields: description","required":false,"type":"string"},{"name":"orderBy","in":"query","description":"The field name to order the results by.","required":false,"type":"string"},{"name":"orderByDirection","in":"query","description":"The direction to order the results by. ASC and DESC are valid values.","required":false,"type":"string"},{"name":"fields","in":"query","description":"Comma separated list of fields to return.","required":false,"type":"string"},{"name":"offset","in":"query","description":"Offset of the starting record. 0 indicates the first record.","required":false,"type":"integer","format":"int32"},{"name":"limit","in":"query","description":"Maximum records to return. The maximum value allowed is 50.","required":false,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/UserGroupListResponse"}},"401":{"description":"Unauthorized"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"post":{"tags":["UserManagement"],"summary":"Create a user group","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserManagementV3_PostUserGroup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"requestModel","in":"body","description":"
name: user group name
\r\n\r\naddAllUsers: Optional - if true add all tenant users to the group. Default is false
\r\n\r\nusers: Optional - list of users to add to the group. If addAllUsers is true this list is ignored
","required":true,"schema":{"$ref":"#/definitions/PostUserGroupRequest"}}],"responses":{"201":{"description":"Created","schema":{"$ref":"#/definitions/PostUserGroupResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-management/user-groups/{groupId}":{"put":{"tags":["UserManagement"],"summary":"Update a user group","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserManagementV3_PutGroup","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"groupId","in":"path","description":"The user group id","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"name: new user group name
\r\n\r\nremoveAllUsers: Optional - if true remove all users from the group. Default is false
\r\n\r\naddAllUsers: Optional - if true add all tenant users to the group. Default is false
\r\n\r\nNote, addAllUsers will take priority over removeAllUsers when both are set to true.
","required":true,"schema":{"$ref":"#/definitions/PutUserGroupRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GenericResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"delete":{"tags":["UserManagement"],"summary":"Delete a user group","description":"Allowed Scopes: api-tenant, manage-user","operationId":"UserManagementV3_DeleteGroup","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"groupId","in":"path","description":"The user group id","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GenericResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/user-management/user-groups/{groupId}/members":{"get":{"tags":["UserManagement"],"summary":"Get a list of user group members","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UserManagementV3_GetGroupmembers","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"groupId","in":"path","description":"The user group id","required":true,"type":"integer","format":"int32"},{"name":"filters","in":"query","description":"A delimited list of field filters.\r\nremoveUsers: list of users' Id to remove from the group
\r\n\r\naddUsers: list of users' Id to add to the group
","required":true,"schema":{"$ref":"#/definitions/PatchUserGroupMembershipRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/GenericResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/users/{userId}":{"get":{"tags":["Users"],"summary":"Get a specific user","description":"Allowed Scopes: api-tenant, view-users","operationId":"UsersV3_GetUser","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userId","in":"path","description":"The user id can be obtained by calling GET /api/v3/users","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/User"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}},"put":{"tags":["Users"],"summary":"Update an existing user","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UsersV3_PutUser","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded","multipart/form-data"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userId","in":"path","description":"The user id can be obtained by calling GET /api/v3/users","required":true,"type":"integer","format":"int32"},{"name":"requestModel","in":"body","description":"PutUserRequest model","required":true,"schema":{"$ref":"#/definitions/PutUserRequest"}}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/PutUserResponse"}},"400":{"description":"BadRequest","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"422":{"description":"UnprocessableEntity","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError","schema":{"$ref":"#/definitions/ErrorResponse"}}}},"delete":{"tags":["Users"],"summary":"Delete a specific user","description":"Allowed Scopes: api-tenant, manage-users","operationId":"UsersV3_DeleteUser","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"userId","in":"path","description":"The user id can be obtained by calling GET /api/v3/users","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Ok","schema":{"$ref":"#/definitions/DeleteUserResponse"}},"401":{"description":"Unauthorized"},"404":{"description":"NotFound"},"429":{"description":"TooManyRequests"},"500":{"description":"InternalServerError"}}}},"/api/v3/users":{"get":{"tags":["Users"],"summary":"Get a list of users","description":"Allowed Scopes: api-tenant, view-users","operationId":"UsersV3_GetUsers","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"filters","in":"query","description":"A delimited list of field filters.\r\n