Sites

Update a site

patch/v1/sites/{id}

Request

  • Base URL: https://api.feelingsurf.fr
  • URL: https://api.feelingsurf.fr/v1/sites/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Site identifier.

Request body

namestring nullable

User-chosen name; null clears it.

pausedboolean

Pause or resume visit delivery.

visit_distribution'even' | 'asap'

How visits are paced — "even" spreads them across the day, "asap" delivers as fast as possible.

traffic_sourcesinteger[]

IDs of traffic sources to assign; an empty list assigns the default "Direct visits" source.

labelsinteger[]

IDs of labels to assign.

Response

The updated site.

idinteger

Unique identifier.

urlstring

The website's URL.

namestring nullable

Optional user-chosen name.

pausedboolean

Whether the user has paused delivery.

blockedboolean

Whether the platform has blocked the site (e.g. dead link).

limit_reachedboolean

Whether a configured visit cap has been reached.

visit_distribution'even' | 'asap'

How visits are paced — "even" spreads them across the day, "asap" delivers as fast as possible.

traffic_sourcesinteger[]

IDs of assigned traffic sources (resolve via GET /v1/traffic-sources).

labelsinteger[]

IDs of assigned labels (resolve via GET /v1/labels).

total_visitsinteger

Lifetime visits delivered.

created_atstring date-time nullable

When it was created (UTC), or null.

Example response

{
  "id": 2761880,
  "url": "https://example.com",
  "name": "My landing page",
  "paused": false,
  "blocked": false,
  "limit_reached": false,
  "devices": {
    "desktop": 100,
    "mobile": 0,
    "tablet": 0
  },
  "visit_duration": {
    "min_seconds": 10,
    "max_seconds": 10
  },
  "visit_distribution": "even",
  "limits": {
    "hourly": 50,
    "daily": null,
    "total": null
  },
  "schedule": {
    "active_hours_mask": null,
    "time_zone": null
  },
  "traffic_quality": {
    "low_quality_ips": true,
    "ipv6": true
  },
  "browsing": {
    "max_sub_windows": 0
  },
  "traffic_sources": [
    1
  ],
  "labels": [],
  "total_visits": 0,
  "created_at": "2026-06-25T07:58:02Z",
  "location_targeting": {
    "mode": "include",
    "locations": []
  },
  "blocked_domains": {
    "rate": 100,
    "domains": []
  },
  "actions": {
    "window": "latest",
    "items": []
  },
  "cookies": [],
  "visit_history": {
    "by_hour": [
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0
    ],
    "by_day": [
      0,
      0,
      0,
      0,
      0,
      0,
      0,
      0
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.