List this org's macros.

Required scope: read

GET /api/v1/macros

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/macros' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "limit": 20,
  "macros": [
    {
      "auto_send": true,
      "body": "Two-person tent, green — replacement for damaged pole set.",
      "channel": "string",
      "created_at": "2026-08-31T14:22:05Z",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Two-Person Tent",
      "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "rule_name": "string",
      "slots": [],
      "source": "string",
      "status": "candidate",
      "tags": [],
      "title": "Replacement tent pole set",
      "tool": {
        "arguments": null,
        "name": null
      },
      "updated_at": "2026-08-31T14:22:05Z"
    }
  ],
  "offset": 1,
  "total": 102
}

Required scope: read

Query parameters

limit · integer

Page size

offset · integer

Page offset

status · string

candidate | approved | archived

rule_name · string

Only macros bound to this policy rule

Response

ListMacrosResponse

limit · integer · required

macros · Macro[] · required

Show Macro

auto_send · boolean · required

body · string · required

channel · string

created_at · string · required

id · string · required

name · string · required

Upsert key within an org, matching the rules convention.

org_id · string · required

rule_name · string

The policy rule whose citation selects this macro.

slots · string[] · required

Merge fields parsed from body at write time.

source · string

status · MacroStatus · required

tags · string[]

title · string

tool · object

Show tool

arguments · object

name · string · required

updated_at · string · required

offset · integer · required

total · integer · required

Status codes

Code	Meaning
200	Macros for this organization
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/macros' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "limit": 20,
  "macros": [
    {
      "auto_send": true,
      "body": "Two-person tent, green — replacement for damaged pole set.",
      "channel": "string",
      "created_at": "2026-08-31T14:22:05Z",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Two-Person Tent",
      "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "rule_name": "string",
      "slots": [],
      "source": "string",
      "status": "candidate",
      "tags": [],
      "title": "Replacement tent pole set",
      "tool": {
        "arguments": null,
        "name": null
      },
      "updated_at": "2026-08-31T14:22:05Z"
    }
  ],
  "offset": 1,
  "total": 102
}