Skip to main content
GET
List the top level of a release's files

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

owner
string
required

Owning user or team slug

Required string length: 1 - 255
name
string
required

Package name

Required string length: 1 - 255
version
string
required

An exact PEP 440 version (1.2 is 1.2.0, never 1.2.5), a ref name such as latest, or sha256: plus at least 12 hex digits of the content hash

Required string length: 1 - 255

Response

Successful Response

kind
enum<string>
required
Available options:
directory,
file
path
string
required

Empty for the root

release_id
string
required
version
string | null
required
index_status
enum<string> | null
required

A root with no entries usually means indexing hasn't finished

Available options:
processing,
completed,
failed
entries
ReleaseFileEntry · object[]

Directories first, then files

file
ReleaseFileEntry · object | null
url
string | null

Time-limited link to a file's content

expires_at
string<date-time> | null