@lessly/sdk-app 97.4.0 → 98.0.0

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.
@@ -68453,6 +68453,168 @@ capabilities: {
68453
68453
  deliveryMode: ("auto" | "reminder")
68454
68454
  }
68455
68455
 
68456
+ export interface ContentFoldersCreateInput {
68457
+ /**
68458
+ * The folder name, from 1 to 200 characters.
68459
+ */
68460
+ name: string
68461
+ /**
68462
+ * Parent folder id, or null for a root folder. New folders go last among siblings.
68463
+ */
68464
+ parentId?: (string | null)
68465
+ }
68466
+
68467
+ export interface ContentFoldersCreateOutput {
68468
+ /**
68469
+ * Folder id.
68470
+ */
68471
+ id: string
68472
+ /**
68473
+ * Folder name.
68474
+ */
68475
+ name: string
68476
+ /**
68477
+ * Parent folder id, or null at the root.
68478
+ */
68479
+ parentId: (string | null)
68480
+ /**
68481
+ * Order among siblings with the same parent.
68482
+ */
68483
+ position: number
68484
+ /**
68485
+ * ISO-8601 creation time.
68486
+ */
68487
+ createdAt: string
68488
+ /**
68489
+ * ISO-8601 time of the last change.
68490
+ */
68491
+ updatedAt: string
68492
+ }
68493
+
68494
+ export interface ContentFoldersDeleteInput {
68495
+ /**
68496
+ * A folder id from content_folders_list or content_folders_create.
68497
+ */
68498
+ folderId: string
68499
+ }
68500
+
68501
+ export interface ContentFoldersDeleteOutput {
68502
+ /**
68503
+ * True when this empty folder was deleted.
68504
+ */
68505
+ deleted: true
68506
+ /**
68507
+ * A folder id from content_folders_list or content_folders_create.
68508
+ */
68509
+ folderId: string
68510
+ }
68511
+
68512
+ export interface ContentFoldersListInput {
68513
+
68514
+ }
68515
+
68516
+ export interface ContentFoldersListOutput {
68517
+ /**
68518
+ * Flat folder tree; parentId and position describe the hierarchy and order.
68519
+ */
68520
+ folders: {
68521
+ /**
68522
+ * Folder id.
68523
+ */
68524
+ id: string
68525
+ /**
68526
+ * Folder name.
68527
+ */
68528
+ name: string
68529
+ /**
68530
+ * Posts directly in this folder, by status.
68531
+ */
68532
+ counts: {
68533
+ idea: number
68534
+ draft: number
68535
+ failed: number
68536
+ approved: number
68537
+ published: number
68538
+ scheduled: number
68539
+ pending_approval: number
68540
+ }
68541
+ /**
68542
+ * Parent folder id, or null at the root.
68543
+ */
68544
+ parentId: (string | null)
68545
+ /**
68546
+ * Order among siblings with the same parent.
68547
+ */
68548
+ position: number
68549
+ /**
68550
+ * ISO-8601 creation time.
68551
+ */
68552
+ createdAt: string
68553
+ /**
68554
+ * ISO-8601 time of the last change.
68555
+ */
68556
+ updatedAt: string
68557
+ /**
68558
+ * Posts in this folder and all descendants, by status.
68559
+ */
68560
+ totalCounts: {
68561
+ idea: number
68562
+ draft: number
68563
+ failed: number
68564
+ approved: number
68565
+ published: number
68566
+ scheduled: number
68567
+ pending_approval: number
68568
+ }
68569
+ }[]
68570
+ }
68571
+
68572
+ export interface ContentFoldersUpdateInput {
68573
+ /**
68574
+ * New folder name. Omit to keep it.
68575
+ */
68576
+ name?: string
68577
+ /**
68578
+ * A folder id from content_folders_list or content_folders_create.
68579
+ */
68580
+ folderId: string
68581
+ /**
68582
+ * New parent folder id, or null to move to the root. Omit to keep the current parent.
68583
+ */
68584
+ parentId?: (string | null)
68585
+ /**
68586
+ * Insert before this sibling in the target parent. Omit or set null to put the folder last.
68587
+ */
68588
+ beforeFolderId?: (string | null)
68589
+ }
68590
+
68591
+ export interface ContentFoldersUpdateOutput {
68592
+ /**
68593
+ * Folder id.
68594
+ */
68595
+ id: string
68596
+ /**
68597
+ * Folder name.
68598
+ */
68599
+ name: string
68600
+ /**
68601
+ * Parent folder id, or null at the root.
68602
+ */
68603
+ parentId: (string | null)
68604
+ /**
68605
+ * Order among siblings with the same parent.
68606
+ */
68607
+ position: number
68608
+ /**
68609
+ * ISO-8601 creation time.
68610
+ */
68611
+ createdAt: string
68612
+ /**
68613
+ * ISO-8601 time of the last change.
68614
+ */
68615
+ updatedAt: string
68616
+ }
68617
+
68456
68618
  export interface ContentMediaCreateUploadUrlInput {
68457
68619
  /**
68458
68620
  * Name to store the file under, for display purposes.
@@ -68920,14 +69082,22 @@ text: string
68920
69082
  * Media references attached to the current version.
68921
69083
  */
68922
69084
  media: string[]
69085
+ /**
69086
+ * Private plan notes, or null when unset.
69087
+ */
69088
+ notes: (string | null)
69089
+ /**
69090
+ * Plan title, or null when unset.
69091
+ */
69092
+ title: (string | null)
68923
69093
  /**
68924
69094
  * Identity id of whoever composed the post.
68925
69095
  */
68926
69096
  author: string
68927
69097
  /**
68928
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
69098
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
68929
69099
  */
68930
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
69100
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
68931
69101
  /**
68932
69102
  * The networks this post is meant for, each with its variant.
68933
69103
  */
@@ -68951,6 +69121,14 @@ network: string
68951
69121
  */
68952
69122
  postType: string
68953
69123
  }[]
69124
+ /**
69125
+ * Folder containing this post, or null.
69126
+ */
69127
+ folderId: (string | null)
69128
+ /**
69129
+ * Order within its folder, or null for an unfiled post.
69130
+ */
69131
+ position: (number | null)
68954
69132
  /**
68955
69133
  * ISO-8601 creation time.
68956
69134
  */
@@ -68996,14 +69174,22 @@ text: string
68996
69174
  * Media references attached to the current version.
68997
69175
  */
68998
69176
  media: string[]
69177
+ /**
69178
+ * Private plan notes, or null when unset.
69179
+ */
69180
+ notes: (string | null)
69181
+ /**
69182
+ * Plan title, or null when unset.
69183
+ */
69184
+ title: (string | null)
68999
69185
  /**
69000
69186
  * Identity id of whoever composed the post.
69001
69187
  */
69002
69188
  author: string
69003
69189
  /**
69004
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
69190
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
69005
69191
  */
69006
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
69192
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
69007
69193
  /**
69008
69194
  * The networks this post is meant for, each with its variant.
69009
69195
  */
@@ -69027,6 +69213,14 @@ network: string
69027
69213
  */
69028
69214
  postType: string
69029
69215
  }[]
69216
+ /**
69217
+ * Folder containing this post, or null.
69218
+ */
69219
+ folderId: (string | null)
69220
+ /**
69221
+ * Order within its folder, or null for an unfiled post.
69222
+ */
69223
+ position: (number | null)
69030
69224
  /**
69031
69225
  * ISO-8601 creation time.
69032
69226
  */
@@ -69047,15 +69241,23 @@ approvedVersion: (number | null)
69047
69241
 
69048
69242
  export interface ContentPostsCreateInput {
69049
69243
  /**
69050
- * The post text, channel-independent, written in markdown — bold, italic, lists, links. Each network gets it flattened to the plain text that network accepts; content_publications_validate shows exactly what that looks like per channel. A target may override it for one network.
69244
+ * Optional channel-independent markdown text. Omit or leave empty to create an idea with a title; with text, the post starts as a draft. A target may override this text for one network.
69051
69245
  */
69052
- text: string
69246
+ text?: string
69053
69247
  /**
69054
69248
  * Media references attached to the post, in display order. Opaque strings — the toolkit does not upload or resolve them.
69055
69249
  *
69056
69250
  * @maxItems 20
69057
69251
  */
69058
69252
  media?: []|[string]|[string, string]|[string, string, string]|[string, string, string, string]|[string, string, string, string, string]|[string, string, string, string, string, string]|[string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]
69253
+ /**
69254
+ * Private plan notes, up to 20,000 characters. They are not published.
69255
+ */
69256
+ notes?: (string | null)
69257
+ /**
69258
+ * Optional plan title, up to 300 characters. Required when text is empty to create an idea.
69259
+ */
69260
+ title?: (string | null)
69059
69261
  /**
69060
69262
  * The networks this post is meant for, each with its variant: post type, optional text override and the network-specific fields. A post needs at least one target before it can be submitted, and it can only be scheduled to channels of these networks. Media is shared by every target.
69061
69263
  *
@@ -73052,6 +73254,10 @@ network: ("linkedin" | "x" | "youtube" | "instagram" | "reddit" | "facebook" | "
73052
73254
  */
73053
73255
  postType?: string
73054
73256
  }]
73257
+ /**
73258
+ * Folder in this product to place the post in, or null for no folder. A new post goes last in that folder.
73259
+ */
73260
+ folderId?: (string | null)
73055
73261
  }
73056
73262
 
73057
73263
  export interface ContentPostsCreateOutput {
@@ -73067,14 +73273,22 @@ text: string
73067
73273
  * Media references attached to the current version.
73068
73274
  */
73069
73275
  media: string[]
73276
+ /**
73277
+ * Private plan notes, or null when unset.
73278
+ */
73279
+ notes: (string | null)
73280
+ /**
73281
+ * Plan title, or null when unset.
73282
+ */
73283
+ title: (string | null)
73070
73284
  /**
73071
73285
  * Identity id of whoever composed the post.
73072
73286
  */
73073
73287
  author: string
73074
73288
  /**
73075
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73289
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73076
73290
  */
73077
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73291
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73078
73292
  /**
73079
73293
  * The networks this post is meant for, each with its variant.
73080
73294
  */
@@ -73098,6 +73312,14 @@ network: string
73098
73312
  */
73099
73313
  postType: string
73100
73314
  }[]
73315
+ /**
73316
+ * Folder containing this post, or null.
73317
+ */
73318
+ folderId: (string | null)
73319
+ /**
73320
+ * Order within its folder, or null for an unfiled post.
73321
+ */
73322
+ position: (number | null)
73101
73323
  /**
73102
73324
  * ISO-8601 creation time.
73103
73325
  */
@@ -73116,6 +73338,24 @@ currentVersion: number
73116
73338
  approvedVersion: (number | null)
73117
73339
  }
73118
73340
 
73341
+ export interface ContentPostsDeleteInput {
73342
+ /**
73343
+ * The post id returned by content_posts_create.
73344
+ */
73345
+ postId: string
73346
+ }
73347
+
73348
+ export interface ContentPostsDeleteOutput {
73349
+ /**
73350
+ * The post id returned by content_posts_create.
73351
+ */
73352
+ postId: string
73353
+ /**
73354
+ * The post and its content versions were deleted.
73355
+ */
73356
+ deleted: true
73357
+ }
73358
+
73119
73359
  export interface ContentPostsDetachMediaInput {
73120
73360
  /**
73121
73361
  * The post id.
@@ -73143,14 +73383,22 @@ text: string
73143
73383
  * Media references attached to the current version.
73144
73384
  */
73145
73385
  media: string[]
73386
+ /**
73387
+ * Private plan notes, or null when unset.
73388
+ */
73389
+ notes: (string | null)
73390
+ /**
73391
+ * Plan title, or null when unset.
73392
+ */
73393
+ title: (string | null)
73146
73394
  /**
73147
73395
  * Identity id of whoever composed the post.
73148
73396
  */
73149
73397
  author: string
73150
73398
  /**
73151
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73399
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73152
73400
  */
73153
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73401
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73154
73402
  /**
73155
73403
  * The networks this post is meant for, each with its variant.
73156
73404
  */
@@ -73174,6 +73422,14 @@ network: string
73174
73422
  */
73175
73423
  postType: string
73176
73424
  }[]
73425
+ /**
73426
+ * Folder containing this post, or null.
73427
+ */
73428
+ folderId: (string | null)
73429
+ /**
73430
+ * Order within its folder, or null for an unfiled post.
73431
+ */
73432
+ position: (number | null)
73177
73433
  /**
73178
73434
  * ISO-8601 creation time.
73179
73435
  */
@@ -73212,14 +73468,22 @@ text: string
73212
73468
  * Media references attached to the current version.
73213
73469
  */
73214
73470
  media: string[]
73471
+ /**
73472
+ * Private plan notes, or null when unset.
73473
+ */
73474
+ notes: (string | null)
73475
+ /**
73476
+ * Plan title, or null when unset.
73477
+ */
73478
+ title: (string | null)
73215
73479
  /**
73216
73480
  * Identity id of whoever composed the post.
73217
73481
  */
73218
73482
  author: string
73219
73483
  /**
73220
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73484
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73221
73485
  */
73222
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73486
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73223
73487
  /**
73224
73488
  * The networks this post is meant for, each with its variant.
73225
73489
  */
@@ -73243,6 +73507,14 @@ network: string
73243
73507
  */
73244
73508
  postType: string
73245
73509
  }[]
73510
+ /**
73511
+ * Folder containing this post, or null.
73512
+ */
73513
+ folderId: (string | null)
73514
+ /**
73515
+ * Order within its folder, or null for an unfiled post.
73516
+ */
73517
+ position: (number | null)
73246
73518
  /**
73247
73519
  * ISO-8601 creation time.
73248
73520
  */
@@ -73273,12 +73545,16 @@ offset?: number
73273
73545
  /**
73274
73546
  * Return only posts in this status.
73275
73547
  */
73276
- status?: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73548
+ status?: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73549
+ /**
73550
+ * Filter to one folder, or null for posts in no folder. Omit for posts in every folder.
73551
+ */
73552
+ folderId?: (string | null)
73277
73553
  }
73278
73554
 
73279
73555
  export interface ContentPostsListOutput {
73280
73556
  /**
73281
- * The page of posts, newest first.
73557
+ * The page of posts, ordered by position when filtered to a folder and newest first otherwise.
73282
73558
  */
73283
73559
  posts: {
73284
73560
  /**
@@ -73293,14 +73569,22 @@ text: string
73293
73569
  * Media references attached to the current version.
73294
73570
  */
73295
73571
  media: string[]
73572
+ /**
73573
+ * Private plan notes, or null when unset.
73574
+ */
73575
+ notes: (string | null)
73576
+ /**
73577
+ * Plan title, or null when unset.
73578
+ */
73579
+ title: (string | null)
73296
73580
  /**
73297
73581
  * Identity id of whoever composed the post.
73298
73582
  */
73299
73583
  author: string
73300
73584
  /**
73301
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73585
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73302
73586
  */
73303
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73587
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73304
73588
  /**
73305
73589
  * The networks this post is meant for, each with its variant.
73306
73590
  */
@@ -73324,6 +73608,14 @@ network: string
73324
73608
  */
73325
73609
  postType: string
73326
73610
  }[]
73611
+ /**
73612
+ * Folder containing this post, or null.
73613
+ */
73614
+ folderId: (string | null)
73615
+ /**
73616
+ * Order within its folder, or null for an unfiled post.
73617
+ */
73618
+ position: (number | null)
73327
73619
  /**
73328
73620
  * ISO-8601 creation time.
73329
73621
  */
@@ -73347,6 +73639,99 @@ approvedVersion: (number | null)
73347
73639
  total: number
73348
73640
  }
73349
73641
 
73642
+ export interface ContentPostsMoveInput {
73643
+ /**
73644
+ * The post id returned by content_posts_create.
73645
+ */
73646
+ postId: string
73647
+ /**
73648
+ * Destination folder in this product, or null to leave the post unfiled.
73649
+ */
73650
+ folderId: (string | null)
73651
+ /**
73652
+ * Put the post immediately before this post in the destination folder. Omit to append it.
73653
+ */
73654
+ beforePostId?: string
73655
+ }
73656
+
73657
+ export interface ContentPostsMoveOutput {
73658
+ /**
73659
+ * Post id.
73660
+ */
73661
+ id: string
73662
+ /**
73663
+ * The current text of the post, in markdown.
73664
+ */
73665
+ text: string
73666
+ /**
73667
+ * Media references attached to the current version.
73668
+ */
73669
+ media: string[]
73670
+ /**
73671
+ * Private plan notes, or null when unset.
73672
+ */
73673
+ notes: (string | null)
73674
+ /**
73675
+ * Plan title, or null when unset.
73676
+ */
73677
+ title: (string | null)
73678
+ /**
73679
+ * Identity id of whoever composed the post.
73680
+ */
73681
+ author: string
73682
+ /**
73683
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73684
+ */
73685
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73686
+ /**
73687
+ * The networks this post is meant for, each with its variant.
73688
+ */
73689
+ targets: {
73690
+ /**
73691
+ * Markdown override for this network, or null to publish the post text.
73692
+ */
73693
+ text: (string | null)
73694
+ /**
73695
+ * Variant field values keyed by field id.
73696
+ */
73697
+ fields: {
73698
+ [k: string]: string
73699
+ }
73700
+ /**
73701
+ * The network this variant is for.
73702
+ */
73703
+ network: string
73704
+ /**
73705
+ * The post type id, from that network's capabilities.postTypes.
73706
+ */
73707
+ postType: string
73708
+ }[]
73709
+ /**
73710
+ * Folder containing this post, or null.
73711
+ */
73712
+ folderId: (string | null)
73713
+ /**
73714
+ * Order within its folder, or null for an unfiled post.
73715
+ */
73716
+ position: (number | null)
73717
+ /**
73718
+ * ISO-8601 creation time.
73719
+ */
73720
+ createdAt: string
73721
+ /**
73722
+ * ISO-8601 time of the last change.
73723
+ */
73724
+ updatedAt: string
73725
+ /**
73726
+ * Version number of the current text.
73727
+ */
73728
+ currentVersion: number
73729
+ /**
73730
+ * The version an approval binds to, or null. Cleared on every edit: approving one text never covers another.
73731
+ */
73732
+ approvedVersion: (number | null)
73733
+ }
73734
+
73350
73735
  export interface ContentPostsSubmitInput {
73351
73736
  /**
73352
73737
  * The post id returned by content_posts_create.
@@ -73367,14 +73752,107 @@ text: string
73367
73752
  * Media references attached to the current version.
73368
73753
  */
73369
73754
  media: string[]
73755
+ /**
73756
+ * Private plan notes, or null when unset.
73757
+ */
73758
+ notes: (string | null)
73759
+ /**
73760
+ * Plan title, or null when unset.
73761
+ */
73762
+ title: (string | null)
73763
+ /**
73764
+ * Identity id of whoever composed the post.
73765
+ */
73766
+ author: string
73767
+ /**
73768
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73769
+ */
73770
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73771
+ /**
73772
+ * The networks this post is meant for, each with its variant.
73773
+ */
73774
+ targets: {
73775
+ /**
73776
+ * Markdown override for this network, or null to publish the post text.
73777
+ */
73778
+ text: (string | null)
73779
+ /**
73780
+ * Variant field values keyed by field id.
73781
+ */
73782
+ fields: {
73783
+ [k: string]: string
73784
+ }
73785
+ /**
73786
+ * The network this variant is for.
73787
+ */
73788
+ network: string
73789
+ /**
73790
+ * The post type id, from that network's capabilities.postTypes.
73791
+ */
73792
+ postType: string
73793
+ }[]
73794
+ /**
73795
+ * Folder containing this post, or null.
73796
+ */
73797
+ folderId: (string | null)
73798
+ /**
73799
+ * Order within its folder, or null for an unfiled post.
73800
+ */
73801
+ position: (number | null)
73802
+ /**
73803
+ * ISO-8601 creation time.
73804
+ */
73805
+ createdAt: string
73806
+ /**
73807
+ * ISO-8601 time of the last change.
73808
+ */
73809
+ updatedAt: string
73810
+ /**
73811
+ * Version number of the current text.
73812
+ */
73813
+ currentVersion: number
73814
+ /**
73815
+ * The version an approval binds to, or null. Cleared on every edit: approving one text never covers another.
73816
+ */
73817
+ approvedVersion: (number | null)
73818
+ }
73819
+
73820
+ export interface ContentPostsToDraftInput {
73821
+ /**
73822
+ * The post id returned by content_posts_create.
73823
+ */
73824
+ postId: string
73825
+ }
73826
+
73827
+ export interface ContentPostsToDraftOutput {
73828
+ /**
73829
+ * Post id.
73830
+ */
73831
+ id: string
73832
+ /**
73833
+ * The current text of the post, in markdown.
73834
+ */
73835
+ text: string
73836
+ /**
73837
+ * Media references attached to the current version.
73838
+ */
73839
+ media: string[]
73840
+ /**
73841
+ * Private plan notes, or null when unset.
73842
+ */
73843
+ notes: (string | null)
73844
+ /**
73845
+ * Plan title, or null when unset.
73846
+ */
73847
+ title: (string | null)
73370
73848
  /**
73371
73849
  * Identity id of whoever composed the post.
73372
73850
  */
73373
73851
  author: string
73374
73852
  /**
73375
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73853
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73376
73854
  */
73377
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73855
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73378
73856
  /**
73379
73857
  * The networks this post is meant for, each with its variant.
73380
73858
  */
@@ -73398,6 +73876,99 @@ network: string
73398
73876
  */
73399
73877
  postType: string
73400
73878
  }[]
73879
+ /**
73880
+ * Folder containing this post, or null.
73881
+ */
73882
+ folderId: (string | null)
73883
+ /**
73884
+ * Order within its folder, or null for an unfiled post.
73885
+ */
73886
+ position: (number | null)
73887
+ /**
73888
+ * ISO-8601 creation time.
73889
+ */
73890
+ createdAt: string
73891
+ /**
73892
+ * ISO-8601 time of the last change.
73893
+ */
73894
+ updatedAt: string
73895
+ /**
73896
+ * Version number of the current text.
73897
+ */
73898
+ currentVersion: number
73899
+ /**
73900
+ * The version an approval binds to, or null. Cleared on every edit: approving one text never covers another.
73901
+ */
73902
+ approvedVersion: (number | null)
73903
+ }
73904
+
73905
+ export interface ContentPostsToIdeaInput {
73906
+ /**
73907
+ * The post id returned by content_posts_create.
73908
+ */
73909
+ postId: string
73910
+ }
73911
+
73912
+ export interface ContentPostsToIdeaOutput {
73913
+ /**
73914
+ * Post id.
73915
+ */
73916
+ id: string
73917
+ /**
73918
+ * The current text of the post, in markdown.
73919
+ */
73920
+ text: string
73921
+ /**
73922
+ * Media references attached to the current version.
73923
+ */
73924
+ media: string[]
73925
+ /**
73926
+ * Private plan notes, or null when unset.
73927
+ */
73928
+ notes: (string | null)
73929
+ /**
73930
+ * Plan title, or null when unset.
73931
+ */
73932
+ title: (string | null)
73933
+ /**
73934
+ * Identity id of whoever composed the post.
73935
+ */
73936
+ author: string
73937
+ /**
73938
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
73939
+ */
73940
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
73941
+ /**
73942
+ * The networks this post is meant for, each with its variant.
73943
+ */
73944
+ targets: {
73945
+ /**
73946
+ * Markdown override for this network, or null to publish the post text.
73947
+ */
73948
+ text: (string | null)
73949
+ /**
73950
+ * Variant field values keyed by field id.
73951
+ */
73952
+ fields: {
73953
+ [k: string]: string
73954
+ }
73955
+ /**
73956
+ * The network this variant is for.
73957
+ */
73958
+ network: string
73959
+ /**
73960
+ * The post type id, from that network's capabilities.postTypes.
73961
+ */
73962
+ postType: string
73963
+ }[]
73964
+ /**
73965
+ * Folder containing this post, or null.
73966
+ */
73967
+ folderId: (string | null)
73968
+ /**
73969
+ * Order within its folder, or null for an unfiled post.
73970
+ */
73971
+ position: (number | null)
73401
73972
  /**
73402
73973
  * ISO-8601 creation time.
73403
73974
  */
@@ -73422,7 +73993,7 @@ export interface ContentPostsUpdateInput {
73422
73993
  */
73423
73994
  id: string
73424
73995
  /**
73425
- * Replacement text, in markdown. Omit to keep the current text.
73996
+ * Replacement text, in markdown; it may be empty for an idea or draft. Omit to keep the current text.
73426
73997
  */
73427
73998
  text?: string
73428
73999
  /**
@@ -73431,6 +74002,14 @@ text?: string
73431
74002
  * @maxItems 20
73432
74003
  */
73433
74004
  media?: []|[string]|[string, string]|[string, string, string]|[string, string, string, string]|[string, string, string, string, string]|[string, string, string, string, string, string]|[string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]
74005
+ /**
74006
+ * New private plan notes, or null to clear them. Changing them does not create a content version or revoke approval.
74007
+ */
74008
+ notes?: (string | null)
74009
+ /**
74010
+ * New plan title, or null to clear it. Changing it does not create a content version or revoke approval.
74011
+ */
74012
+ title?: (string | null)
73434
74013
  /**
73435
74014
  * Replacement target list (replaces, never merges). Omit to keep the current targets. Changing it is an edit like changing the text: a new version, and an approved post returns to pending_approval.
73436
74015
  *
@@ -77442,14 +78021,22 @@ text: string
77442
78021
  * Media references attached to the current version.
77443
78022
  */
77444
78023
  media: string[]
78024
+ /**
78025
+ * Private plan notes, or null when unset.
78026
+ */
78027
+ notes: (string | null)
78028
+ /**
78029
+ * Plan title, or null when unset.
78030
+ */
78031
+ title: (string | null)
77445
78032
  /**
77446
78033
  * Identity id of whoever composed the post.
77447
78034
  */
77448
78035
  author: string
77449
78036
  /**
77450
- * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
78037
+ * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
77451
78038
  */
77452
- status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
78039
+ status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed")
77453
78040
  /**
77454
78041
  * The networks this post is meant for, each with its variant.
77455
78042
  */
@@ -77473,6 +78060,14 @@ network: string
77473
78060
  */
77474
78061
  postType: string
77475
78062
  }[]
78063
+ /**
78064
+ * Folder containing this post, or null.
78065
+ */
78066
+ folderId: (string | null)
78067
+ /**
78068
+ * Order within its folder, or null for an unfiled post.
78069
+ */
78070
+ position: (number | null)
77476
78071
  /**
77477
78072
  * ISO-8601 creation time.
77478
78073
  */