Enable or disable a URL

PATCH

/api/v1/urls/{id}/toggle

Code sample: cURL

curl -X PATCH 'https://api.justcrawl.io/api/v1/urls/00000000-0000-0000-0000-000000000001/toggle' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"isEnabled": false}'

• Production

Flips whether a URL participates in future schedule runs. A disabled URL keeps its ID, history, and extraction results, and stays visible in GET /api/v1/urls — it is simply skipped when schedules dispatch. This is the reversible alternative to DELETE /api/v1/urls/{id}.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

URL item ID.

Request Body^required

Media typeapplication/json

object

isEnabled

required

True to resume scraping this URL, false to pause it.

boolean

Example^generated

{
  "isEnabled": true
}

Responses

200

The URL’s new enabled state.

Media typeapplication/json

object

id

string format: uuid

isEnabled

boolean

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "isEnabled": true
}

400

isEnabled missing or not a boolean.

401

Missing or invalid authentication token

Media typeapplication/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media typeapplication/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

404

URL not found.

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}