Knock

Knock Subscriptions API

The Subscriptions API from Knock — 4 operation(s) for subscriptions.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /v1/objects/{collection}/{object_id}/subscriptions Unsubscribe recipients from an object · Delete subscriptions #

Ask an LLM

“How do I unsubscribe users from an object?”

“Does removing subscriptions return what was deleted?”

Tell an agent destructive · confirm first

Unsubscribe {recipients} from object {object_id} in {collection}.

Remove {recipients}' subscriptions to {collection}/{object_id}.

GET /v1/objects/{collection}/{object_id}/subscriptions List an object's subscriptions · List subscriptions #

Ask an LLM

“Who is subscribed to a given object, like a project or channel?”

“Can I list the objects an object itself subscribes to?”

Tell an agent

List subscribers of object {object_id} in {collection}.

List {collection}/{object_id} subscriptions in mode {mode}.

POST /v1/objects/{collection}/{object_id}/subscriptions Subscribe recipients to an object · Add subscriptions #

Ask an LLM

“How do I subscribe users to an object so they get its notifications?”

“Can I attach custom properties to a subscription?”

Tell an agent

Subscribe {recipients} to object {object_id} in {collection}.

Add {recipients} as subscribers of {collection}/{object_id} with properties {properties}.

GET /v1/users/{user_id}/subscriptions List a user's subscriptions · List user subscriptions #

Ask an LLM

“Which objects is a particular user subscribed to?”

“Can I check whether a user subscribes to specific objects?”

Tell an agent

List subscriptions for user {user_id}.

Show whether user {user_id} subscribes to {objects}.

Documentation

https://docs.knock.app/api-reference/workflows

https://docs.knock.app/send-notifications/triggering-workflows/api

https://docs.knock.app/api-reference/users

https://docs.knock.app/api-reference/messages

https://docs.knock.app/api-reference/objects

https://docs.knock.app/api-reference/tenants

https://docs.knock.app/api-reference/schedules

https://docs.knock.app/concepts/schedules

https://docs.knock.app/api-reference/audiences

https://docs.knock.app/api-reference/channels

https://docs.knock.app/api-reference/providers

https://docs.knock.app/api-reference/integrations

https://docs.knock.app/api-reference/bulk_operations

https://docs.knock.app/mapi

https://docs.knock.app/developer-tools/management-api

Specifications

https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/openapi/knock-app-subscriptions-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/json-schema/knock-workflow-trigger-schema.json

https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/json-schema/knock-message-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/examples/knock-trigger-workflow-example.json

https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/examples/knock-identify-user-example.json

https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/examples/knock-create-schedule-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/knock-app:knock-app-subscriptions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Knock App Subscriptions API
  version: '1.0'
  contact:
    name: Knock
    url: https://knock.app
  license:
    name: Proprietary
  description: 'Operations tagged Subscriptions across 2 of this provider''s published API definitions: knock-objects-api-openapi.yml, knock-users-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.knock.app
  variables: {}
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/knock-app/refs/heads/main/openapi/knock-app-subscriptions-api-openapi.yml