Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Knock Guides API

Guides let you define in-app guides that can be displayed to users based on priority and other conditions.

Knock Guides API is one of 35 APIs that Knock publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Guides. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

This API exposes 15 operations across 12 paths, and defines 13 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.knock.app.

15 operations 12 paths 13 schemas 2 DELETE3 GET10 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Server
https://api.knock.app
Authentication
HTTP Bearer
Contact
License
Proprietary
Resource Areas
1

Authentication & Security 1

Knock Guides API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Knock API key as a Bearer token. Use a public key (pk...) for client-side requests or a secret key (sk...) for server-side.

Paths & Operations 15

Across 12 paths, the API surfaces 15 operations — 2 DELETE, 3 GET, 10 PUT. Each is listed below with its method, path, parameters, and response codes.

Guides 15

Guides let you define in-app guides that can be displayed to users based on priority and other conditions.

DELETE
/v1/guides/{guide_key}
Archive a guide
archiveGuide 1 param → 200
GET
/v1/guides/{guide_key}
Get a guide
getGuide 5 params → 200
PUT
/v1/guides/{guide_key}
Upsert a guide
upsertGuide 7 params body → 200
GET
/v1/guides
List guides
listGuides 7 params → 200
PUT
/v1/guides/{guide_key}/activate
Activate a guide
activateGuide 3 params body → 200
PUT
/v1/guides/{guide_key}/validate
Validate a guide
validateGuide 3 params body → 200
PUT
/v1/users/{user_id}/guides/messages/seen
Mark guide as seen
markUserGuideAsSeen (2) 1 param body → 200
PUT
/v1/users/{user_id}/guides/messages/{message_id}/seen
Mark guide as seen
markUserGuideAsSeen 1 param body → 200
DELETE
/v1/users/{user_id}/guides/messages/archived
Mark guide as unarchived
markUserGuideAsUnarchived 1 param body → 200
PUT
/v1/users/{user_id}/guides/messages/archived
Mark guide as archived
markUserGuideAsArchived (2) 1 param body → 200
PUT
/v1/users/{user_id}/guides/messages/interacted
Mark guide as interacted
markUserGuideAsInteracted (2) 1 param body → 200
PUT
/v1/users/{user_id}/guides/engagements/reset
Reset guide engagement
resetUserGuideEngagement 1 param body → 200
GET
/v1/users/{user_id}/guides/{channel_id}
List guides
listUserGuides 5 params → 200
PUT
/v1/users/{user_id}/guides/messages/{message_id}/interacted
Mark guide as interacted
markUserGuideAsInteracted 1 param body → 200
PUT
/v1/users/{user_id}/guides/messages/{message_id}/archived
Mark guide as archived
markUserGuideAsArchived 1 param body → 200

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are Guide (18 properties), GuideRequest (9 properties), GuideActionRequest (9 properties), GuideStep (6 properties). Each schema is shown below with its type and property counts.

Guide
object
A guide defines an in-app guide that can be displayed to users based on priority and other conditions.
18 properties 7 required
Condition
object
A condition to be evaluated.
3 properties 2 required
ConditionGroup
object
A group of conditions to be evaluated.
ConditionGroupAllMatch
object
A group of conditions that must all be met.
1 property
PageInfo
object
The information about a paginated result.
3 properties 1 required
GuideRequest
object
A request to create or update a guide.
9 properties 3 required
GuideStep
object
A step in a guide that corresponds to a piece of UI and its content.
6 properties 4 required
GuideActivationParams
object
A request to activate or schedule the activation of a guide.
GuideActionRequest
object
A request to trigger a guide action.
9 properties 4 required
GuidesResponse
object
A response for a list of guides.
4 properties 4 required
GuideActivationUrlPattern
object
A rule that controls when a guide should be shown based on the user's location in the application. At least one of pathname or search must be provided.
3 properties 1 required
GuideActionResponse
object
A response for a guide action.
1 property 1 required
ConditionGroupAnyMatch
object
A group of conditions that any must be met. Can contain nested alls.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

knock-app-guides-api-openapi.yml Raw ↑

Other APIs Knock publishes across the network.

Knock Outbound Webhooks
Knock Accounts API
Knock API keys API
Knock Audiences API
Knock Branches API
Knock Broadcasts API
Knock Bulk operations API
Knock Channel data API
Knock Channel Groups API
Knock Channels API
Knock Commits API
Knock Email layouts API