Site resource

Get site - Get site v2

OVERVIEW



Note: The specification has been updated in Collaborate 4.3

The get site API returned the details for a site. Anyone with site access in Collaborate is permitted to use this API endpoint.

The fields returned for the site object are determined based on user permissions. If the user is a site admin user then they will get fields like Admin Notes otherwise not.

The current implementation does not include logo link. 

The response object contains the user ID of the site owner.

The API responds with an access denied message when “My site” details of another user are accessed. 

Blank values for individual fields are not returned in the XML response, absence of value in the returned XML means that either the value does not exist for that field or the user does not have access to that field.

Request

GET:   /sites/{siteid}

Parameters

 

Parameter Name

Value

Description

siteid

Int

The ID for the site in question

 

Response

<?xml version="1.0" encoding="UTF-8"?>

<sites>

    <site>

        <id>1</id>

        <sitename>My site</sitename>

        <role></role> (CONTENT_ADMIN, MEMBER_ADMIN, QA_ADMIN, REPORTING_ADMIN, SITE_ADMIN, SYSTEM_ADMIN, CREATE_SITE_ROLE)

        <sitedescription />

        <sitefolderID>1</sitefolderID>

        <sitefolderpermission>UPDATE</sitefolderpermission>

        <adminnote />

        <category>

            <id>1</id>

            <name>None</name>

        </category>

        <startdate/>

        <enddate />

        <createddate>14 Mar 2014</createddate>

        <type>Service</type>

        <clientno />

        <matterno />

        <status>Active</status>

        <size>49.34MB</size>

        <rawsitesize> (Added in 4.2 )

            <activedocumentsize>51733834</activedocumentsize>

            <deleteddocumentsize>821711</deleteddocumentsize>

            <totalsize>52555545</totalsize>

        </rawsitesize>

        <rawsitesize>

            <activedocumentsize>50614591</activedocumentsize>

            <deleteddocumentsize>821711</deleteddocumentsize>

            <totalsize>51436302</totalsize>

        </rawsitesize>

        <file>

            <permissionlevel>SITE_AND_FOLDERS</permissionlevel> (SITE_ONLY/SITE_AND_FOLDERS/SITE_FOLDERS_AND_FILES- Added in 4.1.4 )

        </file>

        <issyncable>1</issyncable> (Added in 4.1.4 ) (0 : restriction applied, 1 : not restriction applied)

         <siteowner>

               <firstname>First</firstname>

               <lastname>Last</lastname>

               <email>first.last@domain.com</email>

               <userid>103</userid>

        </siteowner>

    </site>

</sites>

In the case of an invalid site ID an error object is returned.

Please note that the site parameter is permissions specific, and only site admins will be returned the size of a site. 

 

Comments


14 Comments

Last Updated: Jun 09,2023