# Apiera REST API The Apiera REST API provides programmatic access to the Apiera platform, enabling seamless integration with your existing systems and workflows. Version: 1.0.0 ## Servers ``` http://localhost:5281/ ``` ## Security ### Bearer Enter your JWT token Type: http Scheme: bearer Bearer Format: JWT ## Download OpenAPI description [Apiera REST API](https://docs.apiera.io/_bundle/openapi.yaml) ## Tags ### List tags - [GET /v1/tags](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags/get.md): Retrieves a paginated list of tags with optional filtering. ### Create tag - [POST /v1/tags](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags/post.md): Creates a new tag. ### Bulk create tags - [POST /v1/tags/bulk](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1bulk/post.md): Creates multiple tags in a single atomic operation. ### Bulk update tags - [PATCH /v1/tags/bulk](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1bulk/patch.md): Updates multiple tags in a single operation. ### Get tag - [GET /v1/tags/{tagUuid}](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D/get.md): Retrieves complete details for a single tag. ### Update tag - [PATCH /v1/tags/{tagUuid}](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D/patch.md): Updates an existing tag. Only provided fields are updated. ### Delete tag - [DELETE /v1/tags/{tagUuid}](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D/delete.md): Permanently deletes a tag. Cannot be undone. ### Transition tag lifecycle - [PATCH /v1/tags/{tagUuid}/actions/lifecycle](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D~1actions~1lifecycle/patch.md): Transitions a tag to a different lifecycle state. Valid transitions depend on current status. ### Bulk transition tag lifecycle - [PATCH /v1/tags/bulk/actions/lifecycle](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1bulk~1actions~1lifecycle/patch.md): Transitions multiple tags to a different lifecycle state in a single operation. ## Skus ### List SKUs - [GET /v1/skus](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus/get.md): Retrieves a paginated list of SKUs with optional filtering. ### Create SKU - [POST /v1/skus](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus/post.md): Creates a new SKU. ### Bulk create SKUs - [POST /v1/skus/bulk](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1bulk/post.md): Creates multiple SKUs in a single operation. ### Bulk update SKUs - [PATCH /v1/skus/bulk](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1bulk/patch.md): Updates multiple SKUs in a single operation. ### Get SKU - [GET /v1/skus/{skuUuid}](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1%7Bskuuuid%7D/get.md): Retrieves complete details for a single SKU. ### Update SKU - [PATCH /v1/skus/{skuUuid}](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1%7Bskuuuid%7D/patch.md): Updates an existing SKU. Only provided fields are updated. ### Delete SKU - [DELETE /v1/skus/{skuUuid}](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1%7Bskuuuid%7D/delete.md): Permanently deletes a SKU. Cannot be undone. ### Transition SKU lifecycle - [PATCH /v1/skus/{skuUuid}/actions/lifecycle](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1%7Bskuuuid%7D~1actions~1lifecycle/patch.md): Transitions a SKU to a different lifecycle state. Valid transitions depend on current status. ### Bulk transition SKU lifecycle - [PATCH /v1/skus/bulk/actions/lifecycle](https://docs.apiera.io/openapi/skus/paths/~1v1~1skus~1bulk~1actions~1lifecycle/patch.md): Transitions multiple SKUs to a different lifecycle state in a single operation. ## Sku Dimensions ### Set SKU dimensions - [POST /v1/skus/{skuUuid}/dimension](https://docs.apiera.io/openapi/sku-dimensions/paths/~1v1~1skus~1%7Bskuuuid%7D~1dimension/post.md): Sets dimensions for a SKU. Values are provided in the organization's base dimension unit. ### Get SKU dimensions - [GET /v1/skus/{skuUuid}/dimension](https://docs.apiera.io/openapi/sku-dimensions/paths/~1v1~1skus~1%7Bskuuuid%7D~1dimension/get.md): Retrieves dimensions for a SKU including system-calculated conversions. ### Update SKU dimensions - [PATCH /v1/skus/{skuUuid}/dimension](https://docs.apiera.io/openapi/sku-dimensions/paths/~1v1~1skus~1%7Bskuuuid%7D~1dimension/patch.md): Updates dimensions for a SKU. Only provided fields are updated. ### Delete SKU dimensions - [DELETE /v1/skus/{skuUuid}/dimension](https://docs.apiera.io/openapi/sku-dimensions/paths/~1v1~1skus~1%7Bskuuuid%7D~1dimension/delete.md): Removes dimensions from a SKU. ## Sku Weights ### Set SKU weight - [POST /v1/skus/{skuUuid}/weight](https://docs.apiera.io/openapi/sku-weights/paths/~1v1~1skus~1%7Bskuuuid%7D~1weight/post.md): Sets weight for a SKU. Value is provided in the organization's base weight unit. ### Get SKU weight - [GET /v1/skus/{skuUuid}/weight](https://docs.apiera.io/openapi/sku-weights/paths/~1v1~1skus~1%7Bskuuuid%7D~1weight/get.md): Retrieves weight for a SKU including system-calculated conversions. ### Update SKU weight - [PATCH /v1/skus/{skuUuid}/weight](https://docs.apiera.io/openapi/sku-weights/paths/~1v1~1skus~1%7Bskuuuid%7D~1weight/patch.md): Updates weight for a SKU. ### Delete SKU weight - [DELETE /v1/skus/{skuUuid}/weight](https://docs.apiera.io/openapi/sku-weights/paths/~1v1~1skus~1%7Bskuuuid%7D~1weight/delete.md): Removes weight from a SKU. ## Family Attributes ### List family attributes - [GET /v1/families/{familyUuid}/attributes](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes/get.md): Retrieves a paginated list of attribute associations for a family. ### Associate attribute with family - [POST /v1/families/{familyUuid}/attributes](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes/post.md): Creates a new attribute association for a family. ### Get family attribute association - [GET /v1/families/{familyUuid}/attributes/{familyAttributeUuid}](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes~1%7Bfamilyattributeuuid%7D/get.md): Retrieves a single attribute association for a family. ### Update family attribute association - [PATCH /v1/families/{familyUuid}/attributes/{familyAttributeUuid}](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes~1%7Bfamilyattributeuuid%7D/patch.md): Updates an existing attribute association. Only provided fields are updated. ### Remove attribute from family - [DELETE /v1/families/{familyUuid}/attributes/{familyAttributeUuid}](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes~1%7Bfamilyattributeuuid%7D/delete.md): Permanently removes an attribute association from a family. ### Bulk associate attributes with family - [POST /v1/families/{familyUuid}/attributes/bulk](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes~1bulk/post.md): Creates multiple attribute associations for a family in a single operation. ### Bulk update family attribute associations - [PATCH /v1/families/{familyUuid}/attributes/bulk](https://docs.apiera.io/openapi/family-attributes/paths/~1v1~1families~1%7Bfamilyuuid%7D~1attributes~1bulk/patch.md): Updates multiple attribute associations in a single operation. ## Family Categories ### List family categories - [GET /v1/families/{familyUuid}/categories](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories/get.md): Retrieves a paginated list of category associations for a family. ### Associate category with family - [POST /v1/families/{familyUuid}/categories](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories/post.md): Creates a new category association for a family. ### Get family category association - [GET /v1/families/{familyUuid}/categories/{familyCategoryUuid}](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories~1%7Bfamilycategoryuuid%7D/get.md): Retrieves a single category association for a family. ### Update family category association - [PATCH /v1/families/{familyUuid}/categories/{familyCategoryUuid}](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories~1%7Bfamilycategoryuuid%7D/patch.md): Updates an existing category association. Only provided fields are updated. ### Remove category from family - [DELETE /v1/families/{familyUuid}/categories/{familyCategoryUuid}](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories~1%7Bfamilycategoryuuid%7D/delete.md): Permanently removes a category association from a family. ### Bulk associate categories with family - [POST /v1/families/{familyUuid}/categories/bulk](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories~1bulk/post.md): Creates multiple category associations for a family in a single operation. ### Bulk update family category associations - [PATCH /v1/families/{familyUuid}/categories/bulk](https://docs.apiera.io/openapi/family-categories/paths/~1v1~1families~1%7Bfamilyuuid%7D~1categories~1bulk/patch.md): Updates multiple category associations in a single operation. ## Families ### List families - [GET /v1/families](https://docs.apiera.io/openapi/families/paths/~1v1~1families/get.md): Retrieves a paginated list of families with optional filtering. ### Create family - [POST /v1/families](https://docs.apiera.io/openapi/families/paths/~1v1~1families/post.md): Creates a new family. Categories and attributes must be added separately after creation. ### Get family - [GET /v1/families/{familyUuid}](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1%7Bfamilyuuid%7D/get.md): Retrieves complete details for a single family. ### Update family - [PATCH /v1/families/{familyUuid}](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1%7Bfamilyuuid%7D/patch.md): Updates an existing family. Only provided fields are updated. ### Delete family - [DELETE /v1/families/{familyUuid}](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1%7Bfamilyuuid%7D/delete.md): Permanently deletes a family. Cannot be undone. ### Bulk create families - [POST /v1/families/bulk](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1bulk/post.md): Creates multiple families in a single atomic operation. ### Bulk update families - [PATCH /v1/families/bulk](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1bulk/patch.md): Updates multiple families in a single operation. ### Transition family lifecycle - [PATCH /v1/families/{familyUuid}/actions/lifecycle](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1%7Bfamilyuuid%7D~1actions~1lifecycle/patch.md): Transitions a family to a different lifecycle state. Valid transitions depend on current status. ### Bulk transition family lifecycle - [PATCH /v1/families/bulk/actions/lifecycle](https://docs.apiera.io/openapi/families/paths/~1v1~1families~1bulk~1actions~1lifecycle/patch.md): Transitions multiple families to a different lifecycle state in a single operation. ## Organization Members ### /v1/organizations/current/members - [GET /v1/organizations/current/members](https://docs.apiera.io/openapi/organization-members/paths/~1v1~1organizations~1current~1members/get.md) ### /v1/organizations/current/members - [POST /v1/organizations/current/members](https://docs.apiera.io/openapi/organization-members/paths/~1v1~1organizations~1current~1members/post.md) ### /v1/organizations/current/members/{accountUuid} - [GET /v1/organizations/current/members/{accountUuid}](https://docs.apiera.io/openapi/organization-members/paths/~1v1~1organizations~1current~1members~1%7Baccountuuid%7D/get.md) ### /v1/organizations/current/members/{accountUuid} - [DELETE /v1/organizations/current/members/{accountUuid}](https://docs.apiera.io/openapi/organization-members/paths/~1v1~1organizations~1current~1members~1%7Baccountuuid%7D/delete.md) ### /v1/organizations/current/members/{accountUuid}/role - [PATCH /v1/organizations/current/members/{accountUuid}/role](https://docs.apiera.io/openapi/organization-members/paths/~1v1~1organizations~1current~1members~1%7Baccountuuid%7D~1role/patch.md) ### /v1/organizations/current/members/{accountUuid}/actions/lifecycle - [PATCH /v1/organizations/current/members/{accountUuid}/actions/lifecycle](https://docs.apiera.io/openapi/organization-members/paths/~1v1~1organizations~1current~1members~1%7Baccountuuid%7D~1actions~1lifecycle/patch.md) ## Organizations ### /v1/organizations/current - [GET /v1/organizations/current](https://docs.apiera.io/openapi/organizations/paths/~1v1~1organizations~1current/get.md) ### /v1/organizations/current - [PATCH /v1/organizations/current](https://docs.apiera.io/openapi/organizations/paths/~1v1~1organizations~1current/patch.md) ## Organization Roles ### /v1/organizations/current/roles - [GET /v1/organizations/current/roles](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles/get.md) ### /v1/organizations/current/roles - [POST /v1/organizations/current/roles](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles/post.md) ### /v1/organizations/current/roles/{organizationRoleUuid} - [GET /v1/organizations/current/roles/{organizationRoleUuid}](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles~1%7Borganizationroleuuid%7D/get.md) ### /v1/organizations/current/roles/{organizationRoleUuid} - [PATCH /v1/organizations/current/roles/{organizationRoleUuid}](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles~1%7Borganizationroleuuid%7D/patch.md) ### /v1/organizations/current/roles/{organizationRoleUuid} - [DELETE /v1/organizations/current/roles/{organizationRoleUuid}](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles~1%7Borganizationroleuuid%7D/delete.md) ### /v1/organizations/current/roles/{organizationRoleUuid}/permissions/{permissionUuid} - [POST /v1/organizations/current/roles/{organizationRoleUuid}/permissions/{permissionUuid}](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles~1%7Borganizationroleuuid%7D~1permissions~1%7Bpermissionuuid%7D/post.md) ### /v1/organizations/current/roles/{organizationRoleUuid}/permissions/{permissionUuid} - [DELETE /v1/organizations/current/roles/{organizationRoleUuid}/permissions/{permissionUuid}](https://docs.apiera.io/openapi/organization-roles/paths/~1v1~1organizations~1current~1roles~1%7Borganizationroleuuid%7D~1permissions~1%7Bpermissionuuid%7D/delete.md) ## Categories ### List categories - [GET /v1/categories](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories/get.md): Retrieves a paginated list of categories with optional filtering. ### Create category - [POST /v1/categories](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories/post.md): Creates a new category. ### Bulk create categories - [POST /v1/categories/bulk](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1bulk/post.md): Creates multiple categories in a single atomic operation. ### Bulk update categories - [PATCH /v1/categories/bulk](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1bulk/patch.md): Updates multiple categories in a single operation. ### Get category - [GET /v1/categories/{categoryUuid}](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D/get.md): Retrieves complete details for a single category. ### Update category - [PATCH /v1/categories/{categoryUuid}](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D/patch.md): Updates an existing category. Only provided fields are updated. ### Delete category - [DELETE /v1/categories/{categoryUuid}](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D/delete.md): Permanently deletes a category. Cannot be undone. ### Transition category lifecycle - [PATCH /v1/categories/{categoryUuid}/actions/lifecycle](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1%7Bcategoryuuid%7D~1actions~1lifecycle/patch.md): Transitions a category to a different lifecycle state. Valid transitions depend on current status. ### Bulk transition category lifecycle - [PATCH /v1/categories/bulk/actions/lifecycle](https://docs.apiera.io/openapi/categories/paths/~1v1~1categories~1bulk~1actions~1lifecycle/patch.md): Transitions multiple categories to a different lifecycle state in a single operation. ## Attributes ### List attributes - [GET /v1/attributes](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes/get.md): Retrieves a paginated list of attributes with optional filtering. ### Create attribute - [POST /v1/attributes](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes/post.md): Creates a new attribute. Terms must be added separately after creation. ### Bulk create attributes - [POST /v1/attributes/bulk](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1bulk/post.md): Creates multiple attributes in a single atomic operation. ### Bulk update attributes - [PATCH /v1/attributes/bulk](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1bulk/patch.md): Updates multiple attributes in a single operation. ### Get attribute - [GET /v1/attributes/{attributeUuid}](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1%7Battributeuuid%7D/get.md): Retrieves complete details for a single attribute. ### Update attribute - [PATCH /v1/attributes/{attributeUuid}](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1%7Battributeuuid%7D/patch.md): Updates an existing attribute. Only provided fields are updated. ### Delete attribute - [DELETE /v1/attributes/{attributeUuid}](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1%7Battributeuuid%7D/delete.md): Permanently deletes an attribute. Cannot be undone. ### Transition attribute lifecycle - [PATCH /v1/attributes/{attributeUuid}/actions/lifecycle](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1%7Battributeuuid%7D~1actions~1lifecycle/patch.md): Transitions an attribute to a different lifecycle state. Valid transitions depend on current status. ### Bulk transition attribute lifecycle - [PATCH /v1/attributes/bulk/actions/lifecycle](https://docs.apiera.io/openapi/attributes/paths/~1v1~1attributes~1bulk~1actions~1lifecycle/patch.md): Transitions multiple attributes to a different lifecycle state in a single operation. ## Attribute Terms ### List attribute terms - [GET /v1/attributes/{attributeUuid}/terms](https://docs.apiera.io/openapi/attribute-terms/paths/~1v1~1attributes~1%7Battributeuuid%7D~1terms/get.md): Retrieves a paginated list of terms for an attribute with optional filtering. ### Create term - [POST /v1/attributes/{attributeUuid}/terms](https://docs.apiera.io/openapi/attribute-terms/paths/~1v1~1attributes~1%7Battributeuuid%7D~1terms/post.md): Creates a new term for an attribute. ### Get term - [GET /v1/attributes/{attributeUuid}/terms/{termUuid}](https://docs.apiera.io/openapi/attribute-terms/paths/~1v1~1attributes~1%7Battributeuuid%7D~1terms~1%7Btermuuid%7D/get.md): Retrieves a single term. ### Update term - [PATCH /v1/attributes/{attributeUuid}/terms/{termUuid}](https://docs.apiera.io/openapi/attribute-terms/paths/~1v1~1attributes~1%7Battributeuuid%7D~1terms~1%7Btermuuid%7D/patch.md): Updates an existing term. Only provided fields are updated. ### Delete term - [DELETE /v1/attributes/{attributeUuid}/terms/{termUuid}](https://docs.apiera.io/openapi/attribute-terms/paths/~1v1~1attributes~1%7Battributeuuid%7D~1terms~1%7Btermuuid%7D/delete.md): Permanently deletes a term. ## Assets ### List assets - [GET /v1/assets](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets/get.md): Retrieves a paginated list of assets with optional filtering using bracket notation. ### Create asset - [POST /v1/assets](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets/post.md): Creates a new asset entity. Files must be uploaded separately after creation. ### Get asset - [GET /v1/assets/{assetUuid}](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1%7Bassetuuid%7D/get.md): Retrieves complete details for a single asset. ### Update asset - [PATCH /v1/assets/{assetUuid}](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1%7Bassetuuid%7D/patch.md): Updates an existing asset. Only provided fields are updated. ### Delete asset - [DELETE /v1/assets/{assetUuid}](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1%7Bassetuuid%7D/delete.md): Permanently deletes an asset and all associated files. Cannot be undone. ### Bulk create assets - [POST /v1/assets/bulk](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1bulk/post.md): Creates multiple assets in a single atomic operation. ### Bulk update assets - [PATCH /v1/assets/bulk](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1bulk/patch.md): Updates multiple assets in a single operation. ### Transition asset lifecycle - [PATCH /v1/assets/{assetUuid}/actions/lifecycle](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1%7Bassetuuid%7D~1actions~1lifecycle/patch.md): Transitions an asset to a different lifecycle state. Valid transitions depend on current status. ### Bulk transition asset lifecycle - [PATCH /v1/assets/bulk/actions/lifecycle](https://docs.apiera.io/openapi/assets/paths/~1v1~1assets~1bulk~1actions~1lifecycle/patch.md): Transitions multiple assets to a different lifecycle state in a single operation. ## Asset Files ### Bulk initiate file uploads - [POST /v1/assets/files/bulk/actions/initiate-upload](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1files~1bulk~1actions~1initiate-upload/post.md): Initiates multiple file uploads in a single operation and returns pre-signed URLs. ### Bulk complete file uploads - [PATCH /v1/assets/files/bulk/actions/complete-upload](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1files~1bulk~1actions~1complete-upload/patch.md): Completes multiple file uploads after files have been transferred to storage. ### List files - [GET /v1/assets/{assetUuid}/files](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1%7Bassetuuid%7D~1files/get.md): Retrieves a paginated list of files for an asset with optional filtering. ### Get file - [GET /v1/assets/{assetUuid}/files/{fileUuid}](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1%7Bassetuuid%7D~1files~1%7Bfileuuid%7D/get.md): Retrieves complete details for a single file including download URL. ### Delete file - [DELETE /v1/assets/{assetUuid}/files/{fileUuid}](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1%7Bassetuuid%7D~1files~1%7Bfileuuid%7D/delete.md): Permanently deletes a file. Cannot be undone. ### Initiate file upload - [POST /v1/assets/{assetUuid}/files/actions/initiate-upload](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1%7Bassetuuid%7D~1files~1actions~1initiate-upload/post.md): Initiates a file upload and returns a pre-signed URL for uploading. ### Complete file upload - [PATCH /v1/assets/{assetUuid}/files/{fileUuid}/actions/complete-upload](https://docs.apiera.io/openapi/asset-files/paths/~1v1~1assets~1%7Bassetuuid%7D~1files~1%7Bfileuuid%7D~1actions~1complete-upload/patch.md): Completes a file upload after the file has been transferred to storage. ## Asset Metadata ### List metadata - [GET /v1/assets/{assetUuid}/metadata](https://docs.apiera.io/openapi/asset-metadata/paths/~1v1~1assets~1%7Bassetuuid%7D~1metadata/get.md): Retrieves a paginated list of metadata entries for an asset. ### Create metadata - [POST /v1/assets/{assetUuid}/metadata](https://docs.apiera.io/openapi/asset-metadata/paths/~1v1~1assets~1%7Bassetuuid%7D~1metadata/post.md): Creates a new metadata entry for an asset. ### Get metadata - [GET /v1/assets/{assetUuid}/metadata/{metadataUuid}](https://docs.apiera.io/openapi/asset-metadata/paths/~1v1~1assets~1%7Bassetuuid%7D~1metadata~1%7Bmetadatauuid%7D/get.md): Retrieves a single metadata entry. ### Update metadata - [PATCH /v1/assets/{assetUuid}/metadata/{metadataUuid}](https://docs.apiera.io/openapi/asset-metadata/paths/~1v1~1assets~1%7Bassetuuid%7D~1metadata~1%7Bmetadatauuid%7D/patch.md): Updates an existing metadata entry. Only provided fields are updated. ### Delete metadata - [DELETE /v1/assets/{assetUuid}/metadata/{metadataUuid}](https://docs.apiera.io/openapi/asset-metadata/paths/~1v1~1assets~1%7Bassetuuid%7D~1metadata~1%7Bmetadatauuid%7D/delete.md): Permanently deletes a metadata entry.