Terms of service resources

A set of endpoints used to manage terms of service agreements.

Terms of service

The root-level record that is supposed to represent a single Terms of Service.

Attributes and example

Property	Type	Required	Description
id	string	Yes	The unique identifier for this terms of service.
type	enum<string>	Yes	The value will always be terms_of_service. Available options: terms_of_service.
status	enum<string>	No	Whether these terms are enabled or not. Available options: enabled, disabled.
enterprise	object	No	A representation of a Box enterprise.
tos_type	enum<string>	No	Whether to apply these terms to managed users or external users. Available options: managed, external.
text	string	No	The text for your terms and conditions. This text could be empty if the status is set to disabled.
created_at	string	No	When the legal item was created.
modified_at	string	No	When the legal item was modified.

Example

{
  "id": "11446498",
  "type": "terms_of_service",
  "status": "enabled",
  "enterprise": {
    "id": "11446498",
    "type": "enterprise",
    "name": "Acme Inc."
  },
  "tos_type": "managed",
  "text": "By using this service, you agree to ...",
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}

Terms of service (Base)

The root-level record that is supposed to represent a single Terms of Service.

Attributes and example

Property	Type	Required	Description
id	string	Yes	The unique identifier for this terms of service.
type	enum<string>	Yes	The value will always be terms_of_service. Available options: terms_of_service.

Example

{
  "id": "11446498",
  "type": "terms_of_service"
}

Terms of services

A list of terms of services.

Attributes and example

Property	Type	Required	Description
total_count	integer	No	The total number of objects.
entries	array of Terms of service	No	A list of terms of service objects.

Example

{
  "total_count": 2,
  "entries": [
    {
      "id": "11446498",
      "type": "terms_of_service",
      "status": "enabled",
      "enterprise": {
        "id": "11446498",
        "type": "enterprise",
        "name": "Acme Inc."
      },
      "tos_type": "managed",
      "text": "By using this service, you agree to ...",
      "created_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00"
    }
  ]
}