Latest version

Update terms of service

put

https://api.box.com/2.0

/terms_of_services/:terms_of_service_id

This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.

Updates a specific terms of service.

Request

authorizationbearer [ACCESS_TOKEN]

content-typeapplication/json

Path Parameters

terms_of_service_id stringin pathrequired

example324234

The ID of the terms of service.

Request Body

status stringin bodyrequired

example"enabled"

Whether this terms of service is active.

Value is one of enabled,disabled

text stringin bodyrequired

example"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.

Response

200application/jsonTerms of service

Returns an updated terms of service object.

defaultapplication/jsonClient error

An unexpected client error.

put

Update terms of service

You can now try out some of our APIs live, right here in the documentation.

Request Example

cURL TypeScript Gen Python Gen .NET Gen Swift Gen (Beta)Java Gen (Beta)Java Python .NET Node iOS

curl -i -X PUT "https://api.box.com/2.0/terms_of_services/324234" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "status": "enabled",
       "text": "By collaborating on this file you are accepting..."
     }'

Swift Gen (Beta)

Java Gen (Beta)

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"
}