Documentation Index
Fetch the complete documentation index at: https://docs.endorlabs.com/llms.txt
Use this file to discover all available pages before exploring further.
This article describes how to quickly get started with the Endor Labs REST API using the Endor Labs command line tool endorctl or curl. For a more detailed guide, see Getting started with the REST API.
The following is an example request to get the number of findings in your namespace:
- Run
endorctl init and your browser window will open automatically. Select your authentication provider from the available options and complete the authentication process.
You can also specify your supported authentication provider manually.endorctl init --auth-mode google
- Use the
endorctl command-line tool to make your request. Note that you do not have to provide the namespace or access token when using endorctl to access the Endor Labs REST API. For more information, see the Endor Labs CLI documentation.
endorctl api list -r Finding --count
-
Install
curl if it isn’t already installed on your machine. To check if curl is installed, execute curl --version on the command line. If the output provides information about the version of curl, that means curl is installed. If you get a message similar to command not found: curl, you need to download and install curl. For more information, see the curl project download page.
-
Run
endorctl init and your browser window will open automatically. Select your authentication provider from the available options and complete the authentication process.
You can also specify your supported authentication provider manually.endorctl init --auth-mode google
- Create an access token. The access token produced below has the same scopes/permissions as the API key created through
endorctl init. Treat your access token like a password. For more information, see Authentication.
export ENDOR_TOKEN=$(endorctl auth --print-access-token)
- Use the Curl command to make your request. Pass your token in an Authorization header. The following is an example request to get the number of findings in a given namespace. If needed, replace
$ENDOR_NAMESPACE with the name of your namespace, or export it as a variable using export ENDOR_NAMESPACE=<insert-namespace>.
curl --get \
--header "Authorization: Bearer $ENDOR_TOKEN" \
--compressed \
--url "https://api.endorlabs.com/v1/namespaces/$ENDOR_NAMESPACE/findings?list_parameters.count=true"
