Knock

Knock Tenants API

The Tenants API from Knock — 4 operation(s) for tenants.

Documentation GitHub OpenAPI

Business capability

Tenant Provisioning & Lifecycle BC-4230.10

Operations 6

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/tenants/{id} Delete a tenant and its data · Delete a tenant #

Ask an LLM

“How do I delete a tenant and everything associated with it?”

“Can a deleted tenant be recovered?”

Tell an agent destructive · confirm first

Delete tenant {id}.

Permanently remove tenant {id} and its data.

GET /v1/tenants/{id} Get a tenant · Get a tenant #

Ask an LLM

“How do I look up a tenant's name and settings?”

“Can I see a tenant's fully resolved preference settings?”

Tell an agent

Get tenant {id}.

Show tenant {id} with resolved preference settings {resolve_full_preference_settings}.

PUT /v1/tenants/{id} Create or update a tenant · Set a tenant #

Ask an LLM

“How do I create a tenant for one of my customer organizations?”

“Are existing tenant properties merged or replaced when I set it?”

Tell an agent

Set tenant {id} with name {name}.

Update tenant {id}'s settings to {settings}.

GET /v1/tenants List tenants · List tenants #

Ask an LLM

“Which tenants exist in this environment?”

“Can I search tenants by name?”

Tell an agent

List all tenants.

Find tenants named {name}.

POST /v1/tenants/bulk/delete Delete many tenants at once · Bulk delete tenants #

Ask an LLM

“How do I delete up to 1,000 tenants in a single request?”

“Is a bulk tenant delete permanent?”

Tell an agent destructive · confirm first

Bulk delete tenants {tenant_ids}.

Permanently remove all of these tenants at once: {tenant_ids}.

POST /v1/tenants/bulk/set Create or update many tenants at once · Bulk set tenants #

Ask an LLM

“How do I sync a large batch of tenants in one call?”

“Can I upsert many tenants' names and settings together?”

Tell an agent

Bulk set tenants {tenants}.

Create or update this batch of tenants: {tenants}.

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-tenants-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-tenants-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 Tenants API
  version: '1.0'
  description: Manage Tenants — the top-level accounts or workspaces in your product. Tenants power tenant-scoped branding, preferences, and message-targeting.
  contact:
    name: Knock
    url: https://knock.app
  license:
    name: Proprietary
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-tenants-api-openapi.yml