> ## Documentation Index
> Fetch the complete documentation index at: https://help.dsalta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage API overview

> Read your compliance program over the DSALTA Public API — controls, documents, frameworks, people, policies, tests, and vendors.

The DSALTA Public API gives you access to your compliance program: controls,
documents, frameworks, people, policies, tests, and vendors. Most endpoints are reads
(`GET`); the Documents API also supports adding files and links to a document and
removing a file. Every request is authenticated with a scoped API token.

## Base URL

All requests go to `https://apip.dsalta.com/v1`. Append the endpoint path, for example
`https://apip.dsalta.com/v1/frameworks`.

## Authentication

The API authenticates with a DSALTA API token, sent as a Bearer token in the
`Authorization` header on every request:

```bash theme={null}
curl https://apip.dsalta.com/v1/frameworks \
  -H "Authorization: Bearer <DSALTA_API_TOKEN>"
```

A request without a valid token returns `401 Unauthorized`. A token that lacks the
required scope (for example `frameworks:read`) returns `403 Forbidden`.

> [!TIP]
>
> In the interactive playground on each endpoint page, click **Authorize** and paste
> your API token once. It is then attached to every request you send from the docs.

## Pagination

List endpoints accept `page` and `limit` query parameters. `page` is the 1-based page
number and `limit` is the number of items per page.

```bash theme={null}
curl "https://apip.dsalta.com/v1/frameworks?page=1&limit=25" \
  -H "Authorization: Bearer <YOUR_TOKEN>"
```

## Errors

The API uses standard HTTP status codes. `2xx` means success and `4xx` means the
request was rejected.

| Status | Meaning |
| - | - |
| `200 OK` | The request succeeded. |
| `400 Bad Request` | The request body was malformed or missing required fields. |
| `401 Unauthorized` | The API token is missing, invalid, or expired. |
| `403 Forbidden` | The token is valid but lacks the scope required for this endpoint. |
| `404 Not Found` | The requested resource does not exist. |

## Explore the API

> [card] [Frameworks](https://help.dsalta.com/api-reference/frameworks/list-frameworks.md)
>
> List the compliance frameworks in your organization.

> [card] [Controls](https://help.dsalta.com/api-reference/controls/list-controls.md)
>
> Read your controls and their implementation status.

> [card] [Policies](https://help.dsalta.com/api-reference/policies/list-policies.md)
>
> Read the policies that back your controls.

> [card] [Vendors](https://help.dsalta.com/api-reference/vendors/list-vendors.md)
>
> Read the vendors tracked in your vendor risk program.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.