Get artifact files

GET

/v1/artifacts/{id}/files

const url = 'https://shareout.site/v1/artifacts/example/files';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://shareout.site/v1/artifacts/example/files \
  --header 'Authorization: Bearer <token>'

Fetch all files for an artifact version. Requires viewer access or higher.

Authorizations

bearerAuth

Parameters

Path Parameters

required

string

Artifact ID (e.g. art_abc123).

Query Parameters

version

string

Version number or ID. Defaults to the latest.

Responses

200

Files for the version

application/json

object

artifact_id

string

version_id

string

files

Array<object>

object

path

required

string

content

required

string

mime

string

encoding

string

Allowed values: utf8 base64

size_bytes

integer

Example

{
  "files": [
    {
      "encoding": "utf8"
    }
  ]
}

404

Resource not found

application/json

object

success

required

boolean

error

required

Human-readable message.

string

code

required

Machine-readable error code.

string

Example

{
  "success": false
}