List all tags (tagcloud)

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

List all tags of a specific recurring invoice

GET /api/recurring-tags?recurring_id={recurring_id}

Keywords can only be returned for a particular recurring.
Therefore recurring_id is a mandatory parameter.

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

Get a single tag

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

Create a tag

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

Delete tag

DELETE /api/recurring-tags/{id}