List all tags (tagcloud)

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

List all tags for an incoming invoice

GET /api/incoming-tags?incoming_id={incoming_id}

Tags can only be returned for a particular incoming.
Therefore incoming_id is a mandatory parameter.

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

Get single tag

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

Create tag

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

Delete tag

DELETE /api/incoming-tags/{id}