REST API (Beta)
Use the Panther REST API to interact with your Panther entities
Last updated
Was this helpful?
Use the Panther REST API to interact with your Panther entities
Last updated
Was this helpful?
Panther offers a REST API to interact with certain parts of your Panther instance. Currently, you can interact with the following entities through the REST API:
Discover the REST API schema by downloading the OpenAPI specification file:
To locate your REST API URL:
In the upper-right corner of your Panther Console, click the gear icon, then API Tokens. At the top of the page, see the API URL.
Note that all REST URLs exclude /public/graphql
from the end of the value.
Additional operations are available in the .
You can discover the API schema by browsing the API Playground in your Panther Console. Learn more on .
If you are running a deployment of Panther, your REST URL will be the portion shown below:
If you are running a or deployment of Panther, the URL will be the portion shown below (inclusive of /v1
):
See . You can find required permissions for each REST API operation on each entity's page (nested under this one).
In addition to testing with the in the Console, you can invoke the REST API using Swagger, Postman, or this documentation:
In a web browser, navigate to the .
In the code editor on the left-hand side, paste in the Panther REST OpenAPI specification file found above, in .
On the right-hand side, under Server variables, in api_host, enter your Panther REST API URL without the protocol (i.e., excluding https://
).
Click Authorize.
Click Close.
Click Try it out.
Click Environments, then click the plus sign (+).
You can find this value by following the instructions in .
In the upper-right hand corner, click the environment dropdown, and select the one you created in the previous step.
In the modal that pops up, in the endpoint displayed at the top, click {api_host}
.
In the api_host field, enter the REST API URL you identified in , without the protocol (i.e., excluding https://
).
Under Required authentication, check the box next to ApiKeyAuth.
Under Authentication, Name and Value fields will populate. In Value, enter the API token you generated in .
In the Variables section, if the operation has required path variables, such as {id}
, provide value(s) in the VALUE
column.
If there are values in the Query Parameters section, if you would like them to apply to this invocation, click their checkboxes in the right-hand column.