Contexts

Create a context

Create a new context with the specified type, id, and data. Returns 409 if context already exists. type and id are required fields, data is optional, if the context already exists, it returns the 409 response

post/v2/contexts

Request

  • Base URL: https://api.notifly.io
  • URL: https://api.notifly.io/v2/contexts
  • Auth: API key in header Authorization

Request body

typestring required

Context type (e.g., tenant, app, workspace). Must be lowercase alphanumeric with optional separators.

idstring required

Unique identifier for this context. Must be lowercase alphanumeric with optional separators.

dataobject

Optional custom data to associate with this context.

bridgeUrlstring

Optional bridge URL override for agent connect. When an inbound agent turn resolves this context, its bridge call is routed here instead of the agent default bridge URL. Must be a publicly reachable URL.

Example request

{
  "type": "tenant",
  "id": "org-acme",
  "data": {
    "tenantName": "Acme Corp",
    "region": "us-east-1",
    "settings": {
      "theme": "dark"
    }
  },
  "bridgeUrl": "https://tenant-acme.example.com/api/novu"
}

Response

Created

Changes

No recorded changes to this operation across all 1 revision of this API.