Skip to main content
PUT
/
storage_policy_assignments
/
{storage_policy_assignment_id}
cURL
curl -i -X PUT "https://api.box.com/2.0/storage_policy_assignments/932483" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "storage_policy": {
         "type": "storage_policy",
         "id": "1434325"
       }
     }'
{
  "id": "ZW50ZXJwcmlzZV8xMjM0NTY3ODkw",
  "type": "storage_policy_assignment",
  "storage_policy": {
    "id": "11446498",
    "type": "storage_policy"
  },
  "assigned_to": {
    "id": "11446498",
    "type": "file"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

Path Parameters

​
storage_policy_assignment_id
string
required

The ID of the storage policy assignment.

Body

application/json
​
storage_policy
object
required

The storage policy to assign to the user or enterprise.

Response

Returns an updated storage policy assignment object.

The assignment of a storage policy to a user or enterprise.

​
id
string
required

The unique identifier for a storage policy assignment.

Example:

"ZW50ZXJwcmlzZV8xMjM0NTY3ODkw"

​
type
enum<string>
required

The value will always be storage_policy_assignment.

Available options:
storage_policy_assignment
Example:

"storage_policy_assignment"

​
storage_policy
Storage policy (Mini) · object

The assigned storage policy.

​
assigned_to
Reference · object

The enterprise or use the policy is assigned to.