Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Bulk Create Attributes

Creates multiple attributes for a specified attribute template in a single operation. Supports various field types including text, number, boolean, color, images (via URL or base64), and image_object (via existing app image UUID). Automatically uploads images to Cloudflare when not referencing by id. Returns lists of successful and failed creations with detailed error reasons.

POST/api/v1/{team_slug}/{app_slug}/attributes/{attribute_template_key}/bulk
Authorization
AuthorizationBearer token · headerrequired

Management API token, sent as Authorization: Bearer <token>.

Path parameters
team_slugstringrequired

Team slug

app_slugstringrequired

App slug

attribute_template_keystringrequired

Attribute template key

Request body
requiredapplication/json

Attributes to create (max 50)

itemsinternal_pkg_webserver_v1.BulkCreateAttributeItem[]required
max items 50
Show properties
Array of internal_pkg_webserver_v1.BulkCreateAttributeItem
descriptionstring

A description for the attribute.

keystringrequired

A unique key for the attribute.

namestringrequired

The name of the attribute.

valuesobject | null

Values for the attribute's fields, where the key is the field's key. The expected value type depends on the field's type defined in the attribute template:

  • "text": string
  • "html": string (HTML, sanitized on insert)
  • "number": number
  • "boolean": boolean
  • "color": string (hex format, e.g., "#RRGGBB")
  • "image": string (base64 encoded image data, or a public URL)
  • "image_object": string (existing app image UUID only)
Responses
200

Attributes processed successfully

datainternal_pkg_webserver_v1.BulkCreateAttributesResponserequired
Show properties
failed_creationsinternal_pkg_webserver_v1.BulkCreateAttributeFailed[] | null
Show properties
Array of internal_pkg_webserver_v1.BulkCreateAttributeFailed
inputinternal_pkg_webserver_v1.BulkCreateAttributeItem
Show properties
descriptionstring

A description for the attribute.

keystringrequired

A unique key for the attribute.

namestringrequired

The name of the attribute.

valuesobject | null

Values for the attribute's fields, where the key is the field's key. The expected value type depends on the field's type defined in the attribute template:

  • "text": string
  • "html": string (HTML, sanitized on insert)
  • "number": number
  • "boolean": boolean
  • "color": string (hex format, e.g., "#RRGGBB")
  • "image": string (base64 encoded image data, or a public URL)
  • "image_object": string (existing app image UUID only)
reasonstring
successful_creationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | null
Show properties
Array of github_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute
created_atstring
descriptionstring | null
filterableboolean | null
idstring
keystring
namestring | null
template_keystring
template_namestring
translatableboolean | null
translationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.AttributeTranslations
Show properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]
Show properties
Array of github_com_enadhq_nabbit_internal_pkg_webserver_models.Translation
idstring
localestring
valuestring
namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]
updated_atstring | null
valuesobject | null
detailsstring[]

Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes

successbooleanrequired
400

Invalid request payload

detailsstring[]
messagestring
successbooleanrequired
401

Unauthorized access

detailsstring[]
messagestring
successbooleanrequired
404

Attribute template not found

detailsstring[]
messagestring
successbooleanrequired
500

Internal server error

detailsstring[]
messagestring
successbooleanrequired
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST 'https://api.enad.io/api/v1/string/string/attributes/string/bulk' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "items": [
    {
      "description": "string",
      "key": "string",
      "name": "string",
      "values": {
        "property1": null,
        "property2": null
      }
    }
  ]
}'
Response
{
  "data": {
    "failed_creations": [
      {
        "input": {
          "description": "string",
          "key": "string",
          "name": "string",
          "values": {
            "property1": null,
            "property2": null
          }
        },
        "reason": "string"
      }
    ],
    "successful_creations": [
      {
        "created_at": "string",
        "description": "string",
        "filterable": true,
        "id": "string",
        "key": "string",
        "name": "string",
        "template_key": "string",
        "template_name": "string",
        "translatable": true,
        "translations": {
          "description": [
            {
              "id": "string",
              "locale": "string",
              "value": "string"
            }
          ],
          "name": [
            {
              "id": "string",
              "locale": "string",
              "value": "string"
            }
          ]
        },
        "updated_at": "string",
        "values": {
          "property1": {
            "field_id": "string",
            "id": "string",
            "image_id": "string",
            "image_object": {
              "alt": "string",
              "app_id": "string",
              "blurhash": "string",
              "copyright": "string",
              "custom": {
                "property1": "string",
                "property2": "string"
              },
              "folder_id": "string",
              "id": "string",
              "parent_id": "string",
              "public": true,
              "status": "string",
              "title": "string",
              "url": "string"
            },
            "translations": {
              "value": [
                {
                  "id": "string",
                  "locale": "string",
                  "value": "string"
                }
              ]
            },
            "type": "string",
            "value": "string"
          },
          "property2": {
            "field_id": "string",
            "id": "string",
            "image_id": "string",
            "image_object": {
              "alt": "string",
              "app_id": "string",
              "blurhash": "string",
              "copyright": "string",
              "custom": {
                "property1": "string",
                "property2": "string"
              },
              "folder_id": "string",
              "id": "string",
              "parent_id": "string",
              "public": true,
              "status": "string",
              "title": "string",
              "url": "string"
            },
            "translations": {
              "value": [
                {
                  "id": "string",
                  "locale": "string",
                  "value": "string"
                }
              ]
            },
            "type": "string",
            "value": "string"
          }
        }
      }
    ]
  },
  "details": [
    "string"
  ],
  "success": true
}