> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/getting-started/authentication.md).

# Authentication

Authenticate your API requests

The Parvenu API uses an API Key and username to authenticate requests.

You can view and manage your access tokens in [Settings → API key](https://app.parvenu.io/app/settings/profile?tab=api-key) of your Parvenu account and clicking "Generate key".

<figure><img src="https://3434919419-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtEPKyiBTVBwkpn21HLwD%2Fuploads%2FwZBTR8J7c3tUR0fsestZ%2Fimage.png?alt=media&#x26;token=203e19b9-2fd0-413f-a912-ad212be0b4c2" alt=""><figcaption><p>API Key</p></figcaption></figure>

{% hint style="warning" %}
Please be sure to keep your API access tokens secure! Do not share them in emails, chat messages, client-side code or publicly accessible sites.
{% endhint %}

Access tokens are tied to the Parvenu user account for which they were created. **An API key provides the same level of access & privileges that its associated Parvenu user account would have.**

API requests are authenticated in the body. To authenticate a request, provide the API Key, username associated with your account, and email associated with your account.

## Base URL

<mark style="color:green;">`POST`</mark> `https://api.parvenu.io/`

Base URL and authentication schema.

## If the key is missing

Leave `api_key` out of the body and the call comes back in the standard error shape:

```json
{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "api_key: Field required"
  },
  "success": false
}
```

Every endpoint answers in the same envelope, success or failure. See [Response Format](/getting-started/response-format.md).