@meshery/schemas 1.3.102 → 1.3.103
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cloudApi.d.mts +4496 -4098
- package/dist/cloudApi.d.ts +4496 -4098
- package/dist/cloudApi.js +1 -1
- package/dist/cloudApi.mjs +1 -1
- package/dist/constructs/v1alpha1/core/Core.d.ts +1 -1
- package/dist/constructs/v1alpha1/core/CoreSchema.js +1 -1
- package/dist/constructs/v1alpha1/core/CoreSchema.mjs +1 -1
- package/dist/constructs/v1beta1/diagnostics/Diagnostics.d.ts +536 -0
- package/dist/constructs/v1beta1/diagnostics/Diagnostics.js +1 -0
- package/dist/constructs/v1beta1/diagnostics/Diagnostics.mjs +0 -0
- package/dist/constructs/v1beta1/diagnostics/DiagnosticsSchema.d.ts +2 -0
- package/dist/constructs/v1beta1/diagnostics/DiagnosticsSchema.js +2 -0
- package/dist/constructs/v1beta1/diagnostics/DiagnosticsSchema.mjs +2 -0
- package/dist/constructs/v1beta1/support/Support.d.ts +373 -0
- package/dist/constructs/v1beta1/support/SupportSchema.js +1 -1
- package/dist/constructs/v1beta1/support/SupportSchema.mjs +1 -1
- package/dist/constructs/v1beta2/core/Core.d.ts +26 -1
- package/dist/constructs/v1beta2/core/CoreSchema.js +1 -1
- package/dist/constructs/v1beta2/core/CoreSchema.mjs +1 -1
- package/dist/constructs/v1beta3/blowhorn_health/BlowhornHealth.d.ts +50 -0
- package/dist/constructs/v1beta3/blowhorn_health/BlowhornHealthSchema.js +1 -1
- package/dist/constructs/v1beta3/blowhorn_health/BlowhornHealthSchema.mjs +1 -1
- package/dist/constructs/v1beta3/claim/Claim.d.ts +150 -0
- package/dist/constructs/v1beta3/claim/ClaimSchema.js +2 -2
- package/dist/constructs/v1beta3/claim/ClaimSchema.mjs +2 -2
- package/dist/constructs/v1beta3/connection/Connection.d.ts +100 -0
- package/dist/constructs/v1beta3/connection/ConnectionSchema.js +3 -3
- package/dist/constructs/v1beta3/connection/ConnectionSchema.mjs +3 -3
- package/dist/constructs/v1beta3/content_item/ContentItem.d.ts +150 -0
- package/dist/constructs/v1beta3/content_item/ContentItemSchema.js +5 -5
- package/dist/constructs/v1beta3/content_item/ContentItemSchema.mjs +5 -5
- package/dist/constructs/v1beta3/design/DesignSchema.js +5 -5
- package/dist/constructs/v1beta3/design/DesignSchema.mjs +5 -5
- package/dist/constructs/v1beta3/event/Event.d.ts +275 -0
- package/dist/constructs/v1beta3/event/EventSchema.js +3 -3
- package/dist/constructs/v1beta3/event/EventSchema.mjs +3 -3
- package/dist/constructs/v1beta3/github/GithubSchema.js +1 -1
- package/dist/constructs/v1beta3/github/GithubSchema.mjs +1 -1
- package/dist/constructs/v1beta3/invitation/InvitationSchema.js +1 -1
- package/dist/constructs/v1beta3/invitation/InvitationSchema.mjs +1 -1
- package/dist/constructs/v1beta3/ledger/Ledger.d.ts +175 -0
- package/dist/constructs/v1beta3/ledger/LedgerSchema.js +5 -5
- package/dist/constructs/v1beta3/ledger/LedgerSchema.mjs +5 -5
- package/dist/constructs/v1beta3/profile/Profile.d.ts +225 -0
- package/dist/constructs/v1beta3/profile/ProfileSchema.js +1 -1
- package/dist/constructs/v1beta3/profile/ProfileSchema.mjs +1 -1
- package/dist/constructs/v1beta3/provider_capability/ProviderCapability.d.ts +50 -0
- package/dist/constructs/v1beta3/provider_capability/ProviderCapabilitySchema.js +1 -1
- package/dist/constructs/v1beta3/provider_capability/ProviderCapabilitySchema.mjs +1 -1
- package/dist/constructs/v1beta3/schedule/Schedule.d.ts +225 -0
- package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +8 -8
- package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +8 -8
- package/dist/index.d.mts +1 -1
- package/dist/index.d.ts +1 -1
- package/package.json +1 -1
|
@@ -428,6 +428,31 @@ export interface components {
|
|
|
428
428
|
"text/plain": string;
|
|
429
429
|
};
|
|
430
430
|
};
|
|
431
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
432
|
+
MeshkitError429: {
|
|
433
|
+
headers: {
|
|
434
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
435
|
+
"Retry-After": number;
|
|
436
|
+
[name: string]: unknown;
|
|
437
|
+
};
|
|
438
|
+
content: {
|
|
439
|
+
"application/json": {
|
|
440
|
+
/** @description The sentence the caller is shown. */
|
|
441
|
+
error: string;
|
|
442
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
443
|
+
code?: string;
|
|
444
|
+
/**
|
|
445
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
446
|
+
* @enum {string}
|
|
447
|
+
*/
|
|
448
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
449
|
+
/** @description MeshKit's probable causes of the error. */
|
|
450
|
+
probableCause?: string[];
|
|
451
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
452
|
+
suggestedRemediation?: string[];
|
|
453
|
+
};
|
|
454
|
+
};
|
|
455
|
+
};
|
|
431
456
|
/** @description The client's version is below the provider's minimum for that client. The client must update before it can register or keep a connection alive; the body names the minimum and where to get an update. */
|
|
432
457
|
ClientUpgradeRequired: {
|
|
433
458
|
headers: {
|
|
@@ -692,6 +717,31 @@ export interface operations {
|
|
|
692
717
|
"text/plain": string;
|
|
693
718
|
};
|
|
694
719
|
};
|
|
720
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
721
|
+
429: {
|
|
722
|
+
headers: {
|
|
723
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
724
|
+
"Retry-After": number;
|
|
725
|
+
[name: string]: unknown;
|
|
726
|
+
};
|
|
727
|
+
content: {
|
|
728
|
+
"application/json": {
|
|
729
|
+
/** @description The sentence the caller is shown. */
|
|
730
|
+
error: string;
|
|
731
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
732
|
+
code?: string;
|
|
733
|
+
/**
|
|
734
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
735
|
+
* @enum {string}
|
|
736
|
+
*/
|
|
737
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
738
|
+
/** @description MeshKit's probable causes of the error. */
|
|
739
|
+
probableCause?: string[];
|
|
740
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
741
|
+
suggestedRemediation?: string[];
|
|
742
|
+
};
|
|
743
|
+
};
|
|
744
|
+
};
|
|
695
745
|
/** @description Internal server error */
|
|
696
746
|
500: {
|
|
697
747
|
headers: {
|
|
@@ -29,7 +29,7 @@ it, which a client treats as not serving the contract.
|
|
|
29
29
|
named by \`X-Current-Orgid\`. Present only on an authenticated request
|
|
30
30
|
that carried that header.
|
|
31
31
|
`,additionalProperties:false,required:["organizationId","bound"],properties:{organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},bound:{type:"boolean",description:"True when the caller is a live member of the organization."}}},compatibility:{type:"object",description:"Whether a client application's version meets the provider's minimum for that client. A client whose `compatible` is false must update before it registers or keeps a connection alive; the provider answers those calls with 426. A client the provider has no minimum for is compatible and has no `minimumVersion`.\n",additionalProperties:false,required:["clientName","clientVersion","compatible"],properties:{clientName:{type:"string",description:`Identifier of a client application, for example the product name of a desktop app, lowercase. It is a value chosen by the client; the provider keys its minimum client versions by it.
|
|
32
|
-
`,minLength:1,maxLength:64,pattern:"^[a-z0-9][a-z0-9-]*$"},clientVersion:{type:"string",description:"The client's version as it reported it, as `MAJOR.MINOR.PATCH` with an optional leading `v`, for example `v1.25.0`. Versions are ordered by their numeric parts, so `v1.9.0` is older than `v1.25.0`.",maxLength:64},minimumVersion:{type:"string",description:"Oldest client version the provider accepts for this client. Absent when the provider sets no minimum.",maxLength:64},compatible:{type:"boolean",description:"True when `clientVersion` is at or above `minimumVersion`, or when there is no minimum."},upgradeUrl:{type:"string",description:"Where the client can get an update, when the provider knows one.",maxLength:2048}}},session:{type:"object",description:"The authenticated caller's session as the provider sees it: who the caller is, the caller's roles, and, for the organization named by `X-Current-Orgid` when the caller is a live member of it, that organization's roles, plan, entitlements and device usage. Present only on an authenticated request.\n",additionalProperties:false,required:["userId","providerRoles"],properties:{userId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},providerRoles:{type:"array",description:"The caller's provider-wide role names.",items:{type:"string",maxLength:255}},organizationRoles:{type:"array",description:"The caller's role names in the organization.",items:{type:"string",maxLength:255}},plan:{description:"The plan of the organization's active subscription, when it has one.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},entitlements:{type:"array",description:"The features the organization's active subscriptions entitle it to.",items:{"x-go-type":"featurev1beta1.Feature","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta1/feature",name:"featurev1beta1"},type:"object",additionalProperties:false,description:"A feature is a quantified entitlement granted to an organization through its subscription plan, such as the number of components allowed in a design.",required:["id","plan_id","name","quantity","created_at","updated_at"],properties:{id:{description:"Unique identifier for the feature.","x-go-name":"ID","x-oapi-codegen-extra-tags":{db:"id",csv:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan_id:{description:"Identifier of the plan granting this feature.","x-go-name":"PlanId","x-oapi-codegen-extra-tags":{db:"plan_id",csv:"plan_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan:{description:"The plan granting this feature. Populated only when the association is explicitly loaded.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},"x-oapi-codegen-extra-tags":{belongs_to:"plans",fk_id:"PlanId",json:"plan,omitempty"},"x-order":3,type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},name:{description:"Name of the entitled feature.","x-go-type":"FeatureName","x-oapi-codegen-extra-tags":{db:"name",csv:"name"},"x-order":4,type:"string","x-enum-casing-exempt":true,enum:["ComponentsInDesign","RelationshipsInDesign","DesignsInWorkspace","WorkspacesInOrganization","ImageSizeInDesign","SizePerDesign","BlowhornProfiles","BlowhornBrowserAutomation","BlowhornScheduler","BlowhornDevicesPerSeat","BlowhornPlatformLinkedIn","BlowhornPlatformX","BlowhornPlatformReddit","BlowhornPlatformHackerNews","BlowhornPlatformSlack","BlowhornPlatformBluesky","BlowhornPlatformGitHub","BlowhornPlatformBlog"],"x-enumDescriptions":{ComponentsInDesign:"Maximum number of components in a single design; 999999999999 is unlimited.",RelationshipsInDesign:"Maximum number of relationships in a single design; 999999999999 is unlimited.",DesignsInWorkspace:"Maximum number of designs in a single workspace; 999999999999 is unlimited.",WorkspacesInOrganization:"Maximum number of workspaces in an organization; 999999999999 is unlimited.",ImageSizeInDesign:"Maximum size, in bytes, of an image embedded in a design; 999999999999 is unlimited.",SizePerDesign:"Maximum size of a single design; 999999999999 is unlimited.",BlowhornProfiles:"Maximum number of Blowhorn posting profiles the organization may hold; 999999999999 is unlimited.",BlowhornBrowserAutomation:"Blowhorn may publish through browser automation; granted when quantity is greater than 0.",BlowhornScheduler:"Blowhorn may run scheduled publishes; granted when quantity is greater than 0.",BlowhornDevicesPerSeat:"Maximum number of devices one Blowhorn seat may publish from; 999999999999 is unlimited.",BlowhornPlatformLinkedIn:"Blowhorn may publish to LinkedIn; granted when quantity is greater than 0.",BlowhornPlatformX:"Blowhorn may publish to X; granted when quantity is greater than 0.",BlowhornPlatformReddit:"Blowhorn may publish to Reddit; granted when quantity is greater than 0.",BlowhornPlatformHackerNews:"Blowhorn may publish to Hacker News; granted when quantity is greater than 0.",BlowhornPlatformSlack:"Blowhorn may publish to Slack; granted when quantity is greater than 0.",BlowhornPlatformBluesky:"Blowhorn may publish to Bluesky; granted when quantity is greater than 0.",BlowhornPlatformGitHub:"Blowhorn may publish to GitHub; granted when quantity is greater than 0.",BlowhornPlatformBlog:"Blowhorn may publish to a blog; granted when quantity is greater than 0."}},quantity:{type:"number",format:"double",description:"Quantity of the feature granted by the plan. For a cap-style feature this is the maximum, and the sentinel value 999999999999 denotes unlimited. For a capability-style feature any value greater than 0 grants the capability.",minimum:0,"x-oapi-codegen-extra-tags":{db:"quantity",csv:"quantity"},"x-order":5},created_at:{"x-order":6,description:"Timestamp when the resource was created.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updated_at:{"x-order":7,description:"Timestamp when the resource was updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}},deviceUsage:{type:"object",description:"Registered devices (live `desktop` connections) in the organization against the organization's device limit. Registrations over the limit are accepted; `overLimit` flags the organization instead.\n",additionalProperties:false,required:["registered","overLimit"],properties:{registered:{type:"integer",minimum:0,description:"Live `desktop` connections registered in the organization."},limit:{type:"integer",minimum:0,description:"Devices the organization's subscriptions allow. Absent when unlimited or when no subscription sets a device limit."},overLimit:{type:"boolean",description:"True when `limit` is present and `registered` exceeds it."}}}}},extensions:{type:"object",description:"Extension points; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true},capabilities:{type:"array",description:"Features the provider serves and their endpoints. Clients read paths from here instead of hard-coding them. A provider serving desktop connections lists `register-connection`, `connection-heartbeat` and `deregister-desktop-connection`; an endpoint may hold `{connectionId}` or `{installationId}` placeholders.\n",items:{type:"object",description:"One feature the provider serves and the endpoint that serves it.",additionalProperties:false,required:["feature"],properties:{feature:{type:"string",description:"Feature name, for example `persist-connection`.",maxLength:255},endpoint:{type:"string",description:"Path that serves the feature, relative to the provider's base URL.",maxLength:1024}}}},restrictedAccess:{type:"object",description:"Access restrictions applied to this client; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},responses:{500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}},ClientUpgradeRequired:{description:`The client's version is below the provider's minimum for that client. The client must update before it can register or keep a connection alive; the body names the minimum and where to get an update.
|
|
32
|
+
`,minLength:1,maxLength:64,pattern:"^[a-z0-9][a-z0-9-]*$"},clientVersion:{type:"string",description:"The client's version as it reported it, as `MAJOR.MINOR.PATCH` with an optional leading `v`, for example `v1.25.0`. Versions are ordered by their numeric parts, so `v1.9.0` is older than `v1.25.0`.",maxLength:64},minimumVersion:{type:"string",description:"Oldest client version the provider accepts for this client. Absent when the provider sets no minimum.",maxLength:64},compatible:{type:"boolean",description:"True when `clientVersion` is at or above `minimumVersion`, or when there is no minimum."},upgradeUrl:{type:"string",description:"Where the client can get an update, when the provider knows one.",maxLength:2048}}},session:{type:"object",description:"The authenticated caller's session as the provider sees it: who the caller is, the caller's roles, and, for the organization named by `X-Current-Orgid` when the caller is a live member of it, that organization's roles, plan, entitlements and device usage. Present only on an authenticated request.\n",additionalProperties:false,required:["userId","providerRoles"],properties:{userId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},providerRoles:{type:"array",description:"The caller's provider-wide role names.",items:{type:"string",maxLength:255}},organizationRoles:{type:"array",description:"The caller's role names in the organization.",items:{type:"string",maxLength:255}},plan:{description:"The plan of the organization's active subscription, when it has one.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},entitlements:{type:"array",description:"The features the organization's active subscriptions entitle it to.",items:{"x-go-type":"featurev1beta1.Feature","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta1/feature",name:"featurev1beta1"},type:"object",additionalProperties:false,description:"A feature is a quantified entitlement granted to an organization through its subscription plan, such as the number of components allowed in a design.",required:["id","plan_id","name","quantity","created_at","updated_at"],properties:{id:{description:"Unique identifier for the feature.","x-go-name":"ID","x-oapi-codegen-extra-tags":{db:"id",csv:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan_id:{description:"Identifier of the plan granting this feature.","x-go-name":"PlanId","x-oapi-codegen-extra-tags":{db:"plan_id",csv:"plan_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan:{description:"The plan granting this feature. Populated only when the association is explicitly loaded.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},"x-oapi-codegen-extra-tags":{belongs_to:"plans",fk_id:"PlanId",json:"plan,omitempty"},"x-order":3,type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},name:{description:"Name of the entitled feature.","x-go-type":"FeatureName","x-oapi-codegen-extra-tags":{db:"name",csv:"name"},"x-order":4,type:"string","x-enum-casing-exempt":true,enum:["ComponentsInDesign","RelationshipsInDesign","DesignsInWorkspace","WorkspacesInOrganization","ImageSizeInDesign","SizePerDesign","BlowhornProfiles","BlowhornBrowserAutomation","BlowhornScheduler","BlowhornDevicesPerSeat","BlowhornPlatformLinkedIn","BlowhornPlatformX","BlowhornPlatformReddit","BlowhornPlatformHackerNews","BlowhornPlatformSlack","BlowhornPlatformBluesky","BlowhornPlatformGitHub","BlowhornPlatformBlog"],"x-enumDescriptions":{ComponentsInDesign:"Maximum number of components in a single design; 999999999999 is unlimited.",RelationshipsInDesign:"Maximum number of relationships in a single design; 999999999999 is unlimited.",DesignsInWorkspace:"Maximum number of designs in a single workspace; 999999999999 is unlimited.",WorkspacesInOrganization:"Maximum number of workspaces in an organization; 999999999999 is unlimited.",ImageSizeInDesign:"Maximum size, in bytes, of an image embedded in a design; 999999999999 is unlimited.",SizePerDesign:"Maximum size of a single design; 999999999999 is unlimited.",BlowhornProfiles:"Maximum number of Blowhorn posting profiles the organization may hold; 999999999999 is unlimited.",BlowhornBrowserAutomation:"Blowhorn may publish through browser automation; granted when quantity is greater than 0.",BlowhornScheduler:"Blowhorn may run scheduled publishes; granted when quantity is greater than 0.",BlowhornDevicesPerSeat:"Maximum number of devices one Blowhorn seat may publish from; 999999999999 is unlimited.",BlowhornPlatformLinkedIn:"Blowhorn may publish to LinkedIn; granted when quantity is greater than 0.",BlowhornPlatformX:"Blowhorn may publish to X; granted when quantity is greater than 0.",BlowhornPlatformReddit:"Blowhorn may publish to Reddit; granted when quantity is greater than 0.",BlowhornPlatformHackerNews:"Blowhorn may publish to Hacker News; granted when quantity is greater than 0.",BlowhornPlatformSlack:"Blowhorn may publish to Slack; granted when quantity is greater than 0.",BlowhornPlatformBluesky:"Blowhorn may publish to Bluesky; granted when quantity is greater than 0.",BlowhornPlatformGitHub:"Blowhorn may publish to GitHub; granted when quantity is greater than 0.",BlowhornPlatformBlog:"Blowhorn may publish to a blog; granted when quantity is greater than 0."}},quantity:{type:"number",format:"double",description:"Quantity of the feature granted by the plan. For a cap-style feature this is the maximum, and the sentinel value 999999999999 denotes unlimited. For a capability-style feature any value greater than 0 grants the capability.",minimum:0,"x-oapi-codegen-extra-tags":{db:"quantity",csv:"quantity"},"x-order":5},created_at:{"x-order":6,description:"Timestamp when the resource was created.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updated_at:{"x-order":7,description:"Timestamp when the resource was updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}},deviceUsage:{type:"object",description:"Registered devices (live `desktop` connections) in the organization against the organization's device limit. Registrations over the limit are accepted; `overLimit` flags the organization instead.\n",additionalProperties:false,required:["registered","overLimit"],properties:{registered:{type:"integer",minimum:0,description:"Live `desktop` connections registered in the organization."},limit:{type:"integer",minimum:0,description:"Devices the organization's subscriptions allow. Absent when unlimited or when no subscription sets a device limit."},overLimit:{type:"boolean",description:"True when `limit` is present and `registered` exceeds it."}}}}},extensions:{type:"object",description:"Extension points; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true},capabilities:{type:"array",description:"Features the provider serves and their endpoints. Clients read paths from here instead of hard-coding them. A provider serving desktop connections lists `register-connection`, `connection-heartbeat` and `deregister-desktop-connection`; an endpoint may hold `{connectionId}` or `{installationId}` placeholders.\n",items:{type:"object",description:"One feature the provider serves and the endpoint that serves it.",additionalProperties:false,required:["feature"],properties:{feature:{type:"string",description:"Feature name, for example `persist-connection`.",maxLength:255},endpoint:{type:"string",description:"Path that serves the feature, relative to the provider's base URL.",maxLength:1024}}}},restrictedAccess:{type:"object",description:"Access restrictions applied to this client; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},responses:{500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}},MeshkitError429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},ClientUpgradeRequired:{description:`The client's version is below the provider's minimum for that client. The client must update before it can register or keep a connection alive; the body names the minimum and where to get an update.
|
|
33
33
|
`,content:{"application/json":{schema:{type:"object",description:`Body of a 426 answer: a MeshKit error sentence plus the client's compatibility, so the client can show the minimum and where to update.
|
|
34
34
|
`,additionalProperties:false,required:["error","compatibility"],properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code allocated by the emitting service; not a stable part of this contract."},compatibility:{type:"object",description:"Whether a client application's version meets the provider's minimum for that client. A client whose `compatible` is false must update before it registers or keeps a connection alive; the provider answers those calls with 426. A client the provider has no minimum for is compatible and has no `minimumVersion`.\n",additionalProperties:false,required:["clientName","clientVersion","compatible"],properties:{clientName:{type:"string",description:`Identifier of a client application, for example the product name of a desktop app, lowercase. It is a value chosen by the client; the provider keys its minimum client versions by it.
|
|
35
35
|
`,minLength:1,maxLength:64,pattern:"^[a-z0-9][a-z0-9-]*$"},clientVersion:{type:"string",description:"The client's version as it reported it, as `MAJOR.MINOR.PATCH` with an optional leading `v`, for example `v1.25.0`. Versions are ordered by their numeric parts, so `v1.9.0` is older than `v1.25.0`.",maxLength:64},minimumVersion:{type:"string",description:"Oldest client version the provider accepts for this client. Absent when the provider sets no minimum.",maxLength:64},compatible:{type:"boolean",description:"True when `clientVersion` is at or above `minimumVersion`, or when there is no minimum."},upgradeUrl:{type:"string",description:"Where the client can get an update, when the provider knows one.",maxLength:2048}}}}}}}}},parameters:{version:{name:"version",in:"path",description:"Version of the requesting client, for example `v0.8.0`.",required:true,schema:{type:"string",maxLength:64}},client:{name:"client",in:"query",description:"Identifier of the requesting client application, for example the product name of a desktop app. When present, the document carries `compatibility` for this client at the `{version}` path parameter.\n",required:false,schema:{type:"string",description:`Identifier of a client application, for example the product name of a desktop app, lowercase. It is a value chosen by the client; the provider keys its minimum client versions by it.
|
|
@@ -29,7 +29,7 @@ it, which a client treats as not serving the contract.
|
|
|
29
29
|
named by \`X-Current-Orgid\`. Present only on an authenticated request
|
|
30
30
|
that carried that header.
|
|
31
31
|
`,additionalProperties:false,required:["organizationId","bound"],properties:{organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},bound:{type:"boolean",description:"True when the caller is a live member of the organization."}}},compatibility:{type:"object",description:"Whether a client application's version meets the provider's minimum for that client. A client whose `compatible` is false must update before it registers or keeps a connection alive; the provider answers those calls with 426. A client the provider has no minimum for is compatible and has no `minimumVersion`.\n",additionalProperties:false,required:["clientName","clientVersion","compatible"],properties:{clientName:{type:"string",description:`Identifier of a client application, for example the product name of a desktop app, lowercase. It is a value chosen by the client; the provider keys its minimum client versions by it.
|
|
32
|
-
`,minLength:1,maxLength:64,pattern:"^[a-z0-9][a-z0-9-]*$"},clientVersion:{type:"string",description:"The client's version as it reported it, as `MAJOR.MINOR.PATCH` with an optional leading `v`, for example `v1.25.0`. Versions are ordered by their numeric parts, so `v1.9.0` is older than `v1.25.0`.",maxLength:64},minimumVersion:{type:"string",description:"Oldest client version the provider accepts for this client. Absent when the provider sets no minimum.",maxLength:64},compatible:{type:"boolean",description:"True when `clientVersion` is at or above `minimumVersion`, or when there is no minimum."},upgradeUrl:{type:"string",description:"Where the client can get an update, when the provider knows one.",maxLength:2048}}},session:{type:"object",description:"The authenticated caller's session as the provider sees it: who the caller is, the caller's roles, and, for the organization named by `X-Current-Orgid` when the caller is a live member of it, that organization's roles, plan, entitlements and device usage. Present only on an authenticated request.\n",additionalProperties:false,required:["userId","providerRoles"],properties:{userId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},providerRoles:{type:"array",description:"The caller's provider-wide role names.",items:{type:"string",maxLength:255}},organizationRoles:{type:"array",description:"The caller's role names in the organization.",items:{type:"string",maxLength:255}},plan:{description:"The plan of the organization's active subscription, when it has one.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},entitlements:{type:"array",description:"The features the organization's active subscriptions entitle it to.",items:{"x-go-type":"featurev1beta1.Feature","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta1/feature",name:"featurev1beta1"},type:"object",additionalProperties:false,description:"A feature is a quantified entitlement granted to an organization through its subscription plan, such as the number of components allowed in a design.",required:["id","plan_id","name","quantity","created_at","updated_at"],properties:{id:{description:"Unique identifier for the feature.","x-go-name":"ID","x-oapi-codegen-extra-tags":{db:"id",csv:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan_id:{description:"Identifier of the plan granting this feature.","x-go-name":"PlanId","x-oapi-codegen-extra-tags":{db:"plan_id",csv:"plan_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan:{description:"The plan granting this feature. Populated only when the association is explicitly loaded.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},"x-oapi-codegen-extra-tags":{belongs_to:"plans",fk_id:"PlanId",json:"plan,omitempty"},"x-order":3,type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},name:{description:"Name of the entitled feature.","x-go-type":"FeatureName","x-oapi-codegen-extra-tags":{db:"name",csv:"name"},"x-order":4,type:"string","x-enum-casing-exempt":true,enum:["ComponentsInDesign","RelationshipsInDesign","DesignsInWorkspace","WorkspacesInOrganization","ImageSizeInDesign","SizePerDesign","BlowhornProfiles","BlowhornBrowserAutomation","BlowhornScheduler","BlowhornDevicesPerSeat","BlowhornPlatformLinkedIn","BlowhornPlatformX","BlowhornPlatformReddit","BlowhornPlatformHackerNews","BlowhornPlatformSlack","BlowhornPlatformBluesky","BlowhornPlatformGitHub","BlowhornPlatformBlog"],"x-enumDescriptions":{ComponentsInDesign:"Maximum number of components in a single design; 999999999999 is unlimited.",RelationshipsInDesign:"Maximum number of relationships in a single design; 999999999999 is unlimited.",DesignsInWorkspace:"Maximum number of designs in a single workspace; 999999999999 is unlimited.",WorkspacesInOrganization:"Maximum number of workspaces in an organization; 999999999999 is unlimited.",ImageSizeInDesign:"Maximum size, in bytes, of an image embedded in a design; 999999999999 is unlimited.",SizePerDesign:"Maximum size of a single design; 999999999999 is unlimited.",BlowhornProfiles:"Maximum number of Blowhorn posting profiles the organization may hold; 999999999999 is unlimited.",BlowhornBrowserAutomation:"Blowhorn may publish through browser automation; granted when quantity is greater than 0.",BlowhornScheduler:"Blowhorn may run scheduled publishes; granted when quantity is greater than 0.",BlowhornDevicesPerSeat:"Maximum number of devices one Blowhorn seat may publish from; 999999999999 is unlimited.",BlowhornPlatformLinkedIn:"Blowhorn may publish to LinkedIn; granted when quantity is greater than 0.",BlowhornPlatformX:"Blowhorn may publish to X; granted when quantity is greater than 0.",BlowhornPlatformReddit:"Blowhorn may publish to Reddit; granted when quantity is greater than 0.",BlowhornPlatformHackerNews:"Blowhorn may publish to Hacker News; granted when quantity is greater than 0.",BlowhornPlatformSlack:"Blowhorn may publish to Slack; granted when quantity is greater than 0.",BlowhornPlatformBluesky:"Blowhorn may publish to Bluesky; granted when quantity is greater than 0.",BlowhornPlatformGitHub:"Blowhorn may publish to GitHub; granted when quantity is greater than 0.",BlowhornPlatformBlog:"Blowhorn may publish to a blog; granted when quantity is greater than 0."}},quantity:{type:"number",format:"double",description:"Quantity of the feature granted by the plan. For a cap-style feature this is the maximum, and the sentinel value 999999999999 denotes unlimited. For a capability-style feature any value greater than 0 grants the capability.",minimum:0,"x-oapi-codegen-extra-tags":{db:"quantity",csv:"quantity"},"x-order":5},created_at:{"x-order":6,description:"Timestamp when the resource was created.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updated_at:{"x-order":7,description:"Timestamp when the resource was updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}},deviceUsage:{type:"object",description:"Registered devices (live `desktop` connections) in the organization against the organization's device limit. Registrations over the limit are accepted; `overLimit` flags the organization instead.\n",additionalProperties:false,required:["registered","overLimit"],properties:{registered:{type:"integer",minimum:0,description:"Live `desktop` connections registered in the organization."},limit:{type:"integer",minimum:0,description:"Devices the organization's subscriptions allow. Absent when unlimited or when no subscription sets a device limit."},overLimit:{type:"boolean",description:"True when `limit` is present and `registered` exceeds it."}}}}},extensions:{type:"object",description:"Extension points; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true},capabilities:{type:"array",description:"Features the provider serves and their endpoints. Clients read paths from here instead of hard-coding them. A provider serving desktop connections lists `register-connection`, `connection-heartbeat` and `deregister-desktop-connection`; an endpoint may hold `{connectionId}` or `{installationId}` placeholders.\n",items:{type:"object",description:"One feature the provider serves and the endpoint that serves it.",additionalProperties:false,required:["feature"],properties:{feature:{type:"string",description:"Feature name, for example `persist-connection`.",maxLength:255},endpoint:{type:"string",description:"Path that serves the feature, relative to the provider's base URL.",maxLength:1024}}}},restrictedAccess:{type:"object",description:"Access restrictions applied to this client; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},responses:{500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}},ClientUpgradeRequired:{description:`The client's version is below the provider's minimum for that client. The client must update before it can register or keep a connection alive; the body names the minimum and where to get an update.
|
|
32
|
+
`,minLength:1,maxLength:64,pattern:"^[a-z0-9][a-z0-9-]*$"},clientVersion:{type:"string",description:"The client's version as it reported it, as `MAJOR.MINOR.PATCH` with an optional leading `v`, for example `v1.25.0`. Versions are ordered by their numeric parts, so `v1.9.0` is older than `v1.25.0`.",maxLength:64},minimumVersion:{type:"string",description:"Oldest client version the provider accepts for this client. Absent when the provider sets no minimum.",maxLength:64},compatible:{type:"boolean",description:"True when `clientVersion` is at or above `minimumVersion`, or when there is no minimum."},upgradeUrl:{type:"string",description:"Where the client can get an update, when the provider knows one.",maxLength:2048}}},session:{type:"object",description:"The authenticated caller's session as the provider sees it: who the caller is, the caller's roles, and, for the organization named by `X-Current-Orgid` when the caller is a live member of it, that organization's roles, plan, entitlements and device usage. Present only on an authenticated request.\n",additionalProperties:false,required:["userId","providerRoles"],properties:{userId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},providerRoles:{type:"array",description:"The caller's provider-wide role names.",items:{type:"string",maxLength:255}},organizationRoles:{type:"array",description:"The caller's role names in the organization.",items:{type:"string",maxLength:255}},plan:{description:"The plan of the organization's active subscription, when it has one.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},entitlements:{type:"array",description:"The features the organization's active subscriptions entitle it to.",items:{"x-go-type":"featurev1beta1.Feature","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta1/feature",name:"featurev1beta1"},type:"object",additionalProperties:false,description:"A feature is a quantified entitlement granted to an organization through its subscription plan, such as the number of components allowed in a design.",required:["id","plan_id","name","quantity","created_at","updated_at"],properties:{id:{description:"Unique identifier for the feature.","x-go-name":"ID","x-oapi-codegen-extra-tags":{db:"id",csv:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan_id:{description:"Identifier of the plan granting this feature.","x-go-name":"PlanId","x-oapi-codegen-extra-tags":{db:"plan_id",csv:"plan_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},plan:{description:"The plan granting this feature. Populated only when the association is explicitly loaded.","x-go-type":"planv1beta3.Plan","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/plan",name:"planv1beta3"},"x-oapi-codegen-extra-tags":{belongs_to:"plans",fk_id:"PlanId",json:"plan,omitempty"},"x-order":3,type:"object",additionalProperties:false,required:["id","name","cadence","unit","pricePerUnit","minimumUnits","currency"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id",json:"id",csv:"id"}},name:{description:"Display name of the plan.","x-go-type":"PlanName","x-oapi-codegen-extra-tags":{db:"name",json:"name",csv:"name"},type:"string","x-enum-casing-exempt":true,enum:["Free","Team Designer","Team Operator","Enterprise"]},cadence:{description:"Billing cadence for the plan (monthly, annually, or none).","x-go-type":"PlanCadence","x-oapi-codegen-extra-tags":{db:"cadence",json:"cadence",csv:"cadence"},type:"string",enum:["none","monthly","annually"]},unit:{description:"Unit of consumption this plan charges against (e.g. user).","x-go-type":"PlanUnit","x-oapi-codegen-extra-tags":{db:"unit",json:"unit",csv:"unit"},type:"string",enum:["user","free"]},minimumUnits:{type:"integer",description:"Minimum number of units required for the plan.","x-oapi-codegen-extra-tags":{db:"minimum_units",json:"minimumUnits",csv:"minimum_units"},minimum:0},pricePerUnit:{type:"number",description:"Price per unit of the plan.","x-oapi-codegen-extra-tags":{db:"price_per_unit",json:"pricePerUnit",csv:"price_per_unit"},minimum:0},currency:{description:"Currency in which the plan is priced.","x-go-type":"Currency","x-oapi-codegen-extra-tags":{db:"currency",json:"currency",csv:"currency"},type:"string",enum:["usd"]}}},name:{description:"Name of the entitled feature.","x-go-type":"FeatureName","x-oapi-codegen-extra-tags":{db:"name",csv:"name"},"x-order":4,type:"string","x-enum-casing-exempt":true,enum:["ComponentsInDesign","RelationshipsInDesign","DesignsInWorkspace","WorkspacesInOrganization","ImageSizeInDesign","SizePerDesign","BlowhornProfiles","BlowhornBrowserAutomation","BlowhornScheduler","BlowhornDevicesPerSeat","BlowhornPlatformLinkedIn","BlowhornPlatformX","BlowhornPlatformReddit","BlowhornPlatformHackerNews","BlowhornPlatformSlack","BlowhornPlatformBluesky","BlowhornPlatformGitHub","BlowhornPlatformBlog"],"x-enumDescriptions":{ComponentsInDesign:"Maximum number of components in a single design; 999999999999 is unlimited.",RelationshipsInDesign:"Maximum number of relationships in a single design; 999999999999 is unlimited.",DesignsInWorkspace:"Maximum number of designs in a single workspace; 999999999999 is unlimited.",WorkspacesInOrganization:"Maximum number of workspaces in an organization; 999999999999 is unlimited.",ImageSizeInDesign:"Maximum size, in bytes, of an image embedded in a design; 999999999999 is unlimited.",SizePerDesign:"Maximum size of a single design; 999999999999 is unlimited.",BlowhornProfiles:"Maximum number of Blowhorn posting profiles the organization may hold; 999999999999 is unlimited.",BlowhornBrowserAutomation:"Blowhorn may publish through browser automation; granted when quantity is greater than 0.",BlowhornScheduler:"Blowhorn may run scheduled publishes; granted when quantity is greater than 0.",BlowhornDevicesPerSeat:"Maximum number of devices one Blowhorn seat may publish from; 999999999999 is unlimited.",BlowhornPlatformLinkedIn:"Blowhorn may publish to LinkedIn; granted when quantity is greater than 0.",BlowhornPlatformX:"Blowhorn may publish to X; granted when quantity is greater than 0.",BlowhornPlatformReddit:"Blowhorn may publish to Reddit; granted when quantity is greater than 0.",BlowhornPlatformHackerNews:"Blowhorn may publish to Hacker News; granted when quantity is greater than 0.",BlowhornPlatformSlack:"Blowhorn may publish to Slack; granted when quantity is greater than 0.",BlowhornPlatformBluesky:"Blowhorn may publish to Bluesky; granted when quantity is greater than 0.",BlowhornPlatformGitHub:"Blowhorn may publish to GitHub; granted when quantity is greater than 0.",BlowhornPlatformBlog:"Blowhorn may publish to a blog; granted when quantity is greater than 0."}},quantity:{type:"number",format:"double",description:"Quantity of the feature granted by the plan. For a cap-style feature this is the maximum, and the sentinel value 999999999999 denotes unlimited. For a capability-style feature any value greater than 0 grants the capability.",minimum:0,"x-oapi-codegen-extra-tags":{db:"quantity",csv:"quantity"},"x-order":5},created_at:{"x-order":6,description:"Timestamp when the resource was created.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updated_at:{"x-order":7,description:"Timestamp when the resource was updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}},deviceUsage:{type:"object",description:"Registered devices (live `desktop` connections) in the organization against the organization's device limit. Registrations over the limit are accepted; `overLimit` flags the organization instead.\n",additionalProperties:false,required:["registered","overLimit"],properties:{registered:{type:"integer",minimum:0,description:"Live `desktop` connections registered in the organization."},limit:{type:"integer",minimum:0,description:"Devices the organization's subscriptions allow. Absent when unlimited or when no subscription sets a device limit."},overLimit:{type:"boolean",description:"True when `limit` is present and `registered` exceeds it."}}}}},extensions:{type:"object",description:"Extension points; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true},capabilities:{type:"array",description:"Features the provider serves and their endpoints. Clients read paths from here instead of hard-coding them. A provider serving desktop connections lists `register-connection`, `connection-heartbeat` and `deregister-desktop-connection`; an endpoint may hold `{connectionId}` or `{installationId}` placeholders.\n",items:{type:"object",description:"One feature the provider serves and the endpoint that serves it.",additionalProperties:false,required:["feature"],properties:{feature:{type:"string",description:"Feature name, for example `persist-connection`.",maxLength:255},endpoint:{type:"string",description:"Path that serves the feature, relative to the provider's base URL.",maxLength:1024}}}},restrictedAccess:{type:"object",description:"Access restrictions applied to this client; shape owned by the provider.",additionalProperties:true,"x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},responses:{500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}},MeshkitError429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},ClientUpgradeRequired:{description:`The client's version is below the provider's minimum for that client. The client must update before it can register or keep a connection alive; the body names the minimum and where to get an update.
|
|
33
33
|
`,content:{"application/json":{schema:{type:"object",description:`Body of a 426 answer: a MeshKit error sentence plus the client's compatibility, so the client can show the minimum and where to update.
|
|
34
34
|
`,additionalProperties:false,required:["error","compatibility"],properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code allocated by the emitting service; not a stable part of this contract."},compatibility:{type:"object",description:"Whether a client application's version meets the provider's minimum for that client. A client whose `compatible` is false must update before it registers or keeps a connection alive; the provider answers those calls with 426. A client the provider has no minimum for is compatible and has no `minimumVersion`.\n",additionalProperties:false,required:["clientName","clientVersion","compatible"],properties:{clientName:{type:"string",description:`Identifier of a client application, for example the product name of a desktop app, lowercase. It is a value chosen by the client; the provider keys its minimum client versions by it.
|
|
35
35
|
`,minLength:1,maxLength:64,pattern:"^[a-z0-9][a-z0-9-]*$"},clientVersion:{type:"string",description:"The client's version as it reported it, as `MAJOR.MINOR.PATCH` with an optional leading `v`, for example `v1.25.0`. Versions are ordered by their numeric parts, so `v1.9.0` is older than `v1.25.0`.",maxLength:64},minimumVersion:{type:"string",description:"Oldest client version the provider accepts for this client. Absent when the provider sets no minimum.",maxLength:64},compatible:{type:"boolean",description:"True when `clientVersion` is at or above `minimumVersion`, or when there is no minimum."},upgradeUrl:{type:"string",description:"Where the client can get an update, when the provider knows one.",maxLength:2048}}}}}}}}},parameters:{version:{name:"version",in:"path",description:"Version of the requesting client, for example `v0.8.0`.",required:true,schema:{type:"string",maxLength:64}},client:{name:"client",in:"query",description:"Identifier of the requesting client application, for example the product name of a desktop app. When present, the document carries `compatibility` for this client at the `{version}` path parameter.\n",required:false,schema:{type:"string",description:`Identifier of a client application, for example the product name of a desktop app, lowercase. It is a value chosen by the client; the provider keys its minimum client versions by it.
|
|
@@ -822,6 +822,31 @@ export interface components {
|
|
|
822
822
|
"text/plain": string;
|
|
823
823
|
};
|
|
824
824
|
};
|
|
825
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
826
|
+
MeshkitError429: {
|
|
827
|
+
headers: {
|
|
828
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
829
|
+
"Retry-After": number;
|
|
830
|
+
[name: string]: unknown;
|
|
831
|
+
};
|
|
832
|
+
content: {
|
|
833
|
+
"application/json": {
|
|
834
|
+
/** @description The sentence the caller is shown. */
|
|
835
|
+
error: string;
|
|
836
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
837
|
+
code?: string;
|
|
838
|
+
/**
|
|
839
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
840
|
+
* @enum {string}
|
|
841
|
+
*/
|
|
842
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
843
|
+
/** @description MeshKit's probable causes of the error. */
|
|
844
|
+
probableCause?: string[];
|
|
845
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
846
|
+
suggestedRemediation?: string[];
|
|
847
|
+
};
|
|
848
|
+
};
|
|
849
|
+
};
|
|
825
850
|
};
|
|
826
851
|
parameters: {
|
|
827
852
|
/** @description Entity tag of the schedule as last read, from the `ETag` header of getScheduleById, createSchedule or updateSchedule. When present the write applies only if it still matches; otherwise 412. */
|
|
@@ -1152,6 +1177,31 @@ export interface operations {
|
|
|
1152
1177
|
"text/plain": string;
|
|
1153
1178
|
};
|
|
1154
1179
|
};
|
|
1180
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
1181
|
+
429: {
|
|
1182
|
+
headers: {
|
|
1183
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
1184
|
+
"Retry-After": number;
|
|
1185
|
+
[name: string]: unknown;
|
|
1186
|
+
};
|
|
1187
|
+
content: {
|
|
1188
|
+
"application/json": {
|
|
1189
|
+
/** @description The sentence the caller is shown. */
|
|
1190
|
+
error: string;
|
|
1191
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
1192
|
+
code?: string;
|
|
1193
|
+
/**
|
|
1194
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
1195
|
+
* @enum {string}
|
|
1196
|
+
*/
|
|
1197
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
1198
|
+
/** @description MeshKit's probable causes of the error. */
|
|
1199
|
+
probableCause?: string[];
|
|
1200
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
1201
|
+
suggestedRemediation?: string[];
|
|
1202
|
+
};
|
|
1203
|
+
};
|
|
1204
|
+
};
|
|
1155
1205
|
/** @description Internal server error */
|
|
1156
1206
|
500: {
|
|
1157
1207
|
headers: {
|
|
@@ -1555,6 +1605,31 @@ export interface operations {
|
|
|
1555
1605
|
"text/plain": string;
|
|
1556
1606
|
};
|
|
1557
1607
|
};
|
|
1608
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
1609
|
+
429: {
|
|
1610
|
+
headers: {
|
|
1611
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
1612
|
+
"Retry-After": number;
|
|
1613
|
+
[name: string]: unknown;
|
|
1614
|
+
};
|
|
1615
|
+
content: {
|
|
1616
|
+
"application/json": {
|
|
1617
|
+
/** @description The sentence the caller is shown. */
|
|
1618
|
+
error: string;
|
|
1619
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
1620
|
+
code?: string;
|
|
1621
|
+
/**
|
|
1622
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
1623
|
+
* @enum {string}
|
|
1624
|
+
*/
|
|
1625
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
1626
|
+
/** @description MeshKit's probable causes of the error. */
|
|
1627
|
+
probableCause?: string[];
|
|
1628
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
1629
|
+
suggestedRemediation?: string[];
|
|
1630
|
+
};
|
|
1631
|
+
};
|
|
1632
|
+
};
|
|
1558
1633
|
/** @description Internal server error */
|
|
1559
1634
|
500: {
|
|
1560
1635
|
headers: {
|
|
@@ -1840,6 +1915,31 @@ export interface operations {
|
|
|
1840
1915
|
"text/plain": string;
|
|
1841
1916
|
};
|
|
1842
1917
|
};
|
|
1918
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
1919
|
+
429: {
|
|
1920
|
+
headers: {
|
|
1921
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
1922
|
+
"Retry-After": number;
|
|
1923
|
+
[name: string]: unknown;
|
|
1924
|
+
};
|
|
1925
|
+
content: {
|
|
1926
|
+
"application/json": {
|
|
1927
|
+
/** @description The sentence the caller is shown. */
|
|
1928
|
+
error: string;
|
|
1929
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
1930
|
+
code?: string;
|
|
1931
|
+
/**
|
|
1932
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
1933
|
+
* @enum {string}
|
|
1934
|
+
*/
|
|
1935
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
1936
|
+
/** @description MeshKit's probable causes of the error. */
|
|
1937
|
+
probableCause?: string[];
|
|
1938
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
1939
|
+
suggestedRemediation?: string[];
|
|
1940
|
+
};
|
|
1941
|
+
};
|
|
1942
|
+
};
|
|
1843
1943
|
/** @description Internal server error */
|
|
1844
1944
|
500: {
|
|
1845
1945
|
headers: {
|
|
@@ -2256,6 +2356,31 @@ export interface operations {
|
|
|
2256
2356
|
};
|
|
2257
2357
|
content?: never;
|
|
2258
2358
|
};
|
|
2359
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
2360
|
+
429: {
|
|
2361
|
+
headers: {
|
|
2362
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
2363
|
+
"Retry-After": number;
|
|
2364
|
+
[name: string]: unknown;
|
|
2365
|
+
};
|
|
2366
|
+
content: {
|
|
2367
|
+
"application/json": {
|
|
2368
|
+
/** @description The sentence the caller is shown. */
|
|
2369
|
+
error: string;
|
|
2370
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
2371
|
+
code?: string;
|
|
2372
|
+
/**
|
|
2373
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
2374
|
+
* @enum {string}
|
|
2375
|
+
*/
|
|
2376
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
2377
|
+
/** @description MeshKit's probable causes of the error. */
|
|
2378
|
+
probableCause?: string[];
|
|
2379
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
2380
|
+
suggestedRemediation?: string[];
|
|
2381
|
+
};
|
|
2382
|
+
};
|
|
2383
|
+
};
|
|
2259
2384
|
/** @description Internal server error */
|
|
2260
2385
|
500: {
|
|
2261
2386
|
headers: {
|
|
@@ -2304,6 +2429,31 @@ export interface operations {
|
|
|
2304
2429
|
"text/plain": string;
|
|
2305
2430
|
};
|
|
2306
2431
|
};
|
|
2432
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
2433
|
+
429: {
|
|
2434
|
+
headers: {
|
|
2435
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
2436
|
+
"Retry-After": number;
|
|
2437
|
+
[name: string]: unknown;
|
|
2438
|
+
};
|
|
2439
|
+
content: {
|
|
2440
|
+
"application/json": {
|
|
2441
|
+
/** @description The sentence the caller is shown. */
|
|
2442
|
+
error: string;
|
|
2443
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
2444
|
+
code?: string;
|
|
2445
|
+
/**
|
|
2446
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
2447
|
+
* @enum {string}
|
|
2448
|
+
*/
|
|
2449
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
2450
|
+
/** @description MeshKit's probable causes of the error. */
|
|
2451
|
+
probableCause?: string[];
|
|
2452
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
2453
|
+
suggestedRemediation?: string[];
|
|
2454
|
+
};
|
|
2455
|
+
};
|
|
2456
|
+
};
|
|
2307
2457
|
/** @description Internal server error */
|
|
2308
2458
|
500: {
|
|
2309
2459
|
headers: {
|
|
@@ -2616,6 +2766,31 @@ export interface operations {
|
|
|
2616
2766
|
"text/plain": string;
|
|
2617
2767
|
};
|
|
2618
2768
|
};
|
|
2769
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
2770
|
+
429: {
|
|
2771
|
+
headers: {
|
|
2772
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
2773
|
+
"Retry-After": number;
|
|
2774
|
+
[name: string]: unknown;
|
|
2775
|
+
};
|
|
2776
|
+
content: {
|
|
2777
|
+
"application/json": {
|
|
2778
|
+
/** @description The sentence the caller is shown. */
|
|
2779
|
+
error: string;
|
|
2780
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
2781
|
+
code?: string;
|
|
2782
|
+
/**
|
|
2783
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
2784
|
+
* @enum {string}
|
|
2785
|
+
*/
|
|
2786
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
2787
|
+
/** @description MeshKit's probable causes of the error. */
|
|
2788
|
+
probableCause?: string[];
|
|
2789
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
2790
|
+
suggestedRemediation?: string[];
|
|
2791
|
+
};
|
|
2792
|
+
};
|
|
2793
|
+
};
|
|
2619
2794
|
/** @description Internal server error */
|
|
2620
2795
|
500: {
|
|
2621
2796
|
headers: {
|
|
@@ -2910,6 +3085,31 @@ export interface operations {
|
|
|
2910
3085
|
"text/plain": string;
|
|
2911
3086
|
};
|
|
2912
3087
|
};
|
|
3088
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
3089
|
+
429: {
|
|
3090
|
+
headers: {
|
|
3091
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
3092
|
+
"Retry-After": number;
|
|
3093
|
+
[name: string]: unknown;
|
|
3094
|
+
};
|
|
3095
|
+
content: {
|
|
3096
|
+
"application/json": {
|
|
3097
|
+
/** @description The sentence the caller is shown. */
|
|
3098
|
+
error: string;
|
|
3099
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
3100
|
+
code?: string;
|
|
3101
|
+
/**
|
|
3102
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
3103
|
+
* @enum {string}
|
|
3104
|
+
*/
|
|
3105
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
3106
|
+
/** @description MeshKit's probable causes of the error. */
|
|
3107
|
+
probableCause?: string[];
|
|
3108
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
3109
|
+
suggestedRemediation?: string[];
|
|
3110
|
+
};
|
|
3111
|
+
};
|
|
3112
|
+
};
|
|
2913
3113
|
/** @description Internal server error */
|
|
2914
3114
|
500: {
|
|
2915
3115
|
headers: {
|
|
@@ -2960,6 +3160,31 @@ export interface operations {
|
|
|
2960
3160
|
"text/plain": string;
|
|
2961
3161
|
};
|
|
2962
3162
|
};
|
|
3163
|
+
/** @description Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying. */
|
|
3164
|
+
429: {
|
|
3165
|
+
headers: {
|
|
3166
|
+
/** @description Number of seconds the caller must wait before retrying. */
|
|
3167
|
+
"Retry-After": number;
|
|
3168
|
+
[name: string]: unknown;
|
|
3169
|
+
};
|
|
3170
|
+
content: {
|
|
3171
|
+
"application/json": {
|
|
3172
|
+
/** @description The sentence the caller is shown. */
|
|
3173
|
+
error: string;
|
|
3174
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
3175
|
+
code?: string;
|
|
3176
|
+
/**
|
|
3177
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
3178
|
+
* @enum {string}
|
|
3179
|
+
*/
|
|
3180
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
3181
|
+
/** @description MeshKit's probable causes of the error. */
|
|
3182
|
+
probableCause?: string[];
|
|
3183
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
3184
|
+
suggestedRemediation?: string[];
|
|
3185
|
+
};
|
|
3186
|
+
};
|
|
3187
|
+
};
|
|
2963
3188
|
/** @description Internal server error */
|
|
2964
3189
|
500: {
|
|
2965
3190
|
headers: {
|