Skip to main content
POST
/
terms_of_services
cURL
curl -i -X POST "https://api.box.com/2.0/terms_of_services" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "status": "enabled",
       "text": "By collaborating on this file you are accepting..."
     }'
{
  "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"
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
status
enum<string>
required

Whether this terms of service is active.

Available options:
enabled,
disabled
Example:

"enabled"

​
text
string
required

The terms of service text to display to users.

The text can be set to empty if the status is set to disabled.

Example:

"By collaborating on this file you are accepting..."

​
tos_type
enum<string>

The type of user to set the terms of service for.

Available options:
external,
managed
Example:

"managed"

Response

Returns a new task object.

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

​
id
string
required

The unique identifier for this terms of service.

Example:

"11446498"

​
type
enum<string>
required

The value will always be terms_of_service.

Available options:
terms_of_service
Example:

"terms_of_service"

​
status
enum<string>

Whether these terms are enabled or not.

Available options:
enabled,
disabled
Example:

"enabled"

​
enterprise
Enterprise · object

The enterprise these terms apply to.

​
tos_type
enum<string>

Whether to apply these terms to managed users or external users.

Available options:
managed,
external
Example:

"managed"

​
text
string

The text for your terms and conditions. This text could be empty if the status is set to disabled.

Example:

"By using this service, you agree to ..."

​
created_at
string<date-time>

When the legal item was created.

Example:

"2012-12-12T10:53:43-08:00"

​
modified_at
string<date-time>

When the legal item was modified.

Example:

"2012-12-12T10:53:43-08:00"