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

# Oblique

> Connect Serval to Oblique to look up who has access, manage team membership and file access requests.

## About Oblique

The Oblique integration connects Serval to Oblique's public API. Workflows and the help desk agent can look up a user's teams and direct access, find teams, file team membership requests that Oblique's owners approve, and add or remove team members. Workflows you build can call any operation in the Oblique API.

**Authentication:** An Oblique API key. Serval stores the key securely and sends it as a bearer token only to the Oblique host you select: `us.oblique.security`, `eu.oblique.security`, or another host in the `oblique.security` domain that Oblique gave you.

**Data sync:** On demand. Serval calls Oblique when a workflow runs and does not perform a background sync.

## Create an API key

You must be an Oblique admin to create a key.

**1. Open API keys**

In Oblique, open the **API keys** page in the admin settings.

**2. Add a key**

Select **Add API key** and enter a name, such as Serval.

**3. Choose the permission**

Choose **Read-write** so Serval can add and remove team members and file requests. Choose
**Read-only** if Serval should only look up access; workflows that change Oblique then fail.

**4. Copy the key**

Select **Create key** and copy the key. Oblique shows it only once.

A key's name and permission can't be changed later. To change them, create a new key and delete the old one. See [Oblique's API key guide](https://docs.oblique.security/admin/keys/) for details.

## Connect in Serval

**1. Name the connection**

Enter a recognizable name, such as Production. Use a different name for each Oblique organization
you connect.

**2. Select the region**

Choose United States or Europe to match the address you sign in to Oblique at. If Oblique gave
you a different address, such as `testing.oblique.security`, choose **Other Oblique host** and
enter it.

**3. Enter the API key**

Paste the key and connect.

A connection stays with the region or host it was created for. To use a different one, create a new connection.

## Verify the connection

Serval checks that the key can list Oblique users and teams. A failed check usually means the key was deleted or mistyped, or the selected region or host doesn't match your Oblique organization.

## Workflows

| Workflow | What it does | Approval by default |
| - | - | - |
| Get Oblique User Access | Lists a user's teams, their integration accounts, and the resources granted directly to them or their accounts. | None |
| List Oblique Teams | Searches teams by display name. | None |
| Request Oblique Team Membership | Files a request for the team's owners to approve in Oblique. | Installer |
| Add User to Oblique Team | Adds a user to a team right away, granting the team's access. | Installer |
| Remove User from Oblique Team | Removes a user from a team right away, revoking the team's access. | Installer |

> [!NOTE]
>
> Requests filed through Serval list the API key's service account as the requester. Membership
> changes made with Add User to Oblique Team and Remove User from Oblique Team skip Oblique's
> request and approval flow, so keep their approval step in Serval.

***

Need help? Contact **[support@serval.com](mailto:support@serval.com)** for assistance with your Oblique integration.


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