diff --git a/rust/Cargo.lock b/rust/Cargo.lock index a5da838f..44ca49c3 100644 --- a/rust/Cargo.lock +++ b/rust/Cargo.lock @@ -3268,9 +3268,9 @@ dependencies = [ [[package]] name = "quinn-udp" -version = "0.5.15" +version = "0.5.16" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "35a133f956daabe89a61a685c2649f13d82d5aa4bd5d12d1277e1072a21c0694" +checksum = "af66907df18639dcf4db56ca65490cabc4b27a97dbadd96f2926cca73298f016" dependencies = [ "cfg_aliases", "libc", diff --git a/rust/platform-app-client/graphql/Application.graphql b/rust/platform-app-client/graphql/Application.graphql index 61e97b56..2e9991e9 100644 --- a/rust/platform-app-client/graphql/Application.graphql +++ b/rust/platform-app-client/graphql/Application.graphql @@ -5,6 +5,7 @@ query Application($name: String!) { name description status + distributionType url proxyUrl } diff --git a/rust/platform-app-client/graphql/ApplicationWithLatestRelease.graphql b/rust/platform-app-client/graphql/ApplicationWithLatestRelease.graphql index 7f1bd00c..6995ed91 100644 --- a/rust/platform-app-client/graphql/ApplicationWithLatestRelease.graphql +++ b/rust/platform-app-client/graphql/ApplicationWithLatestRelease.graphql @@ -5,6 +5,7 @@ query ApplicationWithLatestRelease($name: String!) { name description status + distributionType url proxyUrl authorizationScopes diff --git a/rust/platform-app-client/graphql/ApplicationsList.graphql b/rust/platform-app-client/graphql/ApplicationsList.graphql index 7f41c45d..f926d6d4 100644 --- a/rust/platform-app-client/graphql/ApplicationsList.graphql +++ b/rust/platform-app-client/graphql/ApplicationsList.graphql @@ -7,6 +7,7 @@ query ApplicationsList($status: ApplicationStatusFilter) { name description status + distributionType url proxyUrl } diff --git a/rust/platform-app-client/graphql/CreateApplication.graphql b/rust/platform-app-client/graphql/CreateApplication.graphql index 45845cce..2542b2b3 100644 --- a/rust/platform-app-client/graphql/CreateApplication.graphql +++ b/rust/platform-app-client/graphql/CreateApplication.graphql @@ -7,6 +7,7 @@ mutation CreateApplication($input: MutationCreateApplicationInput!) { name description status + distributionType url proxyUrl authorizationScopes diff --git a/rust/platform-app-client/graphql/UpdateApplication.graphql b/rust/platform-app-client/graphql/UpdateApplication.graphql index c7fff622..49b6ecfe 100644 --- a/rust/platform-app-client/graphql/UpdateApplication.graphql +++ b/rust/platform-app-client/graphql/UpdateApplication.graphql @@ -6,6 +6,7 @@ mutation UpdateApplication($id: String!, $input: MutationUpdateApplicationInput! name description status + distributionType url proxyUrl authorizationScopes diff --git a/rust/platform-app-client/graphql/schema.graphql b/rust/platform-app-client/graphql/schema.graphql index b35c13c8..96be699b 100644 --- a/rust/platform-app-client/graphql/schema.graphql +++ b/rust/platform-app-client/graphql/schema.graphql @@ -499,6 +499,11 @@ type ApplicationRelease { """The native extensions registered with this release.""" nativeExtensions: [ApplicationNativeExtension!]! + """ + The authorization scopes required by this release. These are added to the application's authorization scopes when the release is created. + """ + scopes: [String!] + """The settings capabilities registered with this release.""" settings( """Filter settings by Commerce settings group slug.""" @@ -815,7 +820,10 @@ scalar DateTime """The distribution type for an application.""" enum DistributionType { """Application has custom distribution.""" - CUSTOM + CUSTOM @deprecated(reason: "Use PRIVATE instead.") + + """Application is privately distributed.""" + PRIVATE """Application is publicly available.""" PUBLIC @@ -1179,7 +1187,7 @@ input MutationCreateApplicationInput { """ The authorization scopes of the application. Defines the GoDaddy permissions for the application. """ - authorizationScopes: [String!] + authorizationScopes: [String!] @deprecated(reason: "Manage scopes per release via createRelease; retained for backward compatibility and can only extend the application's scopes.") """The description of the application.""" description: String @@ -1246,6 +1254,11 @@ input MutationCreateReleaseInput { """The native extensions associated with the release.""" nativeExtensions: [ApplicationNativeExtensionCreateInput!] + """ + The authorization scopes required by this release (e.g. 'commerce.orders:read'). New scopes are also added to the application's authorization scopes. + """ + scopes: [String!] + """The settings capabilities associated with the release.""" settings: [ApplicationSettingCreateInput!] @@ -1314,13 +1327,13 @@ input MutationUpdateApplicationInput { """ The authorization scopes of the application. Defines the GoDaddy permissions for the application. """ - authorizationScopes: [String!] + authorizationScopes: [String!] @deprecated(reason: "Manage scopes per release via createRelease; retained for backward compatibility and can only extend the application's scopes.") """The description of the application.""" description: String """ - The distribution type for the application (PUBLIC or CUSTOM). Omit to leave unchanged. + The distribution type for the application (PUBLIC or PRIVATE; CUSTOM is deprecated). Omit to leave unchanged. """ distributionType: DistributionType @@ -1523,6 +1536,9 @@ type Query { enablementsByRelease( after: String before: String + + """Optional entity ID to filter enablements by.""" + entityId: String first: Int last: Int diff --git a/rust/platform-app-client/src/lib.rs b/rust/platform-app-client/src/lib.rs index fd96c022..7ade8379 100644 --- a/rust/platform-app-client/src/lib.rs +++ b/rust/platform-app-client/src/lib.rs @@ -235,8 +235,8 @@ mod tests { "data": { "applications": { "edges": [ - { "node": { "id": "a1", "label": "Active", "name": "active-app", "description": null, "status": "ACTIVE", "url": null, "proxyUrl": null } }, - { "node": { "id": "a2", "label": "Inactive", "name": "inactive-app", "description": null, "status": "INACTIVE", "url": null, "proxyUrl": null } } + { "node": { "id": "a1", "label": "Active", "name": "active-app", "description": null, "status": "ACTIVE", "distributionType": "PUBLIC", "url": null, "proxyUrl": null } }, + { "node": { "id": "a2", "label": "Inactive", "name": "inactive-app", "description": null, "status": "INACTIVE", "distributionType": "PUBLIC", "url": null, "proxyUrl": null } } ] } } @@ -287,6 +287,7 @@ mod tests { "version": "1.0.0", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "activatedAt": "2026-09-18T00:00:00Z", "createdAt": "2026-09-18T00:00:00Z", "updatedAt": "2026-09-18T00:00:00Z" @@ -382,6 +383,7 @@ mod tests { "name": "my-app", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "url": null, "proxyUrl": null, "authorizationScopes": [], @@ -406,6 +408,7 @@ mod tests { "name": "observed-app", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "url": null, "proxyUrl": null } diff --git a/rust/schemas/api/app-registry.json b/rust/schemas/api/app-registry.json index bf7d204f..69ab6d57 100644 --- a/rust/schemas/api/app-registry.json +++ b/rust/schemas/api/app-registry.json @@ -239,6 +239,12 @@ "required": false, "type": "String" }, + { + "description": "Optional entity ID to filter enablements by.", + "name": "entityId", + "required": false, + "type": "String" + }, { "name": "first", "required": false, @@ -727,7 +733,7 @@ } ], "schemaRef": "./schema.graphql", - "sdl": "type Application {\n \"\"\"The timestamp of when the Application was activated.\"\"\"\n activatedAt: DateTime\n\n \"\"\"The timestamp of when the Application was archived.\"\"\"\n archivedAt: DateTime\n\n \"\"\"\n The authorization scopes that the OAuth2 client has access to and will use to call API endpoints.\n \"\"\"\n authorizationScopes: [String!]!\n\n \"\"\"\n Earliest linked OAuth client ID for this application by createdAt then id (includes NULL-secret and ARCHIVED apps).\n \"\"\"\n clientId: ID\n\n \"\"\"\n The primary OAuth client secret for this application. Only returned on application creation.\n \"\"\"\n clientSecret: String\n\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The timestamp of when the Application was deactivated.\"\"\"\n deactivatedAt: DateTime\n\n \"\"\"General information about your application.\"\"\"\n description: String\n\n \"\"\"The distribution type for this application.\"\"\"\n distributionType: DistributionType!\n\n \"\"\"The globally-unique ID of the Application.\"\"\"\n id: ID!\n\n \"\"\"A human-readable label of the Application for display purposes.\"\"\"\n label: String!\n\n \"\"\"\n Paginated listings for this application. Requires read scope. When using the filter, `applicationIds` is ignored — results are always scoped to this application.\n \"\"\"\n listings(\n after: String\n before: String\n\n \"\"\"Optional filter for the listings.\"\"\"\n filter: ApplicationListingFilterInput\n first: Int\n last: Int\n ): ApplicationListingsConnection\n\n \"\"\"A url-friendly name for the Application.\"\"\"\n name: String!\n\n \"\"\"The ID of the organization that owns this Application.\"\"\"\n organizationId: ID!\n\n \"\"\"\n The base URL of your application. This is the endpoint that the GoDaddy Commerce platform will call when integrated with actions.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n The public key (base64 encoded) for verifying action requests to your application.\n \"\"\"\n publicKey: String\n\n \"\"\"\n Additional OAuth redirect URIs on the application's OAuth client(s). URL-derived defaults (the application URL and {url}/api/godaddy/callback) are omitted so this list can be submitted unchanged on create or update.\n \"\"\"\n redirectUris: [String!]!\n\n \"\"\"The releases of the Application.\"\"\"\n releases(\n after: String\n before: String\n first: Int\n last: Int\n\n \"\"\"The order in which to sort the releases.\"\"\"\n orderBy: ReleaseOrderBy\n\n \"\"\"Filter by release status.\"\"\"\n status: ReleaseStatusFilter\n ): ApplicationReleasesConnection\n\n \"\"\"\n The secret for verifying webhook requests to your application. Copy and secure this secret. You will not see it again.\n \"\"\"\n secret: String\n\n \"\"\"The status of the application.\"\"\"\n status: ApplicationStatus!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The public website of the application.\"\"\"\n url: String\n}\n\n\"\"\"An action that can be executed by an application within the platform.\"\"\"\ntype ApplicationAction {\n \"\"\"The timestamp of when the action was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The globally-unique ID of the action.\"\"\"\n id: String!\n\n \"\"\"A unique identifier for the action within the application.\"\"\"\n name: String!\n\n \"\"\"The timestamp of when the action was last updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The endpoint URL that will be called when this action is triggered.\"\"\"\n url: String!\n}\n\n\"\"\"Input for creating a new application action.\"\"\"\ninput ApplicationActionCreateInput {\n \"\"\"A unique identifier for the action within the application.\"\"\"\n name: String!\n\n \"\"\"\n The path of the endpoint URL that will be called when this action is triggered.\n \"\"\"\n url: String!\n}\n\n\"\"\"\nA dependency an application release declares on another application (the application's id, the name it was declared under, and its required/excluded/enabled state).\n\"\"\"\ntype ApplicationDependency {\n \"\"\"\n The immutable id of the application depended upon. Unaffected by renames of that application.\n \"\"\"\n applicationId: ID!\n\n \"\"\"\n The application name this dependency was declared under. A record of what was declared, not a live reference — it is not rewritten when the depended-upon application is renamed, so it can differ from that application's current name. Use `applicationId` to identify the application.\n \"\"\"\n name: String!\n\n \"\"\"The declared state for this application dependency.\"\"\"\n state: ApplicationDependencyState!\n}\n\n\"\"\"\nInput for declaring a dependency on another application from a release.\n\"\"\"\ninput ApplicationDependencyInput {\n \"\"\"\n The name of the application depended upon. Must match a non-archived application.\n \"\"\"\n name: String!\n\n \"\"\"The declared state for this application dependency.\"\"\"\n state: ApplicationDependencyState!\n}\n\n\"\"\"The state of an application dependency declaration.\"\"\"\nenum ApplicationDependencyState {\n \"\"\"\n The dependency application is enabled by default but can be overridden.\n \"\"\"\n ENABLED\n\n \"\"\"\n The dependency application is excluded and must not be enabled alongside this release.\n \"\"\"\n EXCLUDED\n\n \"\"\"\n The dependency application is required and cannot be disabled while this release is live.\n \"\"\"\n REQUIRED\n}\n\n\"\"\"\nAn enablement represents an application installed for a specific entity (e.g. a store).\n\"\"\"\ntype ApplicationEnablement {\n \"\"\"When the enablement was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"When the application was disabled.\"\"\"\n disabledAt: DateTime\n\n \"\"\"When the application was enabled.\"\"\"\n enabledAt: DateTime\n\n \"\"\"The ID of the entity this application is enabled for.\"\"\"\n entityId: String!\n\n \"\"\"The type of entity (e.g. STORE).\"\"\"\n entityType: String!\n\n \"\"\"The globally-unique ID of the enablement.\"\"\"\n id: String!\n\n \"\"\"When the enablement was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"A listing for an application.\"\"\"\ntype ApplicationListing {\n \"\"\"The ID of the application this listing belongs to.\"\"\"\n applicationId: ID!\n\n \"\"\"The timestamp when the listing was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"\n Taxonomy facets for this listing (region, industry, category, tag, etc.).\n \"\"\"\n facets: [ApplicationListingFacet!]!\n\n \"\"\"CDN URL of the confirmed HIGHLIGHT asset, or null if not uploaded.\"\"\"\n highlightImageUrl: String\n\n \"\"\"CDN URL of the confirmed ICON asset, or null if not uploaded.\"\"\"\n iconUrl: String\n\n \"\"\"The globally-unique ID of the listing.\"\"\"\n id: ID!\n\n \"\"\"A description for the listing (plain text, max 4000 chars).\"\"\"\n listingDescription: String\n\n \"\"\"HTTPS URL for the privacy policy. Null when not set.\"\"\"\n privacyPolicyUrl: String\n\n \"\"\"CDN URLs of confirmed SCREENSHOT assets, ordered by sort_order.\"\"\"\n screenshotUrls: [String!]!\n\n \"\"\"The lifecycle status of the listing.\"\"\"\n status: ListingStatus!\n\n \"\"\"A short marketing pitch for the listing (plain text, max 160 chars).\"\"\"\n tagline: String\n\n \"\"\"HTTPS URL for the terms and conditions. Null when not set.\"\"\"\n termsAndConditionsUrl: String\n\n \"\"\"The timestamp when the listing was last updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"CDN URLs of confirmed VIDEO assets, ordered by sort_order.\"\"\"\n videoUrls: [String!]!\n\n \"\"\"The visibility of the listing.\"\"\"\n visibility: ListingVisibility!\n}\n\n\"\"\"A taxonomy facet attached to a listing.\"\"\"\ntype ApplicationListingFacet {\n \"\"\"The facet namespace (e.g. 'region', 'industry', 'category', 'tag').\"\"\"\n namespace: String!\n\n \"\"\"The facet value (e.g. 'US', 'retail', 'ecommerce').\"\"\"\n value: String!\n}\n\n\"\"\"\nFilter listings by facet. Returns listings that either have no facets in the given namespace (unrestricted), or have at least one facet in that namespace matching any of the provided values.\n\"\"\"\ninput ApplicationListingFacetFilterInput {\n \"\"\"The facet namespace to filter on (e.g. 'region').\"\"\"\n namespace: String!\n\n \"\"\"\n Accepted facet values (OR semantics within this filter). An empty array is treated as a no-op for this facet filter, not as a filter that matches nothing.\n \"\"\"\n values: [String!]!\n}\n\n\"\"\"A namespace + value pair for a listing facet.\"\"\"\ninput ApplicationListingFacetInput {\n \"\"\"The facet namespace (e.g. 'region', 'industry', 'category', 'tag').\"\"\"\n namespace: String!\n\n \"\"\"The facet value.\"\"\"\n value: String!\n}\n\n\"\"\"Filter options for listing queries.\"\"\"\ninput ApplicationListingFilterInput {\n \"\"\"\n Restrict results to listings for these application IDs (max 50, duplicates ignored).\n \"\"\"\n applicationIds: [ID!]\n\n \"\"\"\n Filter by taxonomy facets. All provided filters must match (AND semantics across namespaces).\n \"\"\"\n facets: [ApplicationListingFacetFilterInput!]\n\n \"\"\"\n Filter by listing lifecycle status. Defaults to ACTIVE for public LISTED discovery. Pass [ACTIVE, INACTIVE] to include deactivated listings (e.g. My Apps by applicationIds).\n \"\"\"\n status: [ListingStatus!]\n\n \"\"\"\n Filter by visibility. Defaults to [LISTED] for public discovery. Pass [LISTED, UNLISTED, HIDDEN] to see all listings for an owner context.\n \"\"\"\n visibility: [ListingVisibility!]\n}\n\n\"\"\"Fields to create or update a listing.\"\"\"\ninput ApplicationListingInput {\n \"\"\"\n Taxonomy facets for the listing. When provided, replaces all existing facets atomically.\n \"\"\"\n facets: [ApplicationListingFacetInput!]\n\n \"\"\"A description for the listing (plain text, max 4000 chars).\"\"\"\n listingDescription: String\n\n \"\"\"\n HTTPS URL for the privacy policy (max 255 chars). Pass null or empty string to clear.\n \"\"\"\n privacyPolicyUrl: String\n\n \"\"\"\n The lifecycle status of the listing. Defaults to INACTIVE on create. ACTIVE requires listing description, privacy URL, terms URL, categories, industries, icon, and screenshots.\n \"\"\"\n status: ListingStatus\n\n \"\"\"A short marketing pitch (plain text, max 160 chars).\"\"\"\n tagline: String\n\n \"\"\"\n HTTPS URL for the terms and conditions (max 255 chars). Pass null or empty string to clear.\n \"\"\"\n termsAndConditionsUrl: String\n\n \"\"\"The visibility of the listing. Defaults to LISTED.\"\"\"\n visibility: ListingVisibility\n}\n\ntype ApplicationListingsConnection {\n edges: [ApplicationListingsConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype ApplicationListingsConnectionEdge {\n cursor: String!\n node: ApplicationListing\n}\n\n\"\"\"\nAn MCP (Model Context Protocol) server registered with an application release.\n\"\"\"\ntype ApplicationMcpServer {\n \"\"\"The timestamp of when the MCP server was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The globally-unique ID of the MCP server.\"\"\"\n id: String!\n\n \"\"\"Additional configuration for the MCP server.\"\"\"\n metadata: JSONObject\n\n \"\"\"A unique identifier for the MCP server within the release.\"\"\"\n name: String!\n\n \"\"\"The MCP protocol version supported by this server.\"\"\"\n protocolVersion: String\n\n \"\"\"The timestamp of when the MCP server was last updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"\n The path of the endpoint URL that Traefik will route to (e.g., '/mcp/inventory').\n \"\"\"\n url: String!\n}\n\n\"\"\"Input for creating a new MCP server registration.\"\"\"\ninput ApplicationMcpServerCreateInput {\n \"\"\"\n Additional configuration for the MCP server (e.g., tool descriptions, capabilities).\n \"\"\"\n metadata: JSONObject\n\n \"\"\"A unique identifier for the MCP server within the release.\"\"\"\n name: String!\n\n \"\"\"The MCP protocol version supported by this server.\"\"\"\n protocolVersion: String\n\n \"\"\"\n The path of the endpoint URL that Traefik will route to (e.g., '/mcp/inventory').\n \"\"\"\n url: String!\n}\n\n\"\"\"\nA native extension registered with an application release. The target platform is indicated by `platform`.\n\"\"\"\ntype ApplicationNativeExtension {\n \"\"\"The ID of the associated application.\"\"\"\n applicationId: String!\n\n \"\"\"Support contact for the native extension.\"\"\"\n contact: String @deprecated(reason: \"Support contact belongs at the application-registration level, not on an individual extension. Retained temporarily and will be removed once an application-level contact exists.\")\n\n \"\"\"The timestamp of when the native extension was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The globally-unique ID of the native extension.\"\"\"\n id: String!\n\n \"\"\"The display name of the native extension.\"\"\"\n name: String\n\n \"\"\"\n The platform package identifier, in reverse-DNS form (e.g. 'com.example.app'). Optional: not every native deployment is installed through a package manager.\n \"\"\"\n packageName: String\n\n \"\"\"The platform for this native extension.\"\"\"\n platform: NativeExtensionPlatform!\n\n \"\"\"The ID of the associated release.\"\"\"\n releaseId: String!\n\n \"\"\"The timestamp of when the native extension was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"Input for creating a new native extension.\"\"\"\ninput ApplicationNativeExtensionCreateInput {\n \"\"\"Support contact for the native extension.\"\"\"\n contact: String @deprecated(reason: \"Support contact belongs at the application-registration level, not on an individual extension. Retained temporarily and will be removed once an application-level contact exists.\")\n\n \"\"\"The display name of the native extension.\"\"\"\n name: String\n\n \"\"\"\n The platform package identifier, in reverse-DNS form (e.g. 'com.example.app'). Optional: not every native deployment is installed through a package manager.\n \"\"\"\n packageName: String\n\n \"\"\"The platform for this native extension.\"\"\"\n platform: NativeExtensionPlatform!\n}\n\n\"\"\"Fields by which applications can be ordered.\"\"\"\ninput ApplicationOrderBy {\n \"\"\"Order applications by creation date.\"\"\"\n createdAt: OrderByDirectionEnum\n\n \"\"\"Order applications by ID.\"\"\"\n id: OrderByDirectionEnum\n\n \"\"\"Order applications by name.\"\"\"\n name: OrderByDirectionEnum\n\n \"\"\"Order applications by last update date.\"\"\"\n updatedAt: OrderByDirectionEnum\n}\n\ntype ApplicationRelease {\n \"\"\"The actions registered with this release.\"\"\"\n actions: [ApplicationAction!]!\n\n \"\"\"The timestamp of when the Application was activated.\"\"\"\n activatedAt: DateTime\n\n \"\"\"\n The other applications this release depends on, and the state it declares for each.\n \"\"\"\n applicationDependencies: [ApplicationDependency!]!\n\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The timestamp of when the release was deactivated.\"\"\"\n deactivatedAt: DateTime\n\n \"\"\"\n Information about the new release. Provide information about what has changed and any implications that it might have on your users.\n \"\"\"\n description: String\n\n \"\"\"The feature dependencies declared by this release.\"\"\"\n featureDependencies: [FeatureDependency!]!\n\n \"\"\"The globally-unique ID of the release.\"\"\"\n id: String!\n\n \"\"\"The MCP servers registered with this release.\"\"\"\n mcpServers: [ApplicationMcpServer!]!\n\n \"\"\"The native extensions registered with this release.\"\"\"\n nativeExtensions: [ApplicationNativeExtension!]!\n\n \"\"\"The settings capabilities registered with this release.\"\"\"\n settings(\n \"\"\"Filter settings by Commerce settings group slug.\"\"\"\n groupSlug: String\n ): [ApplicationSetting!]!\n\n \"\"\"The lifecycle status of the release.\"\"\"\n status: ApplicationReleaseStatus!\n\n \"\"\"The webhook subscriptions registered with this release.\"\"\"\n subscriptions: [ApplicationSubscription!]!\n\n \"\"\"The UI extensions registered with this release.\"\"\"\n uiExtensions(\n \"\"\"\n Optional UI extension target filter. Supports has (single match) and hasAny (any match).\n \"\"\"\n target: StringListFilter\n ): [ApplicationUiExtension!]!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The version number of this release.\"\"\"\n version: String!\n}\n\n\"\"\"The status of an application release.\"\"\"\nenum ApplicationReleaseStatus {\n \"\"\"Release is active and available for use.\"\"\"\n ACTIVE\n\n \"\"\"Release is created but not active.\"\"\"\n INACTIVE\n}\n\ntype ApplicationReleasesConnection {\n edges: [ApplicationReleasesConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype ApplicationReleasesConnectionEdge {\n cursor: String!\n node: ApplicationRelease\n}\n\n\"\"\"\nA settings capability registered with an application release and placed into a Commerce-owned settings group.\n\"\"\"\ntype ApplicationSetting {\n \"\"\"The app-owned slug for this setting registration.\"\"\"\n appSettingSlug: String!\n\n \"\"\"Lifecycle capabilities supported by this setting.\"\"\"\n capabilities: [String!]!\n\n \"\"\"The timestamp of when the setting was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"Display description for this setting.\"\"\"\n description: String\n\n \"\"\"Localization key for the display description.\"\"\"\n descriptionKey: String\n\n \"\"\"The GPA settings namespace path that lifecycle endpoints live beneath.\"\"\"\n entryPath: String!\n\n \"\"\"The Commerce-owned settings group slug.\"\"\"\n groupSlug: String!\n\n \"\"\"Optional icon library for display.\"\"\"\n iconLibrary: String\n\n \"\"\"Optional icon name for display.\"\"\"\n iconName: String\n\n \"\"\"The globally-unique ID of the application setting.\"\"\"\n id: String!\n\n \"\"\"Additional app-defined settings metadata.\"\"\"\n metadata: JSONObject\n\n \"\"\"Sort order within the settings group.\"\"\"\n order: Int!\n\n \"\"\"The client-renderable presentation contract for this setting.\"\"\"\n presentation: JSONObject!\n\n \"\"\"Display title for this setting.\"\"\"\n title: String\n\n \"\"\"Localization key for the display title.\"\"\"\n titleKey: String\n\n \"\"\"The timestamp of when the setting was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"Input for creating a new application settings registration.\"\"\"\ninput ApplicationSettingCreateInput {\n \"\"\"The app-owned slug for this setting registration.\"\"\"\n appSettingSlug: String!\n\n \"\"\"\n Lifecycle capabilities supported by this setting (read, write, validate, test, delete, open, config). config requires metadata.configKeys.\n \"\"\"\n capabilities: [String!]\n\n \"\"\"Display description for this setting.\"\"\"\n description: String\n\n \"\"\"Localization key for the display description.\"\"\"\n descriptionKey: String\n\n \"\"\"The GPA settings namespace path that lifecycle endpoints live beneath.\"\"\"\n entryPath: String!\n\n \"\"\"The Commerce-owned settings group slug.\"\"\"\n groupSlug: String!\n\n \"\"\"Optional icon library for display.\"\"\"\n iconLibrary: String\n\n \"\"\"Optional icon name for display.\"\"\"\n iconName: String\n\n \"\"\"Additional app-defined settings metadata.\"\"\"\n metadata: JSONObject\n\n \"\"\"Sort order within the settings group.\"\"\"\n order: Int\n\n \"\"\"\n The settings-form-v1 or settings-link-v1 presentation contract for this setting.\n \"\"\"\n presentation: JSONObject!\n\n \"\"\"Display title for this setting.\"\"\"\n title: String\n\n \"\"\"Localization key for the display title.\"\"\"\n titleKey: String\n}\n\n\"\"\"The current status of an application in the platform.\"\"\"\nenum ApplicationStatus {\n \"\"\"Application is active and can be used.\"\"\"\n ACTIVE\n\n \"\"\"Application has been archived and is no longer available.\"\"\"\n ARCHIVED\n\n \"\"\"Application has been blocked from use due to policy violations.\"\"\"\n BLOCKED\n\n \"\"\"Application is registered but not active.\"\"\"\n INACTIVE\n\n \"\"\"Application is being verified and is not yet active.\"\"\"\n VERIFYING\n}\n\n\"\"\"Filter applications by status.\"\"\"\ninput ApplicationStatusFilter {\n \"\"\"Filter by exact status match.\"\"\"\n eq: ApplicationStatus\n\n \"\"\"Filter by any of the specified statuses.\"\"\"\n in: [ApplicationStatus!]\n\n \"\"\"Filter by status not equal to the specified value.\"\"\"\n ne: ApplicationStatus\n}\n\n\"\"\"\nWebhook subscriptions that an application has opted to subscribe to. Each subscription has one or many events.\n\"\"\"\ntype ApplicationSubscription {\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"A list of events that the subscription will receive.\"\"\"\n events: [String!]!\n\n \"\"\"The globally-unique ID of the release.\"\"\"\n id: String!\n\n \"\"\"The name of the webhook subscription\"\"\"\n name: String!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The delivery URL of the webhook.\"\"\"\n url: String!\n}\n\n\"\"\"Input for creating a new application webhook subscription.\"\"\"\ninput ApplicationSubscriptionCreateInput {\n \"\"\"List of event types this subscription will receive.\"\"\"\n events: [String!]!\n\n \"\"\"A unique name for the subscription.\"\"\"\n name: String!\n\n \"\"\"The webhook URL that will receive the events.\"\"\"\n url: String!\n}\n\n\"\"\"\nA UI extension registered with an application release (e.g., embed, checkout, blocks).\n\"\"\"\ntype ApplicationUiExtension {\n \"\"\"The base CDN URL for packaged UI extension assets.\"\"\"\n cdnUrl: String\n\n \"\"\"The timestamp of when the UI extension was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The unique handle/identifier for the extension (e.g., 'my-extension').\"\"\"\n handle: String\n\n \"\"\"The globally-unique ID of the UI extension.\"\"\"\n id: String!\n\n \"\"\"The display name of the extension.\"\"\"\n name: String\n\n \"\"\"\n The source file path for the extension (e.g., 'extensions/my-ext/index.ts').\n \"\"\"\n source: String\n\n \"\"\"\n The target location for the extension (e.g., 'body.end', 'checkout.header').\n \"\"\"\n target: String\n\n \"\"\"The type of UI extension (e.g., 'embed', 'checkout', 'blocks').\"\"\"\n type: String!\n\n \"\"\"The timestamp of when the UI extension was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"Input for creating a new application UI extension.\"\"\"\ninput ApplicationUiExtensionCreateInput {\n \"\"\"\n The unique handle/identifier for the extension (e.g., 'my-extension'). Optional for blocks extensions.\n \"\"\"\n handle: String\n\n \"\"\"The display name of the extension. Optional for blocks extensions.\"\"\"\n name: String\n\n \"\"\"\n The source file path for the extension (e.g., 'extensions/my-ext/index.ts'). Optional for blocks extensions.\n \"\"\"\n source: String\n\n \"\"\"\n The target location for the extension (e.g., 'body.end', 'checkout.header'). Required for targeted extensions, optional for block-type extensions.\n \"\"\"\n target: String\n\n \"\"\"The type of UI extension (e.g., 'embed', 'checkout', 'blocks').\"\"\"\n type: String!\n}\n\n\"\"\"Pre-signed upload URL and metadata for listing media.\"\"\"\ntype CreateMediaUploadUrlResponse {\n expiresAt: DateTime!\n maxSizeBytes: Int!\n mediaObjectId: ID!\n requiredHeaders: [String!]!\n uploadUrl: String!\n}\n\n\"\"\"\nResult of creating an OAuth client secret. Includes the secret value once; store it immediately — it cannot be retrieved again.\n\"\"\"\ntype CreatedOauthClientSecret {\n \"\"\"OAuth client id this secret belongs to, or null when unknown.\"\"\"\n clientId: String\n\n \"\"\"Description of the secret, or null when unknown.\"\"\"\n clientSecretDescription: String\n\n \"\"\"Id of this secret (used to revoke).\"\"\"\n clientSecretId: String!\n\n \"\"\"Display name of the secret, or null when unknown.\"\"\"\n clientSecretName: String\n\n \"\"\"\n The secret value, returned only on create. Store it immediately — it cannot be retrieved again.\n \"\"\"\n clientSecretValue: String!\n\n \"\"\"When this secret was created (ISO-8601), or null when unknown.\"\"\"\n createdAt: String\n\n \"\"\"When this secret was revoked (ISO-8601), or null if still active.\"\"\"\n deletedAt: String\n\n \"\"\"When this secret expires (ISO-8601), or null when unknown.\"\"\"\n expiresOn: String\n}\n\n\"\"\"A date-time string in ISO 8601 format (e.g. 2022-01-01T00:00:00Z).\"\"\"\nscalar DateTime\n\n\"\"\"The distribution type for an application.\"\"\"\nenum DistributionType {\n \"\"\"Application has custom distribution.\"\"\"\n CUSTOM\n\n \"\"\"Application is publicly available.\"\"\"\n PUBLIC\n}\n\ntype EnabledApplication {\n \"\"\"The timestamp of when the Application was activated.\"\"\"\n activatedAt: DateTime\n\n \"\"\"The timestamp of when the Application was archived.\"\"\"\n archivedAt: DateTime\n\n \"\"\"\n The authorization scopes that the OAuth2 client has access to and will use to call API endpoints.\n \"\"\"\n authorizationScopes: [String!]!\n\n \"\"\"\n Earliest linked OAuth client ID for this application by createdAt then id (includes NULL-secret and ARCHIVED apps).\n \"\"\"\n clientId: ID\n\n \"\"\"\n The primary OAuth client secret for this application. Only returned on application creation.\n \"\"\"\n clientSecret: String\n\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The timestamp of when the Application was deactivated.\"\"\"\n deactivatedAt: DateTime\n\n \"\"\"General information about your application.\"\"\"\n description: String\n\n \"\"\"The globally-unique ID of the Application.\"\"\"\n id: ID!\n\n \"\"\"A human-readable label of the Application for display purposes.\"\"\"\n label: String!\n\n \"\"\"A url-friendly name for the Application.\"\"\"\n name: String!\n\n \"\"\"The ID of the organization that owns this Application.\"\"\"\n organizationId: ID!\n\n \"\"\"\n The base URL of your application. This is the endpoint that the GoDaddy Commerce platform will call when integrated with actions.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n The public key (base64 encoded) for verifying action requests to your application.\n \"\"\"\n publicKey: String\n\n \"\"\"\n Additional OAuth redirect URIs on the application's OAuth client(s). URL-derived defaults (the application URL and {url}/api/godaddy/callback) are omitted so this list can be submitted unchanged on create or update.\n \"\"\"\n redirectUris: [String!]!\n\n \"\"\"The release/version enabled for this application\"\"\"\n release: ApplicationRelease\n\n \"\"\"\n The secret for verifying webhook requests to your application. Copy and secure this secret. You will not see it again.\n \"\"\"\n secret: String\n\n \"\"\"The status of the application.\"\"\"\n status: ApplicationStatus!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The public website of the application.\"\"\"\n url: String\n}\n\n\"\"\"Fields by which enablements can be ordered.\"\"\"\ninput EnablementOrderBy {\n \"\"\"Order enablements by creation date.\"\"\"\n createdAt: OrderByDirectionEnum\n\n \"\"\"Order enablements by ID.\"\"\"\n id: OrderByDirectionEnum\n\n \"\"\"Order enablements by last update date.\"\"\"\n updatedAt: OrderByDirectionEnum\n}\n\n\"\"\"\nA feature dependency declared by an application release (a feature name and its required/excluded/enabled/disabled state).\n\"\"\"\ntype FeatureDependency {\n \"\"\"The feature name from the available features list.\"\"\"\n name: String!\n\n \"\"\"The declared state for this feature.\"\"\"\n state: FeatureDependencyState!\n}\n\n\"\"\"Input for declaring a feature dependency on a release.\"\"\"\ninput FeatureDependencyInput {\n \"\"\"The feature name from the available features list.\"\"\"\n name: String!\n\n \"\"\"The declared state for this feature.\"\"\"\n state: FeatureDependencyState!\n}\n\n\"\"\"The state of a feature dependency declaration.\"\"\"\nenum FeatureDependencyState {\n \"\"\"Feature is disabled by default but can be overridden.\"\"\"\n DISABLED\n\n \"\"\"Feature is enabled by default but can be overridden.\"\"\"\n ENABLED\n\n \"\"\"Feature is excluded and cannot be required by other apps.\"\"\"\n EXCLUDED\n\n \"\"\"Feature is required and cannot be excluded by other apps.\"\"\"\n REQUIRED\n}\n\n\"\"\"Response containing pre-signed upload URL and metadata.\"\"\"\ntype GenerateReleaseUploadUrlResponse {\n \"\"\"The timestamp when the upload URL expires.\"\"\"\n expiresAt: DateTime!\n\n \"\"\"The S3 key where the file should be uploaded.\"\"\"\n key: String!\n\n \"\"\"Maximum allowed file size in bytes.\"\"\"\n maxSizeBytes: Int!\n\n \"\"\"Required headers for the upload as key:value pairs.\"\"\"\n requiredHeaders: [String!]!\n\n \"\"\"The unique upload identifier for tracking.\"\"\"\n uploadId: String!\n\n \"\"\"The pre-signed URL for uploading the file.\"\"\"\n url: String!\n}\n\n\"\"\"A JSON object scalar type.\"\"\"\nscalar JSONObject @specifiedBy(url: \"http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf\")\n\n\"\"\"Allowed MIME types for listing media uploads.\"\"\"\nenum ListingMediaContentType {\n IMAGE_JPEG\n IMAGE_PNG\n VIDEO_MP4\n}\n\n\"\"\"The merchandising role of a listing media asset.\"\"\"\nenum ListingMediaRole {\n HIGHLIGHT\n ICON\n SCREENSHOT\n VIDEO\n}\n\n\"\"\"The lifecycle status of a listing media upload.\"\"\"\nenum ListingMediaStatus {\n CONFIRMED\n FAILED\n PENDING\n REMOVED\n SUPERSEDED\n}\n\n\"\"\"The lifecycle status of a listing.\"\"\"\nenum ListingStatus {\n \"\"\"Listing is active and eligible for marketplace discovery.\"\"\"\n ACTIVE\n\n \"\"\"Listing is inactive until activation requirements are met.\"\"\"\n INACTIVE\n}\n\n\"\"\"The visibility of a listing.\"\"\"\nenum ListingVisibility {\n \"\"\"Listing is hidden from discovery surfaces.\"\"\"\n HIDDEN\n\n \"\"\"Listing is publicly visible.\"\"\"\n LISTED\n\n \"\"\"Listing is not shown in search.\"\"\"\n UNLISTED\n}\n\n\"\"\"A media asset attached to an application listing.\"\"\"\ntype MediaObject {\n applicationId: ID!\n contentType: String\n createdAt: DateTime!\n failureReason: String\n filename: String\n id: ID!\n listingId: ID\n role: ListingMediaRole\n sortOrder: Int!\n status: ListingMediaStatus!\n updatedAt: DateTime!\n url: String\n}\n\ntype Mutation {\n \"\"\"\n Activate a release and, when permitted, promote its parent application to ACTIVE.\n \"\"\"\n activateRelease(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The ID of the release to activate.\"\"\"\n releaseId: ID!\n ): ApplicationRelease\n\n \"\"\"Archive an existing Application.\"\"\"\n archiveApplication(\n \"\"\"The ID of the application to archive.\"\"\"\n id: String!\n ): Application\n\n \"\"\"Confirm a listing media upload after the client PUTs the file to S3.\"\"\"\n confirmMediaObject(\n \"\"\"The application that owns the media object — used for authorization.\"\"\"\n applicationId: ID!\n\n \"\"\"The media object ID returned from createMediaUploadUrl.\"\"\"\n mediaObjectId: ID!\n ): MediaObject\n\n \"\"\"Create a new Application.\"\"\"\n createApplication(input: MutationCreateApplicationInput!): Application\n\n \"\"\"\n Create an additional OAuth client secret on the application's primary OAuth client. Returns the secret value once. Fails when the active-secret limit is reached.\n \"\"\"\n createApplicationOauthClientSecret(\n \"\"\"The application to create a secret for.\"\"\"\n applicationId: String!\n input: MutationCreateApplicationOauthClientSecretInput!\n ): CreatedOauthClientSecret\n\n \"\"\"\n Create a pending listing media record and return a pre-signed S3 PUT URL.\n \"\"\"\n createMediaUploadUrl(\n \"\"\"The application that owns the listing (1:1).\"\"\"\n applicationId: ID!\n\n \"\"\"MIME type of the file to upload.\"\"\"\n contentType: ListingMediaContentType!\n\n \"\"\"\n Declared file size in bytes. Rejected if it exceeds the role cap before issuing the presigned URL.\n \"\"\"\n fileSizeBytes: Int!\n\n \"\"\"Original filename from the client.\"\"\"\n filename: String!\n\n \"\"\"Merchandising role for this asset.\"\"\"\n role: ListingMediaRole!\n\n \"\"\"\n Optional ordering for screenshots/videos (0–7). Defaults to next slot. Ignored for other roles (defaults to 0).\n \"\"\"\n sortOrder: Int\n ): CreateMediaUploadUrlResponse\n\n \"\"\"Create a new release for an application.\"\"\"\n createRelease(input: MutationCreateReleaseInput!): ApplicationRelease\n\n \"\"\"\n Deactivate an application through its lifecycle operation. Activate it again by activating a release.\n \"\"\"\n deactivateApplication(\n \"\"\"The ID of the application to deactivate.\"\"\"\n id: String!\n ): Application\n\n \"\"\"\n Deactivate a release. When it is the last active release, its application listing is also deactivated.\n \"\"\"\n deactivateRelease(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The ID of the release to deactivate.\"\"\"\n releaseId: ID!\n ): ApplicationRelease\n\n \"\"\"Soft-delete the listing for an application.\"\"\"\n deleteApplicationListing(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n ): Boolean\n\n \"\"\"Disable an application on a customer\"\"\"\n disableCustomerApplication(input: MutationDisableCustomerApplicationInput!): Application\n\n \"\"\"Disable an application in a store\"\"\"\n disableStoreApplication(input: MutationDisableStoreApplicationInput!): Application\n\n \"\"\"Enable an application on a customer\"\"\"\n enableCustomerApplication(input: MutationEnableCustomerApplicationInput!): Application\n\n \"\"\"Enable an application on a store\"\"\"\n enableStoreApplication(input: MutationEnableStoreApplicationInput!): Application\n\n \"\"\"Generate a pre-signed URL for uploading UI extension artifacts.\"\"\"\n generateReleaseUploadUrl(input: MutationGenerateReleaseUploadUrlInput!): GenerateReleaseUploadUrlResponse\n\n \"\"\"\n Remove a confirmed listing media object. Sets status to REMOVED, deletes the promoted S3 object, and invalidates the CDN path.\n \"\"\"\n removeListingMediaObject(\n \"\"\"\n The application that owns the media object — prevents cross-app removal.\n \"\"\"\n applicationId: ID!\n\n \"\"\"The confirmed media object ID to remove.\"\"\"\n mediaObjectId: ID!\n ): MediaObject\n\n \"\"\"\n Revoke one OAuth client secret on the application's primary OAuth client. Cannot revoke the last active secret — create another first.\n \"\"\"\n revokeApplicationOauthClientSecret(\n \"\"\"The application whose secret to revoke.\"\"\"\n applicationId: String!\n input: MutationRevokeApplicationOauthClientSecretInput!\n ): RevokedOauthClientSecret\n\n \"\"\"\n Create or update the listing for an application. Idempotent — safe to call multiple times for the same application.\n \"\"\"\n setApplicationListing(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The listing fields to create or update.\"\"\"\n input: ApplicationListingInput!\n ): ApplicationListing\n\n \"\"\"Update an existing Application.\"\"\"\n updateApplication(id: String!, input: MutationUpdateApplicationInput!): Application\n}\n\ninput MutationCreateApplicationInput {\n \"\"\"\n The authorization scopes of the application. Defines the GoDaddy permissions for the application.\n \"\"\"\n authorizationScopes: [String!]\n\n \"\"\"The description of the application.\"\"\"\n description: String\n\n \"\"\"The distribution type for the application. Defaults to PUBLIC.\"\"\"\n distributionType: DistributionType = PUBLIC\n\n \"\"\"The label of the application.\"\"\"\n label: String!\n\n \"\"\"The name of the application.\"\"\"\n name: String!\n\n \"\"\"\n Optional organization ID for multi-org users. If omitted, the organization is auto-resolved from the user's session. If provided, the user must be an admin of the specified organization.\n \"\"\"\n organizationId: String\n\n \"\"\"\n The proxy URL of the application. This is the base URL for all API endpoints.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n Additional OAuth redirect URI allowlist. Supports up to 5 unique HTTPS URLs. Entries equal to the application URL or its default callback are rejected; those defaults are registered automatically.\n \"\"\"\n redirectUris: [String!]\n\n \"\"\"\n The public URL of the application. This is typically the URL of the application's website.\n \"\"\"\n url: String\n}\n\ninput MutationCreateApplicationOauthClientSecretInput {\n \"\"\"Description for the new secret. Cannot be blank.\"\"\"\n clientSecretDescription: String!\n\n \"\"\"Display name for the new secret.\"\"\"\n clientSecretName: String!\n}\n\ninput MutationCreateReleaseInput {\n \"\"\"The actions associated with the release.\"\"\"\n actions: [ApplicationActionCreateInput!]\n\n \"\"\"\n The other applications this release depends on, and the state it declares for each.\n \"\"\"\n applicationDependencies: [ApplicationDependencyInput!]\n\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The description of the release.\"\"\"\n description: String\n\n \"\"\"The feature dependencies declared by the release.\"\"\"\n featureDependencies: [FeatureDependencyInput!]\n\n \"\"\"The MCP servers associated with the release.\"\"\"\n mcpServers: [ApplicationMcpServerCreateInput!]\n\n \"\"\"The native extensions associated with the release.\"\"\"\n nativeExtensions: [ApplicationNativeExtensionCreateInput!]\n\n \"\"\"The settings capabilities associated with the release.\"\"\"\n settings: [ApplicationSettingCreateInput!]\n\n \"\"\"The subscriptions associated with the release.\"\"\"\n subscriptions: [ApplicationSubscriptionCreateInput!]\n\n \"\"\"The UI extensions associated with the release.\"\"\"\n uiExtensions: [ApplicationUiExtensionCreateInput!]\n\n \"\"\"The version of the release.\"\"\"\n version: String!\n}\n\ninput MutationDisableCustomerApplicationInput {\n \"\"\"The name of the application to disable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the customer to disable the application on.\"\"\"\n customerId: String!\n}\n\ninput MutationDisableStoreApplicationInput {\n \"\"\"The name of the application to disable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the store to disable the application on.\"\"\"\n storeId: String!\n}\n\ninput MutationEnableCustomerApplicationInput {\n \"\"\"The name of the application to enable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the customer to enable the application on.\"\"\"\n customerId: String!\n}\n\ninput MutationEnableStoreApplicationInput {\n \"\"\"The name of the application to enable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the store to enable the application on.\"\"\"\n storeId: String!\n}\n\ninput MutationGenerateReleaseUploadUrlInput {\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The content type of the file to be uploaded.\"\"\"\n contentType: UploadContentType!\n\n \"\"\"The ID of the release.\"\"\"\n releaseId: ID!\n\n \"\"\"The target for the upload.\"\"\"\n target: String\n}\n\ninput MutationRevokeApplicationOauthClientSecretInput {\n \"\"\"Id of the secret to revoke.\"\"\"\n clientSecretId: String!\n}\n\ninput MutationUpdateApplicationInput {\n \"\"\"\n The authorization scopes of the application. Defines the GoDaddy permissions for the application.\n \"\"\"\n authorizationScopes: [String!]\n\n \"\"\"The description of the application.\"\"\"\n description: String\n\n \"\"\"\n The distribution type for the application (PUBLIC or CUSTOM). Omit to leave unchanged.\n \"\"\"\n distributionType: DistributionType\n\n \"\"\"The label of the application.\"\"\"\n label: String\n\n \"\"\"The name of the application.\"\"\"\n name: String\n\n \"\"\"\n The proxy URL of the application. This is the base URL for all API endpoints.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n Additional OAuth redirect URI allowlist. Supports up to 5 unique HTTPS URLs. Entries equal to the effective application URL or its default callback are rejected. On URL changes, both old defaults are replaced; submit any old URI explicitly to retain it as an extra.\n \"\"\"\n redirectUris: [String!]\n\n \"\"\"\n The public URL of the application. This is typically the URL of the application's website.\n \"\"\"\n url: String\n}\n\n\"\"\"The platform for a native extension.\"\"\"\nenum NativeExtensionPlatform {\n \"\"\"Android platform (APK distribution).\"\"\"\n ANDROID\n}\n\n\"\"\"Represents a null value.\"\"\"\nscalar Null\n\n\"\"\"\nMetadata for one OAuth client secret on an application's primary OAuth client. Secret values are never included.\n\"\"\"\ntype OauthClientSecret {\n \"\"\"OAuth client id this secret belongs to, or null when unknown.\"\"\"\n clientId: String\n\n \"\"\"Description of the secret, or null when unknown.\"\"\"\n clientSecretDescription: String\n\n \"\"\"Id of this secret (used to revoke).\"\"\"\n clientSecretId: String!\n\n \"\"\"Display name of the secret, or null when unknown.\"\"\"\n clientSecretName: String\n\n \"\"\"When this secret was created (ISO-8601), or null when unknown.\"\"\"\n createdAt: String\n\n \"\"\"When this secret was revoked (ISO-8601), or null if still active.\"\"\"\n deletedAt: String\n\n \"\"\"When this secret expires (ISO-8601), or null when unknown.\"\"\"\n expiresOn: String\n}\n\n\"\"\"Direction for ordering results in queries.\"\"\"\nenum OrderByDirectionEnum {\n \"\"\"Sort in ascending order.\"\"\"\n ASC\n\n \"\"\"Sort in descending order.\"\"\"\n DESC\n}\n\ntype PageInfo {\n endCursor: String\n hasNextPage: Boolean!\n hasPreviousPage: Boolean!\n startCursor: String\n}\n\ntype Query {\n \"\"\"Get a single application by ID or name.\"\"\"\n application(\n \"\"\"The OAuth client ID of the application to retrieve.\"\"\"\n clientId: String\n\n \"\"\"The unique ID of the application to retrieve.\"\"\"\n id: String\n\n \"\"\"The unique name of the application to retrieve.\"\"\"\n name: String\n ): Application\n\n \"\"\"\n Paginated listings. Defaults to publicly LISTED listings for active PUBLIC-distribution apps with an active release. Pass visibility filter to query owner/admin contexts.\n \"\"\"\n applicationListings(\n after: String\n before: String\n\n \"\"\"Filter options for the query.\"\"\"\n filter: ApplicationListingFilterInput\n first: Int\n last: Int\n ): QueryApplicationListingsConnection\n\n \"\"\"\n List OAuth client secrets (metadata only) for an application's primary OAuth client. Requires application write access.\n \"\"\"\n applicationOauthClientSecrets(\n \"\"\"The application whose primary OAuth client secrets to list.\"\"\"\n applicationId: String!\n ): [OauthClientSecret!]!\n\n \"\"\"\n Get paginated applications. Returns all public applications for service requests, or only applications owned by the authenticated customer's organization. Multi-org users may pass an explicit `organizationId` to select which organization's apps to list.\n \"\"\"\n applications(\n after: String\n before: String\n first: Int\n last: Int\n\n \"\"\"The order in which to sort the applications.\"\"\"\n orderBy: ApplicationOrderBy\n\n \"\"\"\n Optional organization ID. When provided, lists apps for that specific organization. Customer tokens must be admin of the organization; service tokens may specify any organization.\n \"\"\"\n organizationId: String\n\n \"\"\"Filter by application status. Defaults to ACTIVE applications only.\"\"\"\n status: ApplicationStatusFilter\n ): QueryApplicationsConnection\n\n \"\"\"\n Get all applications enabled for an entity by entity ID and type, with optional filtering by actions, UI extensions, and settings.\n \"\"\"\n enabledApplications(\n \"\"\"\n Filter by action names. Supports has (single match) and hasAny (any match).\n \"\"\"\n actionNames: StringListFilter\n\n \"\"\"The ID of the entity to get enabled applications for.\"\"\"\n entityId: String!\n\n \"\"\"\n The type of the entity the applications are enabled on. Currently STORE.\n \"\"\"\n entityType: String!\n\n \"\"\"Filter by Commerce settings group slug.\"\"\"\n settingGroupSlug: String\n\n \"\"\"\n Filter by application setting slugs. Supports has (single match) and hasAny (any match).\n \"\"\"\n settingSlugs: StringListFilter\n\n \"\"\"\n Filter by UI extension targets. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTargets: StringListFilter\n\n \"\"\"\n Filter by UI extension types. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTypes: StringListFilter\n ): [EnabledApplication!]\n\n \"\"\"\n Get all applications enabled for a store by store ID, with optional filtering by actions, UI extensions, and settings.\n \"\"\"\n enabledStoreApplications(\n \"\"\"\n Filter by action names. Supports has (single match) and hasAny (any match).\n \"\"\"\n actionNames: StringListFilter\n\n \"\"\"Filter by Commerce settings group slug.\"\"\"\n settingGroupSlug: String\n\n \"\"\"\n Filter by application setting slugs. Supports has (single match) and hasAny (any match).\n \"\"\"\n settingSlugs: StringListFilter\n\n \"\"\"The ID of the store to get enabled applications for.\"\"\"\n storeId: String!\n\n \"\"\"\n Filter by UI extension targets. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTargets: StringListFilter\n\n \"\"\"\n Filter by UI extension types. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTypes: StringListFilter\n ): [EnabledApplication!]\n\n \"\"\"Returns a paginated list of enablements for a specific release.\"\"\"\n enablementsByRelease(\n after: String\n before: String\n first: Int\n last: Int\n\n \"\"\"The order in which to sort the enablements.\"\"\"\n orderBy: EnablementOrderBy\n\n \"\"\"The release ID to query enablements for.\"\"\"\n releaseId: ID!\n ): QueryEnablementsByReleaseConnection!\n\n \"\"\"Get the status of a release upload by upload ID.\"\"\"\n getReleaseUpload(\n \"\"\"The application ID to verify authorization.\"\"\"\n applicationId: ID!\n\n \"\"\"The unique upload identifier.\"\"\"\n uploadId: String!\n ): ReleaseUpload\n\n \"\"\"Get a single native extension by ID.\"\"\"\n nativeExtension(\n \"\"\"The ID of the native extension to retrieve.\"\"\"\n id: ID!\n ): ApplicationNativeExtension\n\n \"\"\"\n List native extensions by application or release. At least one of applicationId or releaseId must be provided.\n \"\"\"\n nativeExtensions(\n \"\"\"Filter by application ID.\"\"\"\n applicationId: ID\n\n \"\"\"Maximum number of results to return.\"\"\"\n limit: Int\n\n \"\"\"Filter by release ID.\"\"\"\n releaseId: ID\n ): [ApplicationNativeExtension!]!\n\n \"\"\"\n Get the resolved feature states for a store, after reconciling all active app declarations.\n \"\"\"\n storeFeatures(\n \"\"\"The ID of the store to resolve features for.\"\"\"\n storeId: String!\n ): [FeatureDependency!]!\n\n \"\"\"Returns webhook subscription IDs for a specific release/entity pair.\"\"\"\n webhookSubscriptionInstancesByRelease(\n \"\"\"The entity ID to scope the query to.\"\"\"\n entityId: ID!\n\n \"\"\"The entity type to scope the query to (e.g. STORE).\"\"\"\n entityType: String!\n\n \"\"\"The release ID to query webhook subscriptions for.\"\"\"\n releaseId: ID!\n ): [String!]!\n}\n\ntype QueryApplicationListingsConnection {\n edges: [QueryApplicationListingsConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype QueryApplicationListingsConnectionEdge {\n cursor: String!\n node: ApplicationListing\n}\n\ntype QueryApplicationsConnection {\n edges: [QueryApplicationsConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype QueryApplicationsConnectionEdge {\n cursor: String!\n node: Application\n}\n\ntype QueryEnablementsByReleaseConnection {\n edges: [QueryEnablementsByReleaseConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype QueryEnablementsByReleaseConnectionEdge {\n cursor: String!\n node: ApplicationEnablement\n}\n\n\"\"\"Fields by which application releases can be ordered.\"\"\"\ninput ReleaseOrderBy {\n \"\"\"Order releases by activation date.\"\"\"\n activatedAt: OrderByDirectionEnum\n\n \"\"\"Order releases by creation date.\"\"\"\n createdAt: OrderByDirectionEnum\n\n \"\"\"Order releases by ID.\"\"\"\n id: OrderByDirectionEnum\n\n \"\"\"Order releases by last update date.\"\"\"\n updatedAt: OrderByDirectionEnum\n\n \"\"\"Order releases by version number. Must be in {major}.{minor} format.\"\"\"\n version: OrderByDirectionEnum\n}\n\n\"\"\"Filter releases by status.\"\"\"\ninput ReleaseStatusFilter {\n \"\"\"Filter by exact status match.\"\"\"\n eq: ApplicationReleaseStatus\n\n \"\"\"Filter by any of the specified statuses.\"\"\"\n in: [ApplicationReleaseStatus!]\n\n \"\"\"Filter by status not equal to the specified value.\"\"\"\n ne: ApplicationReleaseStatus\n}\n\n\"\"\"A release upload record tracking the status of uploaded artifacts.\"\"\"\ntype ReleaseUpload {\n \"\"\"The ID of the associated application.\"\"\"\n applicationId: String!\n\n \"\"\"The timestamp when the upload was completed or failed.\"\"\"\n completedAt: DateTime\n\n \"\"\"The MIME type of the uploaded content.\"\"\"\n contentType: UploadContentType!\n\n \"\"\"The timestamp when the upload was requested.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The reason for failure if status is FAILED.\"\"\"\n failureReason: String\n\n \"\"\"The globally-unique ID of the upload record.\"\"\"\n id: String!\n\n \"\"\"The ID of the associated release.\"\"\"\n releaseId: String!\n\n \"\"\"The size of the uploaded file in bytes.\"\"\"\n sizeBytes: Int\n\n \"\"\"The current status of the upload.\"\"\"\n status: ReleaseUploadStatus!\n\n \"\"\"The unique upload identifier used for correlation.\"\"\"\n uploadId: String!\n}\n\n\"\"\"The status of a release upload.\"\"\"\nenum ReleaseUploadStatus {\n \"\"\"Upload or processing failed.\"\"\"\n FAILED\n\n \"\"\"File has been processed and deployed successfully.\"\"\"\n PROCESSED\n\n \"\"\"Upload URL has been generated and is awaiting upload.\"\"\"\n REQUESTED\n\n \"\"\"File has been uploaded and is awaiting processing.\"\"\"\n UPLOADED\n}\n\n\"\"\"Result of revoking an OAuth client secret.\"\"\"\ntype RevokedOauthClientSecret {\n \"\"\"Id of the revoked secret.\"\"\"\n clientSecretId: String!\n}\n\n\"\"\"Filter for fields that are lists/sets of strings.\"\"\"\ninput StringListFilter {\n \"\"\"Field must contain this value.\"\"\"\n has: String\n\n \"\"\"Field must contain at least one of these values.\"\"\"\n hasAny: [String!]\n}\n\n\"\"\"Supported content types for release uploads.\"\"\"\nenum UploadContentType {\n \"\"\"JavaScript file\"\"\"\n JS\n\n \"\"\"TAR archive\"\"\"\n TAR\n\n \"\"\"ZIP archive\"\"\"\n ZIP\n}", + "sdl": "type Application {\n \"\"\"The timestamp of when the Application was activated.\"\"\"\n activatedAt: DateTime\n\n \"\"\"The timestamp of when the Application was archived.\"\"\"\n archivedAt: DateTime\n\n \"\"\"\n The authorization scopes that the OAuth2 client has access to and will use to call API endpoints.\n \"\"\"\n authorizationScopes: [String!]!\n\n \"\"\"\n Earliest linked OAuth client ID for this application by createdAt then id (includes NULL-secret and ARCHIVED apps).\n \"\"\"\n clientId: ID\n\n \"\"\"\n The primary OAuth client secret for this application. Only returned on application creation.\n \"\"\"\n clientSecret: String\n\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The timestamp of when the Application was deactivated.\"\"\"\n deactivatedAt: DateTime\n\n \"\"\"General information about your application.\"\"\"\n description: String\n\n \"\"\"The distribution type for this application.\"\"\"\n distributionType: DistributionType!\n\n \"\"\"The globally-unique ID of the Application.\"\"\"\n id: ID!\n\n \"\"\"A human-readable label of the Application for display purposes.\"\"\"\n label: String!\n\n \"\"\"\n Paginated listings for this application. Requires read scope. When using the filter, `applicationIds` is ignored — results are always scoped to this application.\n \"\"\"\n listings(\n after: String\n before: String\n\n \"\"\"Optional filter for the listings.\"\"\"\n filter: ApplicationListingFilterInput\n first: Int\n last: Int\n ): ApplicationListingsConnection\n\n \"\"\"A url-friendly name for the Application.\"\"\"\n name: String!\n\n \"\"\"The ID of the organization that owns this Application.\"\"\"\n organizationId: ID!\n\n \"\"\"\n The base URL of your application. This is the endpoint that the GoDaddy Commerce platform will call when integrated with actions.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n The public key (base64 encoded) for verifying action requests to your application.\n \"\"\"\n publicKey: String\n\n \"\"\"\n Additional OAuth redirect URIs on the application's OAuth client(s). URL-derived defaults (the application URL and {url}/api/godaddy/callback) are omitted so this list can be submitted unchanged on create or update.\n \"\"\"\n redirectUris: [String!]!\n\n \"\"\"The releases of the Application.\"\"\"\n releases(\n after: String\n before: String\n first: Int\n last: Int\n\n \"\"\"The order in which to sort the releases.\"\"\"\n orderBy: ReleaseOrderBy\n\n \"\"\"Filter by release status.\"\"\"\n status: ReleaseStatusFilter\n ): ApplicationReleasesConnection\n\n \"\"\"\n The secret for verifying webhook requests to your application. Copy and secure this secret. You will not see it again.\n \"\"\"\n secret: String\n\n \"\"\"The status of the application.\"\"\"\n status: ApplicationStatus!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The public website of the application.\"\"\"\n url: String\n}\n\n\"\"\"An action that can be executed by an application within the platform.\"\"\"\ntype ApplicationAction {\n \"\"\"The timestamp of when the action was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The globally-unique ID of the action.\"\"\"\n id: String!\n\n \"\"\"A unique identifier for the action within the application.\"\"\"\n name: String!\n\n \"\"\"The timestamp of when the action was last updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The endpoint URL that will be called when this action is triggered.\"\"\"\n url: String!\n}\n\n\"\"\"Input for creating a new application action.\"\"\"\ninput ApplicationActionCreateInput {\n \"\"\"A unique identifier for the action within the application.\"\"\"\n name: String!\n\n \"\"\"\n The path of the endpoint URL that will be called when this action is triggered.\n \"\"\"\n url: String!\n}\n\n\"\"\"\nA dependency an application release declares on another application (the application's id, the name it was declared under, and its required/excluded/enabled state).\n\"\"\"\ntype ApplicationDependency {\n \"\"\"\n The immutable id of the application depended upon. Unaffected by renames of that application.\n \"\"\"\n applicationId: ID!\n\n \"\"\"\n The application name this dependency was declared under. A record of what was declared, not a live reference — it is not rewritten when the depended-upon application is renamed, so it can differ from that application's current name. Use `applicationId` to identify the application.\n \"\"\"\n name: String!\n\n \"\"\"The declared state for this application dependency.\"\"\"\n state: ApplicationDependencyState!\n}\n\n\"\"\"\nInput for declaring a dependency on another application from a release.\n\"\"\"\ninput ApplicationDependencyInput {\n \"\"\"\n The name of the application depended upon. Must match a non-archived application.\n \"\"\"\n name: String!\n\n \"\"\"The declared state for this application dependency.\"\"\"\n state: ApplicationDependencyState!\n}\n\n\"\"\"The state of an application dependency declaration.\"\"\"\nenum ApplicationDependencyState {\n \"\"\"\n The dependency application is enabled by default but can be overridden.\n \"\"\"\n ENABLED\n\n \"\"\"\n The dependency application is excluded and must not be enabled alongside this release.\n \"\"\"\n EXCLUDED\n\n \"\"\"\n The dependency application is required and cannot be disabled while this release is live.\n \"\"\"\n REQUIRED\n}\n\n\"\"\"\nAn enablement represents an application installed for a specific entity (e.g. a store).\n\"\"\"\ntype ApplicationEnablement {\n \"\"\"When the enablement was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"When the application was disabled.\"\"\"\n disabledAt: DateTime\n\n \"\"\"When the application was enabled.\"\"\"\n enabledAt: DateTime\n\n \"\"\"The ID of the entity this application is enabled for.\"\"\"\n entityId: String!\n\n \"\"\"The type of entity (e.g. STORE).\"\"\"\n entityType: String!\n\n \"\"\"The globally-unique ID of the enablement.\"\"\"\n id: String!\n\n \"\"\"When the enablement was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"A listing for an application.\"\"\"\ntype ApplicationListing {\n \"\"\"The ID of the application this listing belongs to.\"\"\"\n applicationId: ID!\n\n \"\"\"The timestamp when the listing was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"\n Taxonomy facets for this listing (region, industry, category, tag, etc.).\n \"\"\"\n facets: [ApplicationListingFacet!]!\n\n \"\"\"CDN URL of the confirmed HIGHLIGHT asset, or null if not uploaded.\"\"\"\n highlightImageUrl: String\n\n \"\"\"CDN URL of the confirmed ICON asset, or null if not uploaded.\"\"\"\n iconUrl: String\n\n \"\"\"The globally-unique ID of the listing.\"\"\"\n id: ID!\n\n \"\"\"A description for the listing (plain text, max 4000 chars).\"\"\"\n listingDescription: String\n\n \"\"\"HTTPS URL for the privacy policy. Null when not set.\"\"\"\n privacyPolicyUrl: String\n\n \"\"\"CDN URLs of confirmed SCREENSHOT assets, ordered by sort_order.\"\"\"\n screenshotUrls: [String!]!\n\n \"\"\"The lifecycle status of the listing.\"\"\"\n status: ListingStatus!\n\n \"\"\"A short marketing pitch for the listing (plain text, max 160 chars).\"\"\"\n tagline: String\n\n \"\"\"HTTPS URL for the terms and conditions. Null when not set.\"\"\"\n termsAndConditionsUrl: String\n\n \"\"\"The timestamp when the listing was last updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"CDN URLs of confirmed VIDEO assets, ordered by sort_order.\"\"\"\n videoUrls: [String!]!\n\n \"\"\"The visibility of the listing.\"\"\"\n visibility: ListingVisibility!\n}\n\n\"\"\"A taxonomy facet attached to a listing.\"\"\"\ntype ApplicationListingFacet {\n \"\"\"The facet namespace (e.g. 'region', 'industry', 'category', 'tag').\"\"\"\n namespace: String!\n\n \"\"\"The facet value (e.g. 'US', 'retail', 'ecommerce').\"\"\"\n value: String!\n}\n\n\"\"\"\nFilter listings by facet. Returns listings that either have no facets in the given namespace (unrestricted), or have at least one facet in that namespace matching any of the provided values.\n\"\"\"\ninput ApplicationListingFacetFilterInput {\n \"\"\"The facet namespace to filter on (e.g. 'region').\"\"\"\n namespace: String!\n\n \"\"\"\n Accepted facet values (OR semantics within this filter). An empty array is treated as a no-op for this facet filter, not as a filter that matches nothing.\n \"\"\"\n values: [String!]!\n}\n\n\"\"\"A namespace + value pair for a listing facet.\"\"\"\ninput ApplicationListingFacetInput {\n \"\"\"The facet namespace (e.g. 'region', 'industry', 'category', 'tag').\"\"\"\n namespace: String!\n\n \"\"\"The facet value.\"\"\"\n value: String!\n}\n\n\"\"\"Filter options for listing queries.\"\"\"\ninput ApplicationListingFilterInput {\n \"\"\"\n Restrict results to listings for these application IDs (max 50, duplicates ignored).\n \"\"\"\n applicationIds: [ID!]\n\n \"\"\"\n Filter by taxonomy facets. All provided filters must match (AND semantics across namespaces).\n \"\"\"\n facets: [ApplicationListingFacetFilterInput!]\n\n \"\"\"\n Filter by listing lifecycle status. Defaults to ACTIVE for public LISTED discovery. Pass [ACTIVE, INACTIVE] to include deactivated listings (e.g. My Apps by applicationIds).\n \"\"\"\n status: [ListingStatus!]\n\n \"\"\"\n Filter by visibility. Defaults to [LISTED] for public discovery. Pass [LISTED, UNLISTED, HIDDEN] to see all listings for an owner context.\n \"\"\"\n visibility: [ListingVisibility!]\n}\n\n\"\"\"Fields to create or update a listing.\"\"\"\ninput ApplicationListingInput {\n \"\"\"\n Taxonomy facets for the listing. When provided, replaces all existing facets atomically.\n \"\"\"\n facets: [ApplicationListingFacetInput!]\n\n \"\"\"A description for the listing (plain text, max 4000 chars).\"\"\"\n listingDescription: String\n\n \"\"\"\n HTTPS URL for the privacy policy (max 255 chars). Pass null or empty string to clear.\n \"\"\"\n privacyPolicyUrl: String\n\n \"\"\"\n The lifecycle status of the listing. Defaults to INACTIVE on create. ACTIVE requires listing description, privacy URL, terms URL, categories, industries, icon, and screenshots.\n \"\"\"\n status: ListingStatus\n\n \"\"\"A short marketing pitch (plain text, max 160 chars).\"\"\"\n tagline: String\n\n \"\"\"\n HTTPS URL for the terms and conditions (max 255 chars). Pass null or empty string to clear.\n \"\"\"\n termsAndConditionsUrl: String\n\n \"\"\"The visibility of the listing. Defaults to LISTED.\"\"\"\n visibility: ListingVisibility\n}\n\ntype ApplicationListingsConnection {\n edges: [ApplicationListingsConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype ApplicationListingsConnectionEdge {\n cursor: String!\n node: ApplicationListing\n}\n\n\"\"\"\nAn MCP (Model Context Protocol) server registered with an application release.\n\"\"\"\ntype ApplicationMcpServer {\n \"\"\"The timestamp of when the MCP server was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The globally-unique ID of the MCP server.\"\"\"\n id: String!\n\n \"\"\"Additional configuration for the MCP server.\"\"\"\n metadata: JSONObject\n\n \"\"\"A unique identifier for the MCP server within the release.\"\"\"\n name: String!\n\n \"\"\"The MCP protocol version supported by this server.\"\"\"\n protocolVersion: String\n\n \"\"\"The timestamp of when the MCP server was last updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"\n The path of the endpoint URL that Traefik will route to (e.g., '/mcp/inventory').\n \"\"\"\n url: String!\n}\n\n\"\"\"Input for creating a new MCP server registration.\"\"\"\ninput ApplicationMcpServerCreateInput {\n \"\"\"\n Additional configuration for the MCP server (e.g., tool descriptions, capabilities).\n \"\"\"\n metadata: JSONObject\n\n \"\"\"A unique identifier for the MCP server within the release.\"\"\"\n name: String!\n\n \"\"\"The MCP protocol version supported by this server.\"\"\"\n protocolVersion: String\n\n \"\"\"\n The path of the endpoint URL that Traefik will route to (e.g., '/mcp/inventory').\n \"\"\"\n url: String!\n}\n\n\"\"\"\nA native extension registered with an application release. The target platform is indicated by `platform`.\n\"\"\"\ntype ApplicationNativeExtension {\n \"\"\"The ID of the associated application.\"\"\"\n applicationId: String!\n\n \"\"\"Support contact for the native extension.\"\"\"\n contact: String @deprecated(reason: \"Support contact belongs at the application-registration level, not on an individual extension. Retained temporarily and will be removed once an application-level contact exists.\")\n\n \"\"\"The timestamp of when the native extension was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The globally-unique ID of the native extension.\"\"\"\n id: String!\n\n \"\"\"The display name of the native extension.\"\"\"\n name: String\n\n \"\"\"\n The platform package identifier, in reverse-DNS form (e.g. 'com.example.app'). Optional: not every native deployment is installed through a package manager.\n \"\"\"\n packageName: String\n\n \"\"\"The platform for this native extension.\"\"\"\n platform: NativeExtensionPlatform!\n\n \"\"\"The ID of the associated release.\"\"\"\n releaseId: String!\n\n \"\"\"The timestamp of when the native extension was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"Input for creating a new native extension.\"\"\"\ninput ApplicationNativeExtensionCreateInput {\n \"\"\"Support contact for the native extension.\"\"\"\n contact: String @deprecated(reason: \"Support contact belongs at the application-registration level, not on an individual extension. Retained temporarily and will be removed once an application-level contact exists.\")\n\n \"\"\"The display name of the native extension.\"\"\"\n name: String\n\n \"\"\"\n The platform package identifier, in reverse-DNS form (e.g. 'com.example.app'). Optional: not every native deployment is installed through a package manager.\n \"\"\"\n packageName: String\n\n \"\"\"The platform for this native extension.\"\"\"\n platform: NativeExtensionPlatform!\n}\n\n\"\"\"Fields by which applications can be ordered.\"\"\"\ninput ApplicationOrderBy {\n \"\"\"Order applications by creation date.\"\"\"\n createdAt: OrderByDirectionEnum\n\n \"\"\"Order applications by ID.\"\"\"\n id: OrderByDirectionEnum\n\n \"\"\"Order applications by name.\"\"\"\n name: OrderByDirectionEnum\n\n \"\"\"Order applications by last update date.\"\"\"\n updatedAt: OrderByDirectionEnum\n}\n\ntype ApplicationRelease {\n \"\"\"The actions registered with this release.\"\"\"\n actions: [ApplicationAction!]!\n\n \"\"\"The timestamp of when the Application was activated.\"\"\"\n activatedAt: DateTime\n\n \"\"\"\n The other applications this release depends on, and the state it declares for each.\n \"\"\"\n applicationDependencies: [ApplicationDependency!]!\n\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The timestamp of when the release was deactivated.\"\"\"\n deactivatedAt: DateTime\n\n \"\"\"\n Information about the new release. Provide information about what has changed and any implications that it might have on your users.\n \"\"\"\n description: String\n\n \"\"\"The feature dependencies declared by this release.\"\"\"\n featureDependencies: [FeatureDependency!]!\n\n \"\"\"The globally-unique ID of the release.\"\"\"\n id: String!\n\n \"\"\"The MCP servers registered with this release.\"\"\"\n mcpServers: [ApplicationMcpServer!]!\n\n \"\"\"The native extensions registered with this release.\"\"\"\n nativeExtensions: [ApplicationNativeExtension!]!\n\n \"\"\"\n The authorization scopes required by this release. These are added to the application's authorization scopes when the release is created.\n \"\"\"\n scopes: [String!]\n\n \"\"\"The settings capabilities registered with this release.\"\"\"\n settings(\n \"\"\"Filter settings by Commerce settings group slug.\"\"\"\n groupSlug: String\n ): [ApplicationSetting!]!\n\n \"\"\"The lifecycle status of the release.\"\"\"\n status: ApplicationReleaseStatus!\n\n \"\"\"The webhook subscriptions registered with this release.\"\"\"\n subscriptions: [ApplicationSubscription!]!\n\n \"\"\"The UI extensions registered with this release.\"\"\"\n uiExtensions(\n \"\"\"\n Optional UI extension target filter. Supports has (single match) and hasAny (any match).\n \"\"\"\n target: StringListFilter\n ): [ApplicationUiExtension!]!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The version number of this release.\"\"\"\n version: String!\n}\n\n\"\"\"The status of an application release.\"\"\"\nenum ApplicationReleaseStatus {\n \"\"\"Release is active and available for use.\"\"\"\n ACTIVE\n\n \"\"\"Release is created but not active.\"\"\"\n INACTIVE\n}\n\ntype ApplicationReleasesConnection {\n edges: [ApplicationReleasesConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype ApplicationReleasesConnectionEdge {\n cursor: String!\n node: ApplicationRelease\n}\n\n\"\"\"\nA settings capability registered with an application release and placed into a Commerce-owned settings group.\n\"\"\"\ntype ApplicationSetting {\n \"\"\"The app-owned slug for this setting registration.\"\"\"\n appSettingSlug: String!\n\n \"\"\"Lifecycle capabilities supported by this setting.\"\"\"\n capabilities: [String!]!\n\n \"\"\"The timestamp of when the setting was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"Display description for this setting.\"\"\"\n description: String\n\n \"\"\"Localization key for the display description.\"\"\"\n descriptionKey: String\n\n \"\"\"The GPA settings namespace path that lifecycle endpoints live beneath.\"\"\"\n entryPath: String!\n\n \"\"\"The Commerce-owned settings group slug.\"\"\"\n groupSlug: String!\n\n \"\"\"Optional icon library for display.\"\"\"\n iconLibrary: String\n\n \"\"\"Optional icon name for display.\"\"\"\n iconName: String\n\n \"\"\"The globally-unique ID of the application setting.\"\"\"\n id: String!\n\n \"\"\"Additional app-defined settings metadata.\"\"\"\n metadata: JSONObject\n\n \"\"\"Sort order within the settings group.\"\"\"\n order: Int!\n\n \"\"\"The client-renderable presentation contract for this setting.\"\"\"\n presentation: JSONObject!\n\n \"\"\"Display title for this setting.\"\"\"\n title: String\n\n \"\"\"Localization key for the display title.\"\"\"\n titleKey: String\n\n \"\"\"The timestamp of when the setting was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"Input for creating a new application settings registration.\"\"\"\ninput ApplicationSettingCreateInput {\n \"\"\"The app-owned slug for this setting registration.\"\"\"\n appSettingSlug: String!\n\n \"\"\"\n Lifecycle capabilities supported by this setting (read, write, validate, test, delete, open, config). config requires metadata.configKeys.\n \"\"\"\n capabilities: [String!]\n\n \"\"\"Display description for this setting.\"\"\"\n description: String\n\n \"\"\"Localization key for the display description.\"\"\"\n descriptionKey: String\n\n \"\"\"The GPA settings namespace path that lifecycle endpoints live beneath.\"\"\"\n entryPath: String!\n\n \"\"\"The Commerce-owned settings group slug.\"\"\"\n groupSlug: String!\n\n \"\"\"Optional icon library for display.\"\"\"\n iconLibrary: String\n\n \"\"\"Optional icon name for display.\"\"\"\n iconName: String\n\n \"\"\"Additional app-defined settings metadata.\"\"\"\n metadata: JSONObject\n\n \"\"\"Sort order within the settings group.\"\"\"\n order: Int\n\n \"\"\"\n The settings-form-v1 or settings-link-v1 presentation contract for this setting.\n \"\"\"\n presentation: JSONObject!\n\n \"\"\"Display title for this setting.\"\"\"\n title: String\n\n \"\"\"Localization key for the display title.\"\"\"\n titleKey: String\n}\n\n\"\"\"The current status of an application in the platform.\"\"\"\nenum ApplicationStatus {\n \"\"\"Application is active and can be used.\"\"\"\n ACTIVE\n\n \"\"\"Application has been archived and is no longer available.\"\"\"\n ARCHIVED\n\n \"\"\"Application has been blocked from use due to policy violations.\"\"\"\n BLOCKED\n\n \"\"\"Application is registered but not active.\"\"\"\n INACTIVE\n\n \"\"\"Application is being verified and is not yet active.\"\"\"\n VERIFYING\n}\n\n\"\"\"Filter applications by status.\"\"\"\ninput ApplicationStatusFilter {\n \"\"\"Filter by exact status match.\"\"\"\n eq: ApplicationStatus\n\n \"\"\"Filter by any of the specified statuses.\"\"\"\n in: [ApplicationStatus!]\n\n \"\"\"Filter by status not equal to the specified value.\"\"\"\n ne: ApplicationStatus\n}\n\n\"\"\"\nWebhook subscriptions that an application has opted to subscribe to. Each subscription has one or many events.\n\"\"\"\ntype ApplicationSubscription {\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"A list of events that the subscription will receive.\"\"\"\n events: [String!]!\n\n \"\"\"The globally-unique ID of the release.\"\"\"\n id: String!\n\n \"\"\"The name of the webhook subscription\"\"\"\n name: String!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The delivery URL of the webhook.\"\"\"\n url: String!\n}\n\n\"\"\"Input for creating a new application webhook subscription.\"\"\"\ninput ApplicationSubscriptionCreateInput {\n \"\"\"List of event types this subscription will receive.\"\"\"\n events: [String!]!\n\n \"\"\"A unique name for the subscription.\"\"\"\n name: String!\n\n \"\"\"The webhook URL that will receive the events.\"\"\"\n url: String!\n}\n\n\"\"\"\nA UI extension registered with an application release (e.g., embed, checkout, blocks).\n\"\"\"\ntype ApplicationUiExtension {\n \"\"\"The base CDN URL for packaged UI extension assets.\"\"\"\n cdnUrl: String\n\n \"\"\"The timestamp of when the UI extension was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The unique handle/identifier for the extension (e.g., 'my-extension').\"\"\"\n handle: String\n\n \"\"\"The globally-unique ID of the UI extension.\"\"\"\n id: String!\n\n \"\"\"The display name of the extension.\"\"\"\n name: String\n\n \"\"\"\n The source file path for the extension (e.g., 'extensions/my-ext/index.ts').\n \"\"\"\n source: String\n\n \"\"\"\n The target location for the extension (e.g., 'body.end', 'checkout.header').\n \"\"\"\n target: String\n\n \"\"\"The type of UI extension (e.g., 'embed', 'checkout', 'blocks').\"\"\"\n type: String!\n\n \"\"\"The timestamp of when the UI extension was last updated.\"\"\"\n updatedAt: DateTime!\n}\n\n\"\"\"Input for creating a new application UI extension.\"\"\"\ninput ApplicationUiExtensionCreateInput {\n \"\"\"\n The unique handle/identifier for the extension (e.g., 'my-extension'). Optional for blocks extensions.\n \"\"\"\n handle: String\n\n \"\"\"The display name of the extension. Optional for blocks extensions.\"\"\"\n name: String\n\n \"\"\"\n The source file path for the extension (e.g., 'extensions/my-ext/index.ts'). Optional for blocks extensions.\n \"\"\"\n source: String\n\n \"\"\"\n The target location for the extension (e.g., 'body.end', 'checkout.header'). Required for targeted extensions, optional for block-type extensions.\n \"\"\"\n target: String\n\n \"\"\"The type of UI extension (e.g., 'embed', 'checkout', 'blocks').\"\"\"\n type: String!\n}\n\n\"\"\"Pre-signed upload URL and metadata for listing media.\"\"\"\ntype CreateMediaUploadUrlResponse {\n expiresAt: DateTime!\n maxSizeBytes: Int!\n mediaObjectId: ID!\n requiredHeaders: [String!]!\n uploadUrl: String!\n}\n\n\"\"\"\nResult of creating an OAuth client secret. Includes the secret value once; store it immediately — it cannot be retrieved again.\n\"\"\"\ntype CreatedOauthClientSecret {\n \"\"\"OAuth client id this secret belongs to, or null when unknown.\"\"\"\n clientId: String\n\n \"\"\"Description of the secret, or null when unknown.\"\"\"\n clientSecretDescription: String\n\n \"\"\"Id of this secret (used to revoke).\"\"\"\n clientSecretId: String!\n\n \"\"\"Display name of the secret, or null when unknown.\"\"\"\n clientSecretName: String\n\n \"\"\"\n The secret value, returned only on create. Store it immediately — it cannot be retrieved again.\n \"\"\"\n clientSecretValue: String!\n\n \"\"\"When this secret was created (ISO-8601), or null when unknown.\"\"\"\n createdAt: String\n\n \"\"\"When this secret was revoked (ISO-8601), or null if still active.\"\"\"\n deletedAt: String\n\n \"\"\"When this secret expires (ISO-8601), or null when unknown.\"\"\"\n expiresOn: String\n}\n\n\"\"\"A date-time string in ISO 8601 format (e.g. 2022-01-01T00:00:00Z).\"\"\"\nscalar DateTime\n\n\"\"\"The distribution type for an application.\"\"\"\nenum DistributionType {\n \"\"\"Application has custom distribution.\"\"\"\n CUSTOM @deprecated(reason: \"Use PRIVATE instead.\")\n\n \"\"\"Application is privately distributed.\"\"\"\n PRIVATE\n\n \"\"\"Application is publicly available.\"\"\"\n PUBLIC\n}\n\ntype EnabledApplication {\n \"\"\"The timestamp of when the Application was activated.\"\"\"\n activatedAt: DateTime\n\n \"\"\"The timestamp of when the Application was archived.\"\"\"\n archivedAt: DateTime\n\n \"\"\"\n The authorization scopes that the OAuth2 client has access to and will use to call API endpoints.\n \"\"\"\n authorizationScopes: [String!]!\n\n \"\"\"\n Earliest linked OAuth client ID for this application by createdAt then id (includes NULL-secret and ARCHIVED apps).\n \"\"\"\n clientId: ID\n\n \"\"\"\n The primary OAuth client secret for this application. Only returned on application creation.\n \"\"\"\n clientSecret: String\n\n \"\"\"The timestamp of when the Application was created.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The timestamp of when the Application was deactivated.\"\"\"\n deactivatedAt: DateTime\n\n \"\"\"General information about your application.\"\"\"\n description: String\n\n \"\"\"The globally-unique ID of the Application.\"\"\"\n id: ID!\n\n \"\"\"A human-readable label of the Application for display purposes.\"\"\"\n label: String!\n\n \"\"\"A url-friendly name for the Application.\"\"\"\n name: String!\n\n \"\"\"The ID of the organization that owns this Application.\"\"\"\n organizationId: ID!\n\n \"\"\"\n The base URL of your application. This is the endpoint that the GoDaddy Commerce platform will call when integrated with actions.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n The public key (base64 encoded) for verifying action requests to your application.\n \"\"\"\n publicKey: String\n\n \"\"\"\n Additional OAuth redirect URIs on the application's OAuth client(s). URL-derived defaults (the application URL and {url}/api/godaddy/callback) are omitted so this list can be submitted unchanged on create or update.\n \"\"\"\n redirectUris: [String!]!\n\n \"\"\"The release/version enabled for this application\"\"\"\n release: ApplicationRelease\n\n \"\"\"\n The secret for verifying webhook requests to your application. Copy and secure this secret. You will not see it again.\n \"\"\"\n secret: String\n\n \"\"\"The status of the application.\"\"\"\n status: ApplicationStatus!\n\n \"\"\"The timestamp of when the Application was updated.\"\"\"\n updatedAt: DateTime!\n\n \"\"\"The public website of the application.\"\"\"\n url: String\n}\n\n\"\"\"Fields by which enablements can be ordered.\"\"\"\ninput EnablementOrderBy {\n \"\"\"Order enablements by creation date.\"\"\"\n createdAt: OrderByDirectionEnum\n\n \"\"\"Order enablements by ID.\"\"\"\n id: OrderByDirectionEnum\n\n \"\"\"Order enablements by last update date.\"\"\"\n updatedAt: OrderByDirectionEnum\n}\n\n\"\"\"\nA feature dependency declared by an application release (a feature name and its required/excluded/enabled/disabled state).\n\"\"\"\ntype FeatureDependency {\n \"\"\"The feature name from the available features list.\"\"\"\n name: String!\n\n \"\"\"The declared state for this feature.\"\"\"\n state: FeatureDependencyState!\n}\n\n\"\"\"Input for declaring a feature dependency on a release.\"\"\"\ninput FeatureDependencyInput {\n \"\"\"The feature name from the available features list.\"\"\"\n name: String!\n\n \"\"\"The declared state for this feature.\"\"\"\n state: FeatureDependencyState!\n}\n\n\"\"\"The state of a feature dependency declaration.\"\"\"\nenum FeatureDependencyState {\n \"\"\"Feature is disabled by default but can be overridden.\"\"\"\n DISABLED\n\n \"\"\"Feature is enabled by default but can be overridden.\"\"\"\n ENABLED\n\n \"\"\"Feature is excluded and cannot be required by other apps.\"\"\"\n EXCLUDED\n\n \"\"\"Feature is required and cannot be excluded by other apps.\"\"\"\n REQUIRED\n}\n\n\"\"\"Response containing pre-signed upload URL and metadata.\"\"\"\ntype GenerateReleaseUploadUrlResponse {\n \"\"\"The timestamp when the upload URL expires.\"\"\"\n expiresAt: DateTime!\n\n \"\"\"The S3 key where the file should be uploaded.\"\"\"\n key: String!\n\n \"\"\"Maximum allowed file size in bytes.\"\"\"\n maxSizeBytes: Int!\n\n \"\"\"Required headers for the upload as key:value pairs.\"\"\"\n requiredHeaders: [String!]!\n\n \"\"\"The unique upload identifier for tracking.\"\"\"\n uploadId: String!\n\n \"\"\"The pre-signed URL for uploading the file.\"\"\"\n url: String!\n}\n\n\"\"\"A JSON object scalar type.\"\"\"\nscalar JSONObject @specifiedBy(url: \"http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf\")\n\n\"\"\"Allowed MIME types for listing media uploads.\"\"\"\nenum ListingMediaContentType {\n IMAGE_JPEG\n IMAGE_PNG\n VIDEO_MP4\n}\n\n\"\"\"The merchandising role of a listing media asset.\"\"\"\nenum ListingMediaRole {\n HIGHLIGHT\n ICON\n SCREENSHOT\n VIDEO\n}\n\n\"\"\"The lifecycle status of a listing media upload.\"\"\"\nenum ListingMediaStatus {\n CONFIRMED\n FAILED\n PENDING\n REMOVED\n SUPERSEDED\n}\n\n\"\"\"The lifecycle status of a listing.\"\"\"\nenum ListingStatus {\n \"\"\"Listing is active and eligible for marketplace discovery.\"\"\"\n ACTIVE\n\n \"\"\"Listing is inactive until activation requirements are met.\"\"\"\n INACTIVE\n}\n\n\"\"\"The visibility of a listing.\"\"\"\nenum ListingVisibility {\n \"\"\"Listing is hidden from discovery surfaces.\"\"\"\n HIDDEN\n\n \"\"\"Listing is publicly visible.\"\"\"\n LISTED\n\n \"\"\"Listing is not shown in search.\"\"\"\n UNLISTED\n}\n\n\"\"\"A media asset attached to an application listing.\"\"\"\ntype MediaObject {\n applicationId: ID!\n contentType: String\n createdAt: DateTime!\n failureReason: String\n filename: String\n id: ID!\n listingId: ID\n role: ListingMediaRole\n sortOrder: Int!\n status: ListingMediaStatus!\n updatedAt: DateTime!\n url: String\n}\n\ntype Mutation {\n \"\"\"\n Activate a release and, when permitted, promote its parent application to ACTIVE.\n \"\"\"\n activateRelease(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The ID of the release to activate.\"\"\"\n releaseId: ID!\n ): ApplicationRelease\n\n \"\"\"Archive an existing Application.\"\"\"\n archiveApplication(\n \"\"\"The ID of the application to archive.\"\"\"\n id: String!\n ): Application\n\n \"\"\"Confirm a listing media upload after the client PUTs the file to S3.\"\"\"\n confirmMediaObject(\n \"\"\"The application that owns the media object — used for authorization.\"\"\"\n applicationId: ID!\n\n \"\"\"The media object ID returned from createMediaUploadUrl.\"\"\"\n mediaObjectId: ID!\n ): MediaObject\n\n \"\"\"Create a new Application.\"\"\"\n createApplication(input: MutationCreateApplicationInput!): Application\n\n \"\"\"\n Create an additional OAuth client secret on the application's primary OAuth client. Returns the secret value once. Fails when the active-secret limit is reached.\n \"\"\"\n createApplicationOauthClientSecret(\n \"\"\"The application to create a secret for.\"\"\"\n applicationId: String!\n input: MutationCreateApplicationOauthClientSecretInput!\n ): CreatedOauthClientSecret\n\n \"\"\"\n Create a pending listing media record and return a pre-signed S3 PUT URL.\n \"\"\"\n createMediaUploadUrl(\n \"\"\"The application that owns the listing (1:1).\"\"\"\n applicationId: ID!\n\n \"\"\"MIME type of the file to upload.\"\"\"\n contentType: ListingMediaContentType!\n\n \"\"\"\n Declared file size in bytes. Rejected if it exceeds the role cap before issuing the presigned URL.\n \"\"\"\n fileSizeBytes: Int!\n\n \"\"\"Original filename from the client.\"\"\"\n filename: String!\n\n \"\"\"Merchandising role for this asset.\"\"\"\n role: ListingMediaRole!\n\n \"\"\"\n Optional ordering for screenshots/videos (0–7). Defaults to next slot. Ignored for other roles (defaults to 0).\n \"\"\"\n sortOrder: Int\n ): CreateMediaUploadUrlResponse\n\n \"\"\"Create a new release for an application.\"\"\"\n createRelease(input: MutationCreateReleaseInput!): ApplicationRelease\n\n \"\"\"\n Deactivate an application through its lifecycle operation. Activate it again by activating a release.\n \"\"\"\n deactivateApplication(\n \"\"\"The ID of the application to deactivate.\"\"\"\n id: String!\n ): Application\n\n \"\"\"\n Deactivate a release. When it is the last active release, its application listing is also deactivated.\n \"\"\"\n deactivateRelease(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The ID of the release to deactivate.\"\"\"\n releaseId: ID!\n ): ApplicationRelease\n\n \"\"\"Soft-delete the listing for an application.\"\"\"\n deleteApplicationListing(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n ): Boolean\n\n \"\"\"Disable an application on a customer\"\"\"\n disableCustomerApplication(input: MutationDisableCustomerApplicationInput!): Application\n\n \"\"\"Disable an application in a store\"\"\"\n disableStoreApplication(input: MutationDisableStoreApplicationInput!): Application\n\n \"\"\"Enable an application on a customer\"\"\"\n enableCustomerApplication(input: MutationEnableCustomerApplicationInput!): Application\n\n \"\"\"Enable an application on a store\"\"\"\n enableStoreApplication(input: MutationEnableStoreApplicationInput!): Application\n\n \"\"\"Generate a pre-signed URL for uploading UI extension artifacts.\"\"\"\n generateReleaseUploadUrl(input: MutationGenerateReleaseUploadUrlInput!): GenerateReleaseUploadUrlResponse\n\n \"\"\"\n Remove a confirmed listing media object. Sets status to REMOVED, deletes the promoted S3 object, and invalidates the CDN path.\n \"\"\"\n removeListingMediaObject(\n \"\"\"\n The application that owns the media object — prevents cross-app removal.\n \"\"\"\n applicationId: ID!\n\n \"\"\"The confirmed media object ID to remove.\"\"\"\n mediaObjectId: ID!\n ): MediaObject\n\n \"\"\"\n Revoke one OAuth client secret on the application's primary OAuth client. Cannot revoke the last active secret — create another first.\n \"\"\"\n revokeApplicationOauthClientSecret(\n \"\"\"The application whose secret to revoke.\"\"\"\n applicationId: String!\n input: MutationRevokeApplicationOauthClientSecretInput!\n ): RevokedOauthClientSecret\n\n \"\"\"\n Create or update the listing for an application. Idempotent — safe to call multiple times for the same application.\n \"\"\"\n setApplicationListing(\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The listing fields to create or update.\"\"\"\n input: ApplicationListingInput!\n ): ApplicationListing\n\n \"\"\"Update an existing Application.\"\"\"\n updateApplication(id: String!, input: MutationUpdateApplicationInput!): Application\n}\n\ninput MutationCreateApplicationInput {\n \"\"\"\n The authorization scopes of the application. Defines the GoDaddy permissions for the application.\n \"\"\"\n authorizationScopes: [String!] @deprecated(reason: \"Manage scopes per release via createRelease; retained for backward compatibility and can only extend the application's scopes.\")\n\n \"\"\"The description of the application.\"\"\"\n description: String\n\n \"\"\"The distribution type for the application. Defaults to PUBLIC.\"\"\"\n distributionType: DistributionType = PUBLIC\n\n \"\"\"The label of the application.\"\"\"\n label: String!\n\n \"\"\"The name of the application.\"\"\"\n name: String!\n\n \"\"\"\n Optional organization ID for multi-org users. If omitted, the organization is auto-resolved from the user's session. If provided, the user must be an admin of the specified organization.\n \"\"\"\n organizationId: String\n\n \"\"\"\n The proxy URL of the application. This is the base URL for all API endpoints.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n Additional OAuth redirect URI allowlist. Supports up to 5 unique HTTPS URLs. Entries equal to the application URL or its default callback are rejected; those defaults are registered automatically.\n \"\"\"\n redirectUris: [String!]\n\n \"\"\"\n The public URL of the application. This is typically the URL of the application's website.\n \"\"\"\n url: String\n}\n\ninput MutationCreateApplicationOauthClientSecretInput {\n \"\"\"Description for the new secret. Cannot be blank.\"\"\"\n clientSecretDescription: String!\n\n \"\"\"Display name for the new secret.\"\"\"\n clientSecretName: String!\n}\n\ninput MutationCreateReleaseInput {\n \"\"\"The actions associated with the release.\"\"\"\n actions: [ApplicationActionCreateInput!]\n\n \"\"\"\n The other applications this release depends on, and the state it declares for each.\n \"\"\"\n applicationDependencies: [ApplicationDependencyInput!]\n\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The description of the release.\"\"\"\n description: String\n\n \"\"\"The feature dependencies declared by the release.\"\"\"\n featureDependencies: [FeatureDependencyInput!]\n\n \"\"\"The MCP servers associated with the release.\"\"\"\n mcpServers: [ApplicationMcpServerCreateInput!]\n\n \"\"\"The native extensions associated with the release.\"\"\"\n nativeExtensions: [ApplicationNativeExtensionCreateInput!]\n\n \"\"\"\n The authorization scopes required by this release (e.g. 'commerce.orders:read'). New scopes are also added to the application's authorization scopes.\n \"\"\"\n scopes: [String!]\n\n \"\"\"The settings capabilities associated with the release.\"\"\"\n settings: [ApplicationSettingCreateInput!]\n\n \"\"\"The subscriptions associated with the release.\"\"\"\n subscriptions: [ApplicationSubscriptionCreateInput!]\n\n \"\"\"The UI extensions associated with the release.\"\"\"\n uiExtensions: [ApplicationUiExtensionCreateInput!]\n\n \"\"\"The version of the release.\"\"\"\n version: String!\n}\n\ninput MutationDisableCustomerApplicationInput {\n \"\"\"The name of the application to disable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the customer to disable the application on.\"\"\"\n customerId: String!\n}\n\ninput MutationDisableStoreApplicationInput {\n \"\"\"The name of the application to disable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the store to disable the application on.\"\"\"\n storeId: String!\n}\n\ninput MutationEnableCustomerApplicationInput {\n \"\"\"The name of the application to enable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the customer to enable the application on.\"\"\"\n customerId: String!\n}\n\ninput MutationEnableStoreApplicationInput {\n \"\"\"The name of the application to enable.\"\"\"\n applicationName: String!\n\n \"\"\"The ID of the store to enable the application on.\"\"\"\n storeId: String!\n}\n\ninput MutationGenerateReleaseUploadUrlInput {\n \"\"\"The ID of the application.\"\"\"\n applicationId: ID!\n\n \"\"\"The content type of the file to be uploaded.\"\"\"\n contentType: UploadContentType!\n\n \"\"\"The ID of the release.\"\"\"\n releaseId: ID!\n\n \"\"\"The target for the upload.\"\"\"\n target: String\n}\n\ninput MutationRevokeApplicationOauthClientSecretInput {\n \"\"\"Id of the secret to revoke.\"\"\"\n clientSecretId: String!\n}\n\ninput MutationUpdateApplicationInput {\n \"\"\"\n The authorization scopes of the application. Defines the GoDaddy permissions for the application.\n \"\"\"\n authorizationScopes: [String!] @deprecated(reason: \"Manage scopes per release via createRelease; retained for backward compatibility and can only extend the application's scopes.\")\n\n \"\"\"The description of the application.\"\"\"\n description: String\n\n \"\"\"\n The distribution type for the application (PUBLIC or PRIVATE; CUSTOM is deprecated). Omit to leave unchanged.\n \"\"\"\n distributionType: DistributionType\n\n \"\"\"The label of the application.\"\"\"\n label: String\n\n \"\"\"The name of the application.\"\"\"\n name: String\n\n \"\"\"\n The proxy URL of the application. This is the base URL for all API endpoints.\n \"\"\"\n proxyUrl: String\n\n \"\"\"\n Additional OAuth redirect URI allowlist. Supports up to 5 unique HTTPS URLs. Entries equal to the effective application URL or its default callback are rejected. On URL changes, both old defaults are replaced; submit any old URI explicitly to retain it as an extra.\n \"\"\"\n redirectUris: [String!]\n\n \"\"\"\n The public URL of the application. This is typically the URL of the application's website.\n \"\"\"\n url: String\n}\n\n\"\"\"The platform for a native extension.\"\"\"\nenum NativeExtensionPlatform {\n \"\"\"Android platform (APK distribution).\"\"\"\n ANDROID\n}\n\n\"\"\"Represents a null value.\"\"\"\nscalar Null\n\n\"\"\"\nMetadata for one OAuth client secret on an application's primary OAuth client. Secret values are never included.\n\"\"\"\ntype OauthClientSecret {\n \"\"\"OAuth client id this secret belongs to, or null when unknown.\"\"\"\n clientId: String\n\n \"\"\"Description of the secret, or null when unknown.\"\"\"\n clientSecretDescription: String\n\n \"\"\"Id of this secret (used to revoke).\"\"\"\n clientSecretId: String!\n\n \"\"\"Display name of the secret, or null when unknown.\"\"\"\n clientSecretName: String\n\n \"\"\"When this secret was created (ISO-8601), or null when unknown.\"\"\"\n createdAt: String\n\n \"\"\"When this secret was revoked (ISO-8601), or null if still active.\"\"\"\n deletedAt: String\n\n \"\"\"When this secret expires (ISO-8601), or null when unknown.\"\"\"\n expiresOn: String\n}\n\n\"\"\"Direction for ordering results in queries.\"\"\"\nenum OrderByDirectionEnum {\n \"\"\"Sort in ascending order.\"\"\"\n ASC\n\n \"\"\"Sort in descending order.\"\"\"\n DESC\n}\n\ntype PageInfo {\n endCursor: String\n hasNextPage: Boolean!\n hasPreviousPage: Boolean!\n startCursor: String\n}\n\ntype Query {\n \"\"\"Get a single application by ID or name.\"\"\"\n application(\n \"\"\"The OAuth client ID of the application to retrieve.\"\"\"\n clientId: String\n\n \"\"\"The unique ID of the application to retrieve.\"\"\"\n id: String\n\n \"\"\"The unique name of the application to retrieve.\"\"\"\n name: String\n ): Application\n\n \"\"\"\n Paginated listings. Defaults to publicly LISTED listings for active PUBLIC-distribution apps with an active release. Pass visibility filter to query owner/admin contexts.\n \"\"\"\n applicationListings(\n after: String\n before: String\n\n \"\"\"Filter options for the query.\"\"\"\n filter: ApplicationListingFilterInput\n first: Int\n last: Int\n ): QueryApplicationListingsConnection\n\n \"\"\"\n List OAuth client secrets (metadata only) for an application's primary OAuth client. Requires application write access.\n \"\"\"\n applicationOauthClientSecrets(\n \"\"\"The application whose primary OAuth client secrets to list.\"\"\"\n applicationId: String!\n ): [OauthClientSecret!]!\n\n \"\"\"\n Get paginated applications. Returns all public applications for service requests, or only applications owned by the authenticated customer's organization. Multi-org users may pass an explicit `organizationId` to select which organization's apps to list.\n \"\"\"\n applications(\n after: String\n before: String\n first: Int\n last: Int\n\n \"\"\"The order in which to sort the applications.\"\"\"\n orderBy: ApplicationOrderBy\n\n \"\"\"\n Optional organization ID. When provided, lists apps for that specific organization. Customer tokens must be admin of the organization; service tokens may specify any organization.\n \"\"\"\n organizationId: String\n\n \"\"\"Filter by application status. Defaults to ACTIVE applications only.\"\"\"\n status: ApplicationStatusFilter\n ): QueryApplicationsConnection\n\n \"\"\"\n Get all applications enabled for an entity by entity ID and type, with optional filtering by actions, UI extensions, and settings.\n \"\"\"\n enabledApplications(\n \"\"\"\n Filter by action names. Supports has (single match) and hasAny (any match).\n \"\"\"\n actionNames: StringListFilter\n\n \"\"\"The ID of the entity to get enabled applications for.\"\"\"\n entityId: String!\n\n \"\"\"\n The type of the entity the applications are enabled on. Currently STORE.\n \"\"\"\n entityType: String!\n\n \"\"\"Filter by Commerce settings group slug.\"\"\"\n settingGroupSlug: String\n\n \"\"\"\n Filter by application setting slugs. Supports has (single match) and hasAny (any match).\n \"\"\"\n settingSlugs: StringListFilter\n\n \"\"\"\n Filter by UI extension targets. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTargets: StringListFilter\n\n \"\"\"\n Filter by UI extension types. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTypes: StringListFilter\n ): [EnabledApplication!]\n\n \"\"\"\n Get all applications enabled for a store by store ID, with optional filtering by actions, UI extensions, and settings.\n \"\"\"\n enabledStoreApplications(\n \"\"\"\n Filter by action names. Supports has (single match) and hasAny (any match).\n \"\"\"\n actionNames: StringListFilter\n\n \"\"\"Filter by Commerce settings group slug.\"\"\"\n settingGroupSlug: String\n\n \"\"\"\n Filter by application setting slugs. Supports has (single match) and hasAny (any match).\n \"\"\"\n settingSlugs: StringListFilter\n\n \"\"\"The ID of the store to get enabled applications for.\"\"\"\n storeId: String!\n\n \"\"\"\n Filter by UI extension targets. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTargets: StringListFilter\n\n \"\"\"\n Filter by UI extension types. Supports has (single match) and hasAny (any match).\n \"\"\"\n uiExtensionTypes: StringListFilter\n ): [EnabledApplication!]\n\n \"\"\"Returns a paginated list of enablements for a specific release.\"\"\"\n enablementsByRelease(\n after: String\n before: String\n\n \"\"\"Optional entity ID to filter enablements by.\"\"\"\n entityId: String\n first: Int\n last: Int\n\n \"\"\"The order in which to sort the enablements.\"\"\"\n orderBy: EnablementOrderBy\n\n \"\"\"The release ID to query enablements for.\"\"\"\n releaseId: ID!\n ): QueryEnablementsByReleaseConnection!\n\n \"\"\"Get the status of a release upload by upload ID.\"\"\"\n getReleaseUpload(\n \"\"\"The application ID to verify authorization.\"\"\"\n applicationId: ID!\n\n \"\"\"The unique upload identifier.\"\"\"\n uploadId: String!\n ): ReleaseUpload\n\n \"\"\"Get a single native extension by ID.\"\"\"\n nativeExtension(\n \"\"\"The ID of the native extension to retrieve.\"\"\"\n id: ID!\n ): ApplicationNativeExtension\n\n \"\"\"\n List native extensions by application or release. At least one of applicationId or releaseId must be provided.\n \"\"\"\n nativeExtensions(\n \"\"\"Filter by application ID.\"\"\"\n applicationId: ID\n\n \"\"\"Maximum number of results to return.\"\"\"\n limit: Int\n\n \"\"\"Filter by release ID.\"\"\"\n releaseId: ID\n ): [ApplicationNativeExtension!]!\n\n \"\"\"\n Get the resolved feature states for a store, after reconciling all active app declarations.\n \"\"\"\n storeFeatures(\n \"\"\"The ID of the store to resolve features for.\"\"\"\n storeId: String!\n ): [FeatureDependency!]!\n\n \"\"\"Returns webhook subscription IDs for a specific release/entity pair.\"\"\"\n webhookSubscriptionInstancesByRelease(\n \"\"\"The entity ID to scope the query to.\"\"\"\n entityId: ID!\n\n \"\"\"The entity type to scope the query to (e.g. STORE).\"\"\"\n entityType: String!\n\n \"\"\"The release ID to query webhook subscriptions for.\"\"\"\n releaseId: ID!\n ): [String!]!\n}\n\ntype QueryApplicationListingsConnection {\n edges: [QueryApplicationListingsConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype QueryApplicationListingsConnectionEdge {\n cursor: String!\n node: ApplicationListing\n}\n\ntype QueryApplicationsConnection {\n edges: [QueryApplicationsConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype QueryApplicationsConnectionEdge {\n cursor: String!\n node: Application\n}\n\ntype QueryEnablementsByReleaseConnection {\n edges: [QueryEnablementsByReleaseConnectionEdge]\n pageInfo: PageInfo!\n}\n\ntype QueryEnablementsByReleaseConnectionEdge {\n cursor: String!\n node: ApplicationEnablement\n}\n\n\"\"\"Fields by which application releases can be ordered.\"\"\"\ninput ReleaseOrderBy {\n \"\"\"Order releases by activation date.\"\"\"\n activatedAt: OrderByDirectionEnum\n\n \"\"\"Order releases by creation date.\"\"\"\n createdAt: OrderByDirectionEnum\n\n \"\"\"Order releases by ID.\"\"\"\n id: OrderByDirectionEnum\n\n \"\"\"Order releases by last update date.\"\"\"\n updatedAt: OrderByDirectionEnum\n\n \"\"\"Order releases by version number. Must be in {major}.{minor} format.\"\"\"\n version: OrderByDirectionEnum\n}\n\n\"\"\"Filter releases by status.\"\"\"\ninput ReleaseStatusFilter {\n \"\"\"Filter by exact status match.\"\"\"\n eq: ApplicationReleaseStatus\n\n \"\"\"Filter by any of the specified statuses.\"\"\"\n in: [ApplicationReleaseStatus!]\n\n \"\"\"Filter by status not equal to the specified value.\"\"\"\n ne: ApplicationReleaseStatus\n}\n\n\"\"\"A release upload record tracking the status of uploaded artifacts.\"\"\"\ntype ReleaseUpload {\n \"\"\"The ID of the associated application.\"\"\"\n applicationId: String!\n\n \"\"\"The timestamp when the upload was completed or failed.\"\"\"\n completedAt: DateTime\n\n \"\"\"The MIME type of the uploaded content.\"\"\"\n contentType: UploadContentType!\n\n \"\"\"The timestamp when the upload was requested.\"\"\"\n createdAt: DateTime!\n\n \"\"\"The reason for failure if status is FAILED.\"\"\"\n failureReason: String\n\n \"\"\"The globally-unique ID of the upload record.\"\"\"\n id: String!\n\n \"\"\"The ID of the associated release.\"\"\"\n releaseId: String!\n\n \"\"\"The size of the uploaded file in bytes.\"\"\"\n sizeBytes: Int\n\n \"\"\"The current status of the upload.\"\"\"\n status: ReleaseUploadStatus!\n\n \"\"\"The unique upload identifier used for correlation.\"\"\"\n uploadId: String!\n}\n\n\"\"\"The status of a release upload.\"\"\"\nenum ReleaseUploadStatus {\n \"\"\"Upload or processing failed.\"\"\"\n FAILED\n\n \"\"\"File has been processed and deployed successfully.\"\"\"\n PROCESSED\n\n \"\"\"Upload URL has been generated and is awaiting upload.\"\"\"\n REQUESTED\n\n \"\"\"File has been uploaded and is awaiting processing.\"\"\"\n UPLOADED\n}\n\n\"\"\"Result of revoking an OAuth client secret.\"\"\"\ntype RevokedOauthClientSecret {\n \"\"\"Id of the revoked secret.\"\"\"\n clientSecretId: String!\n}\n\n\"\"\"Filter for fields that are lists/sets of strings.\"\"\"\ninput StringListFilter {\n \"\"\"Field must contain this value.\"\"\"\n has: String\n\n \"\"\"Field must contain at least one of these values.\"\"\"\n hasAny: [String!]\n}\n\n\"\"\"Supported content types for release uploads.\"\"\"\nenum UploadContentType {\n \"\"\"JavaScript file\"\"\"\n JS\n\n \"\"\"TAR archive\"\"\"\n TAR\n\n \"\"\"ZIP archive\"\"\"\n ZIP\n}", "types": [ { "fields": [ @@ -1425,6 +1431,11 @@ "name": "nativeExtensions", "type": "[ApplicationNativeExtension!]!" }, + { + "description": "The authorization scopes required by this release. These are added to the application's authorization scopes when the release is created.", + "name": "scopes", + "type": "[String!]" + }, { "description": "The settings capabilities registered with this release.", "name": "settings", @@ -1900,6 +1911,7 @@ "name": "DistributionType", "values": [ "CUSTOM", + "PRIVATE", "PUBLIC" ] }, @@ -2313,6 +2325,11 @@ "name": "nativeExtensions", "type": "[ApplicationNativeExtensionCreateInput!]" }, + { + "description": "The authorization scopes required by this release (e.g. 'commerce.orders:read'). New scopes are also added to the application's authorization scopes.", + "name": "scopes", + "type": "[String!]" + }, { "description": "The settings capabilities associated with the release.", "name": "settings", @@ -2451,7 +2468,7 @@ "type": "String" }, { - "description": "The distribution type for the application (PUBLIC or CUSTOM). Omit to leave unchanged.", + "description": "The distribution type for the application (PUBLIC or PRIVATE; CUSTOM is deprecated). Omit to leave unchanged.", "name": "distributionType", "type": "DistributionType" }, @@ -2816,5 +2833,5 @@ ], "name": "app-registry", "title": "app-registry GraphQL API", - "version": "03494d6" + "version": "1d6ad09" } \ No newline at end of file diff --git a/rust/schemas/api/manifest.json b/rust/schemas/api/manifest.json index 1a5ce8f7..4ff59ef6 100644 --- a/rust/schemas/api/manifest.json +++ b/rust/schemas/api/manifest.json @@ -1,5 +1,5 @@ { - "generated": "2026-11-04T09:44:31.519327336+00:00", + "generated": "2026-11-13T16:09:05.800067+00:00", "domains": { "app-registry": { "file": "app-registry.json", diff --git a/rust/src/platform/app/client_tests.rs b/rust/src/platform/app/client_tests.rs index 86b65331..7e60196c 100644 --- a/rust/src/platform/app/client_tests.rs +++ b/rust/src/platform/app/client_tests.rs @@ -20,8 +20,8 @@ async fn list_applications_sends_all_app_registry_statuses() { "data": { "applications": { "edges": [ - { "node": { "id": "a1", "label": "Active", "name": "active-app", "description": null, "status": "ACTIVE", "url": null, "proxyUrl": null } }, - { "node": { "id": "a2", "label": "Inactive", "name": "inactive-app", "description": null, "status": "INACTIVE", "url": null, "proxyUrl": null } } + { "node": { "id": "a1", "label": "Active", "name": "active-app", "description": null, "status": "ACTIVE", "distributionType": "PUBLIC", "url": null, "proxyUrl": null } }, + { "node": { "id": "a2", "label": "Inactive", "name": "inactive-app", "description": null, "status": "INACTIVE", "distributionType": "PUBLIC", "url": null, "proxyUrl": null } } ] } } @@ -63,6 +63,7 @@ async fn activate_release_posts_mutation_with_ids() { "version": "1.0.0", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "activatedAt": "2026-01-01T00:00:00Z", "createdAt": "2026-01-01T00:00:00Z", "updatedAt": "2026-01-01T00:00:00Z" @@ -104,6 +105,7 @@ async fn list_enabled_store_applications_sends_store_id_variable() { "name": "my-app", "label": "My App", "status": "ACTIVE", + "distributionType": "PUBLIC", "release": { "id": "rel-1", "version": "1.0.0" } }] } @@ -209,6 +211,7 @@ async fn create_release_sends_settings_input_and_returns_settings() { application_dependencies: None, feature_dependencies: None, mcp_servers: None, + scopes: None, native_extensions: Some(vec![ create_release::ApplicationNativeExtensionCreateInput { contact: None, @@ -421,6 +424,7 @@ async fn get_application_with_releases_selects_client_id_and_subscriptions() { "name": "my-app", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "url": null, "proxyUrl": null, "authorizationScopes": [], @@ -455,6 +459,10 @@ async fn get_application_with_releases_selects_client_id_and_subscriptions() { mock.assert_async().await; assert_eq!(app.client_id.as_deref(), Some("client-1")); + assert_eq!( + app.distribution_type, + application_with_latest_release::DistributionType::PUBLIC + ); let edges = app .releases .expect("releases connection") @@ -489,6 +497,7 @@ async fn update_application_sends_non_lifecycle_fields() { "name": "my-app", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "url": null, "proxyUrl": null, "authorizationScopes": [], @@ -545,6 +554,7 @@ async fn update_application_omits_unset_input_fields_from_the_request() { "name": "my-app", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "url": null, "proxyUrl": null, "authorizationScopes": [], @@ -589,6 +599,7 @@ async fn get_application_returns_selected_fields() { "name": "my-app", "description": "desc", "status": "ACTIVE", + "distributionType": "PUBLIC", "url": "https://example.com", "proxyUrl": "https://proxy.example.com" } @@ -690,6 +701,7 @@ async fn archive_application_sends_id_and_returns_lifecycle_fields() { "label": "My App", "name": "my-app", "status": "ARCHIVED", + "distributionType": "PUBLIC", "createdAt": "2026-01-01T00:00:00Z", "archivedAt": "2026-02-01T00:00:00Z" } @@ -729,6 +741,7 @@ async fn create_application_sends_input_and_returns_credentials() { "name": "my-app", "description": null, "status": "ACTIVE", + "distributionType": "PUBLIC", "url": null, "proxyUrl": null, "authorizationScopes": [], diff --git a/rust/src/platform/app/commands/add.rs b/rust/src/platform/app/commands/add.rs index 724dd44d..6d5356d8 100644 --- a/rust/src/platform/app/commands/add.rs +++ b/rust/src/platform/app/commands/add.rs @@ -431,6 +431,7 @@ mod tests { name: "my-app".to_owned(), description: None, status: platform_app_client::application::ApplicationStatus::ACTIVE, + distribution_type: platform_app_client::application::DistributionType::PUBLIC, url: None, proxy_url: None, }; @@ -456,7 +457,8 @@ mod tests { "id": "app-registry-id", "label": "My App", "name": "my-app", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } } })); @@ -472,7 +474,8 @@ mod tests { "success": true, "data": { "id": "550e8400-e29b-41d4-a716-446655440001", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } })); }) @@ -564,7 +567,7 @@ mod tests { when.method(Method::POST) .path("/v1/apps/app-registry-subgraph"); then.status(200).json_body(json!({ - "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE" } } + "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE", "distributionType": "PUBLIC" } } })); }) .await; @@ -576,7 +579,8 @@ mod tests { "success": true, "data": { "id": "550e8400-e29b-41d4-a716-446655440001", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } })); }) diff --git a/rust/src/platform/app/commands/add/native_extension.rs b/rust/src/platform/app/commands/add/native_extension.rs index 3f9227d2..da85a31e 100644 --- a/rust/src/platform/app/commands/add/native_extension.rs +++ b/rust/src/platform/app/commands/add/native_extension.rs @@ -355,6 +355,7 @@ mod tests { name: "my-app".to_owned(), description: None, status: platform_app_client::application::ApplicationStatus::ACTIVE, + distribution_type: platform_app_client::application::DistributionType::PUBLIC, url: None, proxy_url: None, }; @@ -374,7 +375,7 @@ mod tests { .header("authorization", "Bearer test-token") .is_true(|request| request.body_string().contains(r#""name":"my-app""#)); then.status(200).json_body(json!({ - "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE" } } + "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE", "distributionType": "PUBLIC" } } })); }) .await; @@ -388,7 +389,8 @@ mod tests { "success": true, "data": { "id": "550e8400-e29b-41d4-a716-446655440001", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } })); }) @@ -468,7 +470,7 @@ mod tests { when.method(Method::POST) .path("/v1/apps/app-registry-subgraph"); then.status(200).json_body(json!({ - "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE" } } + "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE", "distributionType": "PUBLIC" } } })); }) .await; @@ -538,7 +540,7 @@ mod tests { when.method(Method::POST) .path("/v1/apps/app-registry-subgraph"); then.status(200).json_body(json!({ - "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE" } } + "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE", "distributionType": "PUBLIC" } } })); }) .await; @@ -550,7 +552,8 @@ mod tests { "success": true, "data": { "id": "550e8400-e29b-41d4-a716-446655440001", - "status": "PENDING" + "status": "PENDING", + "distributionType": "PUBLIC" } })); }) @@ -562,7 +565,8 @@ mod tests { "success": true, "data": { "organizationId": "550e8400-e29b-41d4-a716-446655440001", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } })); }) @@ -627,7 +631,7 @@ mod tests { when.method(Method::POST) .path("/v1/apps/app-registry-subgraph"); then.status(200).json_body(json!({ - "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE" } } + "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE", "distributionType": "PUBLIC" } } })); }) .await; @@ -639,7 +643,8 @@ mod tests { "success": true, "data": { "id": "550e8400-e29b-41d4-a716-446655440001", - "status": "PENDING" + "status": "PENDING", + "distributionType": "PUBLIC" } })); }) @@ -651,7 +656,8 @@ mod tests { "success": true, "data": { "organizationId": "550e8400-e29b-41d4-a716-446655440001", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } })); }) @@ -733,7 +739,7 @@ mod tests { when.method(Method::POST) .path("/v1/apps/app-registry-subgraph"); then.status(200).json_body(json!({ - "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE" } } + "data": { "application": { "id": "app-registry-id", "label": "My App", "name": "my-app", "status": "ACTIVE", "distributionType": "PUBLIC" } } })); }) .await; @@ -745,7 +751,8 @@ mod tests { "success": true, "data": { "id": "550e8400-e29b-41d4-a716-446655440001", - "status": "ACTIVE" + "status": "ACTIVE", + "distributionType": "PUBLIC" } })); }) diff --git a/rust/src/platform/app/commands/deploy/mod.rs b/rust/src/platform/app/commands/deploy/mod.rs index 6c754c9b..44b4f7ca 100644 --- a/rust/src/platform/app/commands/deploy/mod.rs +++ b/rust/src/platform/app/commands/deploy/mod.rs @@ -496,6 +496,10 @@ mod tests { wire.get("label").is_none(), "unset fields are omitted: {wire}" ); + assert!( + wire.get("distributionType").is_none(), + "a deploy never changes who can install the application: {wire}" + ); let mut omitted = config.clone(); omitted.redirect_uris = None; diff --git a/rust/src/platform/app/commands/distribution_type.rs b/rust/src/platform/app/commands/distribution_type.rs new file mode 100644 index 00000000..b3a551dc --- /dev/null +++ b/rust/src/platform/app/commands/distribution_type.rs @@ -0,0 +1,68 @@ +//! `--distribution-type` flag shared by `gddy platform app init` and `update`. + +use platform_app_client::{create_application, update_application}; + +/// Who can discover and install an application. `CUSTOM` is a deprecated +/// registry value that is never accepted as input, so it has no variant here. +#[derive(Debug, Clone, Copy, PartialEq, Eq, clap::ValueEnum)] +pub(super) enum DistributionTypeArg { + /// Eligible for public distribution through the marketplace. + Public, + /// Visible to and installable by the owning organization only. + Private, +} + +impl From for create_application::DistributionType { + fn from(value: DistributionTypeArg) -> Self { + match value { + DistributionTypeArg::Public => Self::PUBLIC, + DistributionTypeArg::Private => Self::PRIVATE, + } + } +} + +impl From for update_application::DistributionType { + fn from(value: DistributionTypeArg) -> Self { + match value { + DistributionTypeArg::Public => Self::PUBLIC, + DistributionTypeArg::Private => Self::PRIVATE, + } + } +} + +#[cfg(test)] +mod tests { + use clap::ValueEnum; + + use super::DistributionTypeArg; + + #[test] + fn accepts_public_and_private_case_insensitively() { + assert_eq!( + DistributionTypeArg::from_str("public", true).expect("public"), + DistributionTypeArg::Public + ); + assert_eq!( + DistributionTypeArg::from_str("PRIVATE", true).expect("PRIVATE"), + DistributionTypeArg::Private + ); + } + + #[test] + fn rejects_custom_and_unknown_values() { + DistributionTypeArg::from_str("custom", true).expect_err("custom is not an input value"); + DistributionTypeArg::from_str("unlisted", true).expect_err("unknown value"); + } + + #[test] + fn maps_onto_both_generated_enums() { + assert_eq!( + super::create_application::DistributionType::from(DistributionTypeArg::Private), + super::create_application::DistributionType::PRIVATE + ); + assert_eq!( + super::update_application::DistributionType::from(DistributionTypeArg::Public), + super::update_application::DistributionType::PUBLIC + ); + } +} diff --git a/rust/src/platform/app/commands/import.rs b/rust/src/platform/app/commands/import.rs index 97acab41..e54d0e0c 100644 --- a/rust/src/platform/app/commands/import.rs +++ b/rust/src/platform/app/commands/import.rs @@ -122,6 +122,7 @@ fn import_view_columns() -> Vec { TableColumn::new("id", "ID"), TableColumn::new("name", "Name"), TableColumn::new("status", "Status"), + TableColumn::new("distributionType", "Distribution Type"), TableColumn::new("clientId", "Client ID"), TableColumn::new("url", "URL").no_truncate(true), TableColumn::new("proxyUrl", "Proxy URL").no_truncate(true), @@ -330,6 +331,7 @@ pub(super) async fn run( "id": app.id, "name": name, "status": app.status, + "distributionType": app.distribution_type, "clientId": config.client_id, "url": url, "proxyUrl": proxy_url, @@ -390,7 +392,7 @@ mod tests { ApplicationWithLatestReleaseApplicationReleases, ApplicationWithLatestReleaseApplicationReleasesEdges, ApplicationWithLatestReleaseApplicationReleasesEdgesNode, - ApplicationWithLatestReleaseApplicationReleasesEdgesNodeSubscriptions, + ApplicationWithLatestReleaseApplicationReleasesEdgesNodeSubscriptions, DistributionType, }; use serde_json::json; @@ -486,6 +488,7 @@ mod tests { name: "my-app".to_owned(), description: None, status: ApplicationStatus::ACTIVE, + distribution_type: DistributionType::PUBLIC, url: None, proxy_url: None, authorization_scopes: vec![], diff --git a/rust/src/platform/app/commands/info.rs b/rust/src/platform/app/commands/info.rs index b6231c8b..83f9d150 100644 --- a/rust/src/platform/app/commands/info.rs +++ b/rust/src/platform/app/commands/info.rs @@ -46,7 +46,7 @@ pub(super) fn command() -> RuntimeCommandSpec { ) .with_param("name", required_value(&name)), next_action( - "platform app update --id [--label