Blocked

Retrieve blocked items

GETaccount/blocked

Retrieves a list of blocked IP addresses, bots and visitors.

Query String Parameters

presenter

StringDefault Value: plain

Accepted values: plain, tags, indexedTags

Modifies the response data structure

  • plain: A list of visitor IDs
  • tags: A list of objects including the visitor ID and the tag
  • indexedTags: A key:value object of visitorID:tag

Definition

GET https://api.gosquared.com/account/v1/blocked
Open Query Builder
Close

Authentication

Parameters * required

Post Data * required

Example Request

var GoSquared = require('gosquared');
var gosquared = new GoSquared({
  api_key: 'demo',
  site_token: 'GSN-106863-S'
});

gosquared.account.v1.blocked(function(err, res) {
  if (err) return console.log(err);
  console.log(res);
});

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Retrieve blocked bots setting

GETaccount/blocked/bots

Returns whether automatic bot blocking is toggled 'on' for a given project.

Definition

GET https://api.gosquared.com/account/v1/blocked/bots
Open Query Builder
Close

Authentication

Parameters * required

    Post Data * required

    Example Request

    var GoSquared = require('gosquared');
    var gosquared = new GoSquared({
      api_key: 'demo',
      site_token: 'GSN-106863-S'
    });
    
    gosquared.account.v1.blocked.bots(function(err, res) {
      if (err) return console.log(err);
      console.log(res);
    });

    Live Responseundefined undefined

    Your API Key is not authorised for this endpoint

    Update blocked bots setting

    POSTaccount/blocked/bots

    Updates whether the automatic bot blocking feature should be turned on/off for a given project.

    Query String Parameters

    block

    BooleanRequired

    Whether to block bots or not

    Definition

    POST https://api.gosquared.com/account/v1/blocked/bots
    Open Query Builder
    Close

    Authentication

    Parameters * required

    Post Data * required

    Example Request

    The Node library does not support this function at this time

    Live Responseundefined undefined

    Your API Key is not authorised for this endpoint

    Retrieve blocked IPs

    GETaccount/blocked/ips

    Retrieves a list of blocked IP addresses.

    Definition

    GET https://api.gosquared.com/account/v1/blocked/ips
    Open Query Builder
    Close

    Authentication

    Parameters * required

      Post Data * required

      Example Request

      var GoSquared = require('gosquared');
      var gosquared = new GoSquared({
        api_key: 'demo',
        site_token: 'GSN-106863-S'
      });
      
      gosquared.account.v1.blocked.ips(function(err, res) {
        if (err) return console.log(err);
        console.log(res);
      });

      Live Responseundefined undefined

      Your API Key is not authorised for this endpoint

      Update blocked IPs

      POSTaccount/blocked/ips

      Updates the list of IP addresses to be blocked for a given project.

      Query String Parameters

      ip

      StringRequired

      IP address(es) with multiple entries separated by a comma (,)

      Definition

      POST https://api.gosquared.com/account/v1/blocked/ips
      Open Query Builder
      Close

      Authentication

      Parameters * required

      Post Data * required

      Example Request

      The Node library does not support this function at this time

      Live Responseundefined undefined

      Your API Key is not authorised for this endpoint

      Unblock IP addresses

      DELaccount/blocked/ips

      Removes one or more IP addresses from the blocked list

      Query String Parameters

      ip

      StringRequired

      IP address(es) with multiple entries separated by a comma (,)

      Definition

      DEL https://api.gosquared.com/account/v1/blocked/ips
      Open Query Builder
      Close

      Authentication

      Parameters * required

      Post Data * required

      Example Request

      The Node library does not support this function at this time

      Live Responseundefined undefined

      Your API Key is not authorised for this endpoint

      Retrieve blocked visitors

      GETaccount/blocked/visitors

      Retrieves a list of visitor IDs that have been blocked for a given project. Most commonly a visitor will have been blocked from hitting the 'Ignore' button from within the Visitor widget on your Now dashboard.

      Query String Parameters

      presenter

      StringDefault Value: plain

      Accepted values: plain, tags, indexedTags

      Modifies the response data structure

      • plain: A list of visitor IDs
      • tags: A list of objects including the visitor ID and the tag
      • indexedTags: A key:value object of visitorID:tag

      Definition

      GET https://api.gosquared.com/account/v1/blocked/visitors
      Open Query Builder
      Close

      Authentication

      Parameters * required

      Post Data * required

      Example Request

      var GoSquared = require('gosquared');
      var gosquared = new GoSquared({
        api_key: 'demo',
        site_token: 'GSN-106863-S'
      });
      
      gosquared.account.v1.blocked.visitors(function(err, res) {
        if (err) return console.log(err);
        console.log(res);
      });

      Live Responseundefined undefined

      Your API Key is not authorised for this endpoint

      Update blocked visitors

      POSTaccount/blocked/visitors/{visitorID}

      Updates the list of blocked visitors for a given project.

      Path Parameters

      visitorID

      StringRequired

      The ID of the visitor

      Definition

      POST https://api.gosquared.com/account/v1/blocked/visitors/{visitorID}
      Open Query Builder
      Close

      Authentication

      Parameters * required

      Post Data * required

      Example Request

      The Node library does not support this function at this time

      Live Responseundefined undefined

      Your API Key is not authorised for this endpoint

      Unblock visitors

      DELaccount/blocked/visitors/{visitorID}

      Removes a visitor from the blocked list for a given project.

      Path Parameters

      visitorID

      StringRequired

      The ID of the visitor

      Definition

      DEL https://api.gosquared.com/account/v1/blocked/visitors/{visitorID}
      Open Query Builder
      Close

      Authentication

      Parameters * required

      Post Data * required

      Example Request

      The Node library does not support this function at this time

      Live Responseundefined undefined

      Your API Key is not authorised for this endpoint