Skip to main content
POST
/
providers
/
{org}
/
{name}
/
publish
Publish Version
curl --request POST \
  --url https://api.example.com/providers/{org}/{name}/publish \
  --header 'Content-Type: multipart/form-data' \
  --form 'code=<string>' \
  --form 'version=<string>' \
  --form 'changelog=<string>' \
  --form 'display_name=<string>' \
  --form 'description=<string>' \
  --form 'tags=<string>' \
  --form 'icon_url=<string>'
{
  "provider_name": "<string>",
  "version": "<string>",
  "runtime_version": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "image_url": "<string>",
  "source_hash": "<string>",
  "build_id": "<string>",
  "schemas": [
    {}
  ],
  "changelog": "<string>",
  "status": "building",
  "published_at": "2023-11-07T05:31:56Z",
  "error_message": "<string>"
}

Path Parameters

​
org
string
required
​
name
string
required

Body

multipart/form-data
​
code
string
required
​
version
string
required
​
changelog
string | null
​
display_name
string | null
​
description
string | null
​
tags
string | null
​
icon_url
string | null

Response

Successful Response

A published version of a provider.

Identity fields (frozen): provider_name: Globally unique provider name this version belongs to. version: Semantic version string (e.g., "1.0.0").

Build metadata: runtime_version: Pinned runtime version used to build the image. image_url: Built container image URL (set after build completes). source_hash: SHA-256 of the source tarball.

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.

​
provider_name
string
required
​
version
string
required
​
runtime_version
string
required
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
image_url
string | null
​
source_hash
string | null
​
build_id
string | null
​
schemas
Schemas · object[] | null
​
changelog
string | null
​
status
enum<string>
default:building

Build/publish status for a provider version.

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