--- title: "Restore a deleted site" method: POST path: "/v1/sites/{id}/restore" tags: ["Sites"] --- # Restore a deleted site `POST /v1/sites/{id}/restore` ## Request - Base URL: `https://api.feelingsurf.fr` - URL: `https://api.feelingsurf.fr/v1/sites/{id}/restore` - Auth: HTTP bearer Brings back a site you deleted, with the settings it had. Geo targeting, blocked domains and actions your plan cannot use stay suspended and come back empty. Returns 404 once the retention window has passed, and 403 `site_limit_reached` when you have no free slot. ## Path parameters - `id` integer, required ## Response `200` The restored site, with full configuration. - SiteDetail: A website that receives automated visits. Relation-backed settings (geo targeting, blocked domains, actions, traffic sources, labels) are added alongside their write endpoints. - `id` integer: Unique identifier. - `url` string: The website's URL. - `name` string, nullable: Optional user-chosen name. - `paused` boolean: Whether the user has paused delivery. - `blocked` boolean: Whether the platform has blocked the site (e.g. dead link). - `limit_reached` boolean: Whether a configured visit cap has been reached. - `devices` object: Device targeting split, as percentages summing to 100. - `desktop` integer: Percentage of visits sent to desktop devices. - `mobile` integer: Percentage of visits sent to mobile devices. - `tablet` integer: Percentage of visits sent to tablet devices. - `visit_duration` object: Visit duration range, in seconds. - `min_seconds` integer: Shortest visit duration, in seconds. - `max_seconds` integer: Longest visit duration, in seconds. - `visit_distribution` 'even' | 'asap': How visits are paced — "even" spreads them across the day, "asap" delivers as fast as possible. - `limits` object: Visit caps; null means no limit. - `hourly` integer: Max visits per hour — always at least 1 (an hourly cap is mandatory). - `daily` integer, nullable: Max visits per day; null means no limit. - `total` integer, nullable: Max visits in total (lifetime); null means no limit. - `schedule` object: Active-hours scheduling. - `active_hours_mask` string, nullable: A weekly on/off schedule: a 168-character string, one character per hour (24 hours × 7 days). Each is `1` (active that hour) or `0` (paused). The first character is Monday 00:00 and each next is the following hour, ending Sunday 23:00, in `time_zone`. `null` or all-`1`s means always on; at least one hour must be active, so an all-`0`s mask is rejected. - `time_zone` string, nullable: IANA time zone for the active-hours schedule (e.g. "Europe/Paris"); null uses your account timezone. - `traffic_quality` object: Traffic quality controls. - `low_quality_ips` boolean: Whether low-quality IPs (VPN/proxy/datacenter) may deliver visits to this site. - `ipv6` boolean: Whether IPv6 visitors may deliver visits to this site. - `browsing` object: Browsing options. - `max_sub_windows` integer: How many pop-up windows the visited site may open during a visit. - `traffic_sources` integer[]: IDs of assigned traffic sources (resolve via GET /v1/traffic-sources). - `labels` integer[]: IDs of assigned labels (resolve via GET /v1/labels). - `total_visits` integer: Lifetime visits delivered. - `created_at` string, date-time, nullable: When it was created (UTC), or null. - `location_targeting` object: Country/continent targeting. - `mode` 'include' | 'exclude': Whether the locations list is an allow-list (include) or a block-list (exclude). - `locations` object[]: The countries/continents to include or exclude. - `type` 'country' | 'continent': Whether code is a country or a continent. - `code` string: ISO country code (alpha-2) or continent code, per type. - `blocked_domains` object: Domains blocked during visits. - `rate` integer: Percentage of visits to which domain blocking applies. - `domains` string[]: Hostnames to block (e.g. `ads.example.com`; no scheme or path), one per entry. Up to 10. - `actions` object: Auto-actions performed during visits. - `window` 'latest' | 'first': Which opened browser window the actions target — the most recent (latest) or the first (first). - `items` SiteAction[]: The actions to perform. - `type` 'click' | 'click_rss' | 'click_sitemap' | 'scroll' | 'refresh': What the app does — click a link, click an RSS or sitemap link, scroll, or refresh. - `ratio` integer: Percentage of visits that perform this action (default 100 = every visit). - `element` object: Present for click-type actions. - `selection` 'random' | 'first' | 'last', nullable: Which element to click when several match. - `type` 'any' | 'internal_link' | 'external_link' | 'link' | 'button', nullable: What to click: any element, a same-domain link (`internal_link`), an off-domain link (`external_link`), any link (`link`), or a button. - `url_filter` string, nullable: Only click links whose URL contains this text; ignored when the element type is `button`. - `text_filter` string, nullable: Only click elements whose visible text contains this. - `cookies` SiteCookie[]: Cookies set before each visit. - `name` string, required: Cookie name. - `value` string, required: Cookie value. - `domain` string, nullable: Domain to set the cookie on (a leading dot is dropped; subdomains are covered either way); null sets it on the visited site's host. - `visit_history` object: Recent visit counts. - `by_hour` integer[]: Visits per hour over the last 24h, oldest first (last = current hour). - `by_day` integer[]: Visits per day over the last 8 days, oldest first (last = today). ## Other responses - `401`: Missing or invalid API key. - `403`: The request is not allowed. A banned or disabled account is rejected with `forbidden`; a site setting your plan does not include is rejected with `premium_required`. - `404`: Resource not found (or not owned by the caller). - `429`: Too many requests — the per-account, per-minute rate limit was exceeded. Wait the number of seconds given in the `Retry-After` response header, then retry. --- [API](https://skmtc.dev/feelingsurf/apis/feelingsurf-api.md) · [All operations](https://skmtc.dev/feelingsurf/apis/feelingsurf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feelingsurf/apis/feelingsurf-api/revisions/8b09d26880d6?raw)