Box Developer Documentation
 
    Latest version

    Create terms of service

    post
    https://api.box.com/2.0
    /terms_of_services

    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.

    post
    Create terms of service
    You can now try out some of our APIs live, right here in the documentation.
    Log in

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