Update Signal

Updates an existing Signal.

Update a signal.

POSTyouragentURL.symphony.com/agent/v1/signals/{id}/update

Path parameters

id*string

The id of the signal.

Header parameters

Body

application/json

Signal definition.

namestring

Signal name

querystring

The query used to define this signal. The query is defined as "field:value" pairs combined by the operators "AND" or "OR". Supported fields are (case-insensitive): "author", "hashtag" and "cashtag". MUST contain at least one "hashtag" or "cashtag" definition.

visibleOnProfileboolean

Whether the signal is visible on its creator's profile

companyWideboolean

Whether the signal is a push signal

Response

200400401403451500

Signal updated.

Body

application/json

namestring

Signal name

querystring

The query used to define this signal. The query is defined as "field:value" pairs combined by the operators "AND" or "OR". Supported fields are (case-insensitive): "author", "hashtag" and "cashtag". MUST contain at least one "hashtag" or "cashtag" definition.

visibleOnProfileboolean

Whether the signal is visible on its creator's profile

companyWideboolean

Whether the signal is a push signal

idstring

Signal ID

timestampinteger (int64)

Timestamp when the signal was created, in milliseconds since Jan 1 1970

companyWideboolean

Whether the signal is a push signal

Request

JavaScriptCurlPython

const response = await fetch('youragentURL.symphony.com/agent/v1/signals/{id}/update', {
    method: 'POST',
    headers: {
      "sessionToken": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403451500

{
  "name": "text",
  "query": "text",
  "visibleOnProfile": false,
  "companyWide": false,
  "id": "text"
}

Request Example

curl -X POST \
  https://acme.symphony.com/agent/v1/signals/5a8da7edb9d82100011d508f/update \
  -H 'content-type: application/json' \
  -H 'sessiontoken: SESSION_TOKEN' \
  -H 'keymanagertoken: KEYMANAGER_TOKEN' \
  -d '{
    "name": "hashtag only",
    "query": "HASHTAG:hash",
    "visibleOnProfile": false,
    "companyWide": false
   }'

🚧 Known Limitations

• To update a company-wide signal, the requesting user needs to have the canCreatePushedSignals entitlement.

• To update a normal signal, the requesting user needs to be the owner of the signal.

• To send numeric cashtags as signals, add a * before the number, for example, $*122450.