# Platform API Reference

## Platform API

The Platform API manages the organization and projects that hold your Event Gateway resources. Use it to read and update organization details, list and create projects, and manage organization API keys.

### Authentication

Platform endpoints authenticate with an organization-scoped API key — a key created at the organization level rather than inside a single project. Create one in your [organization API key settings](https://dashboard.hookdeck.com/settings/organization/api-keys), then pass it as a bearer token on every request.

An organization key is not limited to the Platform API. It can be granted a set of projects, and its scopes apply within each of them, so the same key can call Event Gateway endpoints in those projects when it carries the matching `gateway.*` scopes. A key created without an explicit scope list defaults to `*`, which reaches every project in the organization.

Organization endpoints require `organizations.read` or `organizations.write`, and project endpoints require `projects.read` or `projects.write`. A request whose key is missing the scope its route requires returns `403`.

```bash
curl "https://api.hookdeck.com/2026-09-01/projects"
  -H "Content-Type: application/json"
  -H "Authorization: Bearer $ORGANIZATION_API_KEY"

```

### Base URL

Platform endpoints share the base URL and versioning of the Hookdeck REST API:

```
https://api.hookdeck.com/2026-09-01

```

## API Resources

### Organizations

* [Organizations](/docs/platform/api/organizations.md)
  * [Organizations](/docs/platform/api/organizations.md#organizations)

### Projects

* [Projects](/docs/platform/api/projects.md)
  * [Projects](/docs/platform/api/projects.md#projects)