Update Provider
Update provider metadata (author only).
Only the provider’s author (matching tenant) can update metadata.
Returns: The updated provider record.
Raises: HTTPException: If user is not the provider author.
Body
Request model for updating provider metadata.
Only provided (non-None) fields are updated.
Attributes: display_name: Human-readable name for UI display. description: Short description of what the provider does. readme: Long-form documentation in markdown. tags: Searchable tags for categorization. icon_url: URL to provider icon image.
Response
Successful Response
Provider listing in the catalog.
Provider identity is stored as two separate fields: prefix and
name. The prefix is an opaque namespace token (either the
literal "pragmatiks" for catalog providers owned by Pragmatiks
or a customer organization slug). The name is the provider's
short name (e.g. pragma, gcp). Use :attr:canonical when a
display string or URL path is needed.
Identity fields (frozen):
prefix: Namespace token ("pragmatiks" or a customer org slug).
name: Provider short name within the prefix.
Metadata: display_name: Human-readable name for UI display. description: Short description of what the provider does. author: Publishing organization metadata. scope: Visibility scope (public or tenant-only). icon_url: URL to provider icon image. readme: Long-form documentation in markdown. tags: Searchable tags for categorization.
State (system-managed): latest_version: Semver of the most recent published version. install_count: Total number of tenant installations.
Author metadata for a provider.
Every provider is owned by exactly one publishing organization,
identified by organization_id. First-party providers are owned
by the reserved pragmatiks organization; customer providers are
owned by the publishing tenant's organization.
Attributes: organization_id: Organization ID of the publishing tenant. display_name: Human-facing label shown in catalog listings and the web UI.
Slash-joined prefix/name canonical string.
Returns: Display form of the provider identity, used in CLI output, web UI labels, and URL paths.
Scope of a provider in the catalog.
public, tenant