# REST API

The HTTP REST API is the primary way to interact with the Dromt platform. It is used to create and manage resources such as drones, missions, and users.
It is available at [https://api.stream.dromt.it](https://api.stream.dromt.it).

## API Reference

* [Platform](https://docs.dromt.it/api/rest/platform.html)

## Authentication

To authenticate with the API, you need to provide a valid authentication token.
This token needs to be provided in the `Authentication` header of the request in the following format:

```
Authentication: Bearer <your token>
```

You can get a token for testing purposes by logging in to the [web interface](https://stream.dromt.it) and then retrieving it from the browser's local storage.
The token is stored in the `auth_access_token` key.

Alternatively, you can use the [Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication.html) APIs to authenticate and get a token.
The following example uses the [AWS CLI](https://aws.amazon.com/cli/) to authenticate and get a token:

```bash
aws cognito-idp initiate-auth \
    --auth-flow USER_PASSWORD_AUTH \
    --auth-parameters USERNAME=<your username>,PASSWORD=<your password> \
    --client-id <your client id> \
    --region <your region>
```

[Contact us](mailto:support@dromt.it) to get your client id and region.

## Organization

In the Dromt platform, an organization is a group of users that share a common set of resources.
Each user can belong to multiple organizations.
The organization is the main unit of access control in the platform.
Users can be granted access to resources in an organization by assigning them a read or write role.

If a request does not specify an organization, it is assumed to be in the user's default organization (the private organization that is created for each user).

You can specify the organization in the `Organization` header of the request in the following format:

```
Organization: <your organization id>
```