Uploading an OpenAPI/Swagger Definition via API

The following steps allow organizations to automatically upload API definitions (OpenAPI, Swagger) to the Data Theorem platform, in order to onboard and scan the corresponding APIs.

Step 1: Retrieving an API key

You will first need to retrieve an API key from the Data Theorem portal, at https://www.securetheorem.com/sdlc/api_access. The API key should have the "API Security Results API" setting enabled:

Step 2: Uploading an API definition using curl

The following curl command can then be used to upload an OpenAPI or Swagger definition to the Data Theorem platform, in order to onboard and scan the corresponding APIs:

curl \
    -H "Authorization: APIKey <enter your API key>" \
    -d @openapi.json \
    "https://api.securetheorem.com/apis/api_security/results/v1beta1/openapi_definitions"