1 of 1

Locations

Locations represent the physical places where you deploy Devices.

Required input parameters

To use the Create Location API the following parameters are mandatory:

locationProfileId
welcomePortalId
loginProfileId

These parameters can be extracted in the following ways:

`locationProfileId`

In Cloud4Wi dashboard follow the path:

Manage -> Location Profiles -> *Select the Location Profile of interest

`welcomePortalId`

In Cloud4Wi dashboard follow the path

Guest WiFi -> Splash Pages -> *Select the Splash Page of interest

`loginProfileId`

In Cloud4Wi dashboard follow the path

Guest WiFi -> Login Profiles -> *Select the Login Profile of interest

organizationPlanId

In Cloud4wi dashboard follow the path

Guest Wifi -> Internet Plans -> *Select the Internet Plan of interest

Locations

Locations represent the physical places where you deploy Devices.

List Locations of the organization

Retrieve all Locations configured in the organization Role: Location Manager, Organization Manager Scope: organization_read

GEThttps://explore.cloud4wi.com//v1/organizations/{cid}/locations

Path parameters

cid*string

id of the organization (aka tenant)

Query parameters

tagsstring

Filter by a tag or a list of tags comma separated

Response

Array with the list of Locations

Body

generatedstring

sizenumber

locationsarray of locationListResponse (object)

idstring

location id

namestring

location name

organziationIdstring

organization id

latnumber

latitude

lngnumber

longitude

timezonestring

location's time zone

addressobject

addressstring

address

citystring

city

statestring

state/province/region

zipstring

zip/postal code

countrystring

country

externalIdstring

tagsarray of string

itemsstring

Request

Response

Get a Location by id

List locations belongs to an organization Scope: organization_read

GEThttps://explore.cloud4wi.com//v1/locations/{lid}

Path parameters

lid*string

Location id

Response

Array with the list of Locations

Body

generatedstring

sizenumber

locationlocationListResponse (object)

idstring

location id

namestring

location name

organziationIdstring

organization id

latnumber

latitude

lngnumber

longitude

timezonestring

location's time zone

addressobject

addressstring

address

citystring

city

statestring

state/province/region

zipstring

zip/postal code

countrystring

country

externalIdstring

tagsarray of string

itemsstring

Request

Response

Add a new location

Add a new location Read https://create.cloud4wi.com/dev-hub/api-reference/getting-started/locations for details Role: Organization Manager Scope: organization_write

POSThttps://explore.cloud4wi.com//v1/organizations/{cid}/locations

Path parameters

cid*string

id of the organization (aka tenant)

Body

desc

name*string

loginProfileId*string

timezone*string

In format "Europe/Rome"

locationProfileId*string

welcomePortalId*string

country*string

country code as ISO 3166-1 alpha-2.

address*string

city*string

state*string

zip*string

onNetboolean

https://cloud4wi.zendesk.com/hc/en-us/articles/200923267-What-is-the-On-Net-option-for-the-Venue-

externalIdstring

descriptionstring

categoryNamestring

valid category: other, consumer electronics, sports center, fast food, disco, pools, bar, ice cream, piano bar, underwear, cinema, computers, footwear, gyms, sandwich, sporting goods, hairstyle, public administration, phone, hotels, pizzeria, coffee, restaurants, clothing, pub

tagsarray of string

itemsstring

enabledboolean

organizationPlanIdstring

internet plan id at organization level

Response

Body

generatedstring

statusstring

locationIdstring

newTagsarray of string

itemsstring

new tags added

Request

Response

Update a location

Update a location Role: Organization Manager Scope: organization_write

PUThttps://explore.cloud4wi.com//v1/organizations/{cid}/locations/{lid}

Path parameters

cid*string

id of the organization (aka tenant)

lid*string

id of the location

Body

desc

namestring

descriptionstring

categoryNamestring

tagsarray of string

itemsstring

externalIdstring

countrystring

country code as ISO 3166-1 alpha-2.

addressstring

citystring

statestring

zipstring

timezonestring

Response

Body

generatedstring

statusstring

locationIdstring

newTagsarray of string

itemsstring

new tags added

Request

Response

Delete a location

Delete a location Role: Organization Manager Scope: organization_write

DELETEhttps://explore.cloud4wi.com//v1/organizations/{cid}/locations/{lid}

Path parameters

cid*string

id of the organization (aka tenant)

lid*string

id of the location

Response

Body

generatedstring

statusstring

Request

Response

Required input parameters

To use the Create Location API the following parameters are mandatory:

locationProfileId
welcomePortalId
loginProfileId

These parameters can be extracted in the following ways:

`locationProfileId`

In Cloud4Wi dashboard follow the path:

Manage -> Location Profiles -> *Select the Location Profile of interest

`welcomePortalId`

In Cloud4Wi dashboard follow the path

Guest WiFi -> Splash Pages -> *Select the Splash Page of interest

`loginProfileId`

In Cloud4Wi dashboard follow the path

Guest WiFi -> Login Profiles -> *Select the Login Profile of interest

organizationPlanId

In Cloud4wi dashboard follow the path

Guest Wifi -> Internet Plans -> *Select the Internet Plan of interest

Delete a location

Delete a location Role: Organization Manager Scope: organization_write

DELETEhttps://explore.cloud4wi.com//v1/organizations/{cid}/locations/{lid}

Path parameters

cid*string

id of the organization (aka tenant)

lid*string

id of the location

Response

Body

generatedstring

statusstring

Request

Response

Update a location

Update a location Role: Organization Manager Scope: organization_write

PUThttps://explore.cloud4wi.com//v1/organizations/{cid}/locations/{lid}

Path parameters

cid*string

id of the organization (aka tenant)

lid*string

id of the location

Body

desc

namestring

descriptionstring

categoryNamestring

tagsarray of string

itemsstring

externalIdstring

countrystring

country code as ISO 3166-1 alpha-2.

addressstring

citystring

statestring

zipstring

timezonestring

Response

Body

generatedstring

statusstring

locationIdstring

newTagsarray of string

itemsstring

new tags added

Request

Response

Add a new location

Add a new location Read https://create.cloud4wi.com/dev-hub/api-reference/getting-started/locations for details Role: Organization Manager Scope: organization_write

POSThttps://explore.cloud4wi.com//v1/organizations/{cid}/locations

Path parameters

cid*string

id of the organization (aka tenant)

Body

desc

name*string

loginProfileId*string

timezone*string

In format "Europe/Rome"

locationProfileId*string

welcomePortalId*string

country*string

country code as ISO 3166-1 alpha-2.

address*string

city*string

state*string

zip*string

onNetboolean

https://cloud4wi.zendesk.com/hc/en-us/articles/200923267-What-is-the-On-Net-option-for-the-Venue-

externalIdstring

descriptionstring

categoryNamestring

tagsarray of string

itemsstring

enabledboolean

organizationPlanIdstring

internet plan id at organization level

Response

Body

generatedstring

statusstring

locationIdstring

newTagsarray of string

itemsstring

new tags added

Request

Response

Get a Location by id

List locations belongs to an organization Scope: organization_read

GEThttps://explore.cloud4wi.com//v1/locations/{lid}

Path parameters

lid*string

Location id

Response

Array with the list of Locations

Body

generatedstring

sizenumber

locationlocationListResponse (object)

idstring

location id

namestring

location name

organziationIdstring

organization id

latnumber

latitude

lngnumber

longitude

timezonestring

location's time zone

addressobject

addressstring

address

citystring

city

statestring

state/province/region

zipstring

zip/postal code

countrystring

country

externalIdstring

tagsarray of string

itemsstring

Request

Response

List Locations of the organization

Retrieve all Locations configured in the organization Role: Location Manager, Organization Manager Scope: organization_read

GEThttps://explore.cloud4wi.com//v1/organizations/{cid}/locations

Path parameters

cid*string

id of the organization (aka tenant)

Query parameters

tagsstring

Filter by a tag or a list of tags comma separated

Response

Array with the list of Locations

Body

generatedstring

sizenumber

locationsarray of locationListResponse (object)

idstring

location id

namestring

location name

organziationIdstring

organization id

latnumber

latitude

lngnumber

longitude

timezonestring

location's time zone

addressobject

addressstring

address

citystring

city

statestring

state/province/region

zipstring

zip/postal code

countrystring

country

externalIdstring

tagsarray of string

itemsstring

Request

Response

const response = await fetch('https://explore.cloud4wi.com//v1/organizations/{cid}/locations', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "loginProfileId": "text",
      "timezone": "text",
      "locationProfileId": "text",
      "welcomePortalId": "text",
      "country": "text",
      "address": "text",
      "city": "text",
      "state": "text",
      "zip": "text"
    }),
});
const data = await response.json();