# Mobb REST API Guide

## Mobb REST API Documentation Page

Mobb REST API documentation can be accessed via the following URL:

<https://apidocs.mobb.ai>

## Getting started

### Generating Mobb API Token

To get started, you will need to generate a Mobb API Token in your Mobb organization. [Here is a quick guide on how to generate your own Mobb API Token](/mobb-user-docs/administration/access-tokens.md).

The "Authentications" section at the top of the [REST API Documentation](https://apidocs.mobb.ai/) page allows you to supply your Mobb API Token. This is useful later when sending test requests, as your API Token will be used in the headers to perform the request.

<figure><img src="/files/r2fGfUiGcmVY1xuvx5ko" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
(Optional) If you have a single tenant instance, you will also need to supply your tenant name here in the "tenant" field:

<img src="/files/Aub3jnOm1jDwEFZvY5y6" alt="" data-size="original">
{% endhint %}

## Testing API requests

To test sending a request, first locate the request you want to use, and use the "Test Request" button to open the request page.

<figure><img src="/files/4VRhg0UvWDEm9oomORgJ" alt=""><figcaption><p>Locating the Test Request Button</p></figcaption></figure>

Ensure your Mobb API Token is properly supplied in the "Authentications" field. Once you're ready, click "Send".

<figure><img src="/files/47z0hB8l9rkrKBJ92MLH" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
(Optional) For single tenant users, you may need to supply your tenant name again in the Test Request page under the "tenant" variable.

<img src="/files/XTBXhkIpfTPoKNt0mOOk" alt="" data-size="original">
{% endhint %}


---

# 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.mobb.ai/mobb-user-docs/mobb-rest-api.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.