List all comments of a confirmation

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

Comments can only be returned for a particular confirmation.
Therefore _confirmation/id is a mandatory parameter.

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

Get a single comment

GET /api/confirmation-comments/{id}
<?xml version="1.0" encoding="UTF-8"?>
<confirmation-comment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <confirmation_id type="integer">1</confirmation_id>
    <user_id type="integer">1</user_id>
    <comment>Confirmation created.</comment>
    <actionkey>CREATED</actionkey>
    <public>0</public>
</confirmation-comment>

actionkey

The value for actionkey indicates by what kind of comment it is. It is set for all actions that were triggered by the system.
With the actionkey a filtering is possible. In this case, multiple values ​​can be specified. They are separated by a comma.

GET /api/confirmation-comments?confirmation_id={confirmation_id}&actionkey=CREATE,COPY
actionkeyDescription
COMMENTa comment that was entered by the user
CREATEcreated
COPYcopied
STATUSstatus changed
MAILsent (e-mail)
LETTERsent (letter)
FAXsent (fax)
CANCELcanceled
ERROR_MAILe-mail error

Create comment

POST /api/confirmation-comments
XML elementDescriptionTypeDefault valueMandatory
confirmation_idID of the confirmationINTyes
commentCommen textALNUMyes
publicShould the comment be displayed in the customer portal (0 = no, 1 = yes)?BOOL0no
<confirmation-comment>
    <confirmation_id>1</confirmation_id>
    <comment>Let's go</comment>
</confirmation-comment>
<?xml version="1.0" encoding="UTF-8"?>
<confirmation-comment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <confirmation_id type="integer">1</confirmation_id>
    <user_id type="integer">1</user_id>
    <comment>Let's go</comment>
    <actionkey>COMMENT</actionkey>
    <public>0</public>
</confirmation-comment>

Delete comment

DELETE /api/confirmation-comments/{id}