# StepSecurity API (Tenant Access)

{% hint style="info" %}
This page covers API access for managing all organizations under your tenant. If you only need access for a single organization, refer to [this page](/administration/settings/stepsecurity-api-org-access.md)
{% endhint %}

To access and interact with StepSecurity’s API, you must obtain an API key. StepSecurity provides both Tenant API keys for full access and read-only API keys for safely retrieving data without making changes. Use your Tenant’s API key management features, including key rotation, for secure handling. The API key enables you to authenticate requests and explore available endpoints through the Swagger documentation.

### Authorizing API Access in StepSecurity

#### Step 1: Navigate to the API Key Section

* Under Integrations, select StepSecurity API

<figure><img src="/files/EYLb12V8LatY3KC8Bruu" alt=""><figcaption></figcaption></figure>

#### Step 2: Copy the API Key

<figure><img src="https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-03-05/72f6f66e-686b-43bc-93d6-79ec77b0683a/ascreenshot.jpeg?tl_px=1144,0&#x26;br_px=2395,699&#x26;force_format=jpeg&#x26;q=100&#x26;width=1120.0&#x26;wat=1&#x26;wat_opacity=1&#x26;wat_gravity=northwest&#x26;wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/8B5CF6_standard.png&#x26;wat_pad=524,254" alt="API settings showing Swagger documentation"><figcaption><p>API Settings</p></figcaption></figure>

#### Step 3: Click `Authorize` on the API documentation section.

<figure><img src="https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-03-05/d0aeb14a-f45f-4dca-992c-060f0bf0cc46/ascreenshot.jpeg?tl_px=1479,534&#x26;br_px=3008,1389&#x26;force_format=jpeg&#x26;q=100&#x26;width=1120.0&#x26;wat=1&#x26;wat_opacity=1&#x26;wat_gravity=northwest&#x26;wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/8B5CF6_standard.png&#x26;wat_pad=916,277" alt="API settings showing Swagger documentation"><figcaption><p>API Settings</p></figcaption></figure>

#### Step 4: Paste Your API Key

* A pop-up window will appear.
* Paste the copied API key into the Value field.
* Click `Authorize`.

<figure><img src="https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-03-05/110f10bb-f33d-42e9-82fe-08e9357742d3/ascreenshot.jpeg?tl_px=303,444&#x26;br_px=2268,1543&#x26;force_format=jpeg&#x26;q=100&#x26;width=1120.0&#x26;wat=1&#x26;wat_opacity=1&#x26;wat_gravity=northwest&#x26;wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/8B5CF6_standard.png&#x26;wat_pad=524,276" alt="API settings showing Swagger documentation"><figcaption><p>API Settings</p></figcaption></figure>

#### Step 5: Test API Endpoints

* Select an API endpoint from the documentation.
* Click `Try it out`.
* Fill in any required parameters.
* Click Execute to send the request.

<figure><img src="https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-03-05/af6b90fe-e8b3-4581-871e-662f3eb249b4/ascreenshot.jpeg?tl_px=1757,696&#x26;br_px=3008,1395&#x26;force_format=jpeg&#x26;q=100&#x26;width=1120.0&#x26;wat=1&#x26;wat_opacity=1&#x26;wat_gravity=northwest&#x26;wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/8B5CF6_standard.png&#x26;wat_pad=901,277" alt="API settings showing Swagger documentation"><figcaption><p>API Settings</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stepsecurity.io/administration/admin-console/integrations/stepsecurity-api-tenant-access.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.