---
title: API profile
description: Canonical makes open source secure, reliable and easy to use, providing
  support for Ubuntu and a portfolio of enterprise-grade technologies. Founded in
  2004, Canonical operates globally with team members in over 80 countries.
url: https://canonical-com-2934.demos.haus/maas/docs/profile?format=md
---

*Submit*

# API profile

In the MAAS CLI, an **API profile** represents a stored set of credentials and connection details for a specific MAAS server. Profiles enable users to manage multiple MAAS environments efficiently by maintaining separate authentication contexts.

## [Managing API profiles:](https://canonical-com-2934.demos.haus/maas/docs/profile?format=md#p-23225-managing-api-profiles)

* **Login** – Authenticate and create a profile using the `login` command.
* **List** – Display all stored profiles with the `list` command.
* **Switch** – Execute commands under a specific profile by prefixing the profile name to a command invocation.
* **Refresh** – Update the CLI’s cached information about the MAAS server’s API with the `refresh` command.
* **Logout** – Remove a profile and its credentials using the `logout` command.

Interact seamlessly with multiple MAAS environments by defining and managing profiles carefully.

---

[Previous

API login](https://canonical-com-2934.demos.haus/maas/docs/how-to-authenticate-to-the-maas-api)
[Next

API reference](https://canonical-com-2934.demos.haus/maas/docs/api)

Last updated 1 year, 6 months ago. [Help improve this document in the forum](https://discourse.maas.io/t/api-profile/11347).
