Skip to main content
POST
Verify a release's uploads and publish it

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

The version POST .../releases took

Required string length: 1 - 255

Query Parameters

content_hash
string | null

The content_hash POST .../releases returned. Send it so a retry finds this push, even when another push of the same version is unfinished.

Pattern: ^[0-9a-f]{64}$

Response

Successful Response

id
string
required

The release id: the id of its source artifact

version
string | null
required

Semantic version; null for releases pushed without one

display_version
string | null
required

version, or failing that the version in the upload's metadata

content_hash
string
required
framework
enum<string>
required

The verifiers API the release targets

Available options:
v0,
v1,
unknown
created_at
string<date-time>
required
source
ReleaseArtifact · object
required
wheel
ReleaseArtifact · object | null
required

Null for a release with no uploaded wheel, such as most forks

index_status
enum<string> | null
required

State of the file index; null if indexing never started

Available options:
processing,
completed,
failed
pushed_by
Pusher · object | null
required
refs
string[]
required

Refs pointing here. latest is computed, not the stored ref

yanked
boolean
default:false

Out of latest and default listings, but still resolvable by exact version, so runs that pinned it reproduce

yank_reason
string | null

Why it was yanked, if given

metadata
Metadata · object

What the upload declared about itself