Skip to content

List templates for an app​

GET
/v1/apps/{app_id}/templates

Lists every template belonging to the App, ordered by creation time. Each template with deliveries in the last 30 days carries stats (sent_30d, ctr_30d); templates without deliveries have no stats field.

Authorizations​

SessionAuth

Admin session cookie set by POST /v1/auth/login. Dashboard-only management.

Type
API Key (cookie: notti_session)
or
RESTKeyAuth

App REST key (rk_...). Server-to-server calls.

Type
HTTP (bearer)

Parameters​

Path Parameters

app_id*

App ID

Type
string
Required

Query Parameters

label

Filter by label; repeatable for AND (case-insensitive)

Type
string

Responses​

OK

application/json
JSON
[
  
{
  
  
"app_id": "string",
  
  
"body": "string",
  
  
"created_at": "string",
  
  
"deep_link": "string",
  
  
"id": "string",
  
  
"image_url": "string",
  
  
"labels": [
  
  
  
"string"
  
  
],
  
  
"name": "string",
  
  
"stats": {
  
  
  
"ctr_30d": 0,
  
  
  
"sent_30d": 0
  
  
},
  
  
"subtitle": "string",
  
  
"title": "string",
  
  
"updated_at": "string"
  
}
]

Playground​

Authorization
Variables
Key
Value

Samples​


Create a template​

POST
/v1/apps/{app_id}/templates

Creates a notification template (title/body, plus optional subtitle, deep_link and image_url) scoped to the App.

Authorizations​

SessionAuth

Admin session cookie set by POST /v1/auth/login. Dashboard-only management.

Type
API Key (cookie: notti_session)
or
RESTKeyAuth

App REST key (rk_...). Server-to-server calls.

Type
HTTP (bearer)

Parameters​

Path Parameters

app_id*

App ID

Type
string
Required

Request Body​

application/json
JSON
{
  
"body": "string",
  
"deep_link": "string",
  
"image_url": "string",
  
"labels": [
  
  
"string"
  
],
  
"name": "string",
  
"subtitle": "string",
  
"title": "string"
}

Responses​

Created

application/json
JSON
{
  
"app_id": "string",
  
"body": "string",
  
"created_at": "string",
  
"deep_link": "string",
  
"id": "string",
  
"image_url": "string",
  
"labels": [
  
  
"string"
  
],
  
"name": "string",
  
"stats": {
  
  
"ctr_30d": 0,
  
  
"sent_30d": 0
  
},
  
"subtitle": "string",
  
"title": "string",
  
"updated_at": "string"
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Get a template​

GET
/v1/apps/{app_id}/templates/{id}

Fetches a single template by ID, scoped to the App.

Authorizations​

SessionAuth

Admin session cookie set by POST /v1/auth/login. Dashboard-only management.

Type
API Key (cookie: notti_session)
or
RESTKeyAuth

App REST key (rk_...). Server-to-server calls.

Type
HTTP (bearer)

Parameters​

Path Parameters

app_id*

App ID

Type
string
Required
id*

Template ID

Type
string
Required

Responses​

OK

application/json
JSON
{
  
"app_id": "string",
  
"body": "string",
  
"created_at": "string",
  
"deep_link": "string",
  
"id": "string",
  
"image_url": "string",
  
"labels": [
  
  
"string"
  
],
  
"name": "string",
  
"stats": {
  
  
"ctr_30d": 0,
  
  
"sent_30d": 0
  
},
  
"subtitle": "string",
  
"title": "string",
  
"updated_at": "string"
}

Playground​

Authorization
Variables
Key
Value

Samples​


Delete a template​

DELETE
/v1/apps/{app_id}/templates/{id}

Deletes a template by ID, scoped to the App.

Authorizations​

SessionAuth

Admin session cookie set by POST /v1/auth/login. Dashboard-only management.

Type
API Key (cookie: notti_session)
or
RESTKeyAuth

App REST key (rk_...). Server-to-server calls.

Type
HTTP (bearer)

Parameters​

Path Parameters

app_id*

App ID

Type
string
Required
id*

Template ID

Type
string
Required

Responses​

No Content

Playground​

Authorization
Variables
Key
Value

Samples​


Update a template​

PATCH
/v1/apps/{app_id}/templates/{id}

Partially updates a template. An omitted or empty name, title or body keeps its stored value; subtitle, deep_link and image_url keep it when the key is omitted and are cleared by null or an empty string.

Authorizations​

SessionAuth

Admin session cookie set by POST /v1/auth/login. Dashboard-only management.

Type
API Key (cookie: notti_session)
or
RESTKeyAuth

App REST key (rk_...). Server-to-server calls.

Type
HTTP (bearer)

Parameters​

Path Parameters

app_id*

App ID

Type
string
Required
id*

Template ID

Type
string
Required

Request Body​

application/json
JSON
{
  
"body": "string",
  
"deep_link": "string",
  
"image_url": "string",
  
"labels": [
  
  
"string"
  
],
  
"name": "string",
  
"subtitle": "string",
  
"title": "string"
}

Responses​

OK

application/json
JSON
{
  
"app_id": "string",
  
"body": "string",
  
"created_at": "string",
  
"deep_link": "string",
  
"id": "string",
  
"image_url": "string",
  
"labels": [
  
  
"string"
  
],
  
"name": "string",
  
"stats": {
  
  
"ctr_30d": 0,
  
  
"sent_30d": 0
  
},
  
"subtitle": "string",
  
"title": "string",
  
"updated_at": "string"
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Powered by VitePress OpenAPI