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

# Tray.ai

> Learn how to connect your Opal instance with Tray.ai Cloud.

Opal's integration with Tray.ai allows you to manage access to the Tray.ai organization and workspaces.

## Supported resources

| Resource | Read | Manage access levels | Grant and revoke access |
| - | - | - | - |
| Tray.ai Organization | ✔️ | ✔️ | |
| Tray.ai Workspace | ✔️ | ✔️ | ✔️ |

## Requirements

Before you begin, you must:

* Be an Opal Admin
* Be on version `1.1256.0`, if you self-host Opal

## 1. Create a Tray API user and API token

To allow Opal to access and manage your Tray roles and workspaces, you must first create an [API token](https://tray.ai/documentation/platform/enterprise-core/organisation-management/api-users-tokenshttps://tray.ai/documentation/platform/enterprise-core/organisation-management/api-users-tokens). You will only be shown the API token on creation, so save it for the next steps.

In **Account Settings > Tokens** under **API users** select the **Create API user** option:

* Name: A suitable name
* Organization role: Either is fine, as you will edit it later
* Workspace: Any workspace
* Workspace Role: Any role

Once you click the Next button, a new window will open for creating an API token.

Provide a suitable Token name and set token expiration period.

Make sure to copy and save the newly created token securely.

You will not be able to view the token again.

Once this is done, edit the API user's organization role and workspace role and set it to `admin`

## 2. Create Tray.ai app in Opal

In Opal, go to **Inventory** > **+App** and select **Tray**. Name your Tray app, provide a description, and enter the API token you generated in step 1.

After you save the app, you can import workspaces and roles from **...** > **Import items**.

## Organization management

Once a user is synced from Tray into Opal, admins can manage the user's access level (admin, member or guest). Opal does not support user provisioning for Tray.ai, so users cannot be added or removed from the Tray organization through Opal.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.