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

# Superhuman Docs

> Search and manage documents, pages, tables, and rows in Superhuman Docs.

export const flowWebUrl = "https://app.letsflow.ai";

Connect Superhuman Docs to run document and table actions from Flow automations. Choose which teams can use the connection. Enable Automation for a team before it can run Superhuman Docs actions.

<Tabs>
  <Tab title="API token">
    ### Prepare in Superhuman Docs

    Create an API token in [Superhuman Docs account settings](https://docs.superhuman.com/account). In **API settings**, select **Generate API token**. Give the token a name and choose restrictions for the documents your automations need. Copy the generated token.

    The token uses your Superhuman Docs account permissions. Write actions need write access to the target document. See [Superhuman Docs API token setup](https://help.superhuman.com/hc/en-us/articles/46210093335949-Manage-your-Superhuman-Docs-account-settings).

    ### Connect in Flow

    <Steps>
      <Step title="Find the Superhuman Docs integration">
        1. Open **Integrations**.
        2. Choose **Add connection**.
        3. In **Add connection**, search for **Superhuman Docs**.
        4. Select the **Superhuman Docs** card.

        <a className="flow-app-link" href={flowWebUrl}>
          Open Flow

          <svg aria-hidden="true" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <path d="M7 7h10v10" />

            <path d="M7 17 17 7" />
          </svg>
        </a>
      </Step>

      <Step title="Connect">
        1. Pick the team that will use the connection.
        2. Give the connection a name and select **Continue** through the setup steps.
        3. Select **Connect** to open the credential form.
        4. Enter your Superhuman Docs API token and submit the form.
        5. After connection completes, enable **Automation** for each team that needs it.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Permissions and scopes

This integration does not define provider scopes.

## Supported actions

| Action | Description | <Tooltip tip="Risk estimates the impact of the action. Low reads provider data, medium changes existing records, and high can grant access, remove data, disable resources, or make broad changes.">Risk</Tooltip> |
| - | - | - |
| Add permission | Grant a user or group access to a Superhuman Docs document. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Create doc | Create a Superhuman Docs document for an operational automation or service process. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Delete permission | Revoke doc access during offboarding or remediation; approval is required. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Get a row | Retrieve a specific row to verify current state before acting. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Insert/upsert rows | Create or idempotently upsert ITSM and administrative records in a Superhuman Docs table. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| List available docs | Discover Superhuman Docs documents that host ITSM and administrative automations. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| List columns | Discover column identifiers needed to read and mutate structured records safely. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| List permissions | Audit current sharing permissions before access changes or deprovisioning. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| List tables | Locate the table backing tickets, assets, requests, or other operational records. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| List workspace users | List workspace members for access audits and role-change targeting. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Push a button | Push a Superhuman Docs button to invoke a row-level workflow such as approval or remediation. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Search principals | Resolve Superhuman Docs principals before granting or revoking document permissions. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Trigger automation | Trigger a configured Superhuman Docs automation rule from an ITSM flow. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Update doc | Update core doc metadata used to maintain an operational workspace. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Update row | Update status, assignee, approval, resolution, or closure fields on a record. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Updates user role | Change a Superhuman Docs workspace member’s role for provisioning or least-privilege remediation; approval is required for privilege changes. | <Badge color="red" size="sm" shape="pill">high</Badge> |


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