Latest version
Create terms of service
API version 2024.0
Creates a terms of service for a given enterprise and type of user.
Request
bearer [ACCESS_TOKEN]
application/json
Request Body
stringin bodyrequired
"enabled"Whether this terms of service is active.
Value is one of enabled,disabled
stringin bodyrequired
"By collaborating on this file you are accepting..."The terms of service text to display to users.
The text can be set to empty if the status is set to disabled.
stringin bodyoptional
"managed"The type of user to set the terms of service for.
Value is one of external,managed
Response
application/jsonTerms of service
Returns a new task object
application/jsonClient error
An unexpected client error.
Request Example
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..."
}'Response Example
{
"id": "11446498",
"type": "terms_of_service",
"created_at": "2012-12-12T10:53:43-08:00",
"enterprise": {
"id": "11446498",
"type": "enterprise",
"name": "Acme Inc."
},
"modified_at": "2012-12-12T10:53:43-08:00",
"status": "enabled",
"text": "By using this service, you agree to ...",
"tos_type": "managed"
}