Skip to main content
PATCH
/
v1
/
topics
/
{id}
curl -X PATCH "https://api.trigify.io/v1/topics/topic_abc123xyz" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Infrastructure Buyers - Priority Accounts",
    "status": "PAUSED"
  }'

{
  "message": "<string>",
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "status": "ACTIVE",
    "keywords": [
      "<string>"
    ],
    "keywords_and": [
      "<string>"
    ],
    "keywords_not": [
      "<string>"
    ],
    "job_titles": [
      "<string>"
    ],
    "time_frame": "<string>",
    "max_results": 123,
    "content_type": "<string>",
    "sort_by": "<string>",
    "expires_at": "<string>",
    "last_run": "<string>",
    "new_items": true,
    "number_of_new_items": 123,
    "created": "<string>",
    "updated": "<string>"
  }
}
Use this endpoint to rename a Social Topics search or change its monitoring status.
Enterprise-only endpoint. Contact us at [email protected] to discuss access.
This endpoint is free. Credits are not charged for topic search updates.

​
Overview

This endpoint supports partial updates. You can change the display name, pause monitoring, resume an eligible topic, or stop a topic permanently.

​
Authentication And Permissions

  • Send your API key in x-api-key
  • Required permission: topics:write
  • Required plan: ENTERPRISE or CUSTOM
curl -X PATCH "https://api.trigify.io/v1/topics/topic_abc123xyz" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Infrastructure Buyers - Priority Accounts",
    "status": "PAUSED"
  }'

​
Allowed Updates

  • name: optional new display name
  • status: optional new status, one of ACTIVE, PAUSED, or STOPPED
Only send the fields you want to change.

​
Status Behavior

  • ACTIVE: topic participates in daily 06:00 UTC rediscovery
  • PAUSED: topic is preserved but excluded from future rediscovery until resumed
  • STOPPED: terminal state; the topic cannot be resumed later
If a topic is already STOPPED or EXPIRED, it cannot be moved back to ACTIVE.

​
Example Response

{
  "success": true,
  "message": "Topic search updated",
  "data": {
    "id": "topic_abc123xyz",
    "name": "AI Infrastructure Buyers - Priority Accounts",
    "status": "PAUSED",
    "keywords": ["ai infrastructure", "model serving", "vector database"],
    "keywords_and": ["buying", "vendor selection"],
    "keywords_not": ["hiring", "job opening"],
    "job_titles": ["CTO", "VP Engineering", "Head of Data"],
    "time_frame": "past-week",
    "max_results": 50,
    "content_type": "posts",
    "sort_by": "date_posted",
    "expires_at": "2026-04-08T09:30:00.000Z",
    "last_run": "2026-03-09T06:00:04.000Z",
    "new_items": true,
    "number_of_new_items": 7,
    "created": "2026-03-09T09:30:00.000Z",
    "updated": "2026-03-09T11:00:27.000Z"
  }
}

​
Monitoring Impact

  • paused and stopped topics no longer participate in daily rediscovery
  • linked posts stop receiving future engagement backfills once no eligible active topic searches still reference them
  • renaming a topic does not affect monitoring or billing behavior

Headers

​
x-api-key
string

Path Parameters

​
id
string
required

Topic search ID

Example:

"topic_abc123xyz"

Body

application/json
​
name
string

New name

Required string length: 1 - 255
​
status
enum<string>

New status (ACTIVE to resume, PAUSED to pause, STOPPED to stop permanently)

Available options:
ACTIVE,
PAUSED,
STOPPED

Response

200 - application/json

Topic search updated successfully

​
message
string
required
​
success
boolean
required
​
data
object
required