# Management-key endpoints

> List, create, fetch, update, and revoke taps over HTTP with an organization management key (fhm_), with the request and response shape for each call.

These endpoints manage **taps** and require a [management key](/organizations/management-keys)
(`fhm_`). Base URL: `https://api.firehose.com`. The same key also manages
[URL Watch subscriptions](/api-reference/url-watch-endpoints).

## List taps

```text
GET /v1/taps
```

```json
{
  "data": [
    {
      "id": "uuid",
      "name": "Brand Mentions",
      "token": "fh_full_tap_token",
      "token_prefix": "fh_abc",
      "rules_count": 3,
      "last_used_at": null,
      "created_at": "2026-02-27T00:00:00+00:00"
    }
  ]
}
```

Returns each tap's full token, so one key is enough to enumerate taps and start streaming.

## Create tap

```text
POST /v1/taps
Content-Type: application/json

{ "name": "Brand Mentions" }
```

Returns `201` with the tap and its full `token`.

## Get tap

```text
GET /v1/taps/:id
```

## Update tap

```text
PUT /v1/taps/:id
Content-Type: application/json

{ "name": "New Name" }
```

## Revoke tap

```text
DELETE /v1/taps/:id
```

Returns `204` with no content.

<Callout type="info">
  The complete, machine-readable reference (every field, the full query grammar, and all category
  and type values) is published as raw Markdown at [`/skill.md`](https://docs.firehose.com/skill.md).
</Callout>