<h1 id="user-content-configure-the-mason-cli-with-an-api-key"><a href="#configure-the-mason-cli-with-an-api-key" aria-hidden="true" tabindex="-1"><span></span></a>Configure the Mason CLI with an API Key</h1>
<p>Some commands in the Mason CLI require a permissioned API Key. This guide will show you how to supply an API key to the Mason CLI.</p>
<h2 id="user-content-prerequisites"><a href="#prerequisites" aria-hidden="true" tabindex="-1"><span></span></a>Prerequisites</h2>
<ul>
<li><a href="/guides/install-cli">Install the Mason CLI</a></li>
<li><a href="/guides/create-a-api-key">Create an API Key</a></li>
</ul>
<h2 id="user-content-configuration"><a href="#configuration" aria-hidden="true" tabindex="-1"><span></span></a>Configuration</h2>
<p>There are three ways you can configure an API key with the Mason CLI</p>
<blockquote>
<p>the following options are checked on every Mason CLI command execution <strong>in the order they are listed</strong></p>
</blockquote>
<ol>
<li>
<p>Supply your API key on every command execution</p>
<pre><code>mason --api-key [APIKEY] ...
</code></pre>
</li>
<li>
<p>Supply your API key through an environment variable</p>
<pre><code>export MASON_API_KEY=[APIKEY]
</code></pre>
</li>
<li>
<p>Set your API key once and persist it across CLI sessions</p>
<blockquote>
<p>mason login is not available on Mason CLI versions 2.0 and higher, use an API key instead.</p>
</blockquote>
<pre><code>mason login --api-key [APIKEY]
</code></pre>
</li>
</ol>
<h2 id="user-content-support"><a href="#support" aria-hidden="true" tabindex="-1"><span></span></a>Support</h2>
<ul>
<li>Contact us at <a href="mailto:support@bymason.com">support@bymason.com</a></li>
</ul>


Some commands in the Mason CLI require a permissioned API Key. This guide will show you how to supply an API key to the Mason CLI.