Blocklist

Add terms to the blocklist to create custom alert rules. When a blocklisted term is detected during a scan, it triggers a signal at the configured severity level. Use this to enforce organization-specific policies — for example, blocking mentions of confidential project names or proprietary data.

GET

/v1/blocklist

List all blocklist entries for your organization.

Response

200 OK

{
  "blocklist": [
    {
      "id": "uuid",
      "term": "Project Aurora",
      "severity": "high",
      "category": "confidential",
      "enabled": true,
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "uuid",
      "term": "internal-api-key",
      "severity": "medium",
      "category": null,
      "enabled": true,
      "created_at": "2026-01-14T08:00:00Z"
    }
  ]
}

POST

/v1/blocklist

Add a term to the blocklist.

Request Body

Parameter	Type	Required	Description
`term`	string	Yes	The term to blocklist (case-sensitive, trimmed)
`severity`	"low" \| "medium" \| "high"	No	Alert severity level. Defaults to "medium".
`category`	string	No	Optional category label for organizing entries

Create Response

201 Created

{
  "entry": {
    "id": "uuid",
    "term": "Project Aurora",
    "severity": "high",
    "category": "confidential",
    "enabled": true,
    "created_at": "2026-01-15T10:00:00Z"
  }
}

Duplicate entries (same term) return a 400 error. The number of entries is limited by your plan tier.

PATCH

/v1/blocklist/:id

Update an existing blocklist entry.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The blocklist entry ID

Update Body

Parameter	Type	Required	Description
`term`	string	No	Updated term (non-empty string)
`severity`	"low" \| "medium" \| "high"	No	Updated severity level
`category`	string	No	Updated category label
`enabled`	boolean	No	Enable or disable the entry

Update Response

200 OK

{
  "entry": {
    "id": "uuid",
    "term": "Project Aurora",
    "severity": "high",
    "category": "confidential",
    "enabled": false,
    "created_at": "2026-01-15T10:00:00Z"
  }
}

DELETE

/v1/blocklist/:id

Remove a term from the blocklist.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The blocklist entry ID

Delete Response

200 OK

{ "deleted": true }

Examples

SDK

// Add a high-severity blocklist entry
await armor.addBlocklistEntry({
  term: 'Project Aurora',
  severity: 'high',
  category: 'confidential',
});

// List all entries
const blocklist = await armor.listBlocklist();

// Disable an entry
await armor.updateBlocklistEntry(blocklist[0].id, {
  enabled: false,
});

// Remove an entry
await armor.removeBlocklistEntry(blocklist[0].id);

cURL — Add

curl -X POST https://indigiarmor.com/v1/blocklist \
  -H "Authorization: Bearer ia_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"term": "Project Aurora", "severity": "high", "category": "confidential"}'