API Use Cases

Includes practical uses for our API.

The pages in this book describe how you can work with the Cobalt platform using our API.

This document assumes that you can run curl in a command line on your system. You can also set up the REST calls in this book in other API clients such as:

If you run curl from the command line, we recommend that you use the jq command line JSON processor to format output.

Format JSON Responses

Without the | jq., you may have output that looks like:


If you add a | jq . to the end of your REST call, you may find it easier to read the output:

  "pagination": {
    "next_page": null,
    "prev_page": null
  "data": [
      "resource": {
        "id": "YOUR-ORG-ID",
        "name": "ORG-NAME",
        "token": "YOUR-V2-ORGANIZATION-TOKEN"
      "links": {
        "ui": {
          "url": "URL-WITH-YOUR-PENTESTS"

For your convenience, we include | jq . in all of our sample REST calls that provide actual output.

Create or Modify an Asset

Run this sequence of REST calls to create an asset.

Was this page helpful?

Yes No Create an Issue

Last modified August.08.2022