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

# AirysChat Platform APIs

# AirysChat Platform APIs

The AirysChat Platform APIs allow you to integrate a conversation management interface into your existing software stack. Installation admins can use these APIs to manage users, accounts, and roles. Additionally, these APIs can be used to sync authentication information from external systems into AirysChat.

> **Note:** These APIs are available only on `self-hosted` AirysChat installations.

## Creating a Platform App

To create a platform app, follow these steps:

1. Go to the super admin portal and navigate to `super_admin/platform_apps`.

   <img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/contributing-guide/images/platform-app/super_admin.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=8559ac591652fc9e00aae177625ddb62" alt="Super Admin Portal" width="2920" height="2316" data-path="contributing-guide/images/platform-app/super_admin.png" />

2. Click on the "New platform app" button.

   <img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/contributing-guide/images/platform-app/platform-home.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=73c279959bcaea56524f64e7b47dcbee" alt="Platform Apps Home" width="2924" height="2330" data-path="contributing-guide/images/platform-app/platform-home.png" />

3. Fill in the platform app name and click the "Create" button.

   <img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/contributing-guide/images/platform-app/platform-create.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=55f7593b3ca8276075fcfe7f7b68ee36" alt="Create Platform App" width="2918" height="2324" data-path="contributing-guide/images/platform-app/platform-create.png" />

4. After creating the platform app, open it to view and copy the access token.

   <img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/contributing-guide/images/platform-app/platform-access-token.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=198d156e2f276a3d0d8e50ae98166550" alt="Platform App Access Token" width="2922" height="2328" data-path="contributing-guide/images/platform-app/platform-access-token.png" />

## Using the Access Token

The `access_token` is required to authenticate all API requests. Please use the Postman collection to test these APIs.

### Testing the APIs

To test the APIs:

1. Copy the access token from the platform app.
2. Use it in the `Authorization` header of your API requests.

Here's an example of creating a user using the API:

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/contributing-guide/images/platform-app/create-user.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=24323e2309238992cc850f74cee7fa03" alt="Create User API" width="2794" height="2144" data-path="contributing-guide/images/platform-app/create-user.png" />

Similarly, you can create `Account` and `Role` entities using the APIs.

## Reference

For more detailed information and to test the APIs, refer to our [Postman Collection](https://www.postman.com/airyschat/workspace/airyschat-apis/collection/162770-e5451b69-9f97-489b-b352-4ca7d8d82aff).
