-
Notifications
You must be signed in to change notification settings - Fork 100
/
Copy path__package__.yml
2589 lines (2575 loc) · 80.1 KB
/
__package__.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
errors:
UnauthorizedError:
status-code: 401
type: Error
docs: >-
Provided access token is invalid or does not have access to requested
resource
examples:
- value:
code: not_authorized
message: Request not authorized
ForbiddenError:
status-code: 403
type: unknown
docs: Provided access token is valid, but is missing the required scopes.
examples:
- value:
code: missing_scopes
message: >-
OAuthForbidden: You are missing the following scopes -
components:write
- value:
code: forbidden
message: User is not authorized to perform this action
- value:
key: value
NotFoundError:
status-code: 404
type: Error
docs: Requested resource not found
examples:
- value:
code: resource_not_found
message: 'Requested resource not found: The site cannot be found'
TooManyRequestsError:
status-code: 429
type: Error
docs: >-
The rate limit of the provided access_token has been reached. Please have
your application respect the X-RateLimit-Remaining header we include on
API responses.
examples:
- value:
code: too_many_requests
message: Too many requests
BadRequestError:
status-code: 400
type: unknown
docs: Request body was incorrectly formatted.
examples:
- value:
code: bad_request
message: 'Bad Request: Request is malformed'
- value:
key: value
- value:
code: validation_error
message: 'Validation Error: Provided ID is invalid'
InternalServerError:
status-code: 500
type: Error
docs: We had a problem with our server. Try again later.
examples:
- value:
code: internal_error
message: An Internal Error occurred
ConflictError:
status-code: 409
type: unknown
docs: Site is published to multiple domains at different times
examples:
- value:
message: '''Site is published to multiple domains at different times'
- value:
code: forms_require_republish
message: To access this feature, the site needs to be republished.
- value:
key: value
- value:
code: ecommerce_not_enabled
message: Ecommerce is not yet initialized
types:
BadRequestErrorBody:
discriminated: false
union:
- InvalidDomain
- NoDomains
source:
openapi: ../../../referenced-specs/v2.yml
ForbiddenErrorBody:
discriminated: false
union:
- InvalidScopes
- UsersNotEnabled
source:
openapi: ../../../referenced-specs/v2.yml
ConflictErrorBody:
discriminated: false
union:
- DuplicateUserEmail
- UserLimitReached
source:
openapi: ../../../referenced-specs/v2.yml
AuthorizedUser:
properties:
id:
type: optional<string>
docs: The unique ID of the user
email:
type: optional<string>
docs: The user's email address
validation:
format: email
firstName:
type: optional<string>
docs: The user's first name
lastName:
type: optional<string>
docs: The user's last name
source:
openapi: ../../../referenced-specs/v2.yml
ErrorCode:
enum:
- bad_request
- collection_not_found
- conflict
- duplicate_collection
- duplicate_user_email
- ecommerce_not_enabled
- forbidden
- forms_require_republish
- incompatible_webhook_filter
- internal_error
- invalid_auth_version
- invalid_credentials
- invalid_domain
- invalid_user_email
- item_not_found
- missing_scopes
- no_domains
- not_authorized
- not_enterprise_plan_site
- not_enterprise_plan_workspace
- order_not_found
- resource_not_found
- too_many_requests
- unsupported_version
- unsupported_webhook_trigger_type
- user_limit_reached
- user_not_found
- users_not_enabled
- validation_error
docs: Error code
source:
openapi: ../../../referenced-specs/v2.yml
ErrorDetailsItem:
discriminated: false
union:
- string
- map<string, unknown>
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
Error:
properties:
code:
type: optional<ErrorCode>
docs: Error code
message:
type: optional<string>
docs: Error message
externalReference:
type: optional<string>
docs: Link to more information
details:
type: optional<list<ErrorDetailsItem>>
docs: Array of errors
source:
openapi: ../../../referenced-specs/v2.yml
Application: unknown
AuthorizationAuthorizationAuthorizedTo:
properties:
siteIds:
type: optional<list<unknown>>
docs: Array of Sites this app is authorized to
workspaceIds:
type: optional<list<unknown>>
docs: Array of Workspaces this app is authorized to
userIds:
type: optional<list<unknown>>
docs: Array of Users this app is authorized to
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
AuthorizationAuthorization:
docs: The Authorization object
properties:
id:
type: optional<string>
docs: The unique ID of the Authorization instance
createdOn:
type: optional<datetime>
docs: The date the Authorization was created
lastUsed:
type: optional<datetime>
docs: The date the Authorization was last used
grantType:
type: optional<string>
docs: The grant type of the Authorization
rateLimit:
type: optional<integer>
docs: The default rate limit for the Authorization (requests/min)
scope:
type: optional<string>
docs: Comma separted list of OAuth scopes corresponding to the Authorization
authorizedTo: optional<AuthorizationAuthorizationAuthorizedTo>
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
Authorization:
properties:
authorization:
type: optional<AuthorizationAuthorization>
docs: The Authorization object
application: optional<Application>
source:
openapi: ../../../referenced-specs/v2.yml
Domain:
properties:
id:
type: string
docs: Unique identifier for the Domain
url:
type: optional<string>
docs: The registered Domain name
source:
openapi: ../../../referenced-specs/v2.yml
Locale:
properties:
id:
type: optional<string>
docs: The unique identifier for the locale.
cmsLocaleId:
type: optional<string>
docs: A CMS-specific identifier for the locale.
enabled:
type: optional<boolean>
docs: Indicates if the locale is enabled.
displayName:
type: optional<string>
docs: The display name of the locale, typically in English.
displayImageId:
type: optional<string>
docs: An optional ID for an image associated with the locale, nullable.
redirect:
type: optional<boolean>
docs: Determines if requests should redirect to the locale's subdirectory.
subdirectory:
type: optional<string>
docs: The subdirectory path for the locale, used in URLs.
tag:
type: optional<string>
docs: >-
A tag or code representing the locale, often following a standard
format like 'en-US'.
source:
openapi: ../../../referenced-specs/v2.yml
Locales:
properties:
primary:
type: optional<Locale>
docs: The primary locale for the site or application.
secondary:
type: optional<list<Locale>>
docs: A list of secondary locales available for the site or application.
source:
openapi: ../../../referenced-specs/v2.yml
SiteDataCollectionType:
enum:
- always
- optOut
- disabled
docs: The type of data collection enabled for the site.
source:
openapi: ../../../referenced-specs/v2.yml
Site:
properties:
id:
type: string
docs: Unique identifier for the Site
workspaceId:
type: optional<string>
docs: Unique identifier for the Workspace
createdOn:
type: optional<datetime>
docs: Date the Site was created
displayName:
type: optional<string>
docs: Name given to Site
shortName:
type: optional<string>
docs: Slugified version of name
lastPublished:
type: optional<datetime>
docs: Date the Site was last published
lastUpdated:
type: optional<datetime>
docs: Date the Site was last updated
previewUrl:
type: optional<string>
docs: URL of a generated image for the given Site
validation:
format: uri
timeZone:
type: optional<string>
docs: Site timezone set under Site Settings
parentFolderId:
type: optional<string>
docs: The ID of the parent folder the Site exists in
customDomains: optional<list<Domain>>
locales: optional<Locales>
dataCollectionEnabled:
type: optional<boolean>
docs: Indicates if data collection is enabled for the site.
dataCollectionType:
type: optional<SiteDataCollectionType>
docs: The type of data collection enabled for the site.
source:
openapi: ../../../referenced-specs/v2.yml
Sites:
properties:
sites: optional<list<Site>>
source:
openapi: ../../../referenced-specs/v2.yml
Domains:
properties:
customDomains: optional<list<Domain>>
source:
openapi: ../../../referenced-specs/v2.yml
InvalidDomain: unknown
NoDomains: unknown
SiteActivityLogItemEvent:
enum:
- styles_modified
- site_published
- ix2_modified_on_page
- page_dom_modified
- cms_item
- backup_created
- page_custom_code_modified
- symbols_modified
- variable_modified
- variables_modified
- cms_collection
- page_settings_modified
- page_settings_custom_code_modified
- ix2_modified_on_component
- ix2_modified_on_class
- site_custom_code_modified
- page_duplicated
- secondary_locale_page_content_modified
- page_renamed
- page_created
- page_deleted
- site_unpublished
- backup_restored
- locale_added
- branch_created
- locale_display_name_updated
- locale_subdirectory_updated
- branch_merged
- locale_tag_updated
- branch_deleted
- locale_enabled
- locale_removed
- locale_disabled
- library_shared
- library_unshared
- library_installed
- library_uninstalled
- library_update_shared
- library_update_accepted
- branch_review_created
- branch_review_approved
- branch_review_canceled
source:
openapi: ../../../referenced-specs/v2.yml
SiteActivityLogItemResourceOperation:
enum:
- CREATED
- MODIFIED
- PUBLISHED
- UNPUBLISHED
- DELETED
- GROUP_REORDERED
- GROUP_CREATED
- GROUP_DELETED
- REORDERED
source:
openapi: ../../../referenced-specs/v2.yml
SiteActivityLogItemUser:
properties:
id: optional<string>
displayName: optional<string>
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
SiteActivityLogItem:
properties:
id: optional<string>
createdOn: optional<datetime>
lastUpdated: optional<datetime>
event: optional<SiteActivityLogItemEvent>
resourceOperation: optional<SiteActivityLogItemResourceOperation>
user: optional<SiteActivityLogItemUser>
resourceId: optional<string>
resourceName: optional<string>
newValue: optional<string>
previousValue: optional<string>
payload: optional<map<string, unknown>>
source:
openapi: ../../../referenced-specs/v2.yml
Pagination:
docs: Pagination object
properties:
limit:
type: optional<double>
docs: The limit used for pagination
offset:
type: optional<double>
docs: The offset used for pagination
total:
type: optional<double>
docs: The total number of records
source:
openapi: ../../../referenced-specs/v2.yml
SiteActivityLogResponse:
properties:
items: optional<list<SiteActivityLogItem>>
pagination: optional<Pagination>
source:
openapi: ../../../referenced-specs/v2.yml
InvalidScopes: unknown
NotEnterprisePlanSite: unknown
CollectionListArrayItem:
docs: A collection object
properties:
id:
type: string
docs: Unique identifier for a Collection
displayName:
type: optional<string>
docs: Name given to the Collection
singularName:
type: optional<string>
docs: >-
The name of one Item in Collection (e.g. ”Blog Post” if the Collection
is called “Blog Posts”)
slug:
type: optional<string>
docs: Slug of Collection in Site URL structure
createdOn:
type: optional<datetime>
docs: The date the collection was created
lastUpdated:
type: optional<datetime>
docs: The date the collection was last updated
source:
openapi: ../../../referenced-specs/v2.yml
CollectionList:
properties:
collections:
type: optional<list<CollectionListArrayItem>>
docs: An array of Collections
source:
openapi: ../../../referenced-specs/v2.yml
FieldType:
enum:
- PlainText
- RichText
- Image
- MultiImage
- Video
- Link
- Email
- Phone
- Number
- DateTime
- Switch
- Color
- ExtFileRef
docs: Choose these appropriate field type for your collection data
source:
openapi: ../../../referenced-specs/v2.yml
Field:
docs: The details of a field in a collection
properties:
id:
type: string
docs: Unique identifier for a Field
isRequired:
type: boolean
docs: define whether a field is required in a collection
isEditable:
type: optional<boolean>
docs: Define whether the field is editable
type:
type: FieldType
docs: Choose these appropriate field type for your collection data
slug:
type: optional<string>
docs: >-
Slug of Field in Site URL structure. Slugs should be all lowercase
with no spaces. Any spaces will be converted to "-."
displayName:
type: string
docs: The name of a field
helpText:
type: optional<string>
docs: Additional text to help anyone filling out this field
source:
openapi: ../../../referenced-specs/v2.yml
Collection:
docs: A collection object
properties:
id:
type: string
docs: Unique identifier for a Collection
displayName:
type: optional<string>
docs: Name given to the Collection
singularName:
type: optional<string>
docs: >-
The name of one Item in Collection (e.g. ”Blog Post” if the Collection
is called “Blog Posts”)
slug:
type: optional<string>
docs: Slug of Collection in Site URL structure
createdOn:
type: optional<datetime>
docs: The date the collection was created
lastUpdated:
type: optional<datetime>
docs: The date the collection was last updated
fields:
docs: The list of fields in the Collection
type: list<Field>
source:
openapi: ../../../referenced-specs/v2.yml
CollectionItemFieldData:
properties:
name:
type: string
docs: Name of the Item
slug:
type: string
docs: >-
URL structure of the Item in your site. Note: Updates to an item slug
will break all links referencing the old slug.
extra-properties: true
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
CollectionItem:
docs: >
The fields that define the schema for a given Item are based on the
Collection that Item belongs to. Beyond the user defined fields, there are
a handful of additional fields that are automatically created for all
items
properties:
id:
type: optional<string>
docs: Unique identifier for the Item
cmsLocaleId:
type: optional<string>
docs: Identifier for the locale of the CMS item
lastPublished:
type: optional<string>
docs: The date the item was last published
lastUpdated:
type: optional<string>
docs: The date the item was last updated
createdOn:
type: optional<string>
docs: The date the item was created
isArchived:
type: optional<boolean>
docs: Boolean determining if the Item is set to archived
default: false
isDraft:
type: optional<boolean>
docs: Boolean determining if the Item is set to draft
default: false
fieldData: CollectionItemFieldData
source:
openapi: ../../../referenced-specs/v2.yml
CollectionItemListPagination:
properties:
limit:
type: optional<double>
docs: The limit specified in the request
default: 100
offset:
type: optional<double>
docs: The offset specified for pagination
default: 0
total:
type: optional<double>
docs: Total number of items in the collection
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
CollectionItemList:
docs: Results from collection items list
properties:
items:
type: optional<list<CollectionItem>>
docs: List of Items within the collection
pagination: optional<CollectionItemListPagination>
source:
openapi: ../../../referenced-specs/v2.yml
CollectionItemPostSingleFieldData:
properties:
name:
type: string
docs: Name of the Item
slug:
type: string
docs: >-
URL structure of the Item in your site. Note: Updates to an item slug
will break all links referencing the old slug.
extra-properties: true
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
CollectionItemPostSingle:
docs: >
The fields that define the schema for a given Item are based on the
Collection that Item belongs to. Beyond the user defined fields, there are
a handful of additional fields that are automatically created for all
items
properties:
id:
type: optional<string>
docs: Unique identifier for the Item
cmsLocaleId:
type: optional<string>
docs: Identifier for the locale of the CMS item
lastPublished:
type: optional<string>
docs: The date the item was last published
lastUpdated:
type: optional<string>
docs: The date the item was last updated
createdOn:
type: optional<string>
docs: The date the item was created
isArchived:
type: optional<boolean>
docs: Boolean determining if the Item is set to archived
default: false
isDraft:
type: optional<boolean>
docs: Boolean determining if the Item is set to draft
default: false
fieldData: CollectionItemPostSingleFieldData
source:
openapi: ../../../referenced-specs/v2.yml
CollectionItemWithIdInputFieldData:
properties:
name:
type: optional<string>
docs: Name of the Item
slug:
type: optional<string>
docs: >-
URL structure of the Item in your site. Note: Updates to an item slug
will break all links referencing the old slug.
extra-properties: true
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
CollectionItemWithIdInput:
docs: >
The fields that define the schema for a given Item are based on the
Collection that Item belongs to. Beyond the user defined fields, there are
a handful of additional fields that are automatically created for all
items
properties:
id:
type: string
docs: Unique identifier for the Item
cmsLocaleId:
type: optional<string>
docs: Identifier for the locale of the CMS item
lastPublished:
type: optional<string>
docs: The date the item was last published
lastUpdated:
type: optional<string>
docs: The date the item was last updated
createdOn:
type: optional<string>
docs: The date the item was created
isArchived:
type: optional<boolean>
docs: Boolean determining if the Item is set to archived
default: false
isDraft:
type: optional<boolean>
docs: Boolean determining if the Item is set to draft
default: false
fieldData: optional<CollectionItemWithIdInputFieldData>
source:
openapi: ../../../referenced-specs/v2.yml
CollectionItemListNoPagination:
docs: Results from collection items list
properties:
items:
type: optional<list<CollectionItem>>
docs: List of Items within the collection
source:
openapi: ../../../referenced-specs/v2.yml
BulkCollectionItemFieldData:
properties:
name:
type: optional<string>
docs: Name of the Item
slug:
type: optional<string>
docs: >-
URL structure of the Item in your site. Note: Updates to an item slug
will break all links referencing the old slug.
extra-properties: true
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
BulkCollectionItem:
docs: >
The fields that define the schema for a given Item are based on the
Collection that Item belongs to. Beyond the user defined fields, there are
a handful of additional fields that are automatically created for all
items
properties:
id:
type: string
docs: Unique identifier for the Item
cmsLocaleIds:
type: optional<list<string>>
docs: Array of identifiers for the locales where the item will be created
lastPublished:
type: optional<string>
docs: The date the item was last published
lastUpdated:
type: optional<string>
docs: The date the item was last updated
createdOn:
type: optional<string>
docs: The date the item was created
isArchived:
type: optional<boolean>
docs: Boolean determining if the Item is set to archived
default: false
isDraft:
type: optional<boolean>
docs: Boolean determining if the Item is set to draft
default: false
fieldData: optional<BulkCollectionItemFieldData>
source:
openapi: ../../../referenced-specs/v2.yml
CollectionItemPatchSingleFieldData:
properties:
name:
type: optional<string>
docs: Name of the Item
slug:
type: optional<string>
docs: >-
URL structure of the Item in your site. Note: Updates to an item slug
will break all links referencing the old slug.
extra-properties: true
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
CollectionItemPatchSingle:
docs: >
The fields that define the schema for a given Item are based on the
Collection that Item belongs to. Beyond the user defined fields, there are
a handful of additional fields that are automatically created for all
items
properties:
id:
type: optional<string>
docs: Unique identifier for the Item
cmsLocaleId:
type: optional<string>
docs: Identifier for the locale of the CMS item
lastPublished:
type: optional<string>
docs: The date the item was last published
lastUpdated:
type: optional<string>
docs: The date the item was last updated
createdOn:
type: optional<string>
docs: The date the item was created
isArchived:
type: optional<boolean>
docs: Boolean determining if the Item is set to archived
default: false
isDraft:
type: optional<boolean>
docs: Boolean determining if the Item is set to draft
default: false
fieldData: optional<CollectionItemPatchSingleFieldData>
source:
openapi: ../../../referenced-specs/v2.yml
PageSeo:
docs: SEO-related fields for the Page
properties:
title:
type: optional<string>
docs: The Page title shown in search engine results
description:
type: optional<string>
docs: The Page description shown in search engine results
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
PageOpenGraph:
docs: Open Graph fields for the Page
properties:
title:
type: optional<string>
docs: The title supplied to Open Graph annotations
titleCopied:
type: optional<boolean>
docs: Indicates the Open Graph title was copied from the SEO title
default: true
description:
type: optional<string>
docs: The description supplied to Open Graph annotations
descriptionCopied:
type: optional<boolean>
docs: >-
Indicates the Open Graph description was copied from the SEO
description
default: true
source:
openapi: ../../../referenced-specs/v2.yml
inline: true
Page:
docs: The Page object
properties:
id:
type: string
docs: Unique identifier for the Page
siteId:
type: optional<string>
docs: Unique identifier for the Site
title:
type: optional<string>
docs: Title of the Page
slug:
type: optional<string>
docs: slug of the Page (derived from title)
parentId:
type: optional<string>
docs: Identifier of the parent folder
collectionId:
type: optional<string>
docs: >-
Unique identifier for a linked Collection, value will be null if the
Page is not part of a Collection.
createdOn:
type: optional<datetime>
docs: The date the Page was created
lastUpdated:
type: optional<datetime>
docs: The date the Page was most recently updated
archived:
type: optional<boolean>
docs: Whether the Page has been archived
default: false
draft:
type: optional<boolean>
docs: Whether the Page is a draft
default: false
canBranch:
type: optional<boolean>
docs: >-
Indicates whether the Page supports [Page
Branching](https://university.webflow.com/lesson/page-branching)
default: false
isBranch:
type: optional<boolean>
docs: >-
Indicates whether the Page is a Branch of another Page [Page
Branching](https://university.webflow.com/lesson/page-branching)
default: false
isMembersOnly:
type: optional<boolean>
docs: >-
Indicates whether the Page is restricted by [Memberships
Controls](https://university.webflow.com/lesson/webflow-memberships-overview#how-to-manage-page-restrictions)
default: false
seo:
type: optional<PageSeo>
docs: SEO-related fields for the Page
openGraph:
type: optional<PageOpenGraph>
docs: Open Graph fields for the Page
localeId:
type: optional<string>
docs: Unique ID of the page locale
publishedPath:
type: optional<string>
docs: Relative path of the published page URL
source:
openapi: ../../../referenced-specs/v2.yml
PageList:
docs: The Page object
properties:
pages: optional<list<Page>>
pagination: optional<Pagination>
source:
openapi: ../../../referenced-specs/v2.yml
TextNode:
docs: >
Represents textual content within the DOM. It contains both the raw text
and its HTML representation, allowing for flexibility in rendering and
processing. Additional attributes can be associated with the text for
styling or other purposes.
properties:
html: optional<string>
text: optional<string>
source:
openapi: ../../../referenced-specs/v2.yml
ImageNode:
docs: >
Represents an image within the DOM. It contains details about the image,
such as its alternative text (alt) for accessibility and an asset
identifier for fetching the actual image resource. Additional attributes
can be associated with the image for styling or other purposes.
properties:
alt: optional<string>
assetId: optional<string>
source:
openapi: ../../../referenced-specs/v2.yml
NodeType:
enum:
- text
- image
source:
openapi: ../../../referenced-specs/v2.yml
Node:
docs: >
A generic representation of a content element within the Document Object
Model (DOM). Each node has a unique identifier and a specific type that
determines its content structure and attributes.
properties:
id:
type: optional<string>
docs: Node UUID
type: optional<NodeType>
text: optional<TextNode>
image: optional<ImageNode>
attributes:
type: optional<map<string, string>>
docs: The custom attributes of the node
source:
openapi: ../../../referenced-specs/v2.yml
Dom:
docs: >
The DOM (Document Object Model) schema represents the content structure of
a web page. It captures various content nodes, such as text and images,
along with their associated attributes. Each node has a unique identifier
and can be of different types like text or image. The schema also provides
pagination details for scenarios where the content nodes are too many to
be fetched in a single request.
properties:
pageId:
type: optional<string>
docs: Page ID
nodes: optional<list<Node>>
pagination: optional<Pagination>
source:
openapi: ../../../referenced-specs/v2.yml
ScriptApplyLocation:
enum:
- header
- footer
docs: >-
Location of the script, either in the header or footer of the published
site
default: header
source:
openapi: ../../../referenced-specs/v2.yml
ScriptApply: