Pause a signal
Hold a signal without losing its place in the schedule.
POST
https://api.up2data.ai/v1/signals/{signal_id}/pauseSets active to false and pause_reason to manual. A run already in flight finishes; no further runs fire until you resume. Idempotent: pausing a paused signal returns it unchanged. Up2Data pauses a signal on its own when a run fails with 402 insufficient_credits or 400 invalid_request; those show the matching pause_reason.
#Request
| Field | Type | Notes |
|---|---|---|
signal_idrequired | string | Path parameter. The signal_id returned by POST /signals. |
#Call it
curl -X POST "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11/pause" \
-H "X-API-Key: YOUR_API_KEY"import requests
url = "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11/pause"
headers = {
"X-API-Key": "YOUR_API_KEY",
}
response = requests.post(url, headers=headers)
print(response.json())const url = "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11/pause";
const headers = {
"X-API-Key": "YOUR_API_KEY",
};
const response = await fetch(url, {
method: "POST",
headers,
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.up2data.ai/v1/signals/9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11/pause"
req, err := http.NewRequest("POST", url, nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
respBody, _ := io.ReadAll(resp.Body)
fmt.Println(string(respBody))
}#Response
{
"data": {
"signal_id": "9d1f4c2e-7b3a-4e8f-a1c5-2f6b8d9e0a11",
"name": "Watch key accounts",
"status": "paused",
"active": false,
"pause_reason": "manual",
"schedule": { "interval_ms": 86400000, "start_at": "2026-11-01T08:00:00Z", "ends_at": null, "max_runs": 30 },
"run_count": 3,
"next_run_at": "2026-11-04T08:00:00Z",
"last_run_at": "2026-11-03T08:00:00Z",
"last_job_id": "job_7hd92kfa",
"last_error": null,
"completed_at": null,
"request": {
"items": [
{ "type": "profile", "url": "https://linkedin.com/in/a" },
{ "type": "company", "url": "https://linkedin.com/company/acme" }
],
"webhook_url": "https://your-server.com/hooks/up2data"
},
"created_at": "2026-10-30T12:00:00Z",
"updated_at": "2026-11-03T08:00:01Z"
},
"meta": { "creditsUsed": 0, "creditsRemaining": 98413, "billed": false, "reason": "signal_paused", "requestId": "req_t4sk0001" }
}#Errors
| Status | Type | When | Billed |
|---|---|---|---|
| 404 | not_found | No signal with this signal_id in your organization, or signal_id is not a UUID. | No |
| 409 | conflict | The signal is completed. PATCH schedule.max_runs or schedule.ends_at to revive it. | No |
| 401 | invalid_api_key | Missing, malformed, or revoked key. | No |
| 429 | rate_limited | Over the 5,000 requests/min limit. Honor Retry-After. | No |
| 500 | internal_error | Something broke on the server side. | No |
| 503 | upstream_error | The scheduling service is unreachable. Safe to retry. | No |
See the Errors guide for every error type this version can return.