Delete URL

DELETE

/api/v1/urls/{id}

Code sample: cURL

curl -X DELETE 'https://api.justcrawl.io/api/v1/urls/00000000-0000-0000-0000-000000000001' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Removes a URL from the org. Hard delete — existing extraction history is preserved (extraction rows reference the URL by ID and survive the deletion), but the URL will no longer surface in GET /api/v1/urls and will not be picked up by any future schedule run. To temporarily disable a URL without losing it, use PATCH /api/v1/urls/{id}/toggle with isEnabled: false instead.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

URL item ID.

Responses

204

URL deleted.

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"
}