Manage Applications

    Update terms of service

    put
    https://api.box.com/2.0
    /terms_of_services/:terms_of_service_id

    Updates a specific terms of service.

    Request

    application/json

    Path Parameters

    stringin pathrequired
    324234

    The ID of the terms of service.

    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.

    Response

    application/jsonTerms Of Service

    Returns an updated terms of service object.

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

    Request Example

    cURL
    curl -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..."
         }'
    .NET
    var updates = new BoxTermsOfServicesRequest()
    {
        Status = "disabled",
        Text = "Updated Text"
    };
    BoxTermsOfService updatedToS = client.TermsOfServiceManager
        .UpdateTermsOfServicesAsync("11111", updates);
    Java
    BoxTermsOfService termsOfService = new BoxTermsOfService(api, "tos-id");
    BoxTermsOfService.Info termsOfServiceInfo = termsOfService.new Info();
    termsOfServiceInfo.setStatus(BoxTermsOfService.TermsOfServiceStatus.DISABLED);
    termsOfServiceInfo.setText("New Terms of Service Text");
    termsOfService.updateInfo(termsOfService);
    Python
    update_object = {'text': 'New Text'}
    updated_tos = client.terms_of_service(tos_id='12345').update_info(update_object)
    print('The updated message for your custom terms of service is {0} with ID {1}'.format(updated_tos.text, updated_tos.id))
    Node
    client.termsOfService.update('12345', { status: 'disabled' })
    	.then(tos => {
    		/* tos -> {
    			type: 'terms_of_service',
    			id: '12345',
    			status: 'disabled',
    			enterprise: { type: 'enterprise', id: '55555' },
    			tos_type: 'managed',
    			text: 'By using this service, you agree to ...',
    			created_at: '2018-04-19T13:55:09-07:00',
    			modified_at: '2018-04-19T13:55:09-07:00' }
    		*/
    	});

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