Box Developer Documentation

Join BoxWorks 2024 to discover what's possible with content and AI!

Register now!

Date metadata field

Date metadata field

A metadata field of type date is displayed to a user as a date picker.

String field

Although dates are presented to users in the Box Web app as date-pickers, the actual dates are actually stored as in RFC3339 format, with up to millisecond precision. The time part of the date is always set to T00:00:00.000Z.

Create a date field

A date field can be added to a metadata template either when creating a metadata template, or when updating a template with the addField operation.

The required attributes for a date field are a type, a displayName, and a key.

{
  "scope": "enterprise",
  "displayName": "Contract",
  "fields": [
    {
      "type": "date",
      "key": "effective_date",
      "displayName": "Effective Date",
      "description": "The effective date when the contract goes in effect",
      "hidden": false
    }
  ]
}

Optionally, a description can be provided that is shown to a user in the UI, and the field can be set to hidden to hide it from users in the web and mobile apps.

Update a date field

A date template field can be updated by updating the template it belongs to. Updates to templates happen through operations to ensure that any template that is already assigned to a file or folder is updated as well.

When updating a date metadata field, the only relevant operation is the editField operation, which can be used to change the field's key, displayName, description, and hidden values.

[
  {
    "op": "editField",
    "fieldKey": "effective_date",
    "data": {
      "displayName": "Effective Contract Date",
      "description": "The contract's effective date",
      "key": "effective_contract_date",
      "hidden": true
    }
  }
]

This will affect existing instances of this template.