Update pipeline configuration
Enable, change, or disable monitoring for a company.
Enables monitoring for a company, changes its monitoring level, or turns monitoring off, all through the same call. Calling this endpoint again for the same company and pipeline updates the existing configuration instead of creating a duplicate, so it is safe to call whenever you want to change the monitoring level.
Route
Path parameters
| Parameter | Type | Description |
|---|---|---|
| id | integer | The company's ID. Must belong to your workspace. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| pipeline_type | string | Yes | Which pipeline to configure. Currently only account_mapping_and_content is available. |
| configuration | string | Yes | The monitoring level to set for this company. Valid values: account_mapping, account_mapping_and_content, disabled. |
What each configuration value means for this company:
account_mapping: we keep the account's team map up to date, no content monitoring.account_mapping_and_content: full monitoring, team map plus posts, comments, and job-postings signals.disabled: turns off account mapping and content monitoring for this company. Existing data is kept. Settingconfigurationback toaccount_mappingoraccount_mapping_and_contentre-enables monitoring.
Example request
curl -X PATCH "https://api.getsillage.com/api/v2/companies/456/pipeline-configs" \
-H "Authorization: Bearer $SILLAGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pipeline_type": "account_mapping_and_content",
"configuration": "account_mapping"
}'Success response
Status: 200 OK
{
"data": {
"pipeline_type": "account_mapping_and_content",
"configuration": "account_mapping"
}
}Example: disable monitoring
To turn monitoring off for a company, send configuration: "disabled". Account mapping and content monitoring both stop; the company's existing data is kept, and the same call with a different configuration value re-enables monitoring later.
curl -X PATCH "https://api.getsillage.com/api/v2/companies/456/pipeline-configs" \
-H "Authorization: Bearer $SILLAGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pipeline_type": "account_mapping_and_content",
"configuration": "disabled"
}'Response, status 200 OK:
{
"data": {
"pipeline_type": "account_mapping_and_content",
"configuration": "disabled"
}
}Response fields
| Field | Type | Description |
|---|---|---|
| data.pipeline_type | string | The pipeline this configuration applies to. |
| data.configuration | string | The monitoring level now active for this company and pipeline. |
Errors
| Status | Meaning |
|---|---|
| 400 | The request body is invalid, or pipeline_type is google_news, which is not available yet. |
| 401 | The API key is missing or invalid. |
| 404 | The company was not found or does not belong to this workspace. |
| 500 | An unexpected server error occurred. |
Error responses use RFC 9457 problem documents with Content-Type: application/problem+json:
{
"type": "https://docs.getsillage.com/errors/invalid-query",
"title": "Invalid request body",
"status": 400,
"instance": "/api/v2/companies/456/pipeline-configs",
"errors": {
"pipeline_type": ["Invalid literal value, expected \"account_mapping_and_content\""]
}
}