> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobileboost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Authenticate and make your first API request

The MobileBoost API lets you manage tests, upload builds, trigger executions, and retrieve run results programmatically.

## Base URL

All API requests use the following base URL:

```
https://api.mobileboost.io
```

## Authentication

Authenticate every request by including a Bearer token in the `Authorization` header:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.mobileboost.io/tests
```

## Quick example

Create a test, upload a build, and trigger execution:

<Steps>
  <Step title="Create a test">
    ```bash theme={null}
    curl -X POST https://api.mobileboost.io/tests \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "title": "Login flow",
        "commands": ["Tap Log in", "Enter credentials", "Verify home screen"]
      }'
    ```
  </Step>

  <Step title="Upload a build">
    ```bash theme={null}
    curl -X POST https://api.mobileboost.io/uploadBuild/ \
      -H "Content-Type: multipart/form-data" \
      -F "build=@app.apk" \
      -F "organisation_key=org123" \
      -F "platform=android" \
      -F "metadata={}"
    ```
  </Step>

  <Step title="Execute tests">
    ```bash theme={null}
    curl -X POST https://api.mobileboost.io/tests/execute \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "organisationid": "org123",
        "uploadid": "BUILD_ID_FROM_STEP_2",
        "tags": ["smoke"]
      }'
    ```
  </Step>
</Steps>