{"openapi":"3.1.0","info":{"title":"MCS Blueprint Public Data API","description":"Read-only integration API for public data and the current account's blueprints and favourites. Create a key with only the scopes your integration needs; all writes stay in the website session.","contact":{"name":"MCSTools contributors"},"license":{"name":"MCS 蓝图站服务许可"},"version":"0.1.0"},"paths":{"/api/v1/account/blueprints":{"get":{"tags":["account"],"operationId":"listOwnedBlueprints","parameters":[{"name":"cursor","in":"query","description":"Legacy cursor; do not combine with page or library filters","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Library page, with totalCount, totalPages and owner-wide status counts","required":false,"schema":{"type":"integer","format":"int32","maximum":10000,"minimum":1}},{"name":"filter","in":"query","description":"all (default, includes private/pending), active, archived, deleted, public, unlisted, private, pending, approved, rejected, restricted, processing","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Literal title/summary search, at most 120 characters","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","description":"Category slug; includes direct child categories","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Current source format","required":false,"schema":{"type":"string"}},{"name":"gameVersion","in":"query","description":"Parsed Minecraft version family","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"updated (default) or created, newest first","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size from 1 through 50","required":false,"schema":{"type":"integer","format":"int32","maximum":50,"minimum":1}}],"responses":{"200":{"description":"Private current-account blueprint page across visibility, moderation and archive states","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Vary":{"schema":{"type":"string"},"description":"Authentication-context variance"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnedBlueprintListResponse"}}}},"400":{"description":"Malformed cursor or query","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Authentication or database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"apiKeyBearer":[]}],"x-mcs-required-scope":"account:read"}},"/api/v1/account/favourites":{"get":{"tags":["account"],"operationId":"listAccountFavourites","parameters":[{"name":"cursor","in":"query","description":"Opaque favourites cursor","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size, maximum 50","required":false,"schema":{"type":"integer","format":"int32","minimum":0}}],"responses":{"200":{"description":"Private favourites with neutral unavailable context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavouriteListResponse"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"apiKeyBearer":[]}],"x-mcs-required-scope":"account:read"}},"/api/v1/blueprints":{"get":{"tags":["discovery"],"operationId":"listPublicBlueprints","parameters":[{"name":"sort","in":"query","description":"latest/oldest 按更新时间降序/升序；popular/least_popular 按热度降序/升序。同值按时间及 ID 排序。featured 保留兼容。","required":false,"schema":{"$ref":"#/components/schemas/DiscoverySort"}},{"name":"extra","in":"query","description":"额外状态 private,pending,rejected，逗号分隔。登录后默认附加自己的私有与待审核作品；none 仅公开。私有作品仅本人可见，管理员可查看其他人的非私有待审核及未通过作品。","required":false,"schema":{"type":"string"}},{"name":"featured","in":"query","description":"仅编辑精选，与排序独立","required":false,"schema":{"type":"boolean"}},{"name":"category","in":"query","description":"Active managed category slug","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Current source format","required":false,"schema":{"$ref":"#/components/schemas/SourceFormat"}},{"name":"gameVersion","in":"query","description":"源文件游戏版本：java-1.7.10、java-1.12 至 java-1.21、bedrock 或 unknown；不是作品版本号","required":false,"schema":{"type":"string"}},{"name":"mod","in":"query","description":"服务端解析出的模组 namespace","required":false,"schema":{"type":"string"}},{"name":"creator","in":"query","description":"Published creator handle","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Literal title, description or creator text filter","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Opaque cursor bound to sort and filters","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"One-based offset page, mutually exclusive with cursor","required":false,"schema":{"type":"integer","format":"int32","maximum":10000,"minimum":1}},{"name":"limit","in":"query","description":"Page size from 1 through 50","required":false,"schema":{"type":"integer","format":"int32","maximum":50,"minimum":1}}],"responses":{"200":{"description":"Bounded public blueprint card page","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public discovery cache policy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintListResponse"}}}},"400":{"description":"Malformed filter or cursor","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/mod-facets":{"get":{"tags":["discovery"],"operationId":"discovery_mod_facets","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"$ref":"#/components/schemas/SourceFormat"}},{"name":"gameVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"creator","in":"query","required":false,"schema":{"type":"string"}},{"name":"extra","in":"query","required":false,"schema":{"type":"string"}},{"name":"featured","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Complete visible mod counts, independent of pagination and selected mod","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintModFacetsResponse"}}}},"400":{"description":"Invalid filter"},"429":{"description":"Rate limited"}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}":{"get":{"tags":["blueprints"],"operationId":"getBlueprint","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Policy-filtered current blueprint detail with stable media URLs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintDetail"}}}},"400":{"description":"Malformed blueprint UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Presented authentication is invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Missing or policy-hidden blueprint","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/comments":{"get":{"tags":["comments"],"operationId":"listBlueprintCommentRoots","parameters":[{"name":"blueprint_id","in":"path","description":"Exact public or unlisted blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","description":"Opaque newest-first cursor bound to this blueprint","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size from 1 through 30","required":false,"schema":{"type":"integer","format":"int32","maximum":30,"minimum":1}}],"responses":{"200":{"description":"Bounded public root comments and oldest visible reply previews with no viewer-personal state","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Shared bounded comment cache policy"},"Cache-Tag":{"schema":{"type":"string"},"description":"Per-blueprint comment cache tag"},"Surrogate-Key":{"schema":{"type":"string"},"description":"Per-blueprint comment cache tag"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintCommentRootPageResponse"}}}},"400":{"description":"INVALID_REQUEST: malformed UUID, cursor or query","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"BLUEPRINT_NOT_FOUND: blueprint is missing or not anonymously discussion-readable","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE: database access is unavailable","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/comments/{root_comment_id}/replies":{"get":{"tags":["comments"],"operationId":"listBlueprintCommentReplies","parameters":[{"name":"blueprint_id","in":"path","description":"Exact public or unlisted blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"root_comment_id","in":"path","description":"Root comment UUID within this blueprint","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","description":"Opaque oldest-first cursor bound to the blueprint and root","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size from 1 through 50","required":false,"schema":{"type":"integer","format":"int32","maximum":50,"minimum":1}}],"responses":{"200":{"description":"Bounded oldest-first visible replies with no viewer-personal state","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Shared bounded comment cache policy"},"Cache-Tag":{"schema":{"type":"string"},"description":"Per-blueprint comment cache tag"},"Surrogate-Key":{"schema":{"type":"string"},"description":"Per-blueprint comment cache tag"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintCommentReplyPageResponse"}}}},"400":{"description":"INVALID_REQUEST: malformed UUID, cursor or query","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"COMMENT_NOT_FOUND: blueprint or public root thread is unavailable","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE: database access is unavailable","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/versions":{"get":{"tags":["blueprints"],"operationId":"listBlueprintVersions","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","description":"Opaque version cursor returned by the prior page","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size from 1 through 100","required":false,"schema":{"type":"integer","format":"int32","maximum":100,"minimum":1}}],"responses":{"200":{"description":"Immutable versions ordered by version number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionListResponse"}}}},"400":{"description":"Malformed UUID, cursor, or limit","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Presented authentication is invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Missing or policy-hidden blueprint","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/versions/{version_number}":{"get":{"tags":["blueprints"],"operationId":"getBlueprintVersion","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version_number","in":"path","description":"Positive blueprint-scoped version number","required":true,"schema":{"type":"integer","format":"int32","minimum":1}}],"responses":{"200":{"description":"Immutable version detail with stable media URLs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintVersionDetail"}}}},"400":{"description":"Malformed UUID or version number","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Presented authentication is invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Missing or policy-hidden version","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/versions/{version_number}/download":{"get":{"tags":["blueprints"],"operationId":"downloadBlueprintVersion","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version_number","in":"path","description":"Positive blueprint-scoped version number","required":true,"schema":{"type":"integer","format":"int32","minimum":1}}],"responses":{"307":{"description":"Authorized redirect to a short-lived exact source object","headers":{"Location":{"schema":{"type":"string"},"description":"Short-lived object URL"}}},"400":{"description":"Malformed UUID or version number","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Presented authentication is invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Missing or policy-hidden version","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database or object storage unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/versions/{version_number}/images/{position}":{"get":{"tags":["blueprints"],"operationId":"previewBlueprintVersionImage","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version_number","in":"path","description":"Positive blueprint-scoped version number","required":true,"schema":{"type":"integer","format":"int32","minimum":1}},{"name":"position","in":"path","description":"Gallery position from 0 through 5","required":true,"schema":{"type":"integer","format":"int32","maximum":5,"minimum":0}}],"responses":{"200":{"description":"Inline exact gallery image bytes"},"307":{"description":"Authorized redirect to the exact gallery image object","headers":{"Location":{"schema":{"type":"string"},"description":"Short-lived object URL"}}},"404":{"description":"Missing, policy-hidden, or gallery-less image","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database or object storage unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/versions/{version_number}/preview":{"get":{"tags":["blueprints"],"operationId":"previewBlueprintVersion","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version_number","in":"path","description":"Positive blueprint-scoped version number","required":true,"schema":{"type":"integer","format":"int32","minimum":1}}],"responses":{"307":{"description":"Authorized redirect to the exact preview object or CDN URL","headers":{"Location":{"schema":{"type":"string"},"description":"Preview object URL"}}},"400":{"description":"Malformed UUID or version number","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Presented authentication is invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Missing, policy-hidden, or preview-less version","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database or object storage unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/blueprints/{blueprint_id}/versions/{version_number}/source":{"get":{"tags":["blueprints"],"operationId":"readBlueprintVersionSource","parameters":[{"name":"blueprint_id","in":"path","description":"Stable public blueprint UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version_number","in":"path","description":"Positive blueprint-scoped version number","required":true,"schema":{"type":"integer","format":"int32","minimum":1}}],"responses":{"200":{"description":"Inline exact source bytes for browser preview"},"307":{"description":"Authorized redirect to a short-lived inline source object","headers":{"Location":{"schema":{"type":"string"},"description":"Short-lived object URL"}}},"400":{"description":"Malformed UUID or version number","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Presented authentication is invalid","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Missing or policy-hidden version","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database or object storage unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/categories":{"get":{"tags":["discovery"],"operationId":"listBlueprintCategories","responses":{"200":{"description":"Active managed categories in stable display order","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public discovery cache policy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintCategoryListResponse"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/categories/{category_id}/cover":{"get":{"tags":["discovery"],"operationId":"getCategoryCover","parameters":[{"name":"category_id","in":"path","description":"Category UUID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Public category cover image bytes"},"307":{"description":"Validated public object redirect"},"404":{"description":"Category or cover is unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"OBJECT_STORAGE_UNAVAILABLE: cover storage unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/community/discussions":{"get":{"tags":["community"],"operationId":"listRecentCommunityDiscussions","parameters":[{"name":"cursor","in":"query","description":"Opaque newest-first chronological cursor","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size from 1 through 30","required":false,"schema":{"type":"integer","format":"int32","maximum":30,"minimum":1}}],"responses":{"200":{"description":"Chronological visible comments on currently discoverable public blueprints","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Shared bounded community cache policy"},"Cache-Tag":{"schema":{"type":"string"},"description":"Community cache tag"},"Surrogate-Key":{"schema":{"type":"string"},"description":"Community cache tag"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecentDiscussionPageResponse"}}}},"400":{"description":"INVALID_REQUEST: malformed cursor or query","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE: database access is unavailable","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/community/posts":{"get":{"tags":["community"],"operationId":"listCommunityPosts","parameters":[{"name":"cursor","in":"query","description":"Opaque newest-activity-first cursor","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","description":"Optional discussion or help filter","required":false,"schema":{"$ref":"#/components/schemas/CommunityPostKind"}},{"name":"status","in":"query","description":"Optional open, solved, or closed filter","required":false,"schema":{"$ref":"#/components/schemas/CommunityPostStatus"}},{"name":"q","in":"query","description":"Optional keyword matched against title, body, or author","required":false,"schema":{"type":"string","maxLength":80}},{"name":"limit","in":"query","description":"Page size from 1 through 30","required":false,"schema":{"type":"integer","format":"int32","maximum":30,"minimum":1}}],"responses":{"200":{"description":"Visible community topics ordered by latest activity","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Shared bounded community cache policy"},"Cache-Tag":{"schema":{"type":"string"},"description":"Community cache tag"},"Surrogate-Key":{"schema":{"type":"string"},"description":"Community cache tag"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityPostPageResponse"}}}},"400":{"description":"INVALID_REQUEST: malformed cursor or query","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE: database access is unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/community/posts/{post_id}":{"get":{"tags":["community"],"operationId":"getCommunityPost","parameters":[{"name":"post_id","in":"path","description":"Community topic UUID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Visible community topic","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityPostResponse"}}}},"400":{"description":"INVALID_REQUEST: malformed UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"COMMUNITY_POST_NOT_FOUND","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/community/posts/{post_id}/replies":{"get":{"tags":["community"],"operationId":"listCommunityPostReplies","parameters":[{"name":"post_id","in":"path","description":"Community topic UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","description":"Opaque oldest-first reply cursor","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size from 1 through 50","required":false,"schema":{"type":"integer","format":"int32","maximum":50,"minimum":1}}],"responses":{"200":{"description":"Visible replies ordered oldest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityPostReplyPageResponse"}}}},"400":{"description":"INVALID_REQUEST","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"COMMUNITY_POST_NOT_FOUND","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/creators":{"get":{"tags":["discovery"],"operationId":"listPublicCreators","parameters":[{"name":"cursor","in":"query","description":"Opaque cursor returned by the prior page","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"One-based offset page, mutually exclusive with cursor","required":false,"schema":{"type":"integer","format":"int32","maximum":10000,"minimum":1}},{"name":"limit","in":"query","description":"Page size from 1 through 50","required":false,"schema":{"type":"integer","format":"int32","maximum":50,"minimum":1}}],"responses":{"200":{"description":"Published creators with discoverable work","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public discovery cache policy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorListResponse"}}}},"400":{"description":"Malformed cursor","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/creators/{account_id}/avatar":{"get":{"tags":["discovery"],"operationId":"getCreatorAvatar","parameters":[{"name":"account_id","in":"path","description":"Creator account UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revision","in":"query","description":"Optional media revision used for cache validation","required":false,"schema":{"type":"integer","format":"int64","minimum":0}}],"responses":{"200":{"description":"Creator avatar bytes"},"304":{"description":"Avatar has not changed for the requested revision"},"404":{"description":"CREATOR_MEDIA_NOT_FOUND: no public avatar is available","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE or STORAGE_UNAVAILABLE: media is unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/creators/{account_id}/background":{"get":{"tags":["discovery"],"operationId":"getCreatorBackground","parameters":[{"name":"account_id","in":"path","description":"Creator account UUID","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revision","in":"query","description":"Optional media revision used for cache validation","required":false,"schema":{"type":"integer","format":"int64","minimum":0}}],"responses":{"200":{"description":"Creator background image or GIF bytes"},"304":{"description":"Background has not changed for the requested revision"},"404":{"description":"CREATOR_MEDIA_NOT_FOUND: no public background is available","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"DATABASE_UNAVAILABLE or STORAGE_UNAVAILABLE: media is unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/creators/{handle}":{"get":{"tags":["discovery"],"operationId":"getPublicCreator","parameters":[{"name":"handle","in":"path","description":"Stable published creator handle","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Eligible public creator profile","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public discovery cache policy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorDetail"}}}},"404":{"description":"Missing, unpublished or ineligible creator","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/creators/{handle}/favourites":{"get":{"tags":["discovery"],"operationId":"listPublicCreatorFavourites","parameters":[{"name":"handle","in":"path","description":"Stable published creator handle","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"One-based offset page","required":false,"schema":{"type":"integer","format":"int32","maximum":10000,"minimum":1}},{"name":"limit","in":"query","description":"Page size from 1 through 50","required":false,"schema":{"type":"integer","format":"int32","maximum":50,"minimum":1}}],"responses":{"200":{"description":"Public, approved blueprints favourited by the creator","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public discovery cache policy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlueprintListResponse"}}}},"404":{"description":"Missing or unpublished creator","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/discovery/home":{"get":{"tags":["discovery"],"operationId":"getHomeDiscovery","responses":{"200":{"description":"Bounded public categories, editor-featured/popular/latest blueprints and creators","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public discovery cache policy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HomeDiscoveryResponse"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/discovery/random":{"get":{"tags":["discovery"],"operationId":"getRandomDiscovery","parameters":[{"name":"seed","in":"query","description":"Opaque refresh seed, 1-128 characters","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Number of cards, from 1 through 12","required":false,"schema":{"type":"integer","format":"int32","maximum":12,"minimum":1}}],"responses":{"200":{"description":"Bounded public random recommendation window","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"No-store response; refreshes are independently seeded"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RandomDiscoveryResponse"}}}},"400":{"description":"Malformed seed or limit","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED: public process window exceeded","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Database unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/openapi.json":{"get":{"tags":["site"],"operationId":"getOpenApiDocument","parameters":[{"name":"audience","in":"query","description":"`developer` (or omitted) returns the public read-only integration projection; `internal` requires an active administrator session","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The current OpenAPI 3 document"},"400":{"description":"INVALID_REQUEST: audience must be developer or internal","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"AUTH_REQUIRED: internal audience requires an administrator session","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"FORBIDDEN: internal audience is limited to active administrators","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"API_RATE_LIMITED or API_KEY_RATE_LIMITED: source-network or API-key window exceeded; retry after Retry-After","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Always private, no-store"},"Retry-After":{"schema":{"type":"string"},"description":"Whole seconds until the source or API-key window resets"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}},"/api/v1/search":{"get":{"tags":["search"],"operationId":"searchBlueprints","parameters":[{"name":"query","in":"query","description":"Text query, 1-200 characters","required":true,"schema":{"type":"string"}},{"name":"category","in":"query","description":"Active managed category slug","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Current source format","required":false,"schema":{"$ref":"#/components/schemas/SourceFormat"}},{"name":"creator","in":"query","description":"Published creator handle","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Opaque query-bound score cursor","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size, maximum 50","required":false,"schema":{"type":"integer","format":"int32","minimum":0}}],"responses":{"200":{"description":"Bounded public search results without engagement evidence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPageResponse"}}}},"404":{"description":"SEARCH_UNAVAILABLE: search capability is disabled or not in the caller's canary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"SEARCH_RATE_LIMITED: per-client search limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{},{"apiKeyBearer":[]}],"x-mcs-required-scope":"public:read"}}},"components":{"schemas":{"Attribution":{"type":"string","enum":["unknown","original","repost"]},"BlockDimensions":{"type":"object","required":["x","y","z"],"properties":{"x":{"type":"integer","format":"int32","minimum":0},"y":{"type":"integer","format":"int32","minimum":0},"z":{"type":"integer","format":"int32","minimum":0}},"additionalProperties":false},"BlueprintAccessState":{"type":"string","description":"Administrator access override, independent from editorial moderation and\nthe owner's requested visibility.","enum":["normal","limited","owner_only"]},"BlueprintAuthor":{"type":"object","required":["id","displayName"],"properties":{"avatarUrl":{"type":["string","null"]},"displayName":{"type":"string"},"id":{"type":"string","format":"uuid"},"level":{"type":["integer","null"],"format":"int32","description":"Display-only account level. It has no permission, ranking or quota effect.","minimum":0}}},"BlueprintCategory":{"type":"object","required":["id","slug","name","description","sortOrder"],"properties":{"blueprintCount":{"type":["integer","null"],"format":"int64","minimum":0},"coverUrl":{"type":["string","null"],"maxLength":2048},"description":{"type":"string"},"iconKey":{"type":["string","null"],"maxLength":64},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"parentId":{"type":["string","null"],"format":"uuid"},"slug":{"type":"string"},"sortOrder":{"type":"integer","format":"int32"}}},"BlueprintCategoryListResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintCategory"}}}},"BlueprintCommentAuthorResponse":{"type":"object","description":"Public author projection. Account UUID, provider identity, role, status and\npermissions are intentionally absent.","required":["displayName","blueprintOwner"],"properties":{"avatarUrl":{"type":["string","null"]},"blueprintOwner":{"type":"boolean"},"creatorHandle":{"type":["string","null"]},"displayName":{"type":"string"},"level":{"type":["integer","null"],"format":"int32","description":"Display-only account level for the public avatar badge.","minimum":0}}},"BlueprintCommentReplyPageResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintCommentReplyResponse"}},"nextCursor":{"type":["string","null"]}}},"BlueprintCommentReplyResponse":{"type":"object","required":["comment","rootCommentId","replyTo"],"properties":{"comment":{"$ref":"#/components/schemas/PublicBlueprintCommentResponse"},"replyTo":{"$ref":"#/components/schemas/BlueprintCommentReplyTargetResponse"},"rootCommentId":{"type":"string","format":"uuid"}}},"BlueprintCommentReplyTargetResponse":{"type":"object","required":["commentId"],"properties":{"commentId":{"type":"string","format":"uuid"},"displayName":{"type":["string","null"]}}},"BlueprintCommentRootPageResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintCommentRootResponse"}},"nextCursor":{"type":["string","null"]}}},"BlueprintCommentRootResponse":{"type":"object","required":["comment","visibleReplyCount","replyPreview"],"properties":{"comment":{"$ref":"#/components/schemas/PublicBlueprintCommentResponse"},"replyPreview":{"$ref":"#/components/schemas/BlueprintCommentReplyPageResponse"},"visibleReplyCount":{"type":"integer","format":"int64","minimum":0}}},"BlueprintDeletionSource":{"type":"string","enum":["user","administrator"]},"BlueprintDetail":{"type":"object","required":["id","slug","title","description","contentMarkdown","author","visibility","attribution","featured","moderationState","anonymouslyReadable","revision","viewerCapabilities","currentVersion","originalSourceByteSize","downloadUrl","engagement","createdAt","updatedAt"],"properties":{"anonymouslyReadable":{"type":"boolean"},"archivedAt":{"type":["string","null"],"format":"date-time"},"attribution":{"$ref":"#/components/schemas/Attribution"},"author":{"$ref":"#/components/schemas/BlueprintAuthor"},"category":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BlueprintCategory"}]},"contentMarkdown":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"creatorHandle":{"type":["string","null"],"description":"Public creator route key when the author has a published profile."},"currentVersion":{"$ref":"#/components/schemas/BlueprintVersionSummary"},"description":{"type":"string"},"downloadUrl":{"type":"string"},"engagement":{"$ref":"#/components/schemas/BlueprintEngagement"},"featured":{"type":"boolean"},"id":{"type":"string","format":"uuid"},"moderationState":{"$ref":"#/components/schemas/ModerationState"},"originalSourceByteSize":{"type":"integer","format":"int64","minimum":0},"previewImages":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintPreviewImage"}},"previewUrl":{"type":["string","null"]},"revision":{"type":"integer","format":"int64"},"slug":{"type":"string"},"sourceUrl":{"type":["string","null"]},"title":{"type":"string"},"trustedAnalysis":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TrustedAnalysis"}]},"updatedAt":{"type":"string","format":"date-time"},"videos":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintVideo"}},"viewerCapabilities":{"$ref":"#/components/schemas/BlueprintViewerCapabilities"},"viewerSourceByteSize":{"type":["integer","null"],"format":"int64","minimum":0},"viewerSourceFormat":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceFormat"}]},"visibility":{"$ref":"#/components/schemas/Visibility"}}},"BlueprintEngagement":{"type":"object","description":"Public display counters. They are never used as discovery ordering input.","required":["viewCount","downloadCount","likeCount","favouriteCount"],"properties":{"downloadCount":{"type":"integer","format":"int64","minimum":0},"favouriteCount":{"type":"integer","format":"int64","minimum":0},"likeCount":{"type":"integer","format":"int64","minimum":0},"viewCount":{"type":"integer","format":"int64","minimum":0}}},"BlueprintListResponse":{"type":"object","required":["items","totalCount"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintSummary"}},"nextCursor":{"type":["string","null"]},"page":{"type":["integer","null"],"format":"int64","description":"Present when the request used one-based offset pagination."},"pageSize":{"type":["integer","null"],"format":"int64"},"totalCount":{"type":"integer","format":"int64"},"totalPages":{"type":["integer","null"],"format":"int64"}}},"BlueprintModFacetResponse":{"type":"object","required":["namespace","count","iconUrl"],"properties":{"count":{"type":"integer","format":"int64"},"iconUrl":{"type":"string"},"namespace":{"type":"string"}}},"BlueprintModFacetsResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintModFacetResponse"}}}},"BlueprintPreservationState":{"type":"string","enum":["none","dispute"]},"BlueprintPreviewImage":{"type":"object","required":["url","source","role","position"],"properties":{"position":{"type":"integer","format":"int32","minimum":0},"role":{"$ref":"#/components/schemas/BlueprintPreviewImageRole"},"source":{"$ref":"#/components/schemas/BlueprintPreviewImageSource"},"url":{"type":"string"}}},"BlueprintPreviewImageRole":{"type":"string","enum":["cover","preview"]},"BlueprintPreviewImageSource":{"type":"string","enum":["user_upload","automatic"]},"BlueprintProcessingStage":{"type":"string","enum":["queued","reading_source","decoding","analysing","encoding","storing","ready","failed"]},"BlueprintProcessingStatus":{"type":"object","required":["stage","progressBasisPoints"],"properties":{"estimatedCompletionAt":{"type":["string","null"],"format":"date-time"},"progressBasisPoints":{"type":"integer","format":"int32","description":"Integer hundredths of one percent, from 0 through 10000.","minimum":0},"stage":{"$ref":"#/components/schemas/BlueprintProcessingStage"},"startedAt":{"type":["string","null"],"format":"date-time"}}},"BlueprintSummary":{"type":"object","required":["id","slug","title","description","attribution","author","featured","currentVersion","engagement","createdAt","updatedAt"],"properties":{"attribution":{"$ref":"#/components/schemas/Attribution"},"author":{"$ref":"#/components/schemas/BlueprintAuthor"},"category":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BlueprintCategory"}]},"createdAt":{"type":"string","format":"date-time"},"creatorHandle":{"type":["string","null"]},"currentVersion":{"$ref":"#/components/schemas/BlueprintSummaryVersion"},"description":{"type":"string"},"engagement":{"$ref":"#/components/schemas/BlueprintEngagement"},"featured":{"type":"boolean"},"id":{"type":"string","format":"uuid"},"moderationState":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ModerationState"}]},"namespaces":{"type":"array","items":{"type":"string"},"description":"Trusted namespace tags extracted by the native analyser."},"previewUrl":{"type":["string","null"]},"slug":{"type":"string"},"sourceGameVersion":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceGameVersion"}]},"title":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"visibility":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Visibility"}]}}},"BlueprintSummaryVersion":{"type":"object","required":["number","sourceFormat","createdAt"],"properties":{"createdAt":{"type":"string","format":"date-time"},"number":{"type":"integer","format":"int32"},"sourceFormat":{"$ref":"#/components/schemas/SourceFormat"}}},"BlueprintVersionDetail":{"type":"object","required":["id","blueprintId","number","sourceFormat","originalFilename","validationState","processing","originalSourceByteSize","downloadUrl","createdAt"],"properties":{"blueprintId":{"type":"string","format":"uuid"},"changelog":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"downloadUrl":{"type":"string"},"id":{"type":"string","format":"uuid"},"number":{"type":"integer","format":"int32"},"originalFilename":{"type":"string"},"originalSourceByteSize":{"type":"integer","format":"int64","minimum":0},"previewImages":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintPreviewImage"}},"previewUrl":{"type":["string","null"]},"processing":{"$ref":"#/components/schemas/BlueprintProcessingStatus"},"sourceFormat":{"$ref":"#/components/schemas/SourceFormat"},"sourceUrl":{"type":["string","null"]},"trustedAnalysis":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TrustedAnalysis"}]},"validationState":{"$ref":"#/components/schemas/ValidationState"},"viewerSourceByteSize":{"type":["integer","null"],"format":"int64","minimum":0},"viewerSourceFormat":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceFormat"}]}}},"BlueprintVersionSummary":{"type":"object","required":["id","number","sourceFormat","validationState","processing","createdAt"],"properties":{"changelog":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"number":{"type":"integer","format":"int32"},"processing":{"$ref":"#/components/schemas/BlueprintProcessingStatus"},"sourceFormat":{"$ref":"#/components/schemas/SourceFormat"},"validationState":{"$ref":"#/components/schemas/ValidationState"}}},"BlueprintVideo":{"type":"object","required":["platform","videoId","url","embedUrl","position"],"properties":{"embedUrl":{"type":"string"},"platform":{"$ref":"#/components/schemas/BlueprintVideoPlatform"},"position":{"type":"integer","format":"int32","minimum":0},"url":{"type":"string"},"videoId":{"type":"string"}}},"BlueprintVideoPlatform":{"type":"string","enum":["bilibili","douyin"]},"BlueprintViewerCapabilities":{"type":"object","required":["canAppendVersion"],"properties":{"canAppendVersion":{"type":"boolean"}}},"CommunityPostAuthorResponse":{"type":"object","required":["displayName"],"properties":{"avatarUrl":{"type":["string","null"]},"creatorHandle":{"type":["string","null"]},"displayName":{"type":"string"},"level":{"type":["integer","null"],"format":"int32","description":"Display-only account level for the public avatar badge.","minimum":0}}},"CommunityPostKind":{"type":"string","enum":["discussion","help"]},"CommunityPostPageResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CommunityPostResponse"}},"nextCursor":{"type":["string","null"]}}},"CommunityPostReplyPageResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CommunityPostReplyResponse"}},"nextCursor":{"type":["string","null"]}}},"CommunityPostReplyResponse":{"type":"object","required":["id","postId","authorId","bodyMarkdown","author","revision","createdAt","updatedAt"],"properties":{"author":{"$ref":"#/components/schemas/CommunityPostAuthorResponse"},"authorId":{"type":"string","format":"uuid"},"bodyMarkdown":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"postId":{"type":"string","format":"uuid"},"revision":{"type":"integer","format":"int64"},"updatedAt":{"type":"string","format":"date-time"}}},"CommunityPostResponse":{"type":"object","required":["id","authorId","kind","status","title","bodyMarkdown","author","replyCount","revision","lastActivityAt","createdAt","updatedAt"],"properties":{"author":{"$ref":"#/components/schemas/CommunityPostAuthorResponse"},"authorId":{"type":"string","format":"uuid"},"bodyMarkdown":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"kind":{"$ref":"#/components/schemas/CommunityPostKind"},"lastActivityAt":{"type":"string","format":"date-time"},"replyCount":{"type":"integer","format":"int64","minimum":0},"revision":{"type":"integer","format":"int64"},"status":{"$ref":"#/components/schemas/CommunityPostStatus"},"title":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}}},"CommunityPostStatus":{"type":"string","enum":["open","solved","closed"]},"CreatorDetail":{"type":"object","required":["accountId","handle","displayName","blueprintCount","likeCount","favouriteCount","latestPublishedAt","showcaseBlueprints","profileRevision"],"properties":{"accountId":{"type":"string","format":"uuid"},"avatarUrl":{"type":["string","null"]},"backgroundUrl":{"type":["string","null"]},"bilibiliUrl":{"type":["string","null"]},"bio":{"type":["string","null"]},"blueprintCount":{"type":"integer","format":"int64","minimum":0},"displayName":{"type":"string"},"douyinUrl":{"type":["string","null"]},"favouriteCount":{"type":"integer","format":"int64","minimum":0},"handle":{"type":"string"},"latestPublishedAt":{"type":"string","format":"date-time"},"level":{"type":["integer","null"],"format":"int32","description":"Display-only account level. It has no permission, ranking or quota effect.","minimum":0},"likeCount":{"type":"integer","format":"int64","minimum":0},"profileRevision":{"type":"integer","format":"int64"},"showcaseBlueprints":{"type":"array","items":{"$ref":"#/components/schemas/CreatorShowcaseBlueprint"}}}},"CreatorListResponse":{"type":"object","required":["items","totalCount"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CreatorSummary"}},"nextCursor":{"type":["string","null"]},"page":{"type":["integer","null"],"format":"int64","description":"Present when the request used one-based offset pagination."},"pageSize":{"type":["integer","null"],"format":"int64"},"totalCount":{"type":"integer","format":"int64"},"totalPages":{"type":["integer","null"],"format":"int64"}}},"CreatorShowcaseBlueprint":{"type":"object","required":["id","slug","title"],"properties":{"id":{"type":"string","format":"uuid"},"previewUrl":{"type":["string","null"]},"slug":{"type":"string"},"title":{"type":"string"}}},"CreatorSummary":{"type":"object","required":["handle","displayName","blueprintCount","likeCount","favouriteCount","latestPublishedAt","showcaseBlueprints"],"properties":{"avatarUrl":{"type":["string","null"]},"bio":{"type":["string","null"]},"blueprintCount":{"type":"integer","format":"int64","minimum":0},"displayName":{"type":"string"},"favouriteCount":{"type":"integer","format":"int64","minimum":0},"handle":{"type":"string"},"latestPublishedAt":{"type":"string","format":"date-time"},"level":{"type":["integer","null"],"format":"int32","description":"Display-only account level. It has no permission, ranking or quota effect.","minimum":0},"likeCount":{"type":"integer","format":"int64","minimum":0},"showcaseBlueprints":{"type":"array","items":{"$ref":"#/components/schemas/CreatorShowcaseBlueprint"}}}},"DiscoverySort":{"type":"string","enum":["latest","oldest","popular","least_popular","featured"]},"DuplicateBlueprintReference":{"type":"object","description":"A public, bounded reference returned when a source file already belongs to\na blueprint the caller is allowed to discover. Private matches never use\nthis field.","required":["blueprintId","title","slug"],"properties":{"blueprintId":{"type":"string","format":"uuid"},"slug":{"type":"string"},"title":{"type":"string"}}},"FavouriteItemResponse":{"type":"object","description":"A favourite with a neutral public summary; title/slug are null when the\nblueprint is no longer publicly readable.","required":["blueprintId","favouritedAt"],"properties":{"blueprintId":{"type":"string","format":"uuid"},"blueprintUpdatedAt":{"type":["string","null"],"format":"date-time"},"categoryName":{"type":["string","null"]},"description":{"type":["string","null"]},"favouritedAt":{"type":"string","format":"date-time"},"previewUrl":{"type":["string","null"]},"slug":{"type":["string","null"]},"sourceFormat":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceFormat"}]},"title":{"type":["string","null"]},"versionNumber":{"type":["integer","null"],"format":"int32"}}},"FavouriteListResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/FavouriteItemResponse"}},"nextCursor":{"type":["string","null"]}}},"HomeDiscoveryResponse":{"type":"object","required":["categories","featured","popular","latest","creators"],"properties":{"categories":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintCategory"}},"creators":{"type":"array","items":{"$ref":"#/components/schemas/CreatorSummary"}},"featured":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintSummary"}},"latest":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintSummary"}},"popular":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintSummary"},"description":"Automatically ranked public works, separate from the editor-managed\nfeatured list. The ranking uses recent engagement counters."}}},"InvalidParameter":{"type":"object","required":["name","reason"],"properties":{"name":{"type":"string"},"reason":{"type":"string"}}},"ModerationState":{"type":"string","enum":["pending","approved","rejected","restricted"]},"OwnedBlueprintListResponse":{"type":"object","required":["items"],"properties":{"counts":{"type":["object","null"],"additionalProperties":{"type":"integer","format":"int64"},"propertyNames":{"type":"string"}},"items":{"type":"array","items":{"$ref":"#/components/schemas/OwnedBlueprintResponse"}},"nextCursor":{"type":["string","null"]},"page":{"type":["integer","null"],"format":"int64"},"totalCount":{"type":["integer","null"],"format":"int64"},"totalPages":{"type":["integer","null"],"format":"int64"}}},"OwnedBlueprintResponse":{"type":"object","required":["id","slug","title","description","contentMarkdown","visibility","attribution","featured","moderationState","accessState","preservationState","revision","currentVersion","engagement","createdAt","updatedAt"],"properties":{"accessChangedAt":{"type":["string","null"],"format":"date-time"},"accessReason":{"type":["string","null"]},"accessState":{"$ref":"#/components/schemas/BlueprintAccessState"},"archivedAt":{"type":["string","null"],"format":"date-time"},"attribution":{"$ref":"#/components/schemas/Attribution"},"category":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BlueprintCategory"}]},"contentMarkdown":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"currentVersion":{"$ref":"#/components/schemas/OwnedBlueprintVersionResponse"},"deletedAt":{"type":["string","null"],"format":"date-time"},"deletionSource":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BlueprintDeletionSource"}]},"description":{"type":"string"},"engagement":{"$ref":"#/components/schemas/BlueprintEngagement"},"featured":{"type":"boolean"},"id":{"type":"string","format":"uuid"},"moderationState":{"$ref":"#/components/schemas/ModerationState"},"preservationCaseId":{"type":["string","null"],"format":"uuid"},"preservationChangedAt":{"type":["string","null"],"format":"date-time"},"preservationReason":{"type":["string","null"]},"preservationState":{"$ref":"#/components/schemas/BlueprintPreservationState"},"previewUrl":{"type":["string","null"]},"revision":{"type":"integer","format":"int64"},"slug":{"type":"string"},"title":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"visibility":{"$ref":"#/components/schemas/Visibility"}}},"OwnedBlueprintVersionResponse":{"type":"object","required":["id","number","sourceFormat","validationState","createdAt"],"properties":{"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"number":{"type":"integer","format":"int32"},"sourceFormat":{"$ref":"#/components/schemas/SourceFormat"},"validationState":{"$ref":"#/components/schemas/ValidationState"}}},"Problem":{"type":"object","description":"RFC 9457 problem details with a stable machine-readable application code.","required":["type","title","status","code"],"properties":{"code":{"type":"string"},"detail":{"type":["string","null"]},"duplicate":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/DuplicateBlueprintReference"}]},"instance":{"type":["string","null"]},"invalidParams":{"type":"array","items":{"$ref":"#/components/schemas/InvalidParameter"}},"status":{"type":"integer","format":"int32","minimum":0},"title":{"type":"string"},"type":{"type":"string","example":"urn:new-mcs:problem:auth_required"}}},"PublicBlueprintCommentResponse":{"type":"object","required":["id","presentation","revision","likeCount","createdAt","updatedAt"],"properties":{"author":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/BlueprintCommentAuthorResponse","description":"Present only for a visible comment; omitted for a neutral tombstone."}]},"bodyMarkdown":{"type":["string","null"],"description":"Present only for a visible comment; omitted for a neutral tombstone."},"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"likeCount":{"type":"integer","format":"int64","minimum":0},"presentation":{"$ref":"#/components/schemas/PublicCommentPresentationState"},"revision":{"type":"integer","format":"int64"},"updatedAt":{"type":"string","format":"date-time"}}},"PublicCommentPresentationState":{"type":"string","description":"Public presentation deliberately collapses author withdrawal and moderator\nhiding into the same neutral tombstone state.","enum":["visible","tombstone"]},"RandomDiscoveryResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintSummary"}}}},"RecentDiscussionBlueprintResponse":{"type":"object","required":["id","slug","title"],"properties":{"id":{"type":"string","format":"uuid"},"previewUrl":{"type":["string","null"]},"slug":{"type":"string"},"title":{"type":"string"}}},"RecentDiscussionItemResponse":{"type":"object","required":["commentId","blueprint","author","bodyExcerpt","createdAt"],"properties":{"author":{"$ref":"#/components/schemas/BlueprintCommentAuthorResponse"},"blueprint":{"$ref":"#/components/schemas/RecentDiscussionBlueprintResponse"},"bodyExcerpt":{"type":"string"},"commentId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"rootCommentId":{"type":["string","null"],"format":"uuid"}}},"RecentDiscussionPageResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/RecentDiscussionItemResponse"}},"nextCursor":{"type":["string","null"]}}},"SearchItemResponse":{"type":"object","description":"One search result. The only signal is bounded text similarity; no\nengagement, popularity or recommendation evidence is exposed.","required":["blueprintId","slug","title","description","creatorDisplayName","sourceFormat","publishedAt"],"properties":{"blueprintId":{"type":"string","format":"uuid"},"categoryName":{"type":["string","null"]},"creatorDisplayName":{"type":"string"},"creatorHandle":{"type":["string","null"]},"description":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"},"slug":{"type":"string"},"sourceFormat":{"type":"string"},"title":{"type":"string"}}},"SearchPageResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SearchItemResponse"}},"nextCursor":{"type":["string","null"]}}},"SourceFormat":{"type":"string","description":"Stable HTTP representation of the existing WASM numeric format enum.","enum":["create","building_gadgets","litematica","world_edit","bedrock_edition","mc_edit"]},"SourceGameVersion":{"type":"object","required":["edition","evidence","family"],"properties":{"dataVersion":{"type":["integer","null"],"format":"int32"},"edition":{"type":"string"},"evidence":{"type":"string"},"family":{"type":"string"},"release":{"type":["string","null"]}},"additionalProperties":false},"TrustedAnalysis":{"type":"object","required":["schemaVersion","dimensions","sourceBlockCount","visibleBlockCount","paletteSize","tileEntityCount","entityCount"],"properties":{"bounds":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/TrustedAnalysisBounds"}]},"dimensions":{"$ref":"#/components/schemas/BlockDimensions"},"entityCount":{"type":"integer","format":"int64","minimum":0},"materialKindCount":{"type":"integer","format":"int64","minimum":0},"materials":{"type":"array","items":{"$ref":"#/components/schemas/TrustedAnalysisMaterial"}},"materialsTruncated":{"type":"boolean"},"namespaces":{"type":"array","items":{"type":"string"}},"paletteSize":{"type":"integer","format":"int64","minimum":0},"schemaVersion":{"type":"integer","format":"int32","minimum":0},"sourceBlockCount":{"type":"integer","format":"int64","minimum":0},"sourceGameVersion":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SourceGameVersion"}]},"tileEntityCount":{"type":"integer","format":"int64","minimum":0},"transportAvailable":{"type":"boolean","description":"False when the native worker intentionally skipped the dense browser\ntransport for a sparse/oversized source. The original source remains\ndownloadable and trusted analysis remains available."},"visibleBlockCount":{"type":"integer","format":"int64","minimum":0}},"additionalProperties":false},"TrustedAnalysisBounds":{"type":"object","required":["min","max"],"properties":{"max":{"type":"array","items":{"type":"integer","format":"int32"}},"min":{"type":"array","items":{"type":"integer","format":"int32"}}},"additionalProperties":false},"TrustedAnalysisMaterial":{"type":"object","required":["blockId","count"],"properties":{"blockId":{"type":"string"},"count":{"type":"integer","format":"int64","minimum":0}},"additionalProperties":false},"ValidationState":{"type":"string","enum":["client_unverified","pending","valid","invalid","error"]},"VersionListResponse":{"type":"object","required":["blueprintId","items"],"properties":{"blueprintId":{"type":"string","format":"uuid"},"items":{"type":"array","items":{"$ref":"#/components/schemas/BlueprintVersionSummary"}},"nextCursor":{"type":["string","null"]}}},"Visibility":{"type":"string","enum":["public","unlisted","private"]}},"securitySchemes":{"apiKeyBearer":{"type":"http","scheme":"bearer","bearerFormat":"mcs_live_<random>","description":"User API key. Scope is declared by the account owner; send as Authorization: Bearer <token>."}}},"tags":[{"name":"site","description":"Bounded public deployment capabilities"},{"name":"account","description":"Private current-account profile, API keys and owned-blueprint management"},{"name":"blueprints","description":"Blueprint publication and immutable history"},{"name":"comments","description":"Bounded public discussion reads and authenticated author writes"},{"name":"community","description":"Chronological public community discussion"},{"name":"discovery","description":"Bounded public blueprint and creator discovery"},{"name":"search","description":"Bounded public blueprint text search"}]}