Skip to main content
POST
/
storage_policy_assignments
cURL
curl -i -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"
       }
     }'
{
  "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.

Body

application/json
​
storage_policy
object
required

The storage policy to assign to the user or enterprise.

​
assigned_to
object
required

The user or enterprise to assign the storage policy to.

Response

Returns the new storage policy assignment created.

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.