Skip to main content

 Services

Web services from /about to /webhooks

list labels

/groups/{group}/labels [GET]

Description

Returns the list of labels in a group.

Parameters

NameDescriptionRequiredTypeDefault value
typesComma-separated list of label types to returnnostring

The label type can be any combination of:

  • comment
  • fragment
  • edit-note
  • version
  • creation
  • upload
  • document
  • xref
  • content-inline
  • ​content-block

Permission

This service requires guest unless the group is accessible to public.

Response

The output has the following format:

<label-config scope="[server|project|document]"
              template="[project]"
              updated="[updated date time]"> 
  <labels type="[comment|
                 fragment|
                 edit-note|
                 version|
                 creation|
                 upload|
                 document|
                 xref|
                 content-inline|
                 content-block]"> 
    <label name="[label name]" description="[label description]"/>
    <label name="[label name]" description="[label description]"/>
    ...
  </labels> 
  ... 
</label-config>

Error Handling

No specific errors expected for this service.

Created on , last edited on