Skip to main content
POST
/
terms_of_service_user_statuses
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
     }'
{
  "id": "11446498",
  "type": "terms_of_service_user_status",
  "tos": {
    "id": "11446498",
    "type": "terms_of_service"
  },
  "user": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "is_accepted": true,
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
tos
object
required

The terms of service to set the status for.

​
user
object
required

The user to set the status for.

​
is_accepted
boolean
required

Whether the user has accepted the terms.

Example:

true

Response

Returns a terms of service status object.

The association between a Terms of Service and a user.

​
id
string
required

The unique identifier for this terms of service user status.

Example:

"11446498"

​
type
enum<string>
required

The value will always be terms_of_service_user_status.

Available options:
terms_of_service_user_status
Example:

"terms_of_service_user_status"

​
tos
Terms of service (Base) · object

The terms of service.

​
user
User (Mini) · object

The user.

​
is_accepted
boolean

If the user has accepted the terms of services.

Example:

true

​
created_at
string<date-time>

When the legal item was created.

Example:

"2012-12-12T10:53:43-08:00"

​
modified_at
string<date-time>

When the legal item was modified.

Example:

"2012-12-12T10:53:43-08:00"