# Authentication

### Authentication Method

All requests must be made over HTTPS and will be authenticated over standard [HTTP basic authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).

### API Authentication Key

Authentication requires a `x-api-key`. When these values are requested in console/terminal, programming libraries, SDKs, or even here in our docs, use the following values for `x-api-key:`

| Key       | Value      |
| --------- | ---------- |
| x-api-key | {API\_KEY} |

{% hint style="warning" %}
The API key must be kept secret. They should not be in your client-side code or checked into your application's code.
{% endhint %}

### Example Requests

<pre data-title="Ping Request"><code>curl --request GET \
<strong>    -u x-api-key:API_KEY \
</strong>    --url {Sanbox_URL}/api/ping
</code></pre>

### Current API Key

{% code title="Current API Key Request" %}

```
curl --request GET \
  -u x-api-key:API_KEY \ 
  --url {Sanbox_URL}/api/api_keys/current
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.senmo.io/topics/authentication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
