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

# Anaconda Desktop API

The Anaconda Desktop API provides a programmatic interface for managing models. It provides a complete infrastructure for downloading, hosting, and serving models on your own hardware.

## Configuring the Desktop API

To access your Desktop API key and API server port:

1. Select the user dropdown menu in the upper-right corner.
2. Select  *Settings*.
3. Navigate to the *Desktop API Configurations* section.

From the configurations section, you can  **View**,  **Copy**, and  **Rotate** your API key, configure your API server port, and access interactive API documentation.

## Making your first request

### Understanding your server configuration

Your Desktop API server runs locally on your machine at the address `localhost` (also written as `127.0.0.1`).

The **Settings** page shows two additional key pieces of information you'll need:

* **Server port**: The port number where your server listens for requests.
* **API key**: Used for authentication in your requests.

Your base URL combines the server address and port. For example: `http://localhost:8001/`

### Testing your connection

To test your connection to the Desktop API server, open Anaconda Prompt (A command-line application included with Windows installations of Anaconda Distribution and Miniconda. Find it by searching 'Anaconda Prompt' in the Windows Start menu.) (Terminal on macOS/Linux) and run the following command:

```sh Anaconda Prompt theme={null}
curl --request GET ^
    --url http://localhost:8001/api/models/health ^
    --header 'Authorization: Bearer <API_KEY>' ^
    --header "Content-Type: application/json" ^
```

```sh Anaconda PowerShell Prompt theme={null}
curl --request GET `
    --url "http://localhost:8001/api/models/health" `
    --header "Authorization: Bearer <API_KEY>" `
    --header "Content-Type: application/json"
```

```sh Terminal  theme={null}
curl --request GET \
    --url "http://localhost:8001/api/models/health" \
    --header "Authorization: Bearer <API_KEY>" \
    --header "Content-Type: application/json"
```

Comments

Replace \<API\_KEY> with the API key listed on the  **Settings** page.

The API should return `/api/models/health ok`. If you receive an error, verify your API key and port number match what's on the **Settings** page, then try again.
