Manage Applications

    Assign storage policy

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

    Creates a storage policy assignment for an enterprise or user.

    Request

    application/json

    Request Body

    objectin body

    The user or enterprise to assign the storage policy to.

    stringin bodyrequired
    9987987

    The ID of the user or enterprise

    stringin bodyrequired
    user

    The type to assign the policy to.

    Value is one of "user", "enterprise"

    objectin body

    The storage policy to assign to the user or enterprise

    stringin bodyrequired
    1434325

    The ID of the storage policy to assign.

    stringin bodyrequired
    storage_policy

    Value is always "storage_policy"

    Response

    Returns the new storage policy assignment created.

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

    Request Example

    cURL
    curl -X POST https://api.box.com/2.0/storage_policy_assignments \
         -H "Authorization: Bearer <ACCESS_TOKEN>" \
         -H "Content-Type: application/json" \
         -d '{
           "storage_policy": {
             "type": "storage_policy",
             "id": "1434325"
           },
           "assigned_to": {
             "type": "user",
             "id": "9987987"
           }
         }'
    .NET
    BoxStoragePolicyAssignment assignment = client.StoragePoliciesManager
        .CreateAssignmentAsync(userId: "22222", policyId: "6");
    Java
    BoxStoragePolicyAssignment.Info assignmentInfo = BoxStoragePolicyAssignment.assign(api, "1234", "5678");
    Python
    user = client.user(user_id='12345')
    assignment = client.storage_policy(policy_id='56781').assign(user)
    print('Assignment ID is {0} and the assignee id is {1}'.format(assignment.id,assignment.assigned_to.id))
    Node
    client.storagePolicies.createAssignment('7', '22222')
        .then(assignment => {
            /* assignment -> {
                type: 'storage_policy_assignment',
                id: 'dXNlcl8yMjIyMg==',
                storage_policy: 'storage_policy', id: '7' },
                assigned_to: { type: 'user', id: '22222' } }
            */
        });

    Response Example

    {
      "storage_policy": {
        "id": 11446498,
        "type": "storage_policy"
      },
      "assigned_to": {
        "id": 11446498
      }
    }