Sites

Sites
The Sites resource is the primary way of publishing and managing any sites, landing pages or any other normal web experiences within the platform.
Site model
Site object
A site object contains the following fields
Attribute
Type
Description
id
integer
unique id of the site
business_id
integer
Reference id to the Business this site is assigned to
business
object
The full Business object expanded
locations
list
List of the assigned Location objects to the site
user_id
integer
Reference id to the User that created this site
deleted
boolean
Field that denotes if the site is disabled or not
base_directory
string
For landing pages, the directory that the page will be published
formatted_domain
string
The hostname/domain where the site is published, including the domain and subdomain (i.e www.example.com)
formatted_url
string
Read-only field that formats the domain, base directory and scheme (i.e. https://www.example.com/)
domain
string
The domain part of the formatted_domain (i.e. example.com)
subdomain
string
The subdomain part of the formatted_domain (i.e. www)
https
boolean
Toggle for enabling SSL for the site
hash
string
Read only and auto-assigned unique hash for the site. Used in preview_url
published
boolean
Toggle for setting the site to a published state. A setting of false (default) will return a 404 if visited on the formatted_url
preview_url
string
Preview URL for this site. Should always be available regardless of published status
title
string
This is the internal name of the site displayed in the site editor user interfaces. Does not show on the published site
custom_fields
object
Custom field values assigned to the site
theme_settings
object
Assigned theme settings values. Support for these values is dependent on the theme
partner_site_id
string
Unique ID reference to partner IDs
language_code
string
The default language (plus specific region) for the site. Similar to the values that browsers send. Examples: en, en-us
theme_id
integer
The assigned Theme object used by the site
disable_analytics_events
list
List of events to disable automatic tracking of
noindex
boolean
Toggle to set the site as non-indexable by search engines
extra_css
string
Extra CSS to add to all the site's pages
footer_code
string
Extra HTML to add to all the site's pages right before the ending </body> tag
header_code
string
Extra HTML to add to all the site's pages right before the ending </head> tag
linklists
list
configuration of the Site's navigation menus
logo
object
fully expanded Logo object
plugins
object
Active site plugins enabled for this site
added
timestamp
Date and time site was created
modified
timestamp
Date and time site was modified
asset_url_prefix
string
Base URL that will be used to prefix static assets. This can be used to enable a CDN for serving these files.
screenshot_thumbnail
string
Link to a thumbnail image preview of the site's homepage
ssl_last_updated
string
Timestamp of when the site's SSL was last updated
www_primary
boolean
Determines if the site should be published prefixed by www. or not
vanity_domain
string
Ability to set a domain, that if pointed, will redirect to this Site
Example object:
{
  "added": "2013-06-19T11:17:13",
  "base_directory": "/",
  "business_id": 432,
  "business": {
    ... fully expanded `Business` object
  },
  "custom_fields": {
    "headline_one": "Example headline one",
    "headline_two": "Example headline two",
    "bullet_points": [
      "Bullet point one",
      "Bullet point two"
    ]
  }
  "deleted": false,
  "disable_analytics_events": ["form-submit"],
  "domain": "yourdomain.com",
  "extra_css": ".body { background-color: red }",
  "formatted_domain": "www.yourdomain.com",
  "formatted_url": "https://www.yourdomain.com/",
  "footer_code": "<script>...</script>",
  "hash": "934dc52",
  "header_code": "<meta .../>",
  "https": true,
  "id": 1234,
  "language_code": "en-us",
  "linklists": [
    ... configuration of the Site's menu
  ],
  "locations": [
    ... list of associated `Location` objects
  ],
  "logo": {
    ... fully expanded `Logo` object
  },
  "modified": "2014-01-28T13:20:13",
  "noindex": false,
  "partner_site_id": "site-12345",
  "plugins": {},
  "preview_url": "http://934dc52.whitelabel.cloudpreview.net/",
  "published": true,
  "resource_uri": "/api/v2/sites/1234/",
  "screenshot_thumbnail": "https://api.urlbox.io/v1/f45f325d-c052-4f54-a839-e3b6fb93bb73/e751570235f0e814d6e94864aa361552bb234fbb/png?url=http%3A%2F%2F934dc52.whitelabel.cloudpreview.net%2F&width=1280&thumb_width=640&height=800",
  "ssl_last_updated": null,
  "subdomain": "www",
  "theme_id": 123,
  "theme_settings": {
    "body_background_color": "#000000",
    "hide_navigation": false
  },
  "title": "Site Title (internal use only)",
  "trace_id": null,
  "user": {
    ... fully expanded `User` object
  },
  "user_id": 248114,
  "www_primary": true,
  "vanity_domain": "vanitydomain.com"
}
Custom fields
Each site that is built on the platform can be assigned custom_fields values that can then be used throughout templates and pages.
This field can contain a structured JSON object with support for nested values.
"custom_fields": {
  "headline_one": "Example headline one",
  "headline_two": "Example headline two",
  "bullet_points": [
    "Bullet point one",
    "Bullet point two"
  ]
}
From this example, the value can be used in templates via either the macro ($custom_headline_one) or via template variable ({{ site.custom_fields.headline_one }}). More examples here.
Create a site
POST /api/v2/sites/
Required fields
Attribute
formatted_domain
theme_id
title
List sites
List all sites including active, deleted, non-published and published
GET /api/v2/sites/
List all active sites
GET /api/v2/sites/?deleted=0
Parameters
Name
Type
Description
added__date
string
Filter for sites created on a particular date in YYYY-MM-DD format
business_id
string
Filter for sites associated with a particular Business
deleted
string
Return sites based on if they are active (0) or deleted/disabled (1)
formatted_domain
string
Searching by domain/subdomain similar to how you pass formatted_domain on Site creation
location_id
string
Filter for sites associated with a particular Location
order_by
string
Set the field to sort the results by. Available order_by includes id (default) and title. You can also sort decending by prefixing the field with a minus sign (i.e. order_by=-id)
partner_site_id
string
Used to lookup/search for sites matching a particular internal id
Response
{
  "meta": {
    "limit": 20,
    "next": "/api/v2/sites/?limit=20&offset=20",
    "offset": 0,
    "previous": null,
    "total_count": 1039
  },
  "objects": [
    {
      "about": "<p>Here is a description of this Site</p>",
      "added": "2013-06-19T11:17:13",
      "base_directory": "/",
      "business_id": 24305,
      "deleted": false,
      "domain": "cloudpreview.net",
      "formatted_domain": "somesite.cloudpreview.net",
      "formatted_url": "http://somesite.cloudpreview.net/",
      "hash": "934dc52",
      "id": 1281131,
      "keywords": "",
      "modified": "2014-01-28T13:20:13",
      "parent_id": null,
      "partner_site_id": null,
      "partner_sub_id": null,
      "published": true,
      "resource_uri": "/api/v2/sites/1281131/",
      "subdomain": "somesite",
      "theme_id": 449,
      "title": "Site Title (internal use only)",
      "type": "default",
      "user_id": 248114,
      "www_primary": false
    },
    {
      "about": "<p>This is Site number two</p>",
      "added": "2013-06-19T11:17:13",
      "base_directory": "/",
      "business_id": 15555,
      "deleted": false,
      "domain": "cloudpreview.net",
      "formatted_domain": "www.somerealdomain.com",
      "formatted_url": "http://www.somerealdomain.com/",
      "hash": "8c7d6s",
      "id": 1281132,
      "keywords": "",
      "modified": "2014-01-28T13:20:13",
      "parent_id": null,
      "partner_site_id": null,
      "partner_sub_id": null,
      "published": true,
      "resource_uri": "/api/v2/sites/1281132/",
      "subdomain": "www",
      "theme_id": 449,
      "title": "Site Title (internal use only)",
      "type": "default",
      "user_id": 248114,
      "www_primary": true
    },
    ...
  ]
}
Get a single site
Fetch the Site detail using the Site.id
GET /api/v2/sites/:id/
Updating a site
PUT /api/v2/sites/:id/
You can PUT a partial or full object to the detail endpoint to update/change values on the Site object. If using a partial object, you must insure that the primary site id is part of the payload.
Disabling / enabling a site
Disabling a site
To disable an active site and clear all cache references to the domain, use the DELETE method on the Site detail endpoint.
DELETE /api/v2/sites/:id/
Enabling a site
To enable a currently disabled site, you will set the param for deleted to False using the Site update endpoint.

Last modified 9mo ago

Name	Type	Description
`added__date`	`string`	Filter for sites created on a particular date in `YYYY-MM-DD` format
`business_id`	`string`	Filter for sites associated with a particular `Business`
`deleted`	`string`	Return sites based on if they are active (`0`) or deleted/disabled (`1`)
`formatted_domain`	`string`	Searching by domain/subdomain similar to how you pass formatted_domain on Site creation
`location_id`	`string`	Filter for sites associated with a particular `Location`
`order_by`	`string`	Set the field to sort the results by. Available `order_by` includes `id` (default) and `title`. You can also sort decending by prefixing the field with a minus sign (i.e. `order_by=-id`)
`partner_site_id`	`string`	Used to lookup/search for sites matching a particular internal id

Attribute	Type	Description
id	integer	unique id of the site
business_id	integer	Reference id to the Business this site is assigned to
business	object	The full Business object expanded
locations	list	List of the assigned Location objects to the site
user_id	integer	Reference id to the User that created this site
deleted	boolean	Field that denotes if the site is disabled or not
base_directory	string	For landing pages, the directory that the page will be published
formatted_domain	string	The hostname/domain where the site is published, including the domain and subdomain (i.e `www.example.com`)
formatted_url	string	Read-only field that formats the domain, base directory and scheme (i.e. `https://www.example.com/`)
domain	string	The domain part of the `formatted_domain` (i.e. `example.com`)
subdomain	string	The subdomain part of the `formatted_domain` (i.e. `www`)
https	boolean	Toggle for enabling SSL for the site
hash	string	Read only and auto-assigned unique hash for the site. Used in `preview_url`
published	boolean	Toggle for setting the site to a published state. A setting of `false` (default) will return a 404 if visited on the `formatted_url`
preview_url	string	Preview URL for this site. Should always be available regardless of published status
title	string	This is the internal name of the site displayed in the site editor user interfaces. Does not show on the published site
custom_fields	object	Custom field values assigned to the site
theme_settings	object	Assigned theme settings values. Support for these values is dependent on the theme
partner_site_id	string	Unique ID reference to partner IDs
language_code	string	The default language (plus specific region) for the site. Similar to the values that browsers send. Examples: `en`, `en-us`
theme_id	integer	The assigned Theme object used by the site
disable_analytics_events	list	List of events to disable automatic tracking of
noindex	boolean	Toggle to set the site as non-indexable by search engines
extra_css	string	Extra CSS to add to all the site's pages
footer_code	string	Extra HTML to add to all the site's pages right before the ending `</body>` tag
header_code	string	Extra HTML to add to all the site's pages right before the ending `</head>` tag
linklists	list	configuration of the Site's navigation menus
logo	object	fully expanded `Logo` object
plugins	object	Active site plugins enabled for this site
added	timestamp	Date and time site was created
modified	timestamp	Date and time site was modified
asset_url_prefix	string	Base URL that will be used to prefix static assets. This can be used to enable a CDN for serving these files.
screenshot_thumbnail	string	Link to a thumbnail image preview of the site's homepage
ssl_last_updated	string	Timestamp of when the site's SSL was last updated
www_primary	boolean	Determines if the site should be published prefixed by `www.` or not
vanity_domain	string	Ability to set a domain, that if pointed, will redirect to this Site