= CADAC Web Service API =


== URIs, Methods and Representations  ==

=== Notes ===

All URIs are prefixed by {{{/xml}}}.

{{{<root>}}} indicates the root tag of an XML instance document used as input ('''Request Body'''), or returned ('''Response Body'''). Blank cells indicate that either no content is expected, or no content is returned.

{{{[/]}}} denotes an optional trailing slash.

Currently, {{{GET}}}s are world-readable. All other methods require authorization.

=== {{{/runs[/]}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{POST}}}    || Adds a new run ||  {{{<Run>}}} ||  {{{<id>}}} ||


=== {{{/runs/{run}}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns {{{{run}}}} ||        || {{{<Run>}}} ||
|| {{{DELETE}}} || Deletes {{{{run}}}} || || ||
|| {{{POST}}} || Adds or updates {{{{run}}}} elements  || {{{<Run>}}} || ||


=== {{{/runs/{run}/tags[/]}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns the list of tags for {{{{run}}}} ||        || {{{<TagList>}}} ||
|| {{{DELETE}}} || Deletes all tags for {{{{run}}}} || || ||

=== {{{/members/{user}/tags[/]}}} ===

|| '''Method'''  || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}     || Returns a list of {{{{user}}}}'s tags ||  || {{{<TagList>}}} ||

=== {{{/members/{user}/runs[/]}}} ===

|| '''Method'''  || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}     || Returns a list of {{{{user}}}}'s runs ||  || {{{<RunList>}}} ||


=== {{{/members/{user}/runs/{run}}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns {{{{run}}}} ||        || {{{<Run>}}} ||

=== {{{/members/{user}/runs/{run}/tags[/]}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns the list of tags for {{{{run}}}} ||        || {{{<TagList>}}} ||

=== {{{/members/{user}/runs/{run}/tags/{tag}}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns the list of tags for {{{{run}}}} with value {{{{tag}}}} ||        || {{{<TagList>}}} ||
|| {{{DELETE}}} || Deletes {{{{user}}}}'s tags for {{{{run}}}} with value {{{{tag}}}} || || ||
|| {{{POST}}} || Tags {{{{run}}}} with {{{{tag}}}} for {{{{user}}}} || || ||


=== {{{/members/{user}/{tag}/runs[/]}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns a list of {{{{user}}}}'s runs with {{{{tag}}}} ||        || {{{<RunList>}}} ||

=== {{{/members/{user}/{tag}/runs/{run}}}} ===

|| '''Method''' || '''Action''' || '''Request Body''' || '''Response Body''' ||
|| {{{GET}}}    || Returns {{{{run}}}} ||        || {{{<Run>}}} ||