List cached artifacts

GET

/artifacts

curl --request GET \
  --url https://example.com/api/v1/artifacts \
  --cookie __Host-shardkeep_session=<__Host-shardkeep_session>

Global administrators only. Every server jar in the Controller’s cache, newest first.

Authorizations

• sessionCookie
• bearerToken

Responses

200

The cached artifacts.

Media typeapplication/json

object

items

required

Array<object>

object

id

required

string format: uuid

template

required

string

version

required

string

build

required

Empty for software without builds (Vanilla) or uploads without one.

string

javaVersion

required

integer

sha256

required

Lowercase hex SHA-256 of the jar.

string

sizeBytes

required

integer format: int64

source

required

UPSTREAM was downloaded from the publisher; UPLOAD was uploaded by an administrator.

string

Allowed values: UPSTREAM UPLOAD

verified

required

Checked against the checksum the publisher published. Uploads never are.

boolean

createdAt

required

string format: date-time

Example

{
  "items": [
    {
      "source": "UPSTREAM"
    }
  ]
}

401

Not signed in, or the credentials are invalid.

Media typeapplication/problem+json

An RFC 9457 problem with a machine-readable code.

object

type

required

string

title

required

string

status

required

integer

detail

string

code

required

Stable machine-readable error code.

string

Example

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "code": "conflict"
}

403

Signed in, but not allowed.

Media typeapplication/problem+json

An RFC 9457 problem with a machine-readable code.

object

type

required

string

title

required

string

status

required

integer

detail

string

code

required

Stable machine-readable error code.

string

Example

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "code": "conflict"
}