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

# Welcome

> Public Meridian API surfaces for OAuth, bot status, and webhooks.

The Meridian API product covers the public HTTP surfaces you can call from your own apps and monitors.

<Columns cols={2}>
  <Column>
    <Card title="Trigger webhook events" icon="wifi">
      Trigger a bot's webhook event by sending a request to it's domain.
    </Card>
  </Column>

  <Column>
    <Card title="Health" icon="heart">
      Get the health status of any webhook gateway using a simple API call.
    </Card>
  </Column>
</Columns>

<Columns cols={2}>
  <Column>
    <Card title="OAuth API" icon="key">
      Authorization code flow for third-party apps that act on a Meridian user's account.
    </Card>
  </Column>

  <Column>
    <Card title="Bot status API" icon="signal">
      Public JSON status for a bot when the owner enables the public status endpoint.
    </Card>
  </Column>
</Columns>

## Hosts

| Host                                                       | What it serves                                  |
| ---------------------------------------------------------- | ----------------------------------------------- |
| [developer.meridian.surf](https://developer.meridian.surf) | OAuth application portal                        |
| `meridian.surf`                                            | OAuth consent/token/userinfo, bot status JSON   |
| `api.meridian.surf`                                        | Bot HTTP webhooks, webhook health, OpenAPI spec |

<Note>
  Meridian OAuth is separate from the [Discord Developer Portal](https://discord.com/developers/applications), which is for Discord bot tokens and Discord application settings.
</Note>