Site

Update an existing site

Changed on

Updates the properties of an existing site. The site to update is identified by the 'id' query parameter (also referred to as 'siteId' or 'hostId' in other parts of the API). Requires access to the Sites portlet.

put/api/v1/site

Request

Query parameters

idstring required

Identifier of the site to update (siteId/hostId are used interchangeably)

Request body

aliasesstring

Comma- or newline-separated list of host aliases (alternate hostnames) for this site.

siteNamestring required

The hostname of the site, e.g. 'www.example.com'. This is the site's primary name.

tagStoragestring

Identifier of the site whose tag storage this site shares. Defaults to this site itself when omitted.

siteThumbnailstring

Identifier of the image asset used as the site thumbnail.

runDashboardboolean

Whether the analytics dashboard runs for this site.

keywordsstring

Default meta keywords applied to pages on this site.

descriptionstring

Default meta description applied to pages on this site.

googleMapstring

Google Maps API key for this site.

googleAnalyticsstring

Google Analytics tracking ID for this site.

addThisstring

AddThis sharing-widget account ID for this site.

proxyUrlForEditModestring

Proxy URL used to render the site in edit mode.

embeddedDashboardstring

Embedded dashboard markup for this site.

languageIdinteger

Default language ID for this site. Defaults to the system default language when 0/omitted.

identifierstring

Identifier of the site. Ignored on creation; server-generated.

inodestring

Inode (version identifier) of the site. Ignored on creation; server-generated.

defaultboolean
forceExecutionboolean

Whether to force creation even when validation would otherwise warn (e.g. a duplicate alias).

Response

Site updated successfully

entityobject
i18nMessagesMapobject
permissionsstring[]

Changes

    • breaking

      request body became required

    • breaking

      removed the media type */* from the request body

    • breaking

      the query request parameter id became required

    • info

      api tag Site added

    • info

      added the media type application/json to the request body

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the success response with the status