API reference

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.

View as Markdown

These endpoints manage taps and require a management key (fhm_). Base URL: https://api.firehose.com. The same key also manages URL Watch subscriptions.

List taps

GET /v1/taps

{
  "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

POST /v1/taps
Content-Type: application/json
 
{ "name": "Brand Mentions" }

Returns 201 with the tap and its full token.

Get tap

GET /v1/taps/:id

Update tap

PUT /v1/taps/:id
Content-Type: application/json
 
{ "name": "New Name" }

Revoke tap

DELETE /v1/taps/:id

Returns 204 with no content.

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.