API v3 is live and in beta: expect possible malfunctions and breaking changes in the coming days. If you find a bug, please report it to your Sillage contact.
v2DeprecatedSignals

Update a Signal

Update the interaction payload of an existing signal.

Updates the interaction_data of an existing signal.

Update a signal

PATCH/api/v2/partner/workspaces/{partner_workspace_id}/signals/{id}

Path parameters

ParameterTypeDescription
partner_workspace_idstringOpaque workspace identifier from the partner system.
idintegerId of the signal.

Request body

FieldTypeRequiredDescription
interaction_dataanyNoSignal-type-specific payload to store, replacing the existing one.

Example request

curl -X PATCH "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/signals/301" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interaction_data": {"keywords_found": ["AI", "growth"]}}'

Example response

{
  "data": {
    "id": 301,
    "signal_type": "keywordDetection",
    "data": { "keywords_found": ["AI", "growth"] },
    "detected_at": "2026-06-12T09:00:00.000Z",
    "signal_date": "2026-06-12T09:00:00.000Z",
    "lead_id": null,
    "company_id": 456,
    "agent_id": null,
    "source_url": null,
    "author": null,
    "excerpt": null
  }
}

Response fields

FieldTypeDescription
idintegerId of the signal.
signal_typestring or nullSignal type.
dataany or nullSignal-type-specific payload.
detected_atstring or nullWhen the signal was detected (ISO 8601).
signal_datestring or nullDate associated with the signal event (ISO 8601).
lead_idinteger or nullID of the associated lead, if any.
company_idinteger or nullID of the associated company, if any.
agent_idinteger or nullID of the agent that produced this signal, if any.
source_urlstring or nullLink to the source content behind the signal. null when the signal has no public external link.
authorobject or nullThe person behind the source content, when known: full_name, headline, linkedin_url (each nullable). null for company-level or authorless signals.
excerptstring or nullA short text excerpt from the source content. null when no text is available.

Errors

StatusMeaning
400Invalid request body or id parameter.
401The master key is missing or invalid.
403The master key is not authorized to access this resource.
404No signal found for this id.
429Too many requests.
500An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json.

On this page