Redmine

h1. Files

{{>toc}}

h2. /projects/:project_id/files.:format

h3. GET

Returns the files available for the project of given id or identifier (:project_id).

+Examples+:

<pre>

GET /projects/foo/files.xml

GET /projects/1/files.xml

</pre>

+Response+:

<pre>

<?xml version="1.0" encoding="UTF-8"?>

<files type="array">

  <file>

    <id>12</id>

    <filename>foo-1.0-setup.exe</filename>

    <filesize>74753799</filesize>

    <content_type>application/octet-stream</content_type>

    <description>Foo App for Windows</description>

    <content_url>http://localhost:3000/attachments/download/12/foo-1.0-setup.exe</content_url>

    <author id="1" name="Redmine Admin"/>

    <created_on>2017-01-04T09:12:32Z</created_on>

    <version id="2" name="1.0"/>

    <digest>1276481102f218c981e0324180bafd9f</digest>

    <downloads>12</downloads>

  </file>

  <file>

    <id>11</id>

    <filename>foo-1.0.dmg</filename>

    <filesize>6886287</filesize>

    <content_type>application/x-octet-stream</content_type>

    <description>Foo App for macOS</description>

    <content_url>http://localhost:3000/attachments/download/11/foo-1.0.dmg</content_url>

    <author id="1" name="Redmine Admin"/>

    <created_on>2017-01-04T09:12:07Z</created_on>

    <version id="2" name="1.0"/>

    <digest>14758f1afd44c09b7992073ccf00b43d</digest>

    <downloads>5</downloads>

  </file>

</files>

</pre>

h3. POST

Upload a file for the project of given id or identifier (:project_id).

+Parameters+:

* @file@ (required): a hash of the version attributes, including:

  * @token@ (required): a token for your uploaded file. See [[Rest_api#Attaching-files|Attaching files]].

  * @version_id@

  * @filename@

  * @description@

+Examples+:

<pre>

POST /projects/1/files.xml

<?xml version="1.0"?>

<file>

  <token>21.01a1d7b1c2ffcbbc9ecf14debeec27d8</token>

  <version_id>2</version_id>

  <filename>foo-1.0-src.tar.tgz</filename>

  <description>Foo App source code</description>

</file>

</pre>