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

# Enterprise quickstart

> Enable a tool and make your first paid API call from your server.

Make a search request through Locus and charge it to your workspace pool. You'll need an enterprise workspace and owner or admin access to create the key.

If you are connecting an agent, use the [agent connection guide](/locus-pro/connect-agents) for OAuth or a scoped service credential.

<Steps>
  <Step title="Open your workspace">
    Accept your evaluation or team invitation, sign in to the
    [dashboard](https://platform.paywithlocus.com), and select the enterprise
    workspace.
  </Step>

  <Step title="Create a server key">
    Open **API Keys** and create a secret key with `credits:move` for metered
    calls. Complete MFA or passkey verification when prompted. Save the
    returned value in your server's secret manager; it is shown once.

    ```bash theme={null}
    export LOCUS_SECRET_KEY="lcr_..."
    ```

    Keep this key on your server. Use OAuth for interactive agents and scoped
    Agent Connections for unattended agents.
  </Step>

  <Step title="Check your balance">
    Open **Funding & billing → Funding** and add credits if needed. An
    evaluation workspace may already have a promotional balance.
  </Step>

  <Step title="Enable a tool">
    Open **Agent tools**, find `tavily/search`, review its price, and enable it.
  </Step>

  <Step title="Make the call">
    ```bash theme={null}
    curl --fail-with-body -i -X POST \
      https://api.paywithlocus.com/api/wrapped/credits/tavily/search \
      -H "Authorization: Bearer $LOCUS_SECRET_KEY" \
      -H "Idempotency-Key: enterprise-quickstart-search-1" \
      -H "Content-Type: application/json" \
      -d '{"query":"recent primary-source announcements about coding agents"}'
    ```
  </Step>

  <Step title="Check the result and charge">
    The body contains the search result. Response headers show the charged
    credits and remaining balance. Open **Activity** to find the call and
    its cost.
  </Step>
</Steps>

<Tip>
  Reuse the same idempotency key when retrying this request. Choose a new key
  for a new search.
</Tip>

If the call fails, the response explains whether you need to enable the tool, add credits, or update access.

## Add customer billing

When you want customers to pay for their own usage, create end-user balances and set your markup. The [billing widget](/locus-pro/widget) adds balances and top-ups to your app using browser-safe credentials issued by your server.

<CardGroup cols={3}>
  <Card title="Funding and billing" icon="credit-card" href="/locus-pro/funding-and-billing">
    Configure customer balances, auto-recharge, and spending caps.
  </Card>

  <Card title="Recipes" icon="wand-magic-sparkles" href="/locus-pro/enterprise/recipes">
    Get complete research and enrichment outcomes through one call.
  </Card>

  <Card title="SDK" icon="cube" href="/locus-pro/sdk">
    Make calls from Node or TypeScript.
  </Card>
</CardGroup>