Skip to main content
GET
Get Version Detail

Path Parameters

org
string
required
name
string
required
version
string
required

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.

prefix
string
required
name
string
required
version
string
required
distribution_name
string
required
Required string length: 1 - 200
canonical
string
required
read-only

Slash-joined prefix/name canonical string of the owning provider.

Returns: Display form of the provider identity this version belongs to.

created_at
string<date-time>
updated_at
string<date-time>
wheel_filename
string | null
Minimum string length: 1
wheel_sha256
string | null
Pattern: ^[0-9a-f]{64}$
package
string | null
summary
string | null
keywords
string[]
schemas
Schemas · object[] | null
python_version
string | null
sdk_version
string | null
protocol_versions
integer[]
embedded_providers
Embedded Providers · object
operation_deadline_at
string<date-time> | null
changelog
string | null
status
enum<string>
default:pending

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.

Available options:
pending,
published,
failed
published_at
string<date-time> | null
failure_category
enum<string> | null

Why a provider version failed admission.

Available options:
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
error_message
string | null