@meshery/schemas 1.3.107 → 1.3.109
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 +8651 -4670
- package/dist/cloudApi.d.ts +8651 -4670
- package/dist/cloudApi.js +1 -1
- package/dist/cloudApi.mjs +1 -1
- package/dist/constructs/v1beta3/academy/Academy.d.ts +9 -3
- package/dist/constructs/v1beta3/academy/AcademySchema.js +2 -2
- package/dist/constructs/v1beta3/academy/AcademySchema.mjs +2 -2
- package/dist/constructs/v1beta3/content_item/ContentItem.d.ts +682 -33
- package/dist/constructs/v1beta3/content_item/ContentItemSchema.js +215 -22
- package/dist/constructs/v1beta3/content_item/ContentItemSchema.mjs +215 -22
- package/dist/constructs/v1beta3/invitation/Invitation.d.ts +30 -10
- package/dist/constructs/v1beta3/invitation/InvitationSchema.js +1 -1
- package/dist/constructs/v1beta3/invitation/InvitationSchema.mjs +1 -1
- package/dist/constructs/v1beta3/media_asset/MediaAsset.d.ts +2322 -0
- package/dist/constructs/v1beta3/media_asset/MediaAssetSchema.d.ts +2 -0
- package/dist/constructs/v1beta3/media_asset/MediaAssetSchema.js +61 -0
- package/dist/constructs/v1beta3/media_asset/MediaAssetSchema.mjs +61 -0
- package/dist/constructs/v1beta3/mention_alias/MentionAlias.d.ts +678 -0
- package/dist/constructs/v1beta3/mention_alias/MentionAlias.js +1 -0
- package/dist/constructs/v1beta3/mention_alias/MentionAlias.mjs +0 -0
- package/dist/constructs/v1beta3/mention_alias/MentionAliasSchema.d.ts +2 -0
- package/dist/constructs/v1beta3/mention_alias/MentionAliasSchema.js +75 -0
- package/dist/constructs/v1beta3/mention_alias/MentionAliasSchema.mjs +75 -0
- package/dist/constructs/v1beta3/{risk_profile/RiskProfile.d.ts → posture/Posture.d.ts} +7 -7
- package/dist/constructs/v1beta3/posture/Posture.js +1 -0
- package/dist/constructs/v1beta3/posture/Posture.mjs +0 -0
- package/dist/constructs/v1beta3/posture/PostureSchema.d.ts +2 -0
- package/dist/constructs/v1beta3/posture/PostureSchema.js +22 -0
- package/dist/constructs/v1beta3/posture/PostureSchema.mjs +22 -0
- package/dist/constructs/v1beta3/schedule/Schedule.d.ts +41 -41
- package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +23 -23
- package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +23 -23
- package/dist/index.d.mts +23 -1
- package/dist/index.d.ts +23 -1
- package/dist/index.js +2 -2
- package/dist/index.mjs +2 -2
- package/package.json +1 -1
- package/dist/constructs/v1beta3/risk_profile/RiskProfileSchema.d.ts +0 -2
- package/dist/constructs/v1beta3/risk_profile/RiskProfileSchema.js +0 -22
- package/dist/constructs/v1beta3/risk_profile/RiskProfileSchema.mjs +0 -22
- /package/dist/constructs/v1beta3/{risk_profile/RiskProfile.js → media_asset/MediaAsset.js} +0 -0
- /package/dist/constructs/v1beta3/{risk_profile/RiskProfile.mjs → media_asset/MediaAsset.mjs} +0 -0
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
var e={openapi:"3.0.0",info:{title:"ContentItem",description:`OpenAPI schema for content items - fingerprinted content
|
|
2
2
|
values keyed by organization and row number, with conditional
|
|
3
3
|
updates.
|
|
4
|
+
A content item may carry its own rules of engagement
|
|
5
|
+
(\`rulesOfEngagement\`), which can only tighten the rules its profile and
|
|
6
|
+
platform run under, and may belong to a thread (\`threadId\`,
|
|
7
|
+
\`replyToId\`, \`threadIndex\`): the parts of a split post, or the replies
|
|
8
|
+
of a conversation between profiles.
|
|
4
9
|
Organization scope: every operation acts only in the organization the
|
|
5
10
|
session resolved to (X-Current-Orgid, then the user's selected
|
|
6
11
|
organization), and only when the caller is a live member of it.
|
|
@@ -12,12 +17,58 @@ Delete Content Item for the writes); a caller without it receives a
|
|
|
12
17
|
a live content item of the organization, and a caller who is not a
|
|
13
18
|
live member of it, receive the same 404, so the existence of another
|
|
14
19
|
organization's rows is never disclosed.
|
|
15
|
-
`,version:"v1beta3",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"contentItems",description:"Operations related to content items."}],paths:{"/api/content-items":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"List content items",operationId:"listContentItems",description:"Returns a paginated list of the live content items in the\norganization of the authenticated session, ordered by `rowNumber`\nunless `order` names another column (`rowNumber`, `createdAt`,\n`updatedAt`). `search` matches the profile or the content values,\ncase-insensitively.\n",parameters:[{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}},{name:"profile",in:"query",required:false,description:"Filter by owning profile subject (exact match).",schema:{type:"string"}}],responses:{200:{description:"Content item page",content:{"application/json":{schema:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
20
|
+
`,version:"v1beta3",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"contentItems",description:"Operations related to content items."}],paths:{"/api/content-items":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"List content items",operationId:"listContentItems",description:"Returns a paginated list of the live content items in the\norganization of the authenticated session, ordered by `rowNumber`\nunless `order` names another column (`rowNumber`, `createdAt`,\n`updatedAt`). `search` matches the profile or the content values,\ncase-insensitively. `threadId` returns one whole thread: the root\nitem it names and every live item whose `threadId` names it,\nordered by `threadIndex` (the root first) unless `order` names\nanother column.\n",parameters:[{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}},{name:"profile",in:"query",required:false,description:"Filter by owning profile subject (exact match).",schema:{type:"string"}},{name:"threadId",in:"query",required:false,description:"Return one thread: the root item this ID names and every live item\nwhose `threadId` names it.\n",schema:{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"}}}],responses:{200:{description:"Content item page",content:{"application/json":{schema:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
16
21
|
Content items carry a row number and a server-computed fingerprint over
|
|
17
22
|
their canonical values; updates are conditional on the fingerprint the
|
|
18
23
|
writer read, so stale writes are refused rather than silently applied.
|
|
19
|
-
|
|
20
|
-
|
|
24
|
+
An item may carry its own rules of engagement, which can only tighten,
|
|
25
|
+
and may belong to a thread through \`threadId\`, \`replyToId\` and
|
|
26
|
+
\`threadIndex\`. See docs/content-item-contract.md.
|
|
27
|
+
`,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],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"},"x-order":1},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"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","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,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{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-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
|
|
28
|
+
`,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
29
|
+
least as cautious as the preset its profile and platform
|
|
30
|
+
resolve to.
|
|
31
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
32
|
+
changed; present, the item's rules read as adjusted.
|
|
33
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
|
|
34
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
|
|
35
|
+
`,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}},description:"Content items included on this page of results."}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",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"}}}}}},post:{"x-internal":["cloud"],tags:["contentItems"],summary:"Insert a content item",operationId:"insertContentItem",description:`Inserts a new content item. Insert-only: any supplied
|
|
36
|
+
\`id\` and \`expectedFingerprint\` are ignored; existing rows change
|
|
37
|
+
only through the conditional \`updateContentItem\`. The
|
|
38
|
+
\`fingerprint\` is server-computed. Row numbers are unique across
|
|
39
|
+
the live content items of the organization, whatever their
|
|
40
|
+
\`profile\`. When \`rowNumber\` is omitted the server assigns the next
|
|
41
|
+
row number of the organization (one more than the highest row
|
|
42
|
+
number the organization has used, counting soft-deleted content
|
|
43
|
+
items so a deleted item's number is not handed out again by
|
|
44
|
+
assignment), atomically with the insert, so
|
|
45
|
+
concurrent inserts never receive the same number. An organization
|
|
46
|
+
that has never had a content item is assigned row number 1 first
|
|
47
|
+
(an explicit \`rowNumber\` of 0 is still accepted). A supplied
|
|
48
|
+
\`rowNumber\` that another live content item of the organization
|
|
49
|
+
already holds refuses the insert with a 409.
|
|
50
|
+
A \`rulesOfEngagement\` outside its schema (an unknown preset or
|
|
51
|
+
dial, or a value out of range) is refused with a 400, on insert
|
|
52
|
+
and on update alike.
|
|
53
|
+
Each \`mediaAssetIds\` entry must name a media asset of the session
|
|
54
|
+
organization, else 400 (the same 400 for a missing, another
|
|
55
|
+
organization's and a deleted asset), on insert and on update alike.
|
|
56
|
+
The server does not require the asset to be ready at write time:
|
|
57
|
+
deleting an asset does not check content item references, and such
|
|
58
|
+
an item is refused by name when it posts, so the posting client
|
|
59
|
+
checks readiness.
|
|
60
|
+
Thread fields are checked against the organization's live content
|
|
61
|
+
items in the same transaction as the insert, and a violation is
|
|
62
|
+
refused with a 400: \`threadId\` must name a live item of the
|
|
63
|
+
organization that is not itself part of a thread; \`replyToId\`
|
|
64
|
+
requires \`threadId\` and must name that root or a live item of the
|
|
65
|
+
same thread; \`threadIndex\` is required exactly when \`threadId\` is
|
|
66
|
+
given and must exceed the position of the item \`replyToId\` names
|
|
67
|
+
(the root counts as 0). An item of another organization, a deleted
|
|
68
|
+
item and a missing one receive the same 400. A \`threadIndex\` that
|
|
69
|
+
another live item of the same thread already holds refuses the
|
|
70
|
+
insert with a 409.
|
|
71
|
+
`,requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],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":{json:"id,omitempty"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
|
|
21
72
|
items of the organization. Optional: omitted on insert, the
|
|
22
73
|
server assigns the next row number of the organization; omitted
|
|
23
74
|
on update, the stored row number is kept.
|
|
@@ -25,17 +76,63 @@ on update, the stored row number is kept.
|
|
|
25
76
|
the update applies only when the stored fingerprint still
|
|
26
77
|
matches, and is refused with a 409 otherwise. Ignored on
|
|
27
78
|
insert.
|
|
28
|
-
`,maxLength:255}
|
|
79
|
+
`,maxLength:255},rulesOfEngagement:{allOf:[{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
|
|
80
|
+
optionally, dials changed for this item only. Every value can only
|
|
81
|
+
tighten. The client that runs the item resolves the effective rules
|
|
82
|
+
as the stricter of these and the rules that apply to its profile and
|
|
83
|
+
platform without them (the more cautious preset wins, and each dial
|
|
84
|
+
applies only where it is stricter than the resolved preset's own);
|
|
85
|
+
the warm-up and the pause after a sign-in challenge always apply.
|
|
86
|
+
The server validates the shape and stores the value as given; it
|
|
87
|
+
never resolves or loosens it.
|
|
88
|
+
`,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
89
|
+
least as cautious as the preset its profile and platform
|
|
90
|
+
resolve to.
|
|
91
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
92
|
+
changed; present, the item's rules read as adjusted.
|
|
93
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}}],description:`The item's own rules of engagement, which can only tighten the
|
|
94
|
+
rules its profile and platform run under. Omitted on insert, the
|
|
95
|
+
item has none; omitted on update, the stored rules are kept;
|
|
96
|
+
\`null\` on update clears them.
|
|
97
|
+
`,nullable:true,"x-oapi-codegen-extra-tags":{json:"rulesOfEngagement,omitempty"}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the thread's root item. Read on insert; on update it must
|
|
98
|
+
be omitted or equal the stored value.
|
|
99
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{json:"threadId,omitempty"}},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the root named by\n`threadId` or an item of the same thread. Requires `threadId`.\nRead on insert; on update it must be omitted or equal the stored\nvalue.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{json:"replyToId,omitempty"}},threadIndex:{type:"integer",description:`Position of the item in its thread, the root counting as 0.
|
|
100
|
+
Required exactly when \`threadId\` is given. Read on insert; on
|
|
101
|
+
update it must be omitted or equal the stored value.
|
|
102
|
+
`,minimum:1},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Omitted on
|
|
103
|
+
insert means none; omitted on update keeps the stored list (old
|
|
104
|
+
clients send the whole item without it); an empty array clears it.
|
|
105
|
+
`,"x-oapi-codegen-extra-tags":{json:"mediaAssetIds,omitempty"}}}}}}},responses:{201:{description:"Content item created",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
29
106
|
Content items carry a row number and a server-computed fingerprint over
|
|
30
107
|
their canonical values; updates are conditional on the fingerprint the
|
|
31
108
|
writer read, so stale writes are refused rather than silently applied.
|
|
32
|
-
|
|
33
|
-
|
|
109
|
+
An item may carry its own rules of engagement, which can only tighten,
|
|
110
|
+
and may belong to a thread through \`threadId\`, \`replyToId\` and
|
|
111
|
+
\`threadIndex\`. See docs/content-item-contract.md.
|
|
112
|
+
`,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],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"},"x-order":1},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"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","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,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{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-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
|
|
113
|
+
`,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
114
|
+
least as cautious as the preset its profile and platform
|
|
115
|
+
resolve to.
|
|
116
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
117
|
+
changed; present, the item's rules read as adjusted.
|
|
118
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
|
|
119
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
|
|
120
|
+
`,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",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"}}}}}}},"/api/content-items/{contentItemId}":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"Get a content item by ID",operationId:"getContentItem",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{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"}}}],responses:{200:{description:"Content item response",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
34
121
|
Content items carry a row number and a server-computed fingerprint over
|
|
35
122
|
their canonical values; updates are conditional on the fingerprint the
|
|
36
123
|
writer read, so stale writes are refused rather than silently applied.
|
|
37
|
-
|
|
38
|
-
|
|
124
|
+
An item may carry its own rules of engagement, which can only tighten,
|
|
125
|
+
and may belong to a thread through \`threadId\`, \`replyToId\` and
|
|
126
|
+
\`threadIndex\`. See docs/content-item-contract.md.
|
|
127
|
+
`,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],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"},"x-order":1},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"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","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,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{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-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
|
|
128
|
+
`,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
129
|
+
least as cautious as the preset its profile and platform
|
|
130
|
+
resolve to.
|
|
131
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
132
|
+
changed; present, the item's rules read as adjusted.
|
|
133
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
|
|
134
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
|
|
135
|
+
`,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",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"}}}}}},put:{"x-internal":["cloud"],tags:["contentItems"],summary:"Update a content item",operationId:"updateContentItem",description:"Conditionally updates the content item. When\n`expectedFingerprint` is supplied and stale, the update is\nrefused with a 409, as is an update that would move the item\nonto a `rowNumber` another live content item of the organization\nholds. An omitted `rowNumber` keeps the stored one.\nAn omitted `rulesOfEngagement` keeps the stored rules and `null`\nclears them, so a writer that does not know the field never erases\nit. An omitted `mediaAssetIds` keeps the stored list and `[]`\nclears it. The thread fields are fixed at insert: omitted, or equal to the\nstored values, they are kept; any other value is refused with a 400.\n",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{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"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],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":{json:"id,omitempty"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
|
|
39
136
|
items of the organization. Optional: omitted on insert, the
|
|
40
137
|
server assigns the next row number of the organization; omitted
|
|
41
138
|
on update, the stored row number is kept.
|
|
@@ -43,25 +140,67 @@ on update, the stored row number is kept.
|
|
|
43
140
|
the update applies only when the stored fingerprint still
|
|
44
141
|
matches, and is refused with a 409 otherwise. Ignored on
|
|
45
142
|
insert.
|
|
46
|
-
`,maxLength:255}
|
|
143
|
+
`,maxLength:255},rulesOfEngagement:{allOf:[{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
|
|
144
|
+
optionally, dials changed for this item only. Every value can only
|
|
145
|
+
tighten. The client that runs the item resolves the effective rules
|
|
146
|
+
as the stricter of these and the rules that apply to its profile and
|
|
147
|
+
platform without them (the more cautious preset wins, and each dial
|
|
148
|
+
applies only where it is stricter than the resolved preset's own);
|
|
149
|
+
the warm-up and the pause after a sign-in challenge always apply.
|
|
150
|
+
The server validates the shape and stores the value as given; it
|
|
151
|
+
never resolves or loosens it.
|
|
152
|
+
`,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
153
|
+
least as cautious as the preset its profile and platform
|
|
154
|
+
resolve to.
|
|
155
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
156
|
+
changed; present, the item's rules read as adjusted.
|
|
157
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}}],description:`The item's own rules of engagement, which can only tighten the
|
|
158
|
+
rules its profile and platform run under. Omitted on insert, the
|
|
159
|
+
item has none; omitted on update, the stored rules are kept;
|
|
160
|
+
\`null\` on update clears them.
|
|
161
|
+
`,nullable:true,"x-oapi-codegen-extra-tags":{json:"rulesOfEngagement,omitempty"}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the thread's root item. Read on insert; on update it must
|
|
162
|
+
be omitted or equal the stored value.
|
|
163
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{json:"threadId,omitempty"}},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the root named by\n`threadId` or an item of the same thread. Requires `threadId`.\nRead on insert; on update it must be omitted or equal the stored\nvalue.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{json:"replyToId,omitempty"}},threadIndex:{type:"integer",description:`Position of the item in its thread, the root counting as 0.
|
|
164
|
+
Required exactly when \`threadId\` is given. Read on insert; on
|
|
165
|
+
update it must be omitted or equal the stored value.
|
|
166
|
+
`,minimum:1},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Omitted on
|
|
167
|
+
insert means none; omitted on update keeps the stored list (old
|
|
168
|
+
clients send the whole item without it); an empty array clears it.
|
|
169
|
+
`,"x-oapi-codegen-extra-tags":{json:"mediaAssetIds,omitempty"}}}}}}},responses:{200:{description:"Content item updated",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
47
170
|
Content items carry a row number and a server-computed fingerprint over
|
|
48
171
|
their canonical values; updates are conditional on the fingerprint the
|
|
49
172
|
writer read, so stale writes are refused rather than silently applied.
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
173
|
+
An item may carry its own rules of engagement, which can only tighten,
|
|
174
|
+
and may belong to a thread through \`threadId\`, \`replyToId\` and
|
|
175
|
+
\`threadIndex\`. See docs/content-item-contract.md.
|
|
176
|
+
`,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],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"},"x-order":1},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"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","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,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{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-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
|
|
177
|
+
`,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
178
|
+
least as cautious as the preset its profile and platform
|
|
179
|
+
resolve to.
|
|
180
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
181
|
+
changed; present, the item's rules read as adjusted.
|
|
182
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
|
|
183
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
|
|
184
|
+
`,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",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"}}}}}},delete:{"x-internal":["cloud"],tags:["contentItems"],summary:"Delete a content item",operationId:"deleteContentItem",description:"Soft-deletes the content item. When `expectedFingerprint` is\nsupplied, the delete applies only when the stored fingerprint\nstill matches and is refused with a 409 otherwise; without it the\ndelete is unconditional. Deleting an item that other items name in\n`threadId` or `replyToId` leaves their references as they are.\n",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{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"}}},{name:"expectedFingerprint",in:"query",description:`Optional optimistic-concurrency precondition for delete: the
|
|
56
185
|
delete applies only when the stored fingerprint still matches.
|
|
57
|
-
`,required:false,schema:{type:"string",maxLength:255}}],responses:{204:{description:"Content item deleted"},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint,
|
|
186
|
+
`,required:false,schema:{type:"string",maxLength:255}}],responses:{204:{description:"Content item deleted"},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",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 [REDACTED]",bearerFormat:"JWT"}},responses:{400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",content:{"text/plain":{schema:{type:"string"}}}},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"}}}}}}}},parameters:{expectedFingerprint:{name:"expectedFingerprint",in:"query",description:`Optional optimistic-concurrency precondition for delete: the
|
|
58
187
|
delete applies only when the stored fingerprint still matches.
|
|
59
|
-
`,required:false,schema:{type:"string",maxLength:255}},contentItemId:{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{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"}}},page:{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},pageSize:{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},pagesize:{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},search:{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},order:{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}}},schemas:{ContentItem:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
188
|
+
`,required:false,schema:{type:"string",maxLength:255}},threadId:{name:"threadId",in:"query",required:false,description:"Return one thread: the root item this ID names and every live item\nwhose `threadId` names it.\n",schema:{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"}}},contentItemId:{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{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"}}},page:{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},pageSize:{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},pagesize:{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},search:{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},order:{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}}},schemas:{ContentItem:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
60
189
|
Content items carry a row number and a server-computed fingerprint over
|
|
61
190
|
their canonical values; updates are conditional on the fingerprint the
|
|
62
191
|
writer read, so stale writes are refused rather than silently applied.
|
|
63
|
-
|
|
64
|
-
|
|
192
|
+
An item may carry its own rules of engagement, which can only tighten,
|
|
193
|
+
and may belong to a thread through \`threadId\`, \`replyToId\` and
|
|
194
|
+
\`threadIndex\`. See docs/content-item-contract.md.
|
|
195
|
+
`,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],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"},"x-order":1},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"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","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,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{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-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
|
|
196
|
+
`,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
197
|
+
least as cautious as the preset its profile and platform
|
|
198
|
+
resolve to.
|
|
199
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
200
|
+
changed; present, the item's rules read as adjusted.
|
|
201
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
|
|
202
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
|
|
203
|
+
`,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}},ContentItemPayload:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],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":{json:"id,omitempty"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
|
|
65
204
|
items of the organization. Optional: omitted on insert, the
|
|
66
205
|
server assigns the next row number of the organization; omitted
|
|
67
206
|
on update, the stored row number is kept.
|
|
@@ -69,9 +208,63 @@ on update, the stored row number is kept.
|
|
|
69
208
|
the update applies only when the stored fingerprint still
|
|
70
209
|
matches, and is refused with a 409 otherwise. Ignored on
|
|
71
210
|
insert.
|
|
72
|
-
`,maxLength:255}
|
|
211
|
+
`,maxLength:255},rulesOfEngagement:{allOf:[{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
|
|
212
|
+
optionally, dials changed for this item only. Every value can only
|
|
213
|
+
tighten. The client that runs the item resolves the effective rules
|
|
214
|
+
as the stricter of these and the rules that apply to its profile and
|
|
215
|
+
platform without them (the more cautious preset wins, and each dial
|
|
216
|
+
applies only where it is stricter than the resolved preset's own);
|
|
217
|
+
the warm-up and the pause after a sign-in challenge always apply.
|
|
218
|
+
The server validates the shape and stores the value as given; it
|
|
219
|
+
never resolves or loosens it.
|
|
220
|
+
`,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
221
|
+
least as cautious as the preset its profile and platform
|
|
222
|
+
resolve to.
|
|
223
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
224
|
+
changed; present, the item's rules read as adjusted.
|
|
225
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}}],description:`The item's own rules of engagement, which can only tighten the
|
|
226
|
+
rules its profile and platform run under. Omitted on insert, the
|
|
227
|
+
item has none; omitted on update, the stored rules are kept;
|
|
228
|
+
\`null\` on update clears them.
|
|
229
|
+
`,nullable:true,"x-oapi-codegen-extra-tags":{json:"rulesOfEngagement,omitempty"}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the thread's root item. Read on insert; on update it must
|
|
230
|
+
be omitted or equal the stored value.
|
|
231
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{json:"threadId,omitempty"}},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the root named by\n`threadId` or an item of the same thread. Requires `threadId`.\nRead on insert; on update it must be omitted or equal the stored\nvalue.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{json:"replyToId,omitempty"}},threadIndex:{type:"integer",description:`Position of the item in its thread, the root counting as 0.
|
|
232
|
+
Required exactly when \`threadId\` is given. Read on insert; on
|
|
233
|
+
update it must be omitted or equal the stored value.
|
|
234
|
+
`,minimum:1},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Omitted on
|
|
235
|
+
insert means none; omitted on update keeps the stored list (old
|
|
236
|
+
clients send the whole item without it); an empty array clears it.
|
|
237
|
+
`,"x-oapi-codegen-extra-tags":{json:"mediaAssetIds,omitempty"}}}},ContentItemRulesOfEngagement:{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
|
|
238
|
+
optionally, dials changed for this item only. Every value can only
|
|
239
|
+
tighten. The client that runs the item resolves the effective rules
|
|
240
|
+
as the stricter of these and the rules that apply to its profile and
|
|
241
|
+
platform without them (the more cautious preset wins, and each dial
|
|
242
|
+
applies only where it is stricter than the resolved preset's own);
|
|
243
|
+
the warm-up and the pause after a sign-in challenge always apply.
|
|
244
|
+
The server validates the shape and stores the value as given; it
|
|
245
|
+
never resolves or loosens it.
|
|
246
|
+
`,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
247
|
+
least as cautious as the preset its profile and platform
|
|
248
|
+
resolve to.
|
|
249
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
250
|
+
changed; present, the item's rules read as adjusted.
|
|
251
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},ContentItemRulesOfEngagementDials:{type:"object",additionalProperties:false,description:`Dials of a content item's rules of engagement. Each is optional and
|
|
252
|
+
applies only where it is stricter than the resolved preset's own
|
|
253
|
+
value; a dial that would loosen is ignored by the client that runs
|
|
254
|
+
the item.
|
|
255
|
+
`,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}},ContentItemQuietHours:{type:"object",additionalProperties:false,description:"A window of local hours with no public actions, from `start` up to\n`end`, wrapping past midnight when `end` is earlier than `start`.\n",required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},ContentItemPage:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
|
|
73
256
|
Content items carry a row number and a server-computed fingerprint over
|
|
74
257
|
their canonical values; updates are conditional on the fingerprint the
|
|
75
258
|
writer read, so stale writes are refused rather than silently applied.
|
|
76
|
-
|
|
77
|
-
|
|
259
|
+
An item may carry its own rules of engagement, which can only tighten,
|
|
260
|
+
and may belong to a thread through \`threadId\`, \`replyToId\` and
|
|
261
|
+
\`threadIndex\`. See docs/content-item-contract.md.
|
|
262
|
+
`,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],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"},"x-order":1},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"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","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,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{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-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
|
|
263
|
+
`,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
|
|
264
|
+
least as cautious as the preset its profile and platform
|
|
265
|
+
resolve to.
|
|
266
|
+
`,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
|
|
267
|
+
changed; present, the item's rules read as adjusted.
|
|
268
|
+
`,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
|
|
269
|
+
`,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
|
|
270
|
+
`,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}},description:"Content items included on this page of results."}}}}}},t=e;export{t as default};
|