Rapid Models DataHub Module API Definition

This API definition facilitates auditing static analysis alerts using classifiers, optional adaptive heuristics, and alert prioritization. The API enables jump-starting labeled datasets using test suites. It is intended to enable a wide range of users (with widely varying datasets, static analysis tools, machine learning expertise, and amount of labeled data) to benefit from using classifiers and sophisticated prioritization to automatically triage static analysis alerts.
More information: https://www.sei.cmu.edu/research-capabilities/all-work/display.cfm?customel_datapageid_4050=6453
Contact Info: lflynn@cert.org
Version: 0.0.4
BasePath:
Software Engineering Institute - Copyright (c) 2007-2019 Carnegie Mellon University. All Rights Reserved.
http://apache.org/licenses/LICENSE-2.0.html

Access

Methods

[ Jump to Models ]

Table of Contents

DataHubServer

StatsToDataHub

UIToDataHub

DataHubServer

Up
get /projects/{project_id}/alerts
Retrieve only the alerts and meta-alerts for a specific project. (getAlertsForProject)

Path parameters

project_id (required)
Path Parameter — The ID of the project

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

get_alerts_response

Example data

Content-Type: application/json
{
  "alerts" : [ {
    "code_language_id" : "code_language_id",
    "alert_id" : "alert_id",
    "primary_message" : {
      "filepath" : "filepath",
      "line_start" : 0,
      "line_end" : 6
    },
    "tool_id" : "tool_id",
    "checker_id" : "checker_id",
    "secondary_messages" : ""
  }, {
    "code_language_id" : "code_language_id",
    "alert_id" : "alert_id",
    "primary_message" : {
      "filepath" : "filepath",
      "line_start" : 0,
      "line_end" : 6
    },
    "tool_id" : "tool_id",
    "checker_id" : "checker_id",
    "secondary_messages" : ""
  } ],
  "meta_alerts" : [ {
    "filepath" : "filepath",
    "line_number" : 0,
    "determination" : {
      "flag_list" : [ {
        "flag" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "flag" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "inapplicable_environment_list" : [ {
        "inapplicable_environment" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "inapplicable_environment" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "ignored_list" : [ {
        "ignored" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "ignored" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "verdict_list" : [ {
        "verdict" : "verdict",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "verdict" : "verdict",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "dead_list" : [ {
        "dead" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "dead" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "dangerous_construct_list" : [ {
        "dangerous_construct" : "dangerous_construct",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "dangerous_construct" : "dangerous_construct",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "notes_list" : [ {
        "notes" : "notes",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "notes" : "notes",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ]
    },
    "meta_alert_id" : "meta_alert_id",
    "condition_id" : "condition_id",
    "alert_ids" : [ "alert_ids", "alert_ids" ],
    "auto_verdict" : {
      "key" : "auto_verdict"
    }
  }, {
    "filepath" : "filepath",
    "line_number" : 0,
    "determination" : {
      "flag_list" : [ {
        "flag" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "flag" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "inapplicable_environment_list" : [ {
        "inapplicable_environment" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "inapplicable_environment" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "ignored_list" : [ {
        "ignored" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "ignored" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "verdict_list" : [ {
        "verdict" : "verdict",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "verdict" : "verdict",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "dead_list" : [ {
        "dead" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "dead" : true,
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "dangerous_construct_list" : [ {
        "dangerous_construct" : "dangerous_construct",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "dangerous_construct" : "dangerous_construct",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ],
      "notes_list" : [ {
        "notes" : "notes",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      }, {
        "notes" : "notes",
        "timestamp" : "2000-01-23T04:56:07.000+00:00"
      } ]
    },
    "meta_alert_id" : "meta_alert_id",
    "condition_id" : "condition_id",
    "alert_ids" : [ "alert_ids", "alert_ids" ],
    "auto_verdict" : {
      "key" : "auto_verdict"
    }
  } ],
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return the Alerts and Meta-Alerts Associated with the Project get_alerts_response

400

Invalid Request

404

Alerts and Meta-Alerts Unavailable

default

Unexpected Error error

Up
get /packages/{package_id}
Retrieve an existing package in the DataHub Module. (getPackage)

Path parameters

package_id (required)
Path Parameter — ID of the package to retrieve

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

get_package_response

Example data

Content-Type: application/json
{
  "package" : {
    "uploader_id" : "uploader_id",
    "code_metrics" : [ {
      "filepath_depth" : "filepath_depth",
      "filename" : "filename",
      "filepath" : "filepath",
      "functions" : [ {
        "code_metrics_data" : [ null, null ],
        "name" : "name",
        "line_start" : 0,
        "line_end" : 6
      }, {
        "code_metrics_data" : [ null, null ],
        "name" : "name",
        "line_start" : 0,
        "line_end" : 6
      } ],
      "sourcefile_id" : "sourcefile_id",
      "code_metrics_data" : [ { }, { } ],
      "defect_info" : {
        "key" : ""
      }
    }, {
      "filepath_depth" : "filepath_depth",
      "filename" : "filename",
      "filepath" : "filepath",
      "functions" : [ {
        "code_metrics_data" : [ null, null ],
        "name" : "name",
        "line_start" : 0,
        "line_end" : 6
      }, {
        "code_metrics_data" : [ null, null ],
        "name" : "name",
        "line_start" : 0,
        "line_end" : 6
      } ],
      "sourcefile_id" : "sourcefile_id",
      "code_metrics_data" : [ { }, { } ],
      "defect_info" : {
        "key" : ""
      }
    } ],
    "created_at" : "2000-01-23T04:56:07.000+00:00",
    "package_id" : "package_id",
    "package_description" : "package_description",
    "alerts" : "",
    "author_source" : "author_source",
    "test_suite_id" : "test_suite_id",
    "updated_at" : "2000-01-23T04:56:07.000+00:00",
    "tool_ids" : [ "tool_ids", "tool_ids" ],
    "package_name" : "package_name",
    "code_languages" : "",
    "uploader_organization_id" : "uploader_organization_id"
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return an Existing Package get_package_response

400

Invalid Request

404

Package Unavailable

default

Unexpected Error error

Up
get /status
Provides Server Status (getStatus)

Request headers

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Server Is Running request_token

400

Database Connection Lost

default

Unexpected Error error

Up
get /taxonomies/{taxonomy_id}
Retrieve an existing taxonomy based on the name and version. (getTaxonomy)

Path parameters

taxonomy_id (required)
Path Parameter — ID of the taxonomy to retrieve

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

get_taxonomy_response

Example data

Content-Type: application/json
{
  "taxonomy" : {
    "taxonomy_id" : "taxonomy_id",
    "taxonomy_version" : "taxonomy_version",
    "description" : "description",
    "conditions" : [ {
      "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
      "condition_fields" : "{}",
      "condition_name" : "condition_name",
      "title" : "title",
      "condition_id" : "condition_id",
      "platforms" : [ "platforms", "platforms" ]
    }, {
      "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
      "condition_fields" : "{}",
      "condition_name" : "condition_name",
      "title" : "title",
      "condition_id" : "condition_id",
      "platforms" : [ "platforms", "platforms" ]
    } ],
    "taxonomy_name" : "taxonomy_name"
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Returns data for a specific taxonomy get_taxonomy_response

400

Invalid Request

404

Taxonomy Unavailable

default

Unexpected Error error

Up
get /taxonomies
Retrieve a list of available Taxonomies. (getTaxonomyList)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

taxonomy_list_response

Example data

Content-Type: application/json
{
  "taxonomies" : [ {
    "author_source" : "author_source",
    "taxonomy_id" : "taxonomy_id",
    "uploader_id" : "uploader_id",
    "taxonomy_version" : "taxonomy_version",
    "taxonomy_name" : "taxonomy_name",
    "uploader_organization_id" : "uploader_organization_id"
  }, {
    "author_source" : "author_source",
    "taxonomy_id" : "taxonomy_id",
    "uploader_id" : "uploader_id",
    "taxonomy_version" : "taxonomy_version",
    "taxonomy_name" : "taxonomy_name",
    "uploader_organization_id" : "uploader_organization_id"
  } ],
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Returns a list of taxonomy ids, names and versions. taxonomy_list_response

400

Invalid Request

404

Taxonomies Unavailable

default

Unexpected Error error

Up
get /test_suites
Retrieve a list of Test Suite ids, names and versions that are available. (getTestSuiteList)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

test_suite_list_response

Example data

Content-Type: application/json
{
  "test_suites" : [ {
    "author_source" : "author_source",
    "test_suite_version" : "test_suite_version",
    "test_suite_id" : "test_suite_id",
    "uploader_id" : "uploader_id",
    "manifest_urls" : [ "http://example.com/aeiou", "http://example.com/aeiou" ],
    "uploader_organization_id" : "uploader_organization_id",
    "code_languages" : "",
    "test_suite_name" : "test_suite_name"
  }, {
    "author_source" : "author_source",
    "test_suite_version" : "test_suite_version",
    "test_suite_id" : "test_suite_id",
    "uploader_id" : "uploader_id",
    "manifest_urls" : [ "http://example.com/aeiou", "http://example.com/aeiou" ],
    "uploader_organization_id" : "uploader_organization_id",
    "code_languages" : "",
    "test_suite_name" : "test_suite_name"
  } ],
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Returns a list of test suites test_suite_list_response

400

Invalid Request

404

Test Suites Unavailable

default

Unexpected Error error

Up
get /tools/{tool_id}
Retrieve an existing tool in the DataHub Module. (getToolData)

Path parameters

tool_id (required)
Path Parameter — Tool ID to retrieve data

Request headers

Return type

get_tool_response

Example data

Content-Type: application/json
{
  "request_id" : "request_id",
  "tool" : {
    "tool_name" : "tool_name",
    "author_source" : "author_source",
    "uploader_id" : "uploader_id",
    "tool_version" : "tool_version",
    "tool_id" : "tool_id",
    "metrics_data_headers" : "{}",
    "category" : "category",
    "checker_mappings" : [ {
      "checker_name" : "checker_name",
      "checker_id" : "checker_id",
      "conditions" : [ {
        "taxonomy_id" : "taxonomy_id",
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_id" : "condition_id"
      }, {
        "taxonomy_id" : "taxonomy_id",
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_id" : "condition_id"
      } ]
    }, {
      "checker_name" : "checker_name",
      "checker_id" : "checker_id",
      "conditions" : [ {
        "taxonomy_id" : "taxonomy_id",
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_id" : "condition_id"
      }, {
        "taxonomy_id" : "taxonomy_id",
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_id" : "condition_id"
      } ]
    } ],
    "uploader_organization_id" : "uploader_organization_id"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Returns data for a particular tool get_tool_response

400

Invalid Request

404

Tool Information Unavailable

default

Unexpected Error error

Up
get /tools
Retrieve a list of tool ids, versions and names available in the Module. (getToolList)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

tool_list_response

Example data

Content-Type: application/json
{
  "request_id" : "request_id",
  "tools" : [ {
    "tool_name" : "tool_name",
    "author_source" : "author_source",
    "uploader_id" : "uploader_id",
    "tool_version" : "tool_version",
    "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
    "tool_id" : "tool_id",
    "uploader_organization_id" : "uploader_organization_id"
  }, {
    "tool_name" : "tool_name",
    "author_source" : "author_source",
    "uploader_id" : "uploader_id",
    "tool_version" : "tool_version",
    "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
    "tool_id" : "tool_id",
    "uploader_organization_id" : "uploader_organization_id"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Returns a list of tool id, version and name tool_list_response

400

Invalid Request

404

Tools Unavailable

default

Unexpected Error error

Up
get /languages
Retrieve a list of all the available languages. (listLanguages)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

list_languages_response

Example data

Content-Type: application/json
{
  "languages" : "",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return a list of languages list_languages_response

400

Invalid Request

404

No Languages Available

default

Unexpected Error error

Up
get /packages
Retrieve a list of all available packages. (listPackages)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

list_packages_response

Example data

Content-Type: application/json
{
  "packages" : "",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return a List of Available Packages list_packages_response

400

Invalid Request

404

No Packages Available

default

Unexpected Error error

Up
get /projects
Retrieve a list of all available projects. (listProjects)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

list_projects_response

Example data

Content-Type: application/json
{
  "projects" : "",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return a List of Available Projects list_projects_response

400

Invalid Request

404

No Projects Available

default

Unexpected Error error

StatsToDataHub

Up
post /projects/adaptive_heuristics/close
Send a list of project_ids to stop forwarding the project's alerts to the Stats Module. (closeAdaptiveHeuristics)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

project_ids project_ids (required)
Body Parameter — Multiple project_ids to close adaptive heuristic alert forwarding request

Request headers

Return type

adaptive_heuristic_close_response

Example data

Content-Type: application/json
{
  "project_status" : [ {
    "status_message" : "status_message",
    "project_id" : "project_id",
    "project_updated" : true
  }, {
    "status_message" : "status_message",
    "project_id" : "project_id",
    "project_updated" : true
  } ],
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Adaptive Heuristic Forwarding Successfully Closed adaptive_heuristic_close_response

206

Some Error Occurred adaptive_heuristic_close_response

400

Invalid Request

default

Unexpected Error error

Up
post /projects/classifiers/retrieve
Retrieve projects from the DataHub for Classification at the Stats Module (getProjectsForClassifier)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

classifier_projects_requested classifier_projects_requested (required)
Body Parameter — Tool and taxonomy information the requesting module already has, along with projects it is requesting.

Request headers

Return type

get_projects_classifier_response

Example data

Content-Type: application/json
{
  "projects" : [ {
    "uploader_id" : "uploader_id",
    "project_description" : "project_description",
    "package" : {
      "alerts" : "",
      "test_suite_id" : "test_suite_id",
      "uploader_id" : "uploader_id",
      "updated_at" : "2000-01-23T04:56:07.000+00:00",
      "package_name" : "package_name",
      "created_at" : "2000-01-23T04:56:07.000+00:00",
      "package_id" : "package_id",
      "code_languages" : "",
      "tools" : [ {
        "tool_name" : "tool_name",
        "author_source" : "author_source",
        "uploader_id" : "uploader_id",
        "tool_version" : "tool_version",
        "source_mappings" : [ {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        }, {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        } ],
        "tool_id" : "tool_id",
        "metrics_data_headers" : "{}",
        "category" : "category",
        "uploader_organization_id" : "uploader_organization_id"
      }, {
        "tool_name" : "tool_name",
        "author_source" : "author_source",
        "uploader_id" : "uploader_id",
        "tool_version" : "tool_version",
        "source_mappings" : [ {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        }, {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        } ],
        "tool_id" : "tool_id",
        "metrics_data_headers" : "{}",
        "category" : "category",
        "uploader_organization_id" : "uploader_organization_id"
      } ],
      "uploader_organization_id" : "uploader_organization_id",
      "sourcefiles" : [ {
        "filepath_depth" : "filepath_depth",
        "filename" : "filename",
        "filepath" : "filepath",
        "functions" : [ {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        }, {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        } ],
        "sourcefile_id" : "sourcefile_id",
        "code_metrics_data" : [ { }, { } ],
        "defect_info" : {
          "key" : ""
        }
      }, {
        "filepath_depth" : "filepath_depth",
        "filename" : "filename",
        "filepath" : "filepath",
        "functions" : [ {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        }, {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        } ],
        "sourcefile_id" : "sourcefile_id",
        "code_metrics_data" : [ { }, { } ],
        "defect_info" : {
          "key" : ""
        }
      } ],
      "package_description" : "package_description"
    },
    "meta_alerts" : [ {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    }, {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    } ],
    "updated_at" : "2000-01-23T04:56:07.000+00:00",
    "project_id" : "project_id",
    "taxonomies" : [ {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    }, {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    } ],
    "created_at" : "2000-01-23T04:56:07.000+00:00",
    "project_name" : "project_name",
    "uploader_organization_id" : "uploader_organization_id"
  }, {
    "uploader_id" : "uploader_id",
    "project_description" : "project_description",
    "package" : {
      "alerts" : "",
      "test_suite_id" : "test_suite_id",
      "uploader_id" : "uploader_id",
      "updated_at" : "2000-01-23T04:56:07.000+00:00",
      "package_name" : "package_name",
      "created_at" : "2000-01-23T04:56:07.000+00:00",
      "package_id" : "package_id",
      "code_languages" : "",
      "tools" : [ {
        "tool_name" : "tool_name",
        "author_source" : "author_source",
        "uploader_id" : "uploader_id",
        "tool_version" : "tool_version",
        "source_mappings" : [ {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        }, {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        } ],
        "tool_id" : "tool_id",
        "metrics_data_headers" : "{}",
        "category" : "category",
        "uploader_organization_id" : "uploader_organization_id"
      }, {
        "tool_name" : "tool_name",
        "author_source" : "author_source",
        "uploader_id" : "uploader_id",
        "tool_version" : "tool_version",
        "source_mappings" : [ {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        }, {
          "mapping_source" : "mapping_source",
          "checker_mappings" : [ {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          }, {
            "checker_name" : "checker_name",
            "tool_id" : "tool_id",
            "checker_id" : "checker_id",
            "conditions" : [ {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            }, {
              "condition" : {
                "condition_fields" : "{}",
                "condition_name" : "condition_name",
                "title" : "title",
                "condition_id" : "condition_id",
                "platforms" : [ "platforms", "platforms" ]
              },
              "language_ids" : [ "language_ids", "language_ids" ]
            } ]
          } ]
        } ],
        "tool_id" : "tool_id",
        "metrics_data_headers" : "{}",
        "category" : "category",
        "uploader_organization_id" : "uploader_organization_id"
      } ],
      "uploader_organization_id" : "uploader_organization_id",
      "sourcefiles" : [ {
        "filepath_depth" : "filepath_depth",
        "filename" : "filename",
        "filepath" : "filepath",
        "functions" : [ {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        }, {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        } ],
        "sourcefile_id" : "sourcefile_id",
        "code_metrics_data" : [ { }, { } ],
        "defect_info" : {
          "key" : ""
        }
      }, {
        "filepath_depth" : "filepath_depth",
        "filename" : "filename",
        "filepath" : "filepath",
        "functions" : [ {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        }, {
          "code_metrics_data" : [ null, null ],
          "name" : "name",
          "line_start" : 0,
          "line_end" : 6
        } ],
        "sourcefile_id" : "sourcefile_id",
        "code_metrics_data" : [ { }, { } ],
        "defect_info" : {
          "key" : ""
        }
      } ],
      "package_description" : "package_description"
    },
    "meta_alerts" : [ {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    }, {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    } ],
    "updated_at" : "2000-01-23T04:56:07.000+00:00",
    "project_id" : "project_id",
    "taxonomies" : [ {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    }, {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    } ],
    "created_at" : "2000-01-23T04:56:07.000+00:00",
    "project_name" : "project_name",
    "uploader_organization_id" : "uploader_organization_id"
  } ],
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return Existing Projects get_projects_classifier_response

400

Invalid Request

404

Projects Unavailable

default

Unexpected Error error

Up
post /projects/{project_id}/classifiers/hold
Place a temporary hold on the data forwarding request from the DataHub (holdDataForClassifier)

Path parameters

project_id (required)
Path Parameter — The ID of the project

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK, Data Forwarding Temporarily Stopped request_token

400

Invalid Request

404

Project Unavailable

default

Unexpected Error error

Up
put /projects/{project_id}/classifiers/hold
Remove the temporary hold on the data forwarding request from the DataHub (releaseDataHoldForClassifier)

Path parameters

project_id (required)
Path Parameter — The ID of the project

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK, Data Forwarding Resumed request_token

400

Invalid Request

404

Project Unavailable

default

Unexpected Error error

UIToDataHub

Up
post /languages
Create a new language definition. (createLanguage)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

language_definition language_version (required)
Body Parameter — Language information

Request headers

Return type

create_language_response

Example data

Content-Type: application/json
{
  "language" : {
    "code_language_id" : "code_language_id",
    "language" : "language",
    "version" : "version"
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Language Successfully Uploaded create_language_response

400

Invalid Request

default

Unexpected Error error

Up
post /packages
Create a new package. This request will return the package_id used to reference the package within the DataHub. Note, for metrics data uploads use PUT /tools/{tool_id}. (createPackage)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

package_metadata package_metadata (required)
Body Parameter — Data to the create package

Request headers

Return type

create_package_response

Example data

Content-Type: application/json
{
  "status_message" : [ "status_message", "status_message" ],
  "package" : {
    "package_name" : "package_name",
    "alert_mappings" : {
      "key" : {
        "primary_message" : {
          "filepath" : "filepath",
          "line_start" : 0,
          "line_end" : 6
        },
        "tool_id" : "tool_id",
        "checker_id" : "checker_id"
      }
    },
    "package_id" : "package_id"
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Package Successfully Created create_package_response

400

Unable to Create Package

default

Unexpected Error error

Up
post /projects
Create a new project. The package and taxonomies should be uploaded to the DataHub prior to creating a project. This request will return the project_id to reference the project within the DataHub. (createProject)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

project_metadata project_metadata (required)
Body Parameter — Data to a create project

Request headers

Return type

create_project_response

Example data

Content-Type: application/json
{
  "status_message" : [ "status_message", "status_message" ],
  "project" : {
    "project_id" : "project_id",
    "meta_alert_mappings" : {
      "key" : {
        "filepath" : "filepath",
        "line_number" : 0,
        "condition_id" : "condition_id"
      }
    },
    "project_name" : "project_name"
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Project Successfully Created create_project_response

400

Unable to Create Project

default

Unexpected Error error

Up
post /taxonomies
Upload a new taxonomy to the DataHub Module. Returns the taxonomy_id and condition_ids to reference this Taxonomy and its Conditions. (createTaxonomy)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

taxonomy_metadata taxonomy_metadata (required)
Body Parameter — Taxonomy information to upload

Request headers

Return type

create_taxonomy_response

Example data

Content-Type: application/json
{
  "taxonomy" : {
    "taxonomy_id" : "taxonomy_id",
    "conditions" : [ {
      "condition_name" : "condition_name",
      "title" : "title",
      "condition_id" : "condition_id"
    }, {
      "condition_name" : "condition_name",
      "title" : "title",
      "condition_id" : "condition_id"
    } ]
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK, Taxonomy Successfully Created create_taxonomy_response

400

Unable to Create Taxonomy

default

Unexpected Error error

Up
post /test_suites
Create a Test Suite in the DataHub Module. (createTestSuite)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

test_suite_metadata test_suite_metadata (required)
Body Parameter — Test Suite information to upload

Request headers

Return type

test_suite_upload_response

Example data

Content-Type: application/json
{
  "status_message" : "status_message",
  "test_suite" : {
    "author_source" : "author_source",
    "test_suite_version" : "test_suite_version",
    "test_suite_id" : "test_suite_id",
    "uploader_id" : "uploader_id",
    "manifest_urls" : [ "http://example.com/aeiou", "http://example.com/aeiou" ],
    "uploader_organization_id" : "uploader_organization_id",
    "code_languages" : "",
    "test_suite_name" : "test_suite_name"
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK test_suite_upload_response

400

Unable to Upload Test Suite

default

Unexpected Error error

Up
delete /packages/{package_id}
Delete an existing package. (deletePackage)

Path parameters

package_id (required)
Path Parameter — ID of the package to delete

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Package Successfully Deleted request_token

400

Invalid Request

404

Unable to Delete Package

default

Unexpected Error error

Up
delete /projects/{project_id}
Delete an existing project. (deleteProject)

Path parameters

project_id (required)
Path Parameter — The ID of the project to delete

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Project Successfully Deleted request_token

400

Invalid Request

404

Project Unavailable

default

Unexpected Error error

Up
put /packages/{package_id}
Update an existing package. Use this method to add new alerts for the package. Note, for metrics data uploads use PUT /tools/{tool_id}. (editPackage)

Path parameters

package_id (required)
Path Parameter — ID of the package to update

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

edit_package edit_package (required)
Body Parameter — Package data to modify the existing package with

Request headers

Return type

edit_package_response

Example data

Content-Type: application/json
{
  "status_message" : "status_message",
  "alert_mappings" : {
    "key" : {
      "primary_message" : {
        "filepath" : "filepath",
        "line_start" : 0,
        "line_end" : 6
      },
      "tool_id" : "tool_id",
      "checker_id" : "checker_id"
    }
  },
  "package_id" : "package_id",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Package Successfully Updated edit_package_response

400

Invalid Request

404

Unable to Update Package

default

Unexpected Error error

Up
put /projects/{project_id}
Update an existing project. This method can also be used to send only meta-alert determinations of an existing meta-alert to the DataHub, which is most useful when a project has an open adaptive heuristic set. (editProject)

Path parameters

project_id (required)
Path Parameter — The ID of the project to update

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

edit_project edit_project (required)
Body Parameter — Project data to modify the existing project with

Request headers

Return type

edit_project_response

Example data

Content-Type: application/json
{
  "status_message" : "status_message",
  "project_id" : "project_id",
  "meta_alert_mappings" : {
    "key" : {
      "filepath" : "filepath",
      "line_number" : 0,
      "condition_id" : "condition_id"
    }
  },
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Package was Successfully Updated edit_project_response

400

Invalid Request

404

Unable to Update Project

default

Unexpected Error error

Up
put /tools/{tool_id}
Update a tool with Checker-Mapping or Metrics CSVs (editTool)

Path parameters

tool_id (required)
Path Parameter — Tool ID to update data

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Form parameters

checker_mapping_csv (optional)
Form Parameter — CSV with checker mappings, the filename should match the mapping_filename in tool_metadata
metrics_tool_csv (optional)
Form Parameter — 'Metrics Tool CSV to Upload, the filename should contain one of the following values: 'lizard', 'understand', or 'ccsm''

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK, Tool Successfully Updated request_token

400

Unable to Upload Checker or Metrics Information

default

Unexpected Error error

Up
post /projects/retrieve
Retrieve projects from the DataHub. Send taxonomy information the requestor already has, along with projects it is requesting. This way, a response from the DataHub can efficiently leave out taxonomies that the requestor already has information for. (getProjects)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

projects_requested projects_requested (required)
Body Parameter — Taxonomy information the requesting module already has, along with projects it is requesting.

Request headers

Return type

get_projects_response

Example data

Content-Type: application/json
{
  "projects" : [ {
    "author_source" : "author_source",
    "uploader_id" : "uploader_id",
    "project_description" : "project_description",
    "meta_alerts" : [ {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    }, {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    } ],
    "updated_at" : "2000-01-23T04:56:07.000+00:00",
    "project_id" : "project_id",
    "taxonomies" : [ {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    }, {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    } ],
    "created_at" : "2000-01-23T04:56:07.000+00:00",
    "package_id" : "package_id",
    "project_name" : "project_name",
    "uploader_organization_id" : "uploader_organization_id"
  }, {
    "author_source" : "author_source",
    "uploader_id" : "uploader_id",
    "project_description" : "project_description",
    "meta_alerts" : [ {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    }, {
      "filepath" : "filepath",
      "line_number" : 0,
      "determination" : {
        "flag_list" : [ {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "flag" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "inapplicable_environment_list" : [ {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "inapplicable_environment" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "ignored_list" : [ {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "ignored" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "verdict_list" : [ {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "verdict" : "verdict",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dead_list" : [ {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dead" : true,
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "dangerous_construct_list" : [ {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "dangerous_construct" : "dangerous_construct",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ],
        "notes_list" : [ {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        }, {
          "notes" : "notes",
          "timestamp" : "2000-01-23T04:56:07.000+00:00"
        } ]
      },
      "meta_alert_id" : "meta_alert_id",
      "condition_id" : "condition_id",
      "alert_ids" : [ "alert_ids", "alert_ids" ],
      "auto_verdict" : {
        "key" : "auto_verdict"
      }
    } ],
    "updated_at" : "2000-01-23T04:56:07.000+00:00",
    "project_id" : "project_id",
    "taxonomies" : [ {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    }, {
      "taxonomy_id" : "taxonomy_id",
      "taxonomy_version" : "taxonomy_version",
      "description" : "description",
      "conditions" : [ {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      }, {
        "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
        "condition_fields" : "{}",
        "condition_name" : "condition_name",
        "title" : "title",
        "condition_id" : "condition_id",
        "platforms" : [ "platforms", "platforms" ]
      } ],
      "taxonomy_name" : "taxonomy_name"
    } ],
    "created_at" : "2000-01-23T04:56:07.000+00:00",
    "package_id" : "package_id",
    "project_name" : "project_name",
    "uploader_organization_id" : "uploader_organization_id"
  } ],
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return Existing Projects get_projects_response

400

Invalid Request

404

Projects Unavailable

default

Unexpected Error error

Up
post /packages/{package_id}
Upload a Source Code Archive and MetaData Files for the Package. (uploadCodebaseForPackage)

Path parameters

package_id (required)
Path Parameter — ID of the package to update

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Form parameters

sourcecode_archive (required)
Form Parameter — Source Code Archive for this package
source_file_csv (optional)
Form Parameter — Source File CSV
source_function_csv (optional)
Form Parameter — Source Function CSV

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Code Source Successfully Uploaded request_token

400

Invalid Request

404

Unable to Upload Code Source Archive

default

Unexpected Error error

Up
post /test_suites/{test_suite_id}/packages/{package_id}
Upload Test Suite MetaData Files (uploadTestSuite)

Path parameters

test_suite_id (required)
Path Parameter — Test Suite ID to upload data files
package_id (required)
Path Parameter — Package ID to upload data files

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Form parameters

manifest_file (required)
Form Parameter
use_license_file (optional)
Form Parameter
source_file_csv (optional)
Form Parameter — Source File CSV
source_function_csv (optional)
Form Parameter — Source Function CSV

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Data Successfully Uploaded request_token

400

Invalid Request

404

Unable to Upload MetaData Files

default

Unexpected Error error

Up
post /tools
Upload a new Tool to the DataHub Module. Returns a tool_id to reference the tool in the DataHub Module. For code metrics tools, upload a list of ordered field names. (uploadTool)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

tool_metadata tool_metadata (required)
Body Parameter — Tool information to upload

Request headers

Return type

tool_upload_response

Example data

Content-Type: application/json
{
  "status_message" : "status_message",
  "request_id" : "request_id",
  "tool" : {
    "tool_name" : "tool_name",
    "tool_version" : "tool_version",
    "code_language_ids" : [ "code_language_ids", "code_language_ids" ],
    "tool_id" : "tool_id",
    "category" : "category"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK, Tool Successfully Uploaded tool_upload_response

400

Unable to Upload Tool Information

default

Unexpected Error error

Up
post /tools/{tool_id}/packages/{package_id}
Upload Raw Tool Output (uploadToolOutput)

Path parameters

tool_id (required)
Path Parameter — Tool ID to upload data
package_id (required)
Path Parameter — Package ID to upload data

Consumes

This API call consumes the following media types via the Content-Type request header:

Request headers

Form parameters

raw_tool_output (required)
Form Parameter — Raw Tool Output to Upload to the DataHub

Return type

request_token

Example data

Content-Type: application/json
{
  "message" : "message",
  "request_id" : "request_id"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

OK, Tool Output Successfully Uploaded request_token

400

Unable to Upload Tool Output

default

Unexpected Error error

Models

[ Jump to Methods ]

Table of Contents

  1. adaptive_heuristic_close_response -
  2. alert_mappings -
  3. alert_no_id -
  4. alert_w_id -
  5. checker_conditions -
  6. checker_mappings -
  7. checker_mappings_metadata -
  8. classifier_package -
  9. classifier_project -
  10. classifier_projects_requested -
  11. condition -
  12. condition_heading -
  13. condition_languages -
  14. condition_map -
  15. condition_metadata -
  16. condition_response -
  17. create_language_response -
  18. create_package_response -
  19. create_project_response -
  20. create_taxonomy -
  21. create_taxonomy_response -
  22. created_package -
  23. created_project -
  24. determination -
  25. determination_dangerous_construct_list -
  26. determination_dead_list -
  27. determination_flag_list -
  28. determination_ignored_list -
  29. determination_inapplicable_environment_list -
  30. determination_notes_list -
  31. determination_verdict_list -
  32. edit_package -
  33. edit_package_response -
  34. edit_project -
  35. edit_project_response -
  36. error -
  37. get_alerts_response -
  38. get_classifier_tool -
  39. get_package_response -
  40. get_projects_classifier_response -
  41. get_projects_response -
  42. get_taxonomy -
  43. get_taxonomy_response -
  44. get_tool -
  45. get_tool_response -
  46. language_version -
  47. language_version_w_id -
  48. list_languages -
  49. list_languages_response -
  50. list_packages -
  51. list_packages_response -
  52. list_projects -
  53. list_projects_response -
  54. message -
  55. meta_alert_mappings -
  56. meta_alert_no_id -
  57. meta_alert_w_id -
  58. metrics -
  59. package -
  60. package_alerts -
  61. package_alerts_w_id -
  62. package_heading -
  63. package_metadata -
  64. project -
  65. project_heading -
  66. project_heuristic_message -
  67. project_ids -
  68. project_meta_alerts -
  69. project_metadata -
  70. project_status -
  71. projects_requested -
  72. request_token -
  73. secondary_messages -
  74. secondary_messages_inner -
  75. source_mappings -
  76. sourcefile -
  77. sourcefunction -
  78. taxonomies_present -
  79. taxonomy_heading -
  80. taxonomy_list_response -
  81. taxonomy_metadata -
  82. test_suite_heading -
  83. test_suite_list_response -
  84. test_suite_metadata -
  85. test_suite_upload_response -
  86. tool_heading -
  87. tool_list_response -
  88. tool_metadata -
  89. tool_response -
  90. tool_taxonomies_present -
  91. tool_upload_response -

adaptive_heuristic_close_response - Up

request_id
project_status

alert_mappings - Up

tool_id
checker_id
primary_message

alert_no_id - Up

tool_id
checker_id
code_language
primary_message
secondary_messages (optional)

alert_w_id - Up

alert_id
tool_id
checker_id
code_language_id (optional)
primary_message
secondary_messages (optional)

checker_conditions - Up

checker_id (optional)
checker_name (optional)
conditions (optional)

checker_mappings - Up

checker_id (optional)
checker_name (optional)
tool_id (optional)
conditions (optional)

checker_mappings_metadata - Up

mapping_source (optional)
String Source of the mapping, e.g., CERT wiki, scale.app, etc.
mapper_identity (optional)
mapping_version (optional)
publishable_public_or_not (optional)
dod_publication (optional)
deprecated_or_not (optional)
license_information (optional)
additional_notes (optional)
description (optional)
mapping_date (optional)
Date format: date-time
mapping_filename (optional)
String Filename of the mappings CSV that this data describes and will be uploaded in a subsequent call
mappings (optional)

classifier_package - Up

package_id
package_name
package_description (optional)
code_languages (optional)
alerts (optional)
test_suite_id (optional)
tools (optional)
sourcefiles (optional)
uploader_id (optional)
uploader_organization_id (optional)
created_at
Date format: date-time
updated_at (optional)
Date format: date-time

classifier_project - Up

project_id (optional)
project_name (optional)
project_description (optional)
package (optional)
meta_alerts (optional)
taxonomies (optional)
uploader_id (optional)
uploader_organization_id (optional)
created_at (optional)
Date format: date-time
updated_at (optional)
Date format: date-time

classifier_projects_requested - Up

tool_taxonomies_present (optional)
project_status

condition - Up

code_language_ids (optional)
condition_name
title
platforms (optional)
condition_fields (optional)
Object Fields associated with this condition, i.e., likelihood

condition_heading - Up

condition_id (optional)
condition_name (optional)
title (optional)

condition_languages - Up

condition (optional)
language_ids (optional)

condition_map - Up

taxonomy_id (optional)
condition_id
code_language_ids (optional)

condition_metadata - Up

condition_id (optional)
condition_name (optional)
title (optional)
platforms (optional)
condition_fields (optional)
Object Fields associated with this condition, i.e., likelihood

condition_response - Up

condition_id
code_language_ids (optional)
condition_name
title
platforms (optional)
condition_fields (optional)
Object Fields associated with this condition, i.e., likelihood

create_language_response - Up

request_id (optional)
language (optional)

create_package_response - Up

request_id
package
status_message (optional)
array[String] Messages indicating the status of the package upload.

create_project_response - Up

request_id
project
status_message (optional)
array[String] Messages indicating the status of the package upload.

create_taxonomy - Up

taxonomy_id
conditions

create_taxonomy_response - Up

request_id (optional)
taxonomy (optional)

created_package - Up

package_id
package_name
alert_mappings (optional)
map[String, alert_mappings] Alert IDs created in the DataHub

created_project - Up

project_id
project_name
meta_alert_mappings (optional)
map[String, meta_alert_mappings] Meta-Alert IDs created in the DataHub

determination - Up

flag_list (optional)
verdict_list (optional)
ignored_list (optional)
dead_list (optional)
inapplicable_environment_list (optional)
dangerous_construct_list (optional)
notes_list (optional)

determination_dangerous_construct_list - Up

dangerous_construct (optional)
timestamp (optional)
Date format: date-time

determination_dead_list - Up

dead (optional)
timestamp (optional)
Date format: date-time

determination_flag_list - Up

flag (optional)
timestamp (optional)
Date format: date-time

determination_ignored_list - Up

ignored (optional)
timestamp (optional)
Date format: date-time

determination_inapplicable_environment_list - Up

inapplicable_environment (optional)
timestamp (optional)
Date format: date-time

determination_notes_list - Up

notes (optional)
timestamp (optional)
Date format: date-time

determination_verdict_list - Up

verdict (optional)
timestamp (optional)
Date format: date-time

edit_package - Up

package_name (optional)
package_description (optional)
tool_ids (optional)
String List of new tools for this package
alerts (optional)

edit_package_response - Up

request_id
package_id
alert_mappings (optional)
status_message

edit_project - Up

project_name (optional)
project_description (optional)
taxonomy_ids (optional)
array[String] List of new taxonomies for this project
meta_alerts (optional)

edit_project_response - Up

request_id
project_id
meta_alert_mappings (optional)
status_message

error - Up

code
message

get_alerts_response - Up

request_id (optional)
meta_alerts (optional)
alerts (optional)

get_classifier_tool - Up

tool_id
tool_name
tool_version
category
source_mappings (optional)
metrics_data_headers (optional)
Object Header fields expected for the metrics data
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)

get_package_response - Up

request_id
package

get_projects_classifier_response - Up

request_id
projects

get_projects_response - Up

request_id
projects

get_taxonomy - Up

taxonomy_id
taxonomy_name
String Name of the taxonomy, i.e., CERT or CWE
taxonomy_version
description (optional)
conditions (optional)

get_taxonomy_response - Up

request_id
taxonomy

get_tool - Up

tool_id
tool_name
tool_version
category
checker_mappings (optional)
metrics_data_headers (optional)
Object Header fields expected for the metrics data
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)

get_tool_response - Up

request_id (optional)
tool (optional)

language_version - Up

language
version (optional)

language_version_w_id - Up

code_language_id
language
version (optional)

list_languages - Up

list_languages_response - Up

languages
request_id

list_packages - Up

list_packages_response - Up

packages
request_id

list_projects - Up

list_projects_response - Up

projects
request_id

message - Up

line_start
line_end (optional)
filepath

meta_alert_mappings - Up

condition_id
filepath
line_number

meta_alert_no_id - Up

condition_id
filepath
line_number
alert_ids (optional)
determination (optional)
auto_verdict (optional)

meta_alert_w_id - Up

meta_alert_id
condition_id
filepath
line_number
alert_ids (optional)
determination (optional)
auto_verdict (optional)

metrics - Up

package - Up

package_id
package_name
package_description (optional)
code_languages (optional)
alerts (optional)
code_metrics (optional)
test_suite_id (optional)
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)
tool_ids (optional)
created_at
Date format: date-time
updated_at (optional)
Date format: date-time

package_alerts - Up

package_alerts_w_id - Up

package_heading - Up

package_id
package_name
package_description
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)
code__languages (optional)

package_metadata - Up

package_name
package_description
author_source (optional)
code_language_ids
codesource_url (optional)
String URL to Source Code Archive format: uri
sourcefile_url (optional)
String format: uri
sourcefunction_url (optional)
String format: uri
test_suite_id (optional)
String Test Suite Associated with this Package
alerts (optional)
tool_ids (optional)
array[String] ID of the tools used with this Package

project - Up

project_id (optional)
project_name (optional)
project_description (optional)
package_id (optional)
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)
meta_alerts (optional)
taxonomies (optional)
created_at (optional)
Date format: date-time
updated_at (optional)
Date format: date-time

project_heading - Up

project_id
project_name
project_description (optional)
package_id
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)

project_heuristic_message - Up

project_id (optional)
project_updated (optional)
status_message (optional)

project_ids - Up

project_meta_alerts - Up

project_metadata - Up

project_name
project_description
author_source (optional)
package_id
meta_alerts (optional)
taxonomy_ids (optional)

project_status - Up

project_id
set_adaptive_heuristic_open

projects_requested - Up

taxonomies_present (optional)
project_ids

request_token - Up

request_id
String ID used to correlate messages with each other
message (optional)

secondary_messages - Up

secondary_messages_inner - Up

line_start
line_end (optional)
filepath
message_text

source_mappings - Up

mapping_source (optional)
checker_mappings (optional)

sourcefile - Up

sourcefile_id (optional)
filename (optional)
filepath (optional)
filepath_depth (optional)
defect_info (optional)
code_metrics_data (optional)
functions (optional)

sourcefunction - Up

name (optional)
line_start (optional)
line_end (optional)
code_metrics_data (optional)

taxonomies_present - Up

taxonomy_ids (optional)
array[String] List of taxonomies already present at the source module (Stats). The destination module (DataHub) will use this list to avoid sending duplicate taxonomy information.

taxonomy_heading - Up

taxonomy_id
taxonomy_name
taxonomy_version
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)

taxonomy_list_response - Up

request_id
taxonomies

taxonomy_metadata - Up

taxonomy_name
taxonomy_version
description
author_source (optional)
String Author/Agency source of the taxonomy information
conditions

test_suite_heading - Up

test_suite_id
test_suite_name
test_suite_version
manifest_urls (optional)
array[String] format: uri
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)
String Author/Agency source of the test suite information
code_languages (optional)

test_suite_list_response - Up

request_id
test_suites

test_suite_metadata - Up

test_suite_name
test_suite_version
manifest_urls (optional)
array[String] format: uri
use_license_file_url (optional)
String format: uri
author_source (optional)
String Author/Agency source of the test suite information
code_languages (optional)

test_suite_upload_response - Up

request_id
test_suite
status_message (optional)

tool_heading - Up

tool_id
tool_name
tool_version
code_language_ids (optional)
uploader_id (optional)
uploader_organization_id (optional)
author_source (optional)

tool_list_response - Up

request_id
tools

tool_metadata - Up

tool_name
tool_version
category
String The type of tool, e.g., FFSA or Metrics
code_language_ids (optional)
checker_mappings (optional)
array[checker_mappings_metadata] JSON-formatted checker_mappings
code_metrics_headers (optional)
Object Header fields expected for the metrics data

tool_response - Up

tool_id
tool_name
tool_version
category (optional)
code_language_ids (optional)

tool_taxonomies_present - Up

tool_ids (optional)
array[String] List of tools already present at the source module (Stats). The destination module (DataHub) will use this list to avoid sending duplicate tool information.
taxonomy_ids (optional)
array[String] List of taxonomies already present at the source module (Stats). The destination module (DataHub) will use this list to avoid sending duplicate taxonomy information.

tool_upload_response - Up

request_id
tool
status_message (optional)