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

# Overview

> Base URL, authentication, pagination, and error handling for the Atlas API.

## Base URL

All API endpoints are available under:

```
https://nokia.atlas.arenaphysica.com/api/v1/
```

## Authentication

Every request requires a Bearer token in the `Authorization` header:

```bash theme={null}
curl https://nokia.atlas.arenaphysica.com/api/v1/systems \
  -H "Authorization: Bearer <your-token>"
```

Requests without a valid token return `401 Unauthorized`. See [Authentication](/getting-started/authentication) for how to obtain a token.

## Pagination

List endpoints support `limit` and `offset` query parameters:

| Parameter | Default | Description                 |
| --------- | ------- | --------------------------- |
| `limit`   | 50      | Number of results to return |
| `offset`  | 0       | Number of results to skip   |

```bash theme={null}
curl "https://nokia.atlas.arenaphysica.com/api/v1/issues?limit=20&offset=40" \
  -H "Authorization: Bearer <your-token>"
```

## Errors

All errors return a JSON response body with a `detail` field:

```json theme={null}
{
  "detail": "Not found."
}
```

| Status code | Meaning                                       |
| ----------- | --------------------------------------------- |
| `400`       | Bad request: check request body or parameters |
| `401`       | Unauthorized: missing or invalid token        |
| `403`       | Forbidden: insufficient permissions           |
| `404`       | Not found                                     |
| `422`       | Unprocessable entity: validation error        |
| `500`       | Server error                                  |

## Soft deletes

Most delete endpoints soft-delete resources. They are excluded from list responses but remain in the database. Some resources have a corresponding restore endpoint.

## Content type

For all `POST`, `PUT`, and `PATCH` requests with a request body, set:

```
Content-Type: application/json
```

File uploads use `multipart/form-data`.