> ## Documentation Index > Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Family Attribute > POST /family-attributes. Required scopes: family-attributes:write. ## OpenAPI ````yaml openapi.json POST /api/public/v1/family-attributes openapi: 3.1.0 info: title: WISEPIM Public API version: 1.0.0 description: >- Manage your WisePIM catalogue, prompts and knowledge, and launch enrichment, translation and bulk jobs. Authenticate with `Authorization: Bearer wpk_…`; create keys under Settings → API keys. Each key is bound to one project and to the scopes it was created with. summary: >- Manage catalog entities, prompts and knowledge; launch enrichment, translation and bulk actions and track jobs. termsOfService: https://wisepim.com/terms contact: name: WISEPIM support url: https://wisepim.com/contact email: info@wisepim.com x-logo: url: >- https://docs.wisepim.com/logo/wisepim-logo-horizontal-transparant-lightmode.png altText: WISEPIM servers: - url: https://wisepim.com description: Production. Every path below already starts with /api/public/v1. security: - ProjectApiKeyAuth: [] tags: - name: Key and project description: Key and project endpoints for the project bound to your API key. - name: Products description: Products endpoints for the project bound to your API key. - name: Categories description: Categories endpoints for the project bound to your API key. - name: Attributes description: Attributes endpoints for the project bound to your API key. - name: Dictionary Entries description: Dictionary Entries endpoints for the project bound to your API key. - name: Keywords description: Keywords endpoints for the project bound to your API key. - name: Import Templates description: Import Templates endpoints for the project bound to your API key. - name: Export Templates description: Export Templates endpoints for the project bound to your API key. - name: Attribute Groups description: Attribute Groups endpoints for the project bound to your API key. - name: Product Families description: Product Families endpoints for the project bound to your API key. - name: Value Code Sets description: Value Code Sets endpoints for the project bound to your API key. - name: Code Set Values description: Code Set Values endpoints for the project bound to your API key. - name: Uom Code Sets description: Uom Code Sets endpoints for the project bound to your API key. - name: Uom Values description: Uom Values endpoints for the project bound to your API key. - name: Prompts description: Prompts endpoints for the project bound to your API key. - name: Knowledge Libraries description: Knowledge Libraries endpoints for the project bound to your API key. - name: Enrichments description: Enrichments endpoints for the project bound to your API key. - name: Translations description: Translations endpoints for the project bound to your API key. - name: Bulk Actions description: Bulk Actions endpoints for the project bound to your API key. - name: Jobs description: Jobs endpoints for the project bound to your API key. - name: Family Attributes description: Family Attributes endpoints for the project bound to your API key. - name: Product Categories description: Product Categories endpoints for the project bound to your API key. externalDocs: description: WISEPIM API reference and guides url: https://docs.wisepim.com/en/api-reference/introduction paths: /api/public/v1/family-attributes: post: tags: - Family Attributes summary: Create Family Attribute operationId: public_v1_create_family_attribute parameters: - name: Idempotency-Key in: header required: false schema: type: string minLength: 1 maxLength: 128 pattern: ^[!-~]+$ description: >- Reuse this key for retries of the same write. Scoped to this API key; retained until key deletion. Different requests with the same key return 409. requestBody: content: application/json: schema: $ref: '#/components/schemas/FamilyAttributeCreate' required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/FamilyAttributeOut' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '413': description: Content Too Large content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '422': description: Unprocessable Content content: application/json: schema: $ref: '#/components/schemas/ValidationErrorOut' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorOut' '503': description: Service Unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorOut' security: - ProjectApiKeyAuth: [] components: schemas: FamilyAttributeCreate: additionalProperties: false properties: is_required: default: false title: Is Required type: boolean sort_order: anyOf: - type: integer - type: 'null' title: Sort Order is_variant_axis: default: false title: Is Variant Axis type: boolean is_differentiator: default: false title: Is Differentiator type: boolean default_value: title: Default Value validation_override: anyOf: - additionalProperties: true type: object - type: 'null' title: Validation Override display_sequence: anyOf: - type: integer - type: 'null' title: Display Sequence filter_sequence: anyOf: - type: integer - type: 'null' title: Filter Sequence value_code_set_override: anyOf: - exclusiveMinimum: 0 maximum: 9223372036854776000 type: integer - type: 'null' title: Value Code Set Override allowed_value_codes: anyOf: - items: maxLength: 255 minLength: 1 type: string maxItems: 5000 type: array - type: 'null' title: Allowed Value Codes uom_code_set_override: anyOf: - exclusiveMinimum: 0 maximum: 9223372036854776000 type: integer - type: 'null' title: Uom Code Set Override family: exclusiveMinimum: 0 maximum: 9223372036854776000 title: Family type: integer attribute: exclusiveMinimum: 0 maximum: 9223372036854776000 title: Attribute type: integer required: - family - attribute title: FamilyAttributeCreate type: object FamilyAttributeOut: properties: id: title: Id type: integer family: title: Family type: integer attribute: title: Attribute type: integer is_required: title: Is Required type: boolean sort_order: anyOf: - type: integer - type: 'null' title: Sort Order is_variant_axis: title: Is Variant Axis type: boolean is_differentiator: title: Is Differentiator type: boolean default_value: title: Default Value validation_override: anyOf: - additionalProperties: true type: object - type: 'null' title: Validation Override display_sequence: anyOf: - type: integer - type: 'null' title: Display Sequence filter_sequence: anyOf: - type: integer - type: 'null' title: Filter Sequence value_code_set_override: anyOf: - type: integer - type: 'null' title: Value Code Set Override allowed_value_codes: anyOf: - items: type: string type: array - type: 'null' title: Allowed Value Codes uom_code_set_override: anyOf: - type: integer - type: 'null' title: Uom Code Set Override required: - id - family - attribute - is_required - sort_order - is_variant_axis - is_differentiator - default_value - validation_override - display_sequence - filter_sequence - value_code_set_override - allowed_value_codes - uom_code_set_override title: FamilyAttributeOut type: object ErrorOut: description: |- The shared error envelope every NinjaAPI instance renders. `code` is present for :class:`user_app.ninja_api.errors.ApiError` (`insufficient_scope`, `rate_limited`, `invalid_cursor`, …) so machine clients can branch without parsing `error`. properties: error: title: Error type: string code: anyOf: - type: string - type: 'null' title: Code request_id: title: Request Id type: string required: - error - request_id title: ErrorOut type: object ValidationErrorOut: description: 'HTTP 422: `detail` carries Ninja''s per-field validation errors.' properties: error: title: Error type: string code: anyOf: - type: string - type: 'null' title: Code request_id: title: Request Id type: string detail: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Detail required: - error - request_id title: ValidationErrorOut type: object securitySchemes: ProjectApiKeyAuth: type: http scheme: bearer x-scopes: project:read: Read the project's identity, locales and limits. products:read: >- List and read products, including attribute values and category membership. products:write: Create and update products and their catalogue content. products:delete: Delete products from this project. categories:read: List the project's category tree. categories:write: Create and update the project's categories. categories:delete: Delete the project's categories. attributes:read: List the project's attribute definitions. attributes:write: Create and update the project's attribute definitions. attributes:delete: Delete the project's attribute definitions. attribute-groups:read: Read the project's attribute groups. attribute-groups:write: Create and update the project's attribute groups. attribute-groups:delete: Delete the project's attribute groups. product-families:read: Read the project's product families. product-families:write: Create and update the project's product families. product-families:delete: Delete the project's product families. family-attributes:read: Read the project's family attribute bindings. family-attributes:write: Create and update the project's family attribute bindings. family-attributes:delete: Delete the project's family attribute bindings. product-categories:read: Read the project's product category memberships. product-categories:write: Create and update the project's product category memberships. product-categories:delete: Delete the project's product category memberships. value-code-sets:read: Read the project's controlled vocabularies. value-code-sets:write: Create and update the project's controlled vocabularies. value-code-sets:delete: Delete the project's controlled vocabularies. code-set-values:read: Read values in the project's controlled vocabularies. code-set-values:write: Create and update values in the project's controlled vocabularies. code-set-values:delete: Delete values in the project's controlled vocabularies. uom-code-sets:read: Read the project's unit-of-measure sets. uom-code-sets:write: Create and update the project's unit-of-measure sets. uom-code-sets:delete: Delete the project's unit-of-measure sets. uom-values:read: Read units in the project's unit-of-measure sets. uom-values:write: Create and update units in the project's unit-of-measure sets. uom-values:delete: Delete units in the project's unit-of-measure sets. prompts:read: Read prompts visible to the key issuer in this project. prompts:write: >- Create prompts and update the key issuer's own prompts in this project. prompts:delete: Delete the key issuer's own prompts in this project. knowledge-libraries:read: Read this project's knowledge library. knowledge-libraries:write: Create and update this project's knowledge library. knowledge-libraries:delete: Delete this project's knowledge library. keywords:read: Read the project's keywords. keywords:write: Create and update the project's keywords. keywords:delete: Delete the project's keywords. dictionary-entries:read: Read the project's translation dictionary entries. dictionary-entries:write: Create and update the project's translation dictionary entries. dictionary-entries:delete: Delete the project's translation dictionary entries. import-templates:read: Read the project's reusable import templates. import-templates:write: Create and update the project's reusable import templates. import-templates:delete: Delete the project's reusable import templates. export-templates:read: Read the project's reusable export templates. export-templates:write: Create and update the project's reusable export templates. export-templates:delete: Delete the project's reusable export templates. enrichment:execute: >- Start product enrichment using this project's native pipelines and credit limits. translations:execute: >- Start product translation using this project's native pipelines and credit limits. bulk-actions:execute: Start bulk actions against this project's products. jobs:read: Read this project's background job status and progress. jobs:cancel: Request cooperative cancellation of this project's background jobs. bearerFormat: Project API key (wpk_...) description: >- Use a project API key from **Settings > API Access**. Send it as `Authorization: Bearer wpk_...`. See [authentication and scopes](/en/api-reference/authentication) for setup and permissions. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.