{ "name": "UpdateOrderCustomAttribute", "fully_qualified_name": "SquareupApi.UpdateOrderCustomAttribute@2.0.0", "description": "Create or update a custom attribute for an order.\n\nCall this tool to set or update the value of a custom attribute for a specific order. This is useful for customizing orders based on predefined custom attribute definitions in a Square seller account. Ensure the visibility setting is 'VISIBILITY_READ_WRITE_VALUES' for attributes owned by another application.", "toolkit": { "name": "ArcadeSquareupApi", "description": null, "version": "2.0.0" }, "input": { "parameters": [ { "name": "order_id", "required": true, "description": "The ID of the target order for which the custom attribute is being created or updated.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The ID of the target [order](entity:Order)." }, "inferrable": true, "http_endpoint_parameter_name": "order_id" }, { "name": "custom_attribute_key", "required": true, "description": "The key of the custom attribute to be created or updated. Must match an existing custom attribute definition key.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The key of the custom attribute to create or update. This key must match the key \nof an existing custom attribute definition." }, "inferrable": true, "http_endpoint_parameter_name": "custom_attribute_key" }, { "name": "custom_attribute_request_body", "required": true, "description": "JSON object for the request body containing custom attribute details and idempotency key.", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "custom_attribute": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "key": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The identifier\nof the custom attribute definition and its corresponding custom attributes. This value\ncan be a simple key, which is the key that is provided when the custom attribute definition\nis created, or a qualified key, if the requesting\napplication is not the definition owner. The qualified key consists of the application ID\nof the custom attribute definition owner\nfollowed by the simple key that was provided when the definition was created. It has the\nformat application_id:simple key.\n\nThe value for a simple key can contain up to 60 alphanumeric characters, periods (.),\nunderscores (_), and hyphens (-)." }, "value": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The value assigned to the custom attribute. It is validated against the custom\nattribute definition's schema on write operations. For more information about custom\nattribute values,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview)." }, "version": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Read only. The current version of the custom attribute. This field is incremented when the custom attribute is changed.\nWhen updating an existing custom attribute value, you can provide this field\nand specify the current version of the custom attribute to enable\n[optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency).\nThis field can also be used to enforce strong consistency for reads. For more information about strong consistency for reads,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview)." }, "visibility": { "val_type": "string", "inner_val_type": null, "enum": [ "VISIBILITY_HIDDEN", "VISIBILITY_READ_ONLY", "VISIBILITY_READ_WRITE_VALUES" ], "properties": null, "inner_properties": null, "description": "The level of permission that a seller or other applications requires to\nview this custom attribute definition.\nThe `Visibility` field controls who can read and write the custom attribute values\nand custom attribute definition." }, "definition": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "key": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The identifier\nof the custom attribute definition and its corresponding custom attributes. This value\ncan be a simple key, which is the key that is provided when the custom attribute definition\nis created, or a qualified key, if the requesting\napplication is not the definition owner. The qualified key consists of the application ID\nof the custom attribute definition owner\nfollowed by the simple key that was provided when the definition was created. It has the\nformat application_id:simple key.\n\nThe value for a simple key can contain up to 60 alphanumeric characters, periods (.),\nunderscores (_), and hyphens (-).\n\nThis field can not be changed\nafter the custom attribute definition is created. This field is required when creating\na definition and must be unique per application, seller, and resource type." }, "schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The JSON schema for the custom attribute definition, which determines the data type of the corresponding custom attributes. For more information,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview). This field is required when creating a definition." }, "name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The name of the custom attribute definition for API and seller-facing UI purposes. The name must\nbe unique within the seller and application pair. This field is required if the\n`visibility` field is `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`." }, "description": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Seller-oriented description of the custom attribute definition, including any constraints\nthat the seller should observe. May be displayed as a tooltip in Square UIs. This field is\nrequired if the `visibility` field is `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`." }, "visibility": { "val_type": "string", "inner_val_type": null, "enum": [ "VISIBILITY_HIDDEN", "VISIBILITY_READ_ONLY", "VISIBILITY_READ_WRITE_VALUES" ], "properties": null, "inner_properties": null, "description": "The level of permission that a seller or other applications requires to\nview this custom attribute definition.\nThe `Visibility` field controls who can read and write the custom attribute values\nand custom attribute definition." }, "version": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Read only. The current version of the custom attribute definition.\nThe value is incremented each time the custom attribute definition is updated.\nWhen updating a custom attribute definition, you can provide this field\nand specify the current version of the custom attribute definition to enable\n[optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency).\n\nOn writes, this field must be set to the latest version. Stale writes are rejected.\n\nThis field can also be used to enforce strong consistency for reads. For more information about strong consistency for reads,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview)." }, "updated_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute definition was created or most recently updated,\nin RFC 3339 format." }, "created_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute definition was created, in RFC 3339 format." } }, "inner_properties": null, "description": "Represents a definition for custom attribute values. A custom attribute definition\nspecifies the key, visibility, schema, and other properties for a custom attribute." }, "updated_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute was created or was most recently\nupdated, in RFC 3339 format." }, "created_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute was created, in RFC 3339 format." } }, "inner_properties": null, "description": "A custom attribute value. Each custom attribute value has a corresponding\n`CustomAttributeDefinition` object." }, "idempotency_key": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "A unique identifier for this request, used to ensure idempotency. \nFor more information, see [Idempotency](https://developer.squareup.com/docs/build-basics/common-api-patterns/idempotency)." } }, "inner_properties": null, "description": "An object containing the fields to POST for the request.\n\nSee the corresponding object definition for field details." }, "inferrable": true, "http_endpoint_parameter_name": "requestBody" } ] }, "output": { "description": "Response from the API endpoint 'UpsertOrderCustomAttribute'.", "available_modes": [ "value", "error", "null" ], "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "requirements": { "authorization": { "provider_id": "arcade-squareup", "provider_type": "oauth2", "id": null, "oauth2": { "scopes": [ "ORDERS_WRITE" ] } }, "secrets": null, "metadata": null }, "deprecation_message": null, "metadata": { "object_type": "api_wrapper_tool", "version": "1.1.0", "description": "Tools that enable LLMs to interact directly with the squareup API." }, "http_endpoint": { "metadata": { "object_type": "http_endpoint", "version": "1.2.0", "description": "" }, "url": "https://connect.squareup.com/v2/orders/{order_id}/custom-attributes/{custom_attribute_key}", "http_method": "POST", "headers": {}, "parameters": [ { "name": "order_id", "tool_parameter_name": "order_id", "description": "The ID of the target [order](entity:Order).", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The ID of the target [order](entity:Order)." }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "custom_attribute_key", "tool_parameter_name": "custom_attribute_key", "description": "The key of the custom attribute to create or update. This key must match the key \nof an existing custom attribute definition.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The key of the custom attribute to create or update. This key must match the key \nof an existing custom attribute definition." }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "requestBody", "tool_parameter_name": "custom_attribute_request_body", "description": "An object containing the fields to POST for the request.\n\nSee the corresponding object definition for field details.", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "custom_attribute": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "key": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The identifier\nof the custom attribute definition and its corresponding custom attributes. This value\ncan be a simple key, which is the key that is provided when the custom attribute definition\nis created, or a qualified key, if the requesting\napplication is not the definition owner. The qualified key consists of the application ID\nof the custom attribute definition owner\nfollowed by the simple key that was provided when the definition was created. It has the\nformat application_id:simple key.\n\nThe value for a simple key can contain up to 60 alphanumeric characters, periods (.),\nunderscores (_), and hyphens (-)." }, "value": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The value assigned to the custom attribute. It is validated against the custom\nattribute definition's schema on write operations. For more information about custom\nattribute values,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview)." }, "version": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Read only. The current version of the custom attribute. This field is incremented when the custom attribute is changed.\nWhen updating an existing custom attribute value, you can provide this field\nand specify the current version of the custom attribute to enable\n[optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency).\nThis field can also be used to enforce strong consistency for reads. For more information about strong consistency for reads,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview)." }, "visibility": { "val_type": "string", "inner_val_type": null, "enum": [ "VISIBILITY_HIDDEN", "VISIBILITY_READ_ONLY", "VISIBILITY_READ_WRITE_VALUES" ], "properties": null, "inner_properties": null, "description": "The level of permission that a seller or other applications requires to\nview this custom attribute definition.\nThe `Visibility` field controls who can read and write the custom attribute values\nand custom attribute definition." }, "definition": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "key": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The identifier\nof the custom attribute definition and its corresponding custom attributes. This value\ncan be a simple key, which is the key that is provided when the custom attribute definition\nis created, or a qualified key, if the requesting\napplication is not the definition owner. The qualified key consists of the application ID\nof the custom attribute definition owner\nfollowed by the simple key that was provided when the definition was created. It has the\nformat application_id:simple key.\n\nThe value for a simple key can contain up to 60 alphanumeric characters, periods (.),\nunderscores (_), and hyphens (-).\n\nThis field can not be changed\nafter the custom attribute definition is created. This field is required when creating\na definition and must be unique per application, seller, and resource type." }, "schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The JSON schema for the custom attribute definition, which determines the data type of the corresponding custom attributes. For more information,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview). This field is required when creating a definition." }, "name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The name of the custom attribute definition for API and seller-facing UI purposes. The name must\nbe unique within the seller and application pair. This field is required if the\n`visibility` field is `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`." }, "description": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Seller-oriented description of the custom attribute definition, including any constraints\nthat the seller should observe. May be displayed as a tooltip in Square UIs. This field is\nrequired if the `visibility` field is `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`." }, "visibility": { "val_type": "string", "inner_val_type": null, "enum": [ "VISIBILITY_HIDDEN", "VISIBILITY_READ_ONLY", "VISIBILITY_READ_WRITE_VALUES" ], "properties": null, "inner_properties": null, "description": "The level of permission that a seller or other applications requires to\nview this custom attribute definition.\nThe `Visibility` field controls who can read and write the custom attribute values\nand custom attribute definition." }, "version": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Read only. The current version of the custom attribute definition.\nThe value is incremented each time the custom attribute definition is updated.\nWhen updating a custom attribute definition, you can provide this field\nand specify the current version of the custom attribute definition to enable\n[optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency).\n\nOn writes, this field must be set to the latest version. Stale writes are rejected.\n\nThis field can also be used to enforce strong consistency for reads. For more information about strong consistency for reads,\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview)." }, "updated_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute definition was created or most recently updated,\nin RFC 3339 format." }, "created_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute definition was created, in RFC 3339 format." } }, "inner_properties": null, "description": "Represents a definition for custom attribute values. A custom attribute definition\nspecifies the key, visibility, schema, and other properties for a custom attribute." }, "updated_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute was created or was most recently\nupdated, in RFC 3339 format." }, "created_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timestamp that indicates when the custom attribute was created, in RFC 3339 format." } }, "inner_properties": null, "description": "A custom attribute value. Each custom attribute value has a corresponding\n`CustomAttributeDefinition` object." }, "idempotency_key": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "A unique identifier for this request, used to ensure idempotency. \nFor more information, see [Idempotency](https://developer.squareup.com/docs/build-basics/common-api-patterns/idempotency)." } }, "inner_properties": null, "description": "An object containing the fields to POST for the request.\n\nSee the corresponding object definition for field details." }, "accepted_as": "body", "required": true, "deprecated": false, "default": null, "documentation_urls": [] } ], "documentation_urls": [], "secrets": [ { "arcade_key": "auth_token", "parameter_name": "Authorization", "accepted_as": "header", "formatted_value": "Bearer {authorization}", "description": "The OAuth token to use for authentication.", "is_auth_token": true } ], "request_body_spec": "{\n \"required\": true,\n \"description\": \"An object containing the fields to POST for the request.\\n\\nSee the corresponding object definition for field details.\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\",\n \"description\": \"Represents an upsert request for an order custom attribute.\",\n \"x-release-status\": \"BETA\",\n \"required\": [\n \"custom_attribute\"\n ],\n \"properties\": {\n \"custom_attribute\": {\n \"type\": \"object\",\n \"description\": \"A custom attribute value. Each custom attribute value has a corresponding\\n`CustomAttributeDefinition` object.\",\n \"x-release-status\": \"PUBLIC\",\n \"properties\": {\n \"key\": {\n \"type\": \"string\",\n \"description\": \"The identifier\\nof the custom attribute definition and its corresponding custom attributes. This value\\ncan be a simple key, which is the key that is provided when the custom attribute definition\\nis created, or a qualified key, if the requesting\\napplication is not the definition owner. The qualified key consists of the application ID\\nof the custom attribute definition owner\\nfollowed by the simple key that was provided when the definition was created. It has the\\nformat application_id:simple key.\\n\\nThe value for a simple key can contain up to 60 alphanumeric characters, periods (.),\\nunderscores (_), and hyphens (-).\",\n \"minLength\": 1,\n \"pattern\": \"^([a-zA-Z0-9\\\\._-]+:)?[a-zA-Z0-9\\\\._-]{1,60}$\",\n \"nullable\": true\n },\n \"value\": {\n \"description\": \"The value assigned to the custom attribute. It is validated against the custom\\nattribute definition's schema on write operations. For more information about custom\\nattribute values,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\",\n \"nullable\": true\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Read only. The current version of the custom attribute. This field is incremented when the custom attribute is changed.\\nWhen updating an existing custom attribute value, you can provide this field\\nand specify the current version of the custom attribute to enable\\n[optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency).\\nThis field can also be used to enforce strong consistency for reads. For more information about strong consistency for reads,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\"\n },\n \"visibility\": {\n \"type\": \"string\",\n \"enum\": [\n \"VISIBILITY_HIDDEN\",\n \"VISIBILITY_READ_ONLY\",\n \"VISIBILITY_READ_WRITE_VALUES\"\n ],\n \"x-enum-elements\": [\n {\n \"name\": \"VISIBILITY_HIDDEN\",\n \"description\": \"The custom attribute definition and values are hidden from the seller (except on export\\nof all seller data) and other developers.\"\n },\n {\n \"name\": \"VISIBILITY_READ_ONLY\",\n \"description\": \"The seller and other developers can read the custom attribute definition and values\\non resources.\"\n },\n {\n \"name\": \"VISIBILITY_READ_WRITE_VALUES\",\n \"description\": \"The seller and other developers can read the custom attribute definition,\\nand can read and write values on resources. A custom attribute definition\\ncan only be edited or deleted by the application that created it.\"\n }\n ],\n \"description\": \"The level of permission that a seller or other applications requires to\\nview this custom attribute definition.\\nThe `Visibility` field controls who can read and write the custom attribute values\\nand custom attribute definition.\",\n \"x-release-status\": \"PUBLIC\"\n },\n \"definition\": {\n \"type\": \"object\",\n \"description\": \"Represents a definition for custom attribute values. A custom attribute definition\\nspecifies the key, visibility, schema, and other properties for a custom attribute.\",\n \"x-release-status\": \"PUBLIC\",\n \"properties\": {\n \"key\": {\n \"type\": \"string\",\n \"description\": \"The identifier\\nof the custom attribute definition and its corresponding custom attributes. This value\\ncan be a simple key, which is the key that is provided when the custom attribute definition\\nis created, or a qualified key, if the requesting\\napplication is not the definition owner. The qualified key consists of the application ID\\nof the custom attribute definition owner\\nfollowed by the simple key that was provided when the definition was created. It has the\\nformat application_id:simple key.\\n\\nThe value for a simple key can contain up to 60 alphanumeric characters, periods (.),\\nunderscores (_), and hyphens (-).\\n\\nThis field can not be changed\\nafter the custom attribute definition is created. This field is required when creating\\na definition and must be unique per application, seller, and resource type.\",\n \"minLength\": 1,\n \"pattern\": \"^([a-zA-Z0-9\\\\._-]+:)?[a-zA-Z0-9\\\\._-]{1,60}$\",\n \"nullable\": true\n },\n \"schema\": {\n \"type\": \"object\",\n \"description\": \"The JSON schema for the custom attribute definition, which determines the data type of the corresponding custom attributes. For more information,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview). This field is required when creating a definition.\",\n \"nullable\": true\n },\n \"name\": {\n \"type\": \"string\",\n \"description\": \"The name of the custom attribute definition for API and seller-facing UI purposes. The name must\\nbe unique within the seller and application pair. This field is required if the\\n`visibility` field is `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.\",\n \"maxLength\": 255,\n \"nullable\": true\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Seller-oriented description of the custom attribute definition, including any constraints\\nthat the seller should observe. May be displayed as a tooltip in Square UIs. This field is\\nrequired if the `visibility` field is `VISIBILITY_READ_ONLY` or `VISIBILITY_READ_WRITE_VALUES`.\",\n \"maxLength\": 255,\n \"nullable\": true\n },\n \"visibility\": {\n \"type\": \"string\",\n \"enum\": [\n \"VISIBILITY_HIDDEN\",\n \"VISIBILITY_READ_ONLY\",\n \"VISIBILITY_READ_WRITE_VALUES\"\n ],\n \"x-enum-elements\": [\n {\n \"name\": \"VISIBILITY_HIDDEN\",\n \"description\": \"The custom attribute definition and values are hidden from the seller (except on export\\nof all seller data) and other developers.\"\n },\n {\n \"name\": \"VISIBILITY_READ_ONLY\",\n \"description\": \"The seller and other developers can read the custom attribute definition and values\\non resources.\"\n },\n {\n \"name\": \"VISIBILITY_READ_WRITE_VALUES\",\n \"description\": \"The seller and other developers can read the custom attribute definition,\\nand can read and write values on resources. A custom attribute definition\\ncan only be edited or deleted by the application that created it.\"\n }\n ],\n \"description\": \"The level of permission that a seller or other applications requires to\\nview this custom attribute definition.\\nThe `Visibility` field controls who can read and write the custom attribute values\\nand custom attribute definition.\",\n \"x-release-status\": \"PUBLIC\"\n },\n \"version\": {\n \"type\": \"integer\",\n \"description\": \"Read only. The current version of the custom attribute definition.\\nThe value is incremented each time the custom attribute definition is updated.\\nWhen updating a custom attribute definition, you can provide this field\\nand specify the current version of the custom attribute definition to enable\\n[optimistic concurrency](https://developer.squareup.com/docs/build-basics/common-api-patterns/optimistic-concurrency).\\n\\nOn writes, this field must be set to the latest version. Stale writes are rejected.\\n\\nThis field can also be used to enforce strong consistency for reads. For more information about strong consistency for reads,\\nsee [Custom Attributes Overview](https://developer.squareup.com/docs/devtools/customattributes/overview).\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"description\": \"The timestamp that indicates when the custom attribute definition was created or most recently updated,\\nin RFC 3339 format.\",\n \"readOnly\": true\n },\n \"created_at\": {\n \"type\": \"string\",\n \"description\": \"The timestamp that indicates when the custom attribute definition was created, in RFC 3339 format.\",\n \"readOnly\": true\n }\n }\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"description\": \"The timestamp that indicates when the custom attribute was created or was most recently\\nupdated, in RFC 3339 format.\",\n \"readOnly\": true\n },\n \"created_at\": {\n \"type\": \"string\",\n \"description\": \"The timestamp that indicates when the custom attribute was created, in RFC 3339 format.\",\n \"readOnly\": true\n }\n }\n },\n \"idempotency_key\": {\n \"type\": \"string\",\n \"description\": \"A unique identifier for this request, used to ensure idempotency. \\nFor more information, see [Idempotency](https://developer.squareup.com/docs/build-basics/common-api-patterns/idempotency).\",\n \"minLength\": 1,\n \"maxLength\": 45,\n \"nullable\": true\n }\n },\n \"example\": {\n \"custom_attribute\": {\n \"key\": \"table-number\",\n \"value\": \"42\",\n \"version\": 1\n }\n }\n }\n }\n }\n}", "use_request_body_schema_mode": true, "validate_request_body_schema": true } }