Get Version Detail
Get detail for a specific provider version.
Public endpoint. The authoring organization sees the version in any status, so a publisher can follow its admission; everyone else sees only published versions.
Returns: Provider version detail.
Response
Successful Response
One version of a provider, from upload through admission.
registry_pins, declared_embeds, lock, operation_id and
operation_type are stored but never serialized: the pins, declared
embeds and lock are the platform's admission and install inputs, the
lock can run to megabytes, and the operation fields are the platform's
fence for in-flight admission, meaningless to callers.
Identity fields (frozen): prefix: Namespace token of the owning provider. name: Provider short name this version belongs to. version: Semantic version string (e.g., "1.0.0").
Wheel:
wheel_filename: Filename of the wheel as renamed to the owner's
distribution name; the registry stores the wheel under it.
wheel_sha256: SHA-256 digest of the wheel bytes as renamed to
the owner's distribution name.
distribution_name: Wheel distribution name the version is
published under, <prefix>-<name> canonicalized.
package: Importable package that holds the provider.
summary: Core-metadata summary of the wheel, used as the catalog
description when the version creates the provider.
keywords: Core-metadata keywords of the wheel, used as the catalog
tags when the version creates the provider.
Admission inputs:
registry_pins: Canonical distribution names the version resolves
only from the Pragmatiks registry, computed at publish; the
pin set its installs use.
declared_embeds: Canonical distribution names the wheel declares
under pragma.embeds.
Admission results:
schemas: Resource type schemas reported by introspection, each
keyed on "resource".
python_version: Python minor ("3.14") the version was admitted on.
lock: Resolved uv.lock text the version installs from.
sdk_version: Pragmatiks SDK version the lock resolved.
protocol_versions: Host protocol versions the provider speaks.
embedded_providers: Pragmatiks providers the version installs,
distribution name to locked version.
Operation (system-managed):
operation_id: Fence token of the admission in flight; every write
after pending must match it.
operation_type: Kind of operation in flight, always publish.
operation_deadline_at: When the admission must finish; set when
the provider host first takes it.
State (system-managed):
changelog: Release notes supplied at publish.
status: Publish lifecycle status.
published_at: Timestamp when the version was published.
failure_category: Why admission failed, when failed.
error_message: User-facing failure message, when failed.
1 - 200Slash-joined prefix/name canonical string of the owning provider.
Returns: Display form of the provider identity this version belongs to.
1^[0-9a-f]{64}$Publish lifecycle status for a provider version.
pending while the organization's provider host admits the uploaded
wheel, then published (terminal) or failed. A failed version
may be published again under the same version number.
pending, published, failed Why a provider version failed admission.
upload_failed, digest_mismatch, python_unavailable, dependency_resolution_failed, undeclared_embedded_provider, unregistered_embedded_provider, embedded_provider_not_depended_on, unsupported_protocol, import_failed, missing_observe, stored_wheel_conflict, deadline_exceeded, platform_error, organization_deleted