Skip to main content
POST
Publish Provider Version

Body

multipart/form-data
metadata
string
required
wheel
string
required

Response

Successful Response

A published version of a provider.

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").

Build metadata: wheel_sha256: SHA-256 digest of the wheel bytes, computed server-side at publish time as a catalog audit field. package_name: Optional importable Python package name inside a wheel-published provider. When absent, the runtime attempts to infer it from installed wheel metadata. entrypoint: Optional override of the runtime entrypoint command (e.g. ["python", "-m", "custom_runtime"]). None keeps the default python -m pragma_runtime.entrypoint. source_hash: SHA-256 of the source tarball on legacy rows.

Provider introspection: schemas: Resource type schemas extracted from the provider.

State (system-managed): status: Build/publish lifecycle status. published_at: Timestamp when version was published. error_message: Error details when build fails.

prefix
string
required
name
string
required
version
string
required
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_sha256
string | null
Pattern: ^[0-9a-f]{64}$
package_name
string | null
Required string length: 1 - 200
entrypoint
string[] | null
source_hash
string | null
build_id
string | null
schemas
Schemas · object[] | null
changelog
string | null
status
enum<string>
default:building

Publish lifecycle status for a provider version.

Available options:
building,
published,
failed,
yanked
published_at
string<date-time> | null
error_message
string | null