Change a signal's keywords

Replace the phrases one signal searches for: 1 to 24, each 1 to 4 words a buyer would literally write in a post, at most 48 characters. The workspace's managed signals follow the monitoring keywords and answer 409; change those with Set the monitoring keywords.

PUThttps://app.trygtm.com/api/v1/signals/{signal_id}/keywords

Scope: write
MCP tool: update_signal_keywords

Path parameters

signal_idstringrequired: The signal's id, from list_signals.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

keywordsstring[]required: The whole new list. Phrases not in it are dropped.

Request

curl -X PUT https://app.trygtm.com/api/v1/signals/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/keywords \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [
      "route optimization",
      "last mile"
    ]
  }'

Response

{
  "data": {
    "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
    "name": "Route optimisation chatter",
    "keywords": [
      "route optimization",
      "last mile",
      "dispatch software"
    ]
  }
}