Skip to content
GitmoapAPIBeta
Schema

ProviderListingDetail

Everything a provider's marketplace page shows: its card, README, links, examples, publisher and versions.

Shape

  • categoriesarray of Category: one of source-control | build | test | quality | security | release | deploy | infrastructure | notify | other
  • examplesarray of ProviderExample
    • The ProviderExample schema
    • capability_idsarray of CapabilityId (string)The capabilities this example exercises; each must exist in some published version of the provider (validated at write time).
    • descriptionstringOne- or two-sentence summary (<= 500 chars).
    • snippetstringA pipeline YAML/JSON fragment (<= 8 KB).
    • titlestringShort heading (<= 120 chars).
  • keywordsarray of Keyword (string)
  • namespace_verifiedboolean
  • providerMarketplaceProviderCard
    • The MarketplaceProviderCard schema
    • categoriesarray of Category: one of source-control | build | test | quality | security | release | deploy | infrastructure | notify | other
    • created_atstring
    • descriptionstring
    • idProviderId (string)
    • keywordsarray of Keyword (string)
    • namestring
    • namespace_verifiedbooleanWhether the provider's publisher has verified its namespace. false for providers gitmoap builds itself, which have no publisher.
    • signedbooleanWhether the latest version's images are signed by gitmoap, as platform and verified providers' are.
    • tierProviderTierplatformverifiedcommunityprivateHow a pipeline provider is distributed and how much it is vouched for.
    • updated_atstring
    • featured_rankinteger · int32 or nulloptional0–∞Where gitmoap features the provider: lower numbers are placed higher. Absent when it is not featured.
    • install_countinteger · int64 or nulloptional0–∞How many organizations have installed the provider. Absent for providers gitmoap builds itself.
    • latest_versionProviderVersion (string) or nulloptional
    • lifecycle_stateVersionLifecycleactivedeprecatedsunsetor nulloptionalWhere the latest version is in its life: active, deprecated or sunset.
    • publisher_idPublisherId (string · uuid) or nulloptional
  • versionsarray of ListingVersionView
    • The ListingVersionView schema
    • lifecycle_stateVersionLifecycleactivedeprecatedsunsetLifecycle state of a published ProviderVersionManifest. Active is the default; Deprecated still runs but the trigger-time validator surfaces a warning; Sunset runs only inside its grace window, after which a trigger referencing it fails validation.
    • published_atstring
    • published_bystring
    • sbom_availablebooleanWhether a software bill of materials (SBOM) is available for this version, as it is for platform and verified providers.
    • signedboolean
    • versionProviderVersion (string)
    • changelogMarkdownDoc (string) or nulloptional
  • homepage_urlHttpsUrl (string) or nulloptional
  • install_countinteger · int64 or nulloptional0–∞
  • publisherPublisherBadge or nulloptional
    • The PublisherBadge schema
    • display_namestring
    • namespacePublisherNamespace (string)
    • publisher_idPublisherId (string · uuid)
    • verifiedboolean
    • verification_methodVerificationMethodmanualdnsgithubor nulloptionalHow the publisher was verified, so you can judge how strong the check was. Absent until verified.
    • verification_targetstring or nulloptional
  • readmeMarkdownDoc (string) or nulloptional
  • repository_urlHttpsUrl (string) or nulloptional

Example

Synthesized example
{
"categories": [
"source-control",
"source-control"
],
"examples": [
{
"capability_ids": [],
"description": "Renders each region as density contours of its operations.",
"snippet": "snippet-83a2",
"title": "Pin a page's payload to the build that rendered it"
}
],
"keywords": [
"keywords-1b74",
"keywords-79e1"
],
"namespace_verified": false,
"provider": {
"categories": [
"source-control"
],
"created_at": "2026-10-12T18:27:11Z",
"description": "Renders each region as density contours of its operations.",
"id": "id-eeca",
"keywords": [
"keywords-8d5b",
"keywords-9158"
],
"name": "payments-api",
"namespace_verified": false,
"signed": false,
"tier": "platform",
"updated_at": "2026-10-16T19:31:59Z",
"visibility": {
"kind": "public"
},
"featured_rank": 51,
"install_count": 0,
"latest_version": "latest-version-f488",
"lifecycle_state": "active",
"publisher_id": "36a9043d-9ab1-436d-97f5-e0749521c2cb"
},
"versions": [
{
"lifecycle_state": "active",
"published_at": "2026-10-11T08:57:05Z",
"published_by": "a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"sbom_available": false,
"signed": false,
"version": "version-bfec"
}
],
"homepage_url": "https://gitmoap.example/acme/c041b6da",
"install_count": 6,
"publisher": {
"display_name": "Lin Park",
"namespace": "namespace-63b2",
"publisher_id": "36859d5f-6b4a-424d-8336-4d0a5ef27aab",
"verified": false,
"verification_method": "manual",
"verification_target": "verification-target-226c"
},
"readme": "readme-c53e",
"repository_url": "https://gitmoap.example/acme/eebb8d4e"
}

Graph

Used inside

No schema contains this one.

Used by