> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.specurate.com/llms.txt > Use this file to discover all available pages before exploring further. # Save ## OpenAPI ````yaml /openapi.json post /v1/workspaces/{workspaceId}/projects/{projectId}/items/{projectItemId}/sync-updates/save-as-alternative openapi: 3.1.0 info: title: Specurate API description: '' version: 1.0.0 contact: {} servers: - url: https://app.specurate.com/api description: API Server security: [] tags: [] paths: /v1/workspaces/{workspaceId}/projects/{projectId}/items/{projectItemId}/sync-updates/save-as-alternative: post: tags: - Save Catalog Version summary: Save operationId: SaveCatalogVersionController_save_v1 parameters: - name: workspaceId required: true in: path schema: type: string - name: projectId required: true in: path schema: type: string - name: projectItemId required: true in: path schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SaveCatalogVersionDto' responses: '201': description: '' content: application/json: schema: $ref: '#/components/schemas/SaveCatalogVersionResponseDto' components: schemas: SaveCatalogVersionDto: type: object properties: eventId: type: string pattern: ^[1-9]\d*$ eventIds: minItems: 1 type: array items: type: string pattern: ^[1-9]\d*$ projectItemVersion: type: integer minimum: 1 maximum: 9007199254740991 catalogFamilyVersion: type: integer minimum: 1 maximum: 9007199254740991 required: - eventId - eventIds - projectItemVersion - catalogFamilyVersion additionalProperties: false SaveCatalogVersionResponseDto: type: object properties: item: $ref: '#/components/schemas/ProjectItemResponseDto' idempotent: type: boolean required: - item - idempotent ProjectItemResponseDto: type: object properties: id: type: string projectId: type: string projectItemSlotId: type: string nullable: true name: type: string catalogFamilyId: type: string description: BigInt string catalogItemId: type: string description: BigInt string materialFinish: nullable: true type: object allOf: - $ref: '#/components/schemas/ProjectItemMaterialFinishDto' catalogFamilySourceId: type: string nullable: true columnsAttributes: type: object additionalProperties: true sourceMeta: nullable: true type: object allOf: - $ref: '#/components/schemas/ProjectItemSourceMetaDto' instructionLinks: type: array items: $ref: '#/components/schemas/ProjectItemInstructionLinkResponseDto' syncStateCache: nullable: true type: object allOf: - $ref: '#/components/schemas/SyncStateCacheDto' isPrimary: type: boolean catalogConnectionMode: enum: - live - saved type: string description: >- live participates in catalog synchronization; saved is a project-only saved catalog version savedAt: format: date-time type: string nullable: true selectedSource: nullable: true type: object allOf: - $ref: '#/components/schemas/SelectedSourceDto' collectionApplication: nullable: true type: object allOf: - $ref: '#/components/schemas/CollectionApplicationProvenanceDto' categoryId: type: string productTypeId: type: string nullable: true kind: enum: - option - component type: string catalogFamilyStatus: nullable: true enum: - draft - new_from_project - new_from_collection - ready_to_use type: string description: CatalogFamily.status — drives FE Push/Pull button visibility catalogFamilyItemType: nullable: true enum: - default - material - template type: string description: CatalogFamily.itemType for the linked live Catalog family affectedCatalogFamilyId: type: string nullable: true catalogDecisionEventIds: type: array items: type: string brandStandardId: type: string nullable: true refNumber: type: string nullable: true affectedParentPiIds: type: array items: type: string description: >- Parent PI ids whose parts list embeds this PI as a row. Set only when the mutated PI is a component; FE invalidates each parent PI parts-list cache entry. Empty array for options. version: type: number createdAt: type: string updatedAt: type: string slotColumnsAttributes: type: object nullable: true additionalProperties: true coreChangePolicy: type: object required: - id - projectId - projectItemSlotId - name - catalogFamilyId - catalogItemId - materialFinish - columnsAttributes - sourceMeta - instructionLinks - isPrimary - catalogConnectionMode - savedAt - selectedSource - collectionApplication - categoryId - productTypeId - kind - catalogFamilyStatus - catalogFamilyItemType - catalogDecisionEventIds - brandStandardId - refNumber - affectedParentPiIds - version - createdAt - updatedAt - slotColumnsAttributes - coreChangePolicy ProjectItemMaterialFinishDto: type: object properties: id: type: string name: type: string isBaseMaterial: type: boolean required: - id - name - isBaseMaterial ProjectItemSourceMetaDto: type: object properties: selectors: type: object additionalProperties: type: string description: Column slug → CSS selector of the clipped page element. url: type: string maxLength: 2048 format: uri title: type: string maxLength: 512 favicon: type: string maxLength: 2048 ogImage: type: string maxLength: 2048 clippedAt: type: string required: - url ProjectItemInstructionLinkResponseDto: type: object properties: assigneeRoleGroupIds: type: array items: type: string enum: - mfg_vendors - owners - gc_sub - warehouse - facility_mgr id: type: string text: type: string position: type: number required: - assigneeRoleGroupIds - id - text - position SyncStateCacheDto: type: object properties: hasDiff: type: boolean description: >- Status-worthy drift: core/commercial columns, taxonomy, invalid source binding, or parts; descriptive-only column changes are excluded columnsDiff: type: boolean description: >- Any physical catalog-owned column delta, including descriptive fields; this can be true while hasDiff is false partsDiff: $ref: '#/components/schemas/PartsDiffDto' selectionDiff: $ref: '#/components/schemas/SelectionDiffDto' orphanedRefs: $ref: '#/components/schemas/OrphanedRefsDto' computedAt: type: string componentsDiverged: type: boolean required: - hasDiff - columnsDiff - partsDiff - selectionDiff - orphanedRefs - computedAt - componentsDiverged SelectedSourceDto: type: object properties: isDefault: type: boolean companyName: type: object nullable: true officeName: type: object nullable: true required: - isDefault - companyName - officeName CollectionApplicationProvenanceDto: type: object properties: collection: $ref: '#/components/schemas/CollectionApplicationCollectionProvenanceDto' entry: $ref: '#/components/schemas/CollectionApplicationEntryProvenanceDto' reference: nullable: true type: object allOf: - $ref: '#/components/schemas/CollectionApplicationReferenceProvenanceDto' application: $ref: '#/components/schemas/CollectionApplicationIdentityProvenanceDto' content: $ref: '#/components/schemas/CollectionApplicationContentProvenanceDto' governance: $ref: '#/components/schemas/CollectionApplicationGovernanceProvenanceDto' required: - collection - entry - reference - application - content - governance PartsDiffDto: type: object properties: hasDiff: type: boolean addedLocally: type: array items: type: string removedLocally: type: array items: type: string quantityChanged: type: array items: $ref: '#/components/schemas/PartsDiffEntryDto' required: - hasDiff - addedLocally - removedLocally - quantityChanged SelectionDiffDto: type: object properties: familySourceMismatch: type: boolean description: true when the selected family-source binding is incomplete itemSourceMismatch: type: boolean description: true when the selected item-source binding is incomplete required: - familySourceMismatch - itemSourceMismatch OrphanedRefsDto: type: object properties: family: type: boolean item: type: boolean familySource: type: boolean itemSource: type: boolean required: - family - item - familySource - itemSource CollectionApplicationCollectionProvenanceDto: type: object properties: id: type: string name: type: string brand: type: string region: type: string generation: type: number version: type: number navigable: type: boolean required: - id - name - brand - region - generation - version - navigable CollectionApplicationEntryProvenanceDto: type: object properties: id: type: string label: type: string productTypeLabel: type: string required: - id - label - productTypeLabel CollectionApplicationReferenceProvenanceDto: type: object properties: label: type: string kind: type: string enum: - catalog_item - spec_template referenceCode: type: string nullable: true required: - label - kind - referenceCode CollectionApplicationIdentityProvenanceDto: type: object properties: id: type: string createdAt: type: string required: - id - createdAt CollectionApplicationContentProvenanceDto: type: object properties: description: type: string nullable: true notes: type: array items: type: string required: - description - notes CollectionApplicationGovernanceProvenanceDto: type: object properties: mandatoryItem: type: boolean designReviewRequired: type: boolean optionalManufacturerNames: type: array items: type: string required: - mandatoryItem - designReviewRequired - optionalManufacturerNames PartsDiffEntryDto: type: object properties: catalogItemId: type: string projectQty: type: string nullable: true catalogQty: type: string nullable: true required: - catalogItemId - projectQty - catalogQty ````