List all tags (tagcloud)

GET /api/confirmation-tags
<?xml version="1.0" encoding="UTF-8"?>
<confirmation-tags type="array" page="1" per_page="100" total="2">
    <confirmation-tag>
        <id type="integer">1</id>
        <name>foo</name>
        <count type="integer">12</count>
    </confirmation-tag>
    <confirmation-tag>
        <id type="integer">1</id>
        <name>bar</name>
        <count type="integer">7</count>
    </confirmation-tag>
</confirmation-tags>

List all tags for a confirmation

GET /api/confirmation-tags?confirmation_id={confirmation_id}

Tags can only be returned for a particular confirmation.
Therefore confirmation_id is a mandatory parameter.

<?xml version="1.0" encoding="UTF-8"?>
<confirmation-tags type="array" page="1" per_page="100" total="2">
    <confirmation-tag>
        ...
    </confirmation-tag>
    <confirmation-tag>
        ...
    </confirmation-tag>
</confirmation-tags>

Get single tag

GET /api/confirmation-tags/{id}
<?xml version="1.0" encoding="UTF-8"?>
<confirmation-tag>
    <id type="integer">1</id>
    <confirmation_id type="integer">1</confirmation_id>
    <name>foo</name>
</confirmation-tag>

Create tag

POST /api/confirmation-tags
XML element Description Type Default-Wert Mandatory
confirmation_id ID of the confirmation INT yes
name Name of the tag ALNUM yes
<confirmation-tag>
    <confirmation_id>1</confirmation_id>
    <name>foo</name>
</confirmation-tag>
<?xml version="1.0" encoding="UTF-8"?>
<confirmation-tag>
    <id type="integer">1</id>
    <confirmation_id type="integer">1</confirmation_id>
    <name>foo</name>
</confirmation-tag>

Delete tag

DELETE /api/confirmation-tags/{id}