AttributeValues

Retrieve an attribute value

get

Retrieve an attribute value by ID.

Authorizations

Path parameters

idintegerRequired

Unique identifier of the resource

Example: 1

Responses

200

An attribute value.

application/json

401

Unauthorized Access

application/json

404

The given resource or object was not found or does not exist.

application/json

500

Server Error

get

HTTPcURLJavaScriptPython

GET /api/v1/attribute_value/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "id": 1,
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z",
          "translations": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        },
        "entity_type": {
          "id": 1,
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z",
      "translations": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "entity_type": {
      "id": 1,
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z",
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

Update an attribute value

put

Update an attribute value by ID.

Authorizations

Path parameters

idintegerRequired

Unique identifier of the resource

Example: 1

Body

idinteger · int64OptionalExample: 1

labelstring | nullableOptional

The display label of the attribute value

Example: Color Red

valuestringOptional

The actual value of the attribute

Example: Red

orderinteger | nullableOptional

Order of the attribute value

Example: 1

erp_codestring · max: 255Optional

ERP code for integration purposes

Example: ERPCODE123

created_datestring · date-timeOptional

Date and time when the attribute value was created

Example: 2021-01-01T00:00:00Z

modified_datestring · date-timeOptional

Date and time when the attribute value was last modified

Example: 2021-01-01T00:00:00Z

Responses

200

Attribute value updated successfully.

application/json

400

Required field(s) are missing, data is invalid, or the action is not allowed.

application/json

401

Unauthorized Access

application/json

404

The given resource or object was not found or does not exist.

application/json

406

A custom 406 error occurs due to different validation failures in viewset or service level, such as uniqueness checks or other service-related exceptions.

application/json

500

Server Error

put

HTTPcURLJavaScriptPython

PUT /api/v1/attribute_value/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1150

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z"
        },
        "entity_type": {
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z"
    },
    "entity_type": {
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z"
}

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "id": 1,
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z",
          "translations": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        },
        "entity_type": {
          "id": 1,
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z",
      "translations": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "entity_type": {
      "id": 1,
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z",
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

Delete an attribute value

delete

Delete an attribute value by ID.

Authorizations

Path parameters

idintegerRequired

Unique identifier of the resource

Example: 1

Responses

204

Attribute value deleted successfully.

401

Unauthorized Access

application/json

404

The given resource or object was not found or does not exist.

application/json

500

Server Error

delete

HTTPcURLJavaScriptPython

DELETE /api/v1/attribute_value/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Partial update an attribute value

patch

Partial update an attribute value by ID.

Authorizations

Path parameters

idintegerRequired

Unique identifier of the resource

Example: 1

Body

idinteger · int64OptionalExample: 1

labelstring | nullableOptional

The display label of the attribute value

Example: Color Red

valuestringOptional

The actual value of the attribute

Example: Red

orderinteger | nullableOptional

Order of the attribute value

Example: 1

erp_codestring · max: 255Optional

ERP code for integration purposes

Example: ERPCODE123

created_datestring · date-timeOptional

Date and time when the attribute value was created

Example: 2021-01-01T00:00:00Z

modified_datestring · date-timeOptional

Date and time when the attribute value was last modified

Example: 2021-01-01T00:00:00Z

Responses

200

Attribute value updated successfully.

application/json

400

Required field(s) are missing, data is invalid, or the action is not allowed.

application/json

401

Unauthorized Access

application/json

404

The given resource or object was not found or does not exist.

application/json

406

A custom 406 error occurs due to different validation failures in viewset or service level, such as uniqueness checks or other service-related exceptions.

application/json

500

Server Error

patch

HTTPcURLJavaScriptPython

PATCH /api/v1/attribute_value/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1150

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z"
        },
        "entity_type": {
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z"
    },
    "entity_type": {
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z"
}

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "id": 1,
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z",
          "translations": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        },
        "entity_type": {
          "id": 1,
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z",
      "translations": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "entity_type": {
      "id": 1,
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z",
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

List attribute values

get

Retrieve a list of attribute values with optional filtering.

Authorizations

Query parameters

pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1

limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10

labelstringOptional

The display label of the attribute value

Example: Color

valuestringOptional

Filter by value (contains)

Example: Red

erp_codestringOptional

Filter by ERP code (contains)

Example: ERPCODE123

value__exactstringOptional

Filter by value (exact match)

Example: Red

pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

attributeinteger · int64Optional

Filter by related attribute ID

Example: 1

Responses

200

A list of attribute values.

application/json

401

Unauthorized Access

application/json

500

Server Error

get

HTTPcURLJavaScriptPython

GET /api/v1/attribute_value/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": 1,
    "attribute": {
      "id": 1,
      "default_value": {
        "id": 1,
        "attribute": {
          "id": 1,
          "default_value": {
            "id": 1,
            "attribute": "[Circular Reference]",
            "label": "Color Red",
            "value": "Red",
            "order": 1,
            "erp_code": "ERPCODE123",
            "created_date": "2021-01-01T00:00:00Z",
            "modified_date": "2021-01-01T00:00:00Z",
            "translations": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            }
          },
          "entity_type": {
            "id": 1,
            "app_label": "text",
            "model": "text"
          },
          "erp_code": "ERPCODE123",
          "pre_attribute": true,
          "description": "This is a color attribute",
          "name": "Color",
          "key": "color",
          "data_type": "text"
        },
        "label": "Color Red",
        "value": "Red",
        "order": 1,
        "erp_code": "ERPCODE123",
        "created_date": "2021-01-01T00:00:00Z",
        "modified_date": "2021-01-01T00:00:00Z",
        "translations": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "entity_type": {
        "id": 1,
        "app_label": "text",
        "model": "text"
      },
      "erp_code": "ERPCODE123",
      "pre_attribute": true,
      "description": "This is a color attribute",
      "name": "Color",
      "key": "color",
      "data_type": "text"
    },
    "label": "Color Red",
    "value": "Red",
    "order": 1,
    "erp_code": "ERPCODE123",
    "created_date": "2021-01-01T00:00:00Z",
    "modified_date": "2021-01-01T00:00:00Z",
    "translations": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
]

Create an attribute value

post

Create an attribute value.

Authorizations

Body

idinteger · int64OptionalExample: 1

labelstring | nullableOptional

The display label of the attribute value

Example: Color Red

valuestringOptional

The actual value of the attribute

Example: Red

orderinteger | nullableOptional

Order of the attribute value

Example: 1

erp_codestring · max: 255Optional

ERP code for integration purposes

Example: ERPCODE123

created_datestring · date-timeOptional

Date and time when the attribute value was created

Example: 2021-01-01T00:00:00Z

modified_datestring · date-timeOptional

Date and time when the attribute value was last modified

Example: 2021-01-01T00:00:00Z

Responses

201

Attribute value created successfully.

application/json

400

Required field(s) are missing, data is invalid, or the action is not allowed.

application/json

401

Unauthorized Access

application/json

406

A custom 406 error occurs due to different validation failures in viewset or service level, such as uniqueness checks or other service-related exceptions.

application/json

500

Server Error

post

HTTPcURLJavaScriptPython

POST /api/v1/attribute_value/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1150

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z"
        },
        "entity_type": {
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z"
    },
    "entity_type": {
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z"
}

{
  "id": 1,
  "attribute": {
    "id": 1,
    "default_value": {
      "id": 1,
      "attribute": {
        "id": 1,
        "default_value": {
          "id": 1,
          "attribute": {
            "id": 1,
            "default_value": "[Circular Reference]",
            "entity_type": {
              "id": 1,
              "app_label": "text",
              "model": "text"
            },
            "erp_code": "ERPCODE123",
            "pre_attribute": true,
            "description": "This is a color attribute",
            "name": "Color",
            "key": "color",
            "data_type": "text"
          },
          "label": "Color Red",
          "value": "Red",
          "order": 1,
          "erp_code": "ERPCODE123",
          "created_date": "2021-01-01T00:00:00Z",
          "modified_date": "2021-01-01T00:00:00Z",
          "translations": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        },
        "entity_type": {
          "id": 1,
          "app_label": "text",
          "model": "text"
        },
        "erp_code": "ERPCODE123",
        "pre_attribute": true,
        "description": "This is a color attribute",
        "name": "Color",
        "key": "color",
        "data_type": "text"
      },
      "label": "Color Red",
      "value": "Red",
      "order": 1,
      "erp_code": "ERPCODE123",
      "created_date": "2021-01-01T00:00:00Z",
      "modified_date": "2021-01-01T00:00:00Z",
      "translations": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "entity_type": {
      "id": 1,
      "app_label": "text",
      "model": "text"
    },
    "erp_code": "ERPCODE123",
    "pre_attribute": true,
    "description": "This is a color attribute",
    "name": "Color",
    "key": "color",
    "data_type": "text"
  },
  "label": "Color Red",
  "value": "Red",
  "order": 1,
  "erp_code": "ERPCODE123",
  "created_date": "2021-01-01T00:00:00Z",
  "modified_date": "2021-01-01T00:00:00Z",
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}