Box Developer Documentation
 
    Latest version

    Create terms of service status for new user

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

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

    Sets the status for a terms of service for a user.

    Request

    bearer [ACCESS_TOKEN]
    application/json

    Request Body

    booleanin bodyrequired
    true

    Whether the user has accepted the terms.

    objectin body

    The terms of service to set the status for.

    stringin bodyrequired
    "1232132"

    The ID of terms of service

    stringin bodyrequired
    "terms_of_service"

    The type of object.

    Value is always terms_of_service

    objectin body

    The user to set the status for.

    stringin bodyrequired
    "3423423"

    The ID of user

    stringin bodyrequired
    "user"

    The type of object.

    Value is always user

    Response

    Returns a terms of service status object.

    application/jsonClient error

    An unexpected client error.

    post
    Create terms of service status for new user
    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_service_user_statuses" \
         -H "authorization: Bearer <ACCESS_TOKEN>" \
         -H "content-type: application/json" \
         -d '{
           "tos": {
             "type": "terms_of_service",
             "id": "1232132"
           },
           "user": {
             "type": "user",
             "id": "3423423"
           },
           "is_accepted": true
         }'

    Response Example

    {
      "id": "11446498",
      "type": "terms_of_service_user_status",
      "created_at": "2012-12-12T10:53:43-08:00",
      "is_accepted": true,
      "modified_at": "2012-12-12T10:53:43-08:00",
      "tos": {
        "id": "11446498",
        "type": "terms_of_service"
      },
      "user": {
        "id": "11446498",
        "type": "user",
        "login": "ceo@example.com",
        "name": "Aaron Levie"
      }
    }