Skip to content

Enable or disable an output config

PATCH
/api/v1/integrations/outputs/{id}/toggle
Code sample: cURL
curl -X PATCH 'https://dashboard.justcrawl.io/api/v1/integrations/outputs/oc_01ABC/toggle' \
-H 'Authorization: Bearer $JUSTCRAWL_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"isEnabled":false}'

Soft pause / resume on an output destination — flips isEnabled without deleting the config or wiping its credentials. Workflow nodes referencing a disabled output skip the delivery without erroring out the run; useful for incident-mode pause when a downstream is misbehaving (rotating webhook secret, S3 bucket maintenance, billing investigation) without forcing a full re-provision afterwards.

The internal system-managed config can be toggled — the BI Phase 0 invariant is on identity / FK presence, not on enabled state — but doing so will silently drop bigdata-node writes. Use with care. Requires the org:manage permission.

id
required
string

Output config ID.

Media type application/json
object
isEnabled
required
boolean
Example generated
{
"isEnabled": true
}

New isEnabled state.

Media type application/json
object
id
string
isEnabled
boolean
Example generated
{
"id": "example",
"isEnabled": true
}

Validation failed — request body or query is missing/invalid

Media type application/json
object
error
string
Example
{
"error": "Missing or invalid \"url\" field"
}

Missing or invalid authentication token

Media type application/json
object
error
string
Example
{
"error": "Missing or invalid authentication token"
}

Insufficient permissions for this operation

Media type application/json
object
error
string
Example
{
"error": "No organization. Complete onboarding first."
}

Resource not found

Media type application/json
object
error
string
Example
{
"error": "Workflow not found"
}

Unexpected server error. Logs and PostHog $exception capture

Media type application/json
object
error
string
Example
{
"error": "Something went wrong"
}