# Box Dev Docs: English API reference

> Box for Developers: guides, API reference, SDKs, and tutorials for building content management, Box AI, and enterprise integrations.

## API reference

###  

- [API Reference](https://developer.box.com/reference/index.md)

#### AI

- [AI resources](https://developer.box.com/reference/ai-resources.md)
- [Get AI agent default configuration](https://developer.box.com/reference/get-ai-agent-default.md): Get the AI agent default config.
- [Ask question](https://developer.box.com/reference/post-ai-ask.md): Sends an AI request to supported LLMs and returns an answer specifically focused on the user's question given the provided context.
- [Extract metadata (freeform)](https://developer.box.com/reference/post-ai-extract.md): Sends an AI request to supported Large Language Models (LLMs) and extracts metadata in form of key-value pairs. In this request, both the prompt and the output can be freeform. Metadata template setup before sending the request is not required.
- [Extract metadata (structured)](https://developer.box.com/reference/post-ai-extract-structured.md): Sends an AI request to supported Large Language Models (LLMs) and returns extracted metadata as a set of key-value pairs.
- [Generate text](https://developer.box.com/reference/post-ai-text-gen.md): Sends an AI request to supported Large Language Models (LLMs) and returns generated text based on the provided prompt.

#### AI Studio

- [AI Studio resources](https://developer.box.com/reference/ai-studio-resources.md)
- [Get AI agent by agent ID](https://developer.box.com/reference/get-ai-agents-id.md): Gets an AI Agent using the `agent_id` parameter.
- [List AI agents](https://developer.box.com/reference/get-ai-agents.md): Lists AI agents based on the provided parameters.
- [Create AI agent](https://developer.box.com/reference/post-ai-agents.md): Creates an AI agent. At least one of the following capabilities must be provided: `ask`, `text_gen`, `extract`.
- [Update AI agent](https://developer.box.com/reference/put-ai-agents-id.md): Updates an AI agent.
- [Delete AI agent](https://developer.box.com/reference/delete-ai-agents-id.md): Deletes an AI agent using the provided parameters.

#### App item associations

- [App item associations resources](https://developer.box.com/reference/app-item-associations-resources.md)
- [List file app item associations](https://developer.box.com/reference/get-files-id-app-item-associations.md): **This is a beta feature, which means that its availability might be limited.** Returns all app items the file is associated with. This includes app items associated with ancestors of the file. Assuming the context user has access to the file, the type/ids are revealed even if the context user does…
- [List folder app item associations](https://developer.box.com/reference/get-folders-id-app-item-associations.md): **This is a beta feature, which means that its availability might be limited.** Returns all app items the folder is associated with. This includes app items associated with ancestors of the folder. Assuming the context user has access to the folder, the type/ids are revealed even if the context user…

#### Authorization

- [Authorization resources](https://developer.box.com/reference/authorization-resources.md)
- [Authorize user](https://developer.box.com/reference/get-authorize.md): Authorize a user by sending them through the [Box](https://box.com) website and request their permission to act on their behalf.
- [Refresh access token](https://developer.box.com/reference/post-oauth2-token--refresh.md): Refresh an Access Token using its client ID, secret, and refresh token.
- [Request access token](https://developer.box.com/reference/post-oauth2-token.md): Request an Access Token using either a client-side obtained OAuth 2.0 authorization code or a server-side JWT assertion.
- [Revoke access token](https://developer.box.com/reference/post-oauth2-revoke.md): Revoke an active Access Token, effectively logging a user out that has been previously authenticated.

#### Box Sign requests

- [Box Sign requests resources](https://developer.box.com/reference/sign-requests-resources.md)
- [Get Box Sign request by ID](https://developer.box.com/reference/get-sign-requests-id.md): Gets a sign request by ID.
- [List Box Sign requests](https://developer.box.com/reference/get-sign-requests.md): Gets signature requests created by a user. If the `sign_files` and/or `parent_folder` are deleted, the signature request will not return in the list.
- [Cancel Box Sign request](https://developer.box.com/reference/post-sign-requests-id-cancel.md): Cancels a sign request.
- [Create Box Sign request](https://developer.box.com/reference/post-sign-requests.md): Creates a signature request. This involves preparing a document for signing and sending the signature request to signers.
- [Resend Box Sign request](https://developer.box.com/reference/post-sign-requests-id-resend.md): Resends a signature request email to all outstanding signers.

#### Box Sign templates

- [Box Sign templates resources](https://developer.box.com/reference/sign-templates-resources.md)
- [Get Box Sign template by ID](https://developer.box.com/reference/get-sign-templates-id.md): Fetches details of a specific Box Sign template.
- [List Box Sign templates](https://developer.box.com/reference/get-sign-templates.md): Gets Box Sign templates created by a user.

#### Classifications

- [Classifications resources](https://developer.box.com/reference/classifications-resources.md)
- [List all classifications](https://developer.box.com/reference/get-metadata-templates-enterprise-securityClassification-6VMVochwUWo-schema.md): Retrieves the classification metadata template and lists all the classifications available to this enterprise.
- [Add initial classifications](https://developer.box.com/reference/post-metadata-templates-schema--classifications.md): When an enterprise does not yet have any classifications, this API call initializes the classification template with an initial set of classifications.
- [Add classification](https://developer.box.com/reference/put-metadata-templates-enterprise-securityClassification-6VMVochwUWo-schema--add.md): Adds one or more new classifications to the list of classifications available to the enterprise.
- [Update classification](https://developer.box.com/reference/put-metadata-templates-enterprise-securityClassification-6VMVochwUWo-schema--update.md): Updates the labels and descriptions of one or more classifications available to the enterprise.

#### Classifications on files

- [Get classification on file](https://developer.box.com/reference/get-files-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Retrieves the classification metadata instance that has been applied to a file.
- [Add classification to file](https://developer.box.com/reference/post-files-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Adds a classification to a file by specifying the label of the classification to add.
- [Update classification on file](https://developer.box.com/reference/put-files-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Updates a classification on a file.
- [Remove classification from file](https://developer.box.com/reference/delete-files-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Removes any classifications from a file.

#### Classifications on folders

- [Get classification on folder](https://developer.box.com/reference/get-folders-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Retrieves the classification metadata instance that has been applied to a folder.
- [Add classification to folder](https://developer.box.com/reference/post-folders-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Adds a classification to a folder by specifying the label of the classification to add.
- [Update classification on folder](https://developer.box.com/reference/put-folders-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Updates a classification on a folder.
- [Remove classification from folder](https://developer.box.com/reference/delete-folders-id-metadata-enterprise-securityClassification-6VMVochwUWo.md): Removes any classifications from a folder.

#### Collaborations

- [Collaborations resources](https://developer.box.com/reference/user-collaborations-resources.md)
- [Get collaboration](https://developer.box.com/reference/get-collaborations-id.md): Retrieves a single collaboration.
- [Create collaboration](https://developer.box.com/reference/post-collaborations.md): Adds a collaboration for a single user or a single group to a file or folder.
- [Update collaboration](https://developer.box.com/reference/put-collaborations-id.md): Updates a collaboration. Can be used to change the owner of an item, or to accept collaboration invites. In case of accepting collaboration invite, role is not required.
- [Remove collaboration](https://developer.box.com/reference/delete-collaborations-id.md): Deletes a single collaboration.

#### Collaborations (List)

- [List file collaborations](https://developer.box.com/reference/get-files-id-collaborations.md): Retrieves a list of pending and active collaborations for a file. This returns all the users that have access to the file or have been invited to the file.
- [List folder collaborations](https://developer.box.com/reference/get-folders-id-collaborations.md): Retrieves a list of pending and active collaborations for a folder. This returns all the users that have access to the folder or have been invited to the folder.
- [List group collaborations](https://developer.box.com/reference/get-groups-id-collaborations.md): Retrieves all the collaborations for a group. The user must have admin permissions to inspect enterprise's groups.
- [List pending collaborations](https://developer.box.com/reference/get-collaborations.md): Retrieves all pending collaboration invites for this user.

#### Collections

- [Collections resources](https://developer.box.com/reference/collections-resources.md)
- [Get collection by ID](https://developer.box.com/reference/get-collections-id.md): Retrieves a collection by its ID.
- [List all collections](https://developer.box.com/reference/get-collections.md): Retrieves all collections for a given user.
- [List collection items](https://developer.box.com/reference/get-collections-id-items.md): Retrieves the files and/or folders contained within this collection.

#### Comments

- [Comments resources](https://developer.box.com/reference/comments-resources.md)
- [Get comment](https://developer.box.com/reference/get-comments-id.md): Retrieves the message and metadata for a specific comment, as well as information on the user who created the comment.
- [List file comments](https://developer.box.com/reference/get-files-id-comments.md): Retrieves a list of comments for a file.
- [Create comment](https://developer.box.com/reference/post-comments.md): Adds a comment by the user to a specific file, or as a reply to an other comment.
- [Update comment](https://developer.box.com/reference/put-comments-id.md): Update the message of a comment.
- [Remove comment](https://developer.box.com/reference/delete-comments-id.md): Permanently deletes a comment.

#### Device pinners

- [Device pinners resources](https://developer.box.com/reference/device-pinners-resources.md)
- [Get device pin](https://developer.box.com/reference/get-device-pinners-id.md): Retrieves information about an individual device pin.
- [List enterprise device pins](https://developer.box.com/reference/get-enterprises-id-device-pinners.md): Retrieves all the device pins within an enterprise.
- [Remove device pin](https://developer.box.com/reference/delete-device-pinners-id.md): Deletes an individual device pin.

#### Domain restrictions (User exemptions)

- [Domain restrictions (User exemptions) resources](https://developer.box.com/reference/collaboration-allowlist-exempt-targets-resources.md)
- [Get user exempt from collaboration domain restrictions](https://developer.box.com/reference/get-collaboration-whitelist-exempt-targets-id.md): Returns a users who has been exempt from the collaboration domain restrictions.
- [List users exempt from collaboration domain restrictions](https://developer.box.com/reference/get-collaboration-whitelist-exempt-targets.md): Returns a list of users who have been exempt from the collaboration domain restrictions.
- [Create user exemption from collaboration domain restrictions](https://developer.box.com/reference/post-collaboration-whitelist-exempt-targets.md): Exempts a user from the restrictions set out by the allowed list of domains for collaborations.
- [Remove user from list of users exempt from domain restrictions](https://developer.box.com/reference/delete-collaboration-whitelist-exempt-targets-id.md): Removes a user's exemption from the restrictions set out by the allowed list of domains for collaborations.

#### Domain restrictions for collaborations

- [Domain restrictions for collaborations resources](https://developer.box.com/reference/collaboration-allowlist-entries-resources.md)
- [Get allowed collaboration domain](https://developer.box.com/reference/get-collaboration-whitelist-entries-id.md): Returns a domain that has been deemed safe to create collaborations for within the current enterprise.
- [List allowed collaboration domains](https://developer.box.com/reference/get-collaboration-whitelist-entries.md): Returns the list domains that have been deemed safe to create collaborations for within the current enterprise.
- [Add domain to list of allowed collaboration domains](https://developer.box.com/reference/post-collaboration-whitelist-entries.md): Creates a new entry in the list of allowed domains to allow collaboration for.
- [Remove domain from list of allowed collaboration domains](https://developer.box.com/reference/delete-collaboration-whitelist-entries-id.md): Removes a domain from the list of domains that have been deemed safe to create collaborations for within the current enterprise.

#### Downloads

- [Download file](https://developer.box.com/reference/get-files-id-content.md): Returns the contents of a file in binary format.

#### Email aliases

- [Email aliases resources](https://developer.box.com/reference/email-aliases-resources.md)
- [List user's email aliases](https://developer.box.com/reference/get-users-id-email-aliases.md): Retrieves all email aliases for a user. The collection does not include the primary login for the user.
- [Create email alias](https://developer.box.com/reference/post-users-id-email-aliases.md): Adds a new email alias to a user account..
- [Remove email alias](https://developer.box.com/reference/delete-users-id-email-aliases-id.md): Removes an email alias from a user.

#### Events

- [Events resources](https://developer.box.com/reference/events-resources.md)
- [List user and enterprise events](https://developer.box.com/reference/get-events.md): Returns up to a year of past events for a given user or for the entire enterprise.
- [Get events long poll endpoint](https://developer.box.com/reference/options-events.md)

#### File requests

- [File requests resources](https://developer.box.com/reference/file-requests-resources.md)
- [Get file request](https://developer.box.com/reference/get-file-requests-id.md): Retrieves the information about a file request.
- [Copy file request](https://developer.box.com/reference/post-file-requests-id-copy.md): Copies an existing file request that is already present on one folder, and applies it to another folder.
- [Update file request](https://developer.box.com/reference/put-file-requests-id.md): Updates a file request. This can be used to activate or deactivate a file request.
- [Delete file request](https://developer.box.com/reference/delete-file-requests-id.md): Deletes a file request permanently.

#### File version legal holds

- [File version legal holds resources](https://developer.box.com/reference/file-version-legal-holds-resources.md)
- [Get file version legal hold](https://developer.box.com/reference/get-file-version-legal-holds-id.md): Retrieves information about the legal hold policies assigned to a file version.
- [List file version legal holds](https://developer.box.com/reference/get-file-version-legal-holds.md): Get a list of file versions on legal hold for a legal hold assignment.

#### File version retentions

- [File version retentions resources](https://developer.box.com/reference/file-version-retentions-resources.md)
- [Get retention on file](https://developer.box.com/reference/get-file-version-retentions-id.md): Returns information about a file version retention.
- [List file version retentions](https://developer.box.com/reference/get-file-version-retentions.md): Retrieves all file version retentions for the given enterprise.

#### File versions

- [File versions resources](https://developer.box.com/reference/file-versions-resources.md)
- [Get file version](https://developer.box.com/reference/get-files-id-versions-id.md): Retrieve a specific version of a file.
- [List all file versions](https://developer.box.com/reference/get-files-id-versions.md): Retrieve a list of the past versions for a file.
- [Promote file version](https://developer.box.com/reference/post-files-id-versions-current.md): Promote a specific version of a file.
- [Restore file version](https://developer.box.com/reference/put-files-id-versions-id.md): Restores a specific version of a file after it was deleted. Don't use this endpoint to restore Box Notes, as it works with file formats such as PDF, DOC, PPTX or similar.
- [Remove file version](https://developer.box.com/reference/delete-files-id-versions-id.md): Move a file version to the trash.

#### Files

- [Files resources](https://developer.box.com/reference/files-resources.md)
- [Get file information](https://developer.box.com/reference/get-files-id.md): Retrieves the details about a file.
- [Get file thumbnail](https://developer.box.com/reference/get-files-id-thumbnail-id.md): Retrieves a thumbnail, or smaller image representation, of a file.
- [Copy file](https://developer.box.com/reference/post-files-id-copy.md): Creates a copy of a file.
- [Update file](https://developer.box.com/reference/put-files-id.md): Updates a file. This can be used to rename or move a file, create a shared link, or lock a file.
- [Delete file](https://developer.box.com/reference/delete-files-id.md): Deletes a file, either permanently or by moving it to the trash.

#### Folder Locks

- [Folder Locks resources](https://developer.box.com/reference/folder-locks-resources.md)
- [List folder locks](https://developer.box.com/reference/get-folder-locks.md): Retrieves folder lock details for a given folder.
- [Create folder lock](https://developer.box.com/reference/post-folder-locks.md): Creates a folder lock on a folder, preventing it from being moved and/or deleted.
- [Delete folder lock](https://developer.box.com/reference/delete-folder-locks-id.md): Deletes a folder lock on a given folder.

#### Folders

- [Folders resources](https://developer.box.com/reference/folders-resources.md)
- [Get folder information](https://developer.box.com/reference/get-folders-id.md): Retrieves details for a folder, including the first 100 entries in the folder.
- [List items in folder](https://developer.box.com/reference/get-folders-id-items.md): Retrieves a page of items in a folder. These items can be files, folders, and web links.
- [Copy folder](https://developer.box.com/reference/post-folders-id-copy.md): Creates a copy of a folder within a destination folder.
- [Create folder](https://developer.box.com/reference/post-folders.md): Creates a new empty folder within the specified parent folder.
- [Update folder](https://developer.box.com/reference/put-folders-id.md): Updates a folder. This can be also be used to move the folder, create shared links, update collaborations, and more.
- [Delete folder](https://developer.box.com/reference/delete-folders-id.md): Deletes a folder, either permanently or by moving it to the trash.

#### Group memberships

- [Group memberships resources](https://developer.box.com/reference/memberships-resources.md)
- [Get group membership](https://developer.box.com/reference/get-group-memberships-id.md): Retrieves a specific group membership. Only admins of this group or users with admin-level permissions will be able to use this API.
- [List members of group](https://developer.box.com/reference/get-groups-id-memberships.md): Retrieves all the members for a group. Only members of this group or users with admin-level permissions will be able to use this API.
- [List user's groups](https://developer.box.com/reference/get-users-id-memberships.md): Retrieves all the groups for a user. Only members of this group or users with admin-level permissions will be able to use this API.
- [Add user to group](https://developer.box.com/reference/post-group-memberships.md): Creates a group membership. Only users with admin-level permissions will be able to use this API.
- [Update group membership](https://developer.box.com/reference/put-group-memberships-id.md): Updates a user's group membership. Only admins of this group or users with admin-level permissions will be able to use this API.
- [Remove user from group](https://developer.box.com/reference/delete-group-memberships-id.md): Deletes a specific group membership. Only admins of this group or users with admin-level permissions will be able to use this API.

#### Groups

- [Groups resources](https://developer.box.com/reference/groups-resources.md)
- [Get group](https://developer.box.com/reference/get-groups-id.md): Retrieves information about a group. Only members of this group or users with admin-level permissions will be able to use this API.
- [List groups for enterprise](https://developer.box.com/reference/get-groups.md): Retrieves all of the groups for a given enterprise. The user must have admin permissions to inspect enterprise's groups.
- [Create group](https://developer.box.com/reference/post-groups.md): Creates a new group of users in an enterprise. Only users with admin permissions can create new groups.
- [Update group](https://developer.box.com/reference/put-groups-id.md): Updates a specific group. Only admins of this group or users with admin-level permissions will be able to use this API.
- [Remove group](https://developer.box.com/reference/delete-groups-id.md): Permanently deletes a group. Only users with admin-level permissions will be able to use this API.

#### Integration mappings

- [Integration mappings resources](https://developer.box.com/reference/integration-mappings-resources.md)
- [List Slack integration mappings](https://developer.box.com/reference/get-integration-mappings-slack.md): Lists [Slack integration mappings](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack) in a users' enterprise.
- [List Teams integration mappings](https://developer.box.com/reference/get-integration-mappings-teams.md): Lists [Teams integration mappings](https://support.box.com/hc/en-us/articles/360044681474-Using-Box-for-Teams) in a users' enterprise. You need Admin or Co-Admin role to use this endpoint.
- [Create Slack integration mapping](https://developer.box.com/reference/post-integration-mappings-slack.md): Creates a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack) by mapping a Slack channel to a Box item.
- [Create Teams integration mapping](https://developer.box.com/reference/post-integration-mappings-teams.md): Creates a [Teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-Using-Box-for-Teams) by mapping a Teams channel to a Box item. You need Admin or Co-Admin role to use this endpoint.
- [Update Slack integration mapping](https://developer.box.com/reference/put-integration-mappings-slack-id.md): Updates a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack). Supports updating the Box folder ID and options.
- [Update Teams integration mapping](https://developer.box.com/reference/put-integration-mappings-teams-id.md): Updates a [Teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-Using-Box-for-Teams). Supports updating the Box folder ID and options. You need Admin or Co-Admin role to use this endpoint.
- [Delete Slack integration mapping](https://developer.box.com/reference/delete-integration-mappings-slack-id.md): Deletes a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack).
- [Delete Teams integration mapping](https://developer.box.com/reference/delete-integration-mappings-teams-id.md): Deletes a [Teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-Using-Box-for-Teams). You need Admin or Co-Admin role to use this endpoint.

#### Invites

- [Invites resources](https://developer.box.com/reference/invites-resources.md)
- [Get user invite status](https://developer.box.com/reference/get-invites-id.md): Returns the status of a user invite.
- [Create user invite](https://developer.box.com/reference/post-invites.md): Invites an existing external user to join an enterprise.

#### Legal hold policies

- [Legal hold policies resources](https://developer.box.com/reference/legal-hold-policies-resources.md)
- [Get legal hold policy](https://developer.box.com/reference/get-legal-hold-policies-id.md): Retrieve a legal hold policy.
- [List all legal hold policies](https://developer.box.com/reference/get-legal-hold-policies.md): Retrieves a list of legal hold policies that belong to an enterprise.
- [Create legal hold policy](https://developer.box.com/reference/post-legal-hold-policies.md): Create a new legal hold policy.
- [Update legal hold policy](https://developer.box.com/reference/put-legal-hold-policies-id.md): Update legal hold policy.
- [Remove legal hold policy](https://developer.box.com/reference/delete-legal-hold-policies-id.md): Delete an existing legal hold policy.

#### Legal hold policy assignments

- [Legal hold policy assignments resources](https://developer.box.com/reference/legal-hold-policy-assignments-resources.md)
- [Get legal hold policy assignment](https://developer.box.com/reference/get-legal-hold-policy-assignments-id.md): Retrieve a legal hold policy assignment.
- [List files with current file versions for legal hold policy assignment](https://developer.box.com/reference/get-legal-hold-policy-assignments-id-files-on-hold.md): Get a list of files with current file versions for a legal hold assignment.
- [List legal hold policy assignments](https://developer.box.com/reference/get-legal-hold-policy-assignments.md): Retrieves a list of items a legal hold policy has been assigned to.
- [List previous file versions for legal hold policy assignment](https://developer.box.com/reference/get-legal-hold-policy-assignments-id-file-versions-on-hold.md): Get a list of previous file versions for a legal hold assignment.
- [Assign legal hold policy](https://developer.box.com/reference/post-legal-hold-policy-assignments.md): Assign a legal hold to an item type of: file, file version, folder, user, ownership, or interactions.
- [Unassign legal hold policy](https://developer.box.com/reference/delete-legal-hold-policy-assignments-id.md): Remove a legal hold from an item.

#### Metadata cascade policies

- [Metadata cascade policies resources](https://developer.box.com/reference/metadata-cascade-policies-resources.md)
- [Get metadata cascade policy](https://developer.box.com/reference/get-metadata-cascade-policies-id.md): Retrieve a specific metadata cascade policy assigned to a folder.
- [List metadata cascade policies](https://developer.box.com/reference/get-metadata-cascade-policies.md): Retrieves a list of all the metadata cascade policies that are applied to a given folder. This can not be used on the root folder with ID `0`.
- [Create metadata cascade policy](https://developer.box.com/reference/post-metadata-cascade-policies.md): Creates a new metadata cascade policy that applies a given metadata template to a given folder and automatically cascades it down to any files within that folder.
- [Force-apply metadata cascade policy to folder](https://developer.box.com/reference/post-metadata-cascade-policies-id-apply.md): Force the metadata on a folder with a metadata cascade policy to be applied to all of its children. This can be used after creating a new cascade policy to enforce the metadata to be cascaded down to all existing files within that folder.
- [Remove metadata cascade policy](https://developer.box.com/reference/delete-metadata-cascade-policies-id.md): Deletes a metadata cascade policy.

#### Metadata instances (Files)

- [Metadata instances (Files) resources](https://developer.box.com/reference/file-metadata-resources.md)
- [Get metadata instance on file](https://developer.box.com/reference/get-files-id-metadata-id-id.md): Retrieves the instance of a metadata template that has been applied to a file.
- [List metadata instances on file](https://developer.box.com/reference/get-files-id-metadata.md): Retrieves all metadata for a given file.
- [Create metadata instance on file](https://developer.box.com/reference/post-files-id-metadata-id-id.md): Applies an instance of a metadata template to a file.
- [Update metadata instance on file](https://developer.box.com/reference/put-files-id-metadata-id-id.md): Updates a piece of metadata on a file.
- [Remove metadata instance from file](https://developer.box.com/reference/delete-files-id-metadata-id-id.md): Deletes a piece of file metadata.

#### Metadata instances (Folders)

- [Get metadata instance on folder](https://developer.box.com/reference/get-folders-id-metadata-id-id.md): Retrieves the instance of a metadata template that has been applied to a folder. This can not be used on the root folder with ID `0`.
- [List metadata instances on folder](https://developer.box.com/reference/get-folders-id-metadata.md): Retrieves all metadata for a given folder. This can not be used on the root folder with ID `0`.
- [Create metadata instance on folder](https://developer.box.com/reference/post-folders-id-metadata-id-id.md): Applies an instance of a metadata template to a folder.
- [Update metadata instance on folder](https://developer.box.com/reference/put-folders-id-metadata-id-id.md): Updates a piece of metadata on a folder.
- [Remove metadata instance from folder](https://developer.box.com/reference/delete-folders-id-metadata-id-id.md): Deletes a piece of folder metadata.

#### Metadata taxonomies

- [Metadata taxonomies resources](https://developer.box.com/reference/metadata-taxonomies-resources.md)
- [Get metadata taxonomies for namespace](https://developer.box.com/reference/get-metadata-taxonomies-id.md): Used to retrieve all metadata taxonomies in a namespace.
- [Get metadata taxonomy by taxonomy key](https://developer.box.com/reference/get-metadata-taxonomies-id-id.md): Used to retrieve a metadata taxonomy by taxonomy key.
- [Get metadata taxonomy node by ID](https://developer.box.com/reference/get-metadata-taxonomies-id-id-nodes-id.md): Retrieves a metadata taxonomy node by its identifier.
- [List metadata taxonomy nodes](https://developer.box.com/reference/get-metadata-taxonomies-id-id-nodes.md): Used to retrieve metadata taxonomy nodes based on the parameters specified. Results are sorted in lexicographic order unless a `query` parameter is passed. With a `query` parameter specified, results are sorted in order of relevance.
- [List metadata template's options for taxonomy field](https://developer.box.com/reference/get-metadata-templates-id-id-fields-id-options.md): Used to retrieve metadata taxonomy nodes which are available for the taxonomy field based on its configuration and the parameters specified. Results are sorted in lexicographic order unless a `query` parameter is passed. With a `query` parameter specified, results are sorted in order of relevance.
- [Add metadata taxonomy level](https://developer.box.com/reference/post-metadata-taxonomies-id-id-levels--append.md): Creates a new metadata taxonomy level and appends it to the existing levels. If there are no levels defined yet, this will create the first level.
- [Create metadata taxonomy](https://developer.box.com/reference/post-metadata-taxonomies.md): Creates a new metadata taxonomy that can be used in metadata templates.
- [Create metadata taxonomy levels](https://developer.box.com/reference/post-metadata-taxonomies-id-id-levels.md): Creates new metadata taxonomy levels.
- [Create metadata taxonomy node](https://developer.box.com/reference/post-metadata-taxonomies-id-id-nodes.md): Creates a new metadata taxonomy node.
- [Delete metadata taxonomy level](https://developer.box.com/reference/post-metadata-taxonomies-id-id-levels--trim.md): Deletes the last level of the metadata taxonomy.
- [Update metadata taxonomy](https://developer.box.com/reference/patch-metadata-taxonomies-id-id.md): Updates an existing metadata taxonomy.
- [Update metadata taxonomy level](https://developer.box.com/reference/patch-metadata-taxonomies-id-id-levels-id.md): Updates an existing metadata taxonomy level.
- [Update metadata taxonomy node](https://developer.box.com/reference/patch-metadata-taxonomies-id-id-nodes-id.md): Updates an existing metadata taxonomy node.
- [Remove metadata taxonomy](https://developer.box.com/reference/delete-metadata-taxonomies-id-id.md): Delete a metadata taxonomy. This deletion is permanent and cannot be reverted.
- [Remove metadata taxonomy node](https://developer.box.com/reference/delete-metadata-taxonomies-id-id-nodes-id.md): Delete a metadata taxonomy node. This deletion is permanent and cannot be reverted. Only metadata taxonomy nodes without any children can be deleted.

#### Metadata templates

- [Metadata templates resources](https://developer.box.com/reference/metadata-templates-resources.md)
- [Find metadata template by instance ID](https://developer.box.com/reference/get-metadata-templates.md): Finds a metadata template by searching for the ID of an instance of the template.
- [Get metadata template by ID](https://developer.box.com/reference/get-metadata-templates-id.md): Retrieves a metadata template by its ID.
- [Get metadata template by name](https://developer.box.com/reference/get-metadata-templates-id-id-schema.md): Retrieves a metadata template by its `scope` and `templateKey` values.
- [List all global metadata templates](https://developer.box.com/reference/get-metadata-templates-global.md): Used to retrieve all generic, global metadata templates available to all enterprises using Box.
- [List all metadata templates for enterprise](https://developer.box.com/reference/get-metadata-templates-enterprise.md): Used to retrieve all metadata templates created to be used specifically within the user's enterprise.
- [Create metadata template](https://developer.box.com/reference/post-metadata-templates-schema.md): Creates a new metadata template that can be applied to files and folders.
- [Update metadata template](https://developer.box.com/reference/put-metadata-templates-id-id-schema.md): Updates a metadata template.
- [Remove metadata template](https://developer.box.com/reference/delete-metadata-templates-id-id-schema.md): Delete a metadata template and its instances. This deletion is permanent and can not be reversed.

#### Recent items

- [Recent items resources](https://developer.box.com/reference/recent-items-resources.md)
- [List recently accessed items](https://developer.box.com/reference/get-recent-items.md): Returns information about the recent items accessed by a user, either in the last 90 days or up to the last 1000 items accessed.

#### Retention policies

- [Retention policies resources](https://developer.box.com/reference/retention-policies-resources.md)
- [Get retention policy](https://developer.box.com/reference/get-retention-policies-id.md): Retrieves a retention policy.
- [List retention policies](https://developer.box.com/reference/get-retention-policies.md): Retrieves all of the retention policies for an enterprise.
- [Create retention policy](https://developer.box.com/reference/post-retention-policies.md): Creates a retention policy.
- [Update retention policy](https://developer.box.com/reference/put-retention-policies-id.md): Updates a retention policy.
- [Delete retention policy](https://developer.box.com/reference/delete-retention-policies-id.md): Permanently deletes a retention policy.

#### Retention policy assignments

- [Retention policy assignments resources](https://developer.box.com/reference/retention-policy-assignments-resources.md)
- [Get file versions under retention](https://developer.box.com/reference/get-retention-policy-assignments-id-file-versions-under-retention.md): Returns a list of file versions under retention for a retention policy assignment.
- [Get files under retention](https://developer.box.com/reference/get-retention-policy-assignments-id-files-under-retention.md): Returns a list of files under retention for a retention policy assignment.
- [Get retention policy assignment](https://developer.box.com/reference/get-retention-policy-assignments-id.md): Retrieves a retention policy assignment.
- [List retention policy assignments](https://developer.box.com/reference/get-retention-policies-id-assignments.md): Returns a list of all retention policy assignments associated with a specified retention policy.
- [Assign retention policy](https://developer.box.com/reference/post-retention-policy-assignments.md): Assigns a retention policy to an item.
- [Remove retention policy assignment](https://developer.box.com/reference/delete-retention-policy-assignments-id.md): Removes a retention policy assignment applied to content.

#### Search

- [Search resources](https://developer.box.com/reference/search-resources.md)
- [Search for content](https://developer.box.com/reference/get-search.md): Searches for files, folders, web links, and shared files across the users content or across the entire enterprise.
- [Query files/folders by metadata](https://developer.box.com/reference/post-metadata-queries-execute-read.md): Create a search using SQL-like syntax to return items that match specific metadata.

#### Session termination

- [Session termination resources](https://developer.box.com/reference/session-termination-resources.md)
- [Create jobs to terminate user group session](https://developer.box.com/reference/post-groups-terminate-sessions.md): Validates the roles and permissions of the group, and creates asynchronous jobs to terminate the group's sessions. Returns the status for the POST request.
- [Create jobs to terminate users session](https://developer.box.com/reference/post-users-terminate-sessions.md): Validates the roles and permissions of the user, and creates asynchronous jobs to terminate the user's sessions. Returns the status for the POST request.

#### Shared links (App Items)

- [Find app item for shared link](https://developer.box.com/reference/get-shared-items--app-items.md): Returns the app item represented by a shared link.

#### Shared links (Files)

- [Find file for shared link](https://developer.box.com/reference/get-shared-items.md): Returns the file represented by a shared link.
- [Get shared link for file](https://developer.box.com/reference/get-files-id--get-shared-link.md): Gets the information for a shared link on a file.
- [Add shared link to file](https://developer.box.com/reference/put-files-id--add-shared-link.md): Adds a shared link to a file.
- [Remove shared link from file](https://developer.box.com/reference/put-files-id--remove-shared-link.md): Removes a shared link from a file.
- [Update shared link on file](https://developer.box.com/reference/put-files-id--update-shared-link.md): Updates a shared link on a file.

#### Shared links (Folders)

- [Find folder for shared link](https://developer.box.com/reference/get-shared-items--folders.md): Return the folder represented by a shared link.
- [Get shared link for folder](https://developer.box.com/reference/get-folders-id--get-shared-link.md): Gets the information for a shared link on a folder.
- [Add shared link to folder](https://developer.box.com/reference/put-folders-id--add-shared-link.md): Adds a shared link to a folder.
- [Remove shared link from folder](https://developer.box.com/reference/put-folders-id--remove-shared-link.md): Removes a shared link from a folder.
- [Update shared link on folder](https://developer.box.com/reference/put-folders-id--update-shared-link.md): Updates a shared link on a folder.

#### Shared links (Web Links)

- [Find web link for shared link](https://developer.box.com/reference/get-shared-items--web-links.md): Returns the web link represented by a shared link.
- [Get shared link for web link](https://developer.box.com/reference/get-web-links-id--get-shared-link.md): Gets the information for a shared link on a web link.
- [Add shared link to web link](https://developer.box.com/reference/put-web-links-id--add-shared-link.md): Adds a shared link to a web link.
- [Remove shared link from web link](https://developer.box.com/reference/put-web-links-id--remove-shared-link.md): Removes a shared link from a web link.
- [Update shared link on web link](https://developer.box.com/reference/put-web-links-id--update-shared-link.md): Updates a shared link on a web link.

#### Shield information barrier reports

- [Shield information barrier reports resources](https://developer.box.com/reference/shield-information-barrier-reports-resources.md)
- [Get shield information barrier report by ID](https://developer.box.com/reference/get-shield-information-barrier-reports-id.md): Retrieves a shield information barrier report by its ID.
- [List shield information barrier reports](https://developer.box.com/reference/get-shield-information-barrier-reports.md): Lists shield information barrier reports.
- [Create shield information barrier report](https://developer.box.com/reference/post-shield-information-barrier-reports.md): Creates a shield information barrier report for a given barrier.

#### Shield information barrier segment members

- [Shield information barrier segment members resources](https://developer.box.com/reference/shield-information-barrier-segment-members-resources.md)
- [Get shield information barrier segment member by ID](https://developer.box.com/reference/get-shield-information-barrier-segment-members-id.md): Retrieves a shield information barrier segment member by its ID.
- [List shield information barrier segment members](https://developer.box.com/reference/get-shield-information-barrier-segment-members.md): Lists shield information barrier segment members based on provided segment IDs.
- [Create shield information barrier segment member](https://developer.box.com/reference/post-shield-information-barrier-segment-members.md): Creates a new shield information barrier segment member.
- [Delete shield information barrier segment member by ID](https://developer.box.com/reference/delete-shield-information-barrier-segment-members-id.md): Deletes a shield information barrier segment member based on provided ID.

#### Shield information barrier segment restrictions

- [Shield information barrier segment restrictions resources](https://developer.box.com/reference/shield-information-barrier-segment-restrictions-resources.md)
- [Get shield information barrier segment restriction by ID](https://developer.box.com/reference/get-shield-information-barrier-segment-restrictions-id.md): Retrieves a shield information barrier segment restriction based on provided ID.
- [List shield information barrier segment restrictions](https://developer.box.com/reference/get-shield-information-barrier-segment-restrictions.md): Lists shield information barrier segment restrictions based on provided segment ID.
- [Create shield information barrier segment restriction](https://developer.box.com/reference/post-shield-information-barrier-segment-restrictions.md): Creates a shield information barrier segment restriction object.
- [Delete shield information barrier segment restriction by ID](https://developer.box.com/reference/delete-shield-information-barrier-segment-restrictions-id.md): Delete shield information barrier segment restriction based on provided ID.

#### Shield information barrier segments

- [Shield information barrier segments resources](https://developer.box.com/reference/shield-information-barrier-segments-resources.md)
- [Get shield information barrier segment with specified ID](https://developer.box.com/reference/get-shield-information-barrier-segments-id.md): Retrieves shield information barrier segment based on provided ID..
- [List shield information barrier segments](https://developer.box.com/reference/get-shield-information-barrier-segments.md): Retrieves a list of shield information barrier segment objects for the specified Information Barrier ID.
- [Create shield information barrier segment](https://developer.box.com/reference/post-shield-information-barrier-segments.md): Creates a shield information barrier segment.
- [Update shield information barrier segment with specified ID](https://developer.box.com/reference/put-shield-information-barrier-segments-id.md): Updates the shield information barrier segment based on provided ID..
- [Delete shield information barrier segment](https://developer.box.com/reference/delete-shield-information-barrier-segments-id.md): Deletes the shield information barrier segment based on provided ID.

#### Shield information barriers

- [Shield information barriers resources](https://developer.box.com/reference/shield-information-barriers-resources.md)
- [Get shield information barrier with specified ID](https://developer.box.com/reference/get-shield-information-barriers-id.md): Get shield information barrier based on provided ID.
- [List shield information barriers](https://developer.box.com/reference/get-shield-information-barriers.md): Retrieves a list of shield information barrier objects for the enterprise of JWT.
- [Add changed status of shield information barrier with specified ID](https://developer.box.com/reference/post-shield-information-barriers-change-status.md): Change status of shield information barrier with the specified ID.
- [Create shield information barrier](https://developer.box.com/reference/post-shield-information-barriers.md): Creates a shield information barrier to separate individuals/groups within the same firm and prevents confidential information passing between them.

#### Skills

- [Skills resources](https://developer.box.com/reference/skills-resources.md)
- [List Box Skill cards on file](https://developer.box.com/reference/get-files-id-metadata-global-boxSkillsCards.md): List the Box Skills metadata cards that are attached to a file.
- [Create Box Skill cards on file](https://developer.box.com/reference/post-files-id-metadata-global-boxSkillsCards.md): Applies one or more Box Skills metadata cards to a file.
- [Update all Box Skill cards on file](https://developer.box.com/reference/put-skill-invocations-id.md): An alternative method that can be used to overwrite and update all Box Skill metadata cards on a file.
- [Update Box Skill cards on file](https://developer.box.com/reference/put-files-id-metadata-global-boxSkillsCards.md): Updates one or more Box Skills metadata cards to a file.
- [Remove Box Skill cards from file](https://developer.box.com/reference/delete-files-id-metadata-global-boxSkillsCards.md): Removes any Box Skills cards metadata from a file.

#### Standard and Zones Storage Policies

- [Standard and Zones Storage Policies resources](https://developer.box.com/reference/storage-policies-resources.md)
- [Get storage policy](https://developer.box.com/reference/get-storage-policies-id.md): Fetches a specific storage policy.
- [List storage policies](https://developer.box.com/reference/get-storage-policies.md): Fetches all the storage policies in the enterprise.

#### Standard and Zones Storage Policy Assignments

- [Standard and Zones Storage Policy Assignments resources](https://developer.box.com/reference/storage-policy-assignments-resources.md)
- [Get storage policy assignment](https://developer.box.com/reference/get-storage-policy-assignments-id.md): Fetches a specific storage policy assignment.
- [List storage policy assignments](https://developer.box.com/reference/get-storage-policy-assignments.md): Fetches all the storage policy assignment for an enterprise or user.
- [Assign storage policy](https://developer.box.com/reference/post-storage-policy-assignments.md): Creates a storage policy assignment for an enterprise or user.
- [Update storage policy assignment](https://developer.box.com/reference/put-storage-policy-assignments-id.md): Updates a specific storage policy assignment.
- [Unassign storage policy](https://developer.box.com/reference/delete-storage-policy-assignments-id.md): Delete a storage policy assignment.

#### Task assignments

- [Task assignments resources](https://developer.box.com/reference/task-assignments-resources.md)
- [Get task assignment](https://developer.box.com/reference/get-task-assignments-id.md): Retrieves information about a task assignment.
- [List task assignments](https://developer.box.com/reference/get-tasks-id-assignments.md): Lists all of the assignments for a given task.
- [Assign task](https://developer.box.com/reference/post-task-assignments.md): Assigns a task to a user.
- [Update task assignment](https://developer.box.com/reference/put-task-assignments-id.md): Updates a task assignment. This endpoint can be used to update the state of a task assigned to a user.
- [Unassign task](https://developer.box.com/reference/delete-task-assignments-id.md): Deletes a specific task assignment.

#### Tasks

- [Tasks resources](https://developer.box.com/reference/tasks-resources.md)
- [Get task](https://developer.box.com/reference/get-tasks-id.md): Retrieves information about a specific task.
- [List tasks on file](https://developer.box.com/reference/get-files-id-tasks.md): Retrieves a list of all the tasks for a file. This endpoint does not support pagination.
- [Create task](https://developer.box.com/reference/post-tasks.md): Creates a single task on a file. This task is not assigned to any user and will need to be assigned separately.
- [Update task](https://developer.box.com/reference/put-tasks-id.md): Updates a task. This can be used to update a task's configuration, or to update its completion state.
- [Remove task](https://developer.box.com/reference/delete-tasks-id.md): Removes a task from a file.

#### Terms of service

- [Terms of service resources](https://developer.box.com/reference/terms-of-services-resources.md)
- [Get terms of service](https://developer.box.com/reference/get-terms-of-services-id.md): Fetches a specific terms of service.
- [List terms of services](https://developer.box.com/reference/get-terms-of-services.md): Returns the current terms of service text and settings for the enterprise.
- [Create terms of service](https://developer.box.com/reference/post-terms-of-services.md): Creates a terms of service for a given enterprise and type of user.
- [Update terms of service](https://developer.box.com/reference/put-terms-of-services-id.md): Updates a specific terms of service.

#### Terms of service user statuses

- [Terms of service user statuses resources](https://developer.box.com/reference/terms-of-service-user-statuses-resources.md)
- [List terms of service user statuses](https://developer.box.com/reference/get-terms-of-service-user-statuses.md): Retrieves an overview of users and their status for a terms of service, including Whether they have accepted the terms and when.
- [Create terms of service status for new user](https://developer.box.com/reference/post-terms-of-service-user-statuses.md): Sets the status for a terms of service for a user.
- [Update terms of service status for existing user](https://developer.box.com/reference/put-terms-of-service-user-statuses-id.md): Updates the status for a terms of service for a user.

#### Transfer folders

- [Transfer owned folders](https://developer.box.com/reference/put-users-id-folders-0.md): Move all of the items (files, folders and workflows) owned by a user into another user's account.

#### Trashed files

- [Trashed files resources](https://developer.box.com/reference/trashed-files-resources.md)
- [Get trashed file](https://developer.box.com/reference/get-files-id-trash.md): Retrieves a file that has been moved to the trash.
- [Restore file](https://developer.box.com/reference/post-files-id.md): Restores a file that has been moved to the trash.
- [Permanently remove file](https://developer.box.com/reference/delete-files-id-trash.md): Permanently deletes a file that is in the trash. This action cannot be undone.

#### Trashed folders

- [Trashed folders resources](https://developer.box.com/reference/trashed-folders-resources.md)
- [Get trashed folder](https://developer.box.com/reference/get-folders-id-trash.md): Retrieves a folder that has been moved to the trash.
- [Restore folder](https://developer.box.com/reference/post-folders-id.md): Restores a folder that has been moved to the trash.
- [Permanently remove folder](https://developer.box.com/reference/delete-folders-id-trash.md): Permanently deletes a folder that is in the trash. This action cannot be undone.

#### Trashed items

- [List trashed items](https://developer.box.com/reference/get-folders-trash-items.md): Retrieves the files and folders that have been moved to the trash.

#### Trashed web links

- [Trashed web links resources](https://developer.box.com/reference/trashed-web-links-resources.md)
- [Get trashed web link](https://developer.box.com/reference/get-web-links-id-trash.md): Retrieves a web link that has been moved to the trash.
- [Restore web link](https://developer.box.com/reference/post-web-links-id.md): Restores a web link that has been moved to the trash.
- [Permanently remove web link](https://developer.box.com/reference/delete-web-links-id-trash.md): Permanently deletes a web link that is in the trash. This action cannot be undone.

#### Uploads

- [Uploads resources](https://developer.box.com/reference/uploads-resources.md)
- [Upload file](https://developer.box.com/reference/post-files-content.md): Uploads a small file to Box. For file sizes over 50MB we recommend using the Chunk Upload APIs.
- [Upload file version](https://developer.box.com/reference/post-files-id-content.md): Update a file's content. For file sizes over 50MB we recommend using the Chunk Upload APIs.
- [Preflight check before upload](https://developer.box.com/reference/options-files-content.md)

#### Uploads (Chunked)

- [Uploads (Chunked) resources](https://developer.box.com/reference/chunked-uploads-resources.md)
- [Get upload session](https://developer.box.com/reference/get-files-upload-sessions-id.md): Return information about an upload session.
- [List parts](https://developer.box.com/reference/get-files-upload-sessions-id-parts.md): Return a list of the chunks uploaded to the upload session so far.
- [Commit upload session](https://developer.box.com/reference/post-files-upload-sessions-id-commit.md): Close an upload session and create a file from the uploaded chunks.
- [Create upload session](https://developer.box.com/reference/post-files-upload-sessions.md): Creates an upload session for a new file.
- [Create upload session for existing file](https://developer.box.com/reference/post-files-id-upload-sessions.md): Creates an upload session for an existing file.
- [Plan upload session](https://developer.box.com/reference/post-files-upload-sessions-id-plan.md): Plan an upload session by checking which parts already exist on the server. This endpoint allows clients to optimize uploads by skipping parts that have already been uploaded (cache hits) and only uploading missing parts.
- [Upload part of file](https://developer.box.com/reference/put-files-upload-sessions-id.md): Uploads a chunk of a file for an upload session.
- [Remove upload session](https://developer.box.com/reference/delete-files-upload-sessions-id.md): Abort an upload session and discard all data uploaded.

#### User avatars

- [User avatars resources](https://developer.box.com/reference/avatars-resources.md)
- [Get user avatar](https://developer.box.com/reference/get-users-id-avatar.md): Retrieves an image of a the user's avatar.
- [Add or update user avatar](https://developer.box.com/reference/post-users-id-avatar.md): Adds or updates a user avatar.
- [Delete user avatar](https://developer.box.com/reference/delete-users-id-avatar.md): Removes an existing user avatar. You cannot reverse this operation.

#### Users

- [Users resources](https://developer.box.com/reference/users-resources.md)
- [Get current user](https://developer.box.com/reference/get-users-me.md): Retrieves information about the user who is currently authenticated.
- [Get user](https://developer.box.com/reference/get-users-id.md): Retrieves information about a user in the enterprise.
- [List enterprise users](https://developer.box.com/reference/get-users.md): Returns a list of all users for the Enterprise along with their `user_id`, `public_name`, and `login`.
- [Create user](https://developer.box.com/reference/post-users.md): Creates a new managed user in an enterprise. This endpoint is only available to users and applications with the right admin permissions.
- [Update user](https://developer.box.com/reference/put-users-id.md): Updates a managed or app user in an enterprise. This endpoint is only available to users and applications with the right admin permissions.
- [Delete user](https://developer.box.com/reference/delete-users-id.md): Deletes a user. By default, this operation fails if the user still owns any content. To proceed, move their owned content first, or use the `force` parameter to delete the user and their files.

#### Watermarks (Files)

- [Watermarks (Files) resources](https://developer.box.com/reference/file-watermarks-resources.md)
- [Get watermark on file](https://developer.box.com/reference/get-files-id-watermark.md): Retrieve the watermark for a file.
- [Apply watermark to file](https://developer.box.com/reference/put-files-id-watermark.md): Applies or update a watermark on a file.
- [Remove watermark from file](https://developer.box.com/reference/delete-files-id-watermark.md): Removes the watermark from a file.

#### Watermarks (Folders)

- [Get watermark for folder](https://developer.box.com/reference/get-folders-id-watermark.md): Retrieve the watermark for a folder.
- [Apply watermark to folder](https://developer.box.com/reference/put-folders-id-watermark.md): Applies or update a watermark on a folder.
- [Remove watermark from folder](https://developer.box.com/reference/delete-folders-id-watermark.md): Removes the watermark from a folder.

#### Web links

- [Web links resources](https://developer.box.com/reference/web-links-resources.md)
- [Get web link](https://developer.box.com/reference/get-web-links-id.md): Retrieve information about a web link.
- [Create web link](https://developer.box.com/reference/post-web-links.md): Creates a web link object within a folder.
- [Update web link](https://developer.box.com/reference/put-web-links-id.md): Updates a web link object.
- [Remove web link](https://developer.box.com/reference/delete-web-links-id.md): Deletes a web link.

#### Webhooks

- [Webhooks resources](https://developer.box.com/reference/webhooks-resources.md)
- [Get webhook](https://developer.box.com/reference/get-webhooks-id.md): Retrieves a specific webhook.
- [List all webhooks](https://developer.box.com/reference/get-webhooks.md): Returns all defined webhooks for the requesting application.
- [Create webhook](https://developer.box.com/reference/post-webhooks.md): Creates a webhook.
- [Update webhook](https://developer.box.com/reference/put-webhooks-id.md): Updates a webhook.
- [Remove webhook](https://developer.box.com/reference/delete-webhooks-id.md): Deletes a webhook.

#### Workflows

- [Workflows resources](https://developer.box.com/reference/workflows-resources.md)
- [List workflows](https://developer.box.com/reference/get-workflows.md): Returns list of workflows that act on a given `folder ID`, and have a flow with a trigger type of `WORKFLOW_MANUAL_START`.
- [Starts workflow based on request body](https://developer.box.com/reference/post-workflows-id-start.md): Initiates a flow with a trigger type of `WORKFLOW_MANUAL_START`.

#### Zip Downloads

- [Zip Downloads resources](https://developer.box.com/reference/zip-downloads-resources.md)
- [Download zip archive](https://developer.box.com/reference/get-zip-downloads-id-content.md): Returns the contents of a `zip` archive in binary format. This URL does not require any form of authentication and could be used in a user's browser to download the archive to a user's device.
- [Get zip download status](https://developer.box.com/reference/get-zip-downloads-id-status.md): Returns the download status of a `zip` archive, allowing an application to inspect the progress of the download as well as the number of items that might have been skipped.
- [Create zip download](https://developer.box.com/reference/post-zip-downloads.md): Creates a request to download multiple files and folders as a single `zip` archive file. This API does not return the archive but instead performs all the checks to ensure that the user has access to all the items, and then returns a `download_url` and a `status_url` that can be used to download the…

### v2025.0

#### Archives

- [Archives resources](https://developer.box.com/reference/v2025.0/archives-resources.md)
- [List archives](https://developer.box.com/reference/v2025.0/get-archives.md): Retrieves archives for an enterprise.
- [Create archive](https://developer.box.com/reference/v2025.0/post-archives.md): Creates an archive.
- [Update archive](https://developer.box.com/reference/v2025.0/put-archives-id.md): Updates an archive.
- [Delete archive](https://developer.box.com/reference/v2025.0/delete-archives-id.md): Permanently deletes an archive.

#### Box Doc Gen

- [Box Doc Gen resources](https://developer.box.com/reference/v2025.0/docgen-resources.md)
- [Get Box Doc Gen job by ID](https://developer.box.com/reference/v2025.0/get-docgen-jobs-id.md): Get details of the Box Doc Gen job.
- [Get Box Doc Gen jobs by batch ID](https://developer.box.com/reference/v2025.0/get-docgen-batch-jobs-id.md): Lists Box Doc Gen jobs in a batch.
- [List all Box Doc Gen jobs](https://developer.box.com/reference/v2025.0/get-docgen-jobs.md): Lists all Box Doc Gen jobs for a user.
- [Generate document using Box Doc Gen template](https://developer.box.com/reference/v2025.0/post-docgen-batches.md): Generates a document using a Box Doc Gen template.

#### Box Doc Gen templates

- [Box Doc Gen templates resources](https://developer.box.com/reference/v2025.0/docgen-template-resources.md)
- [Get Box Doc Gen template by ID](https://developer.box.com/reference/v2025.0/get-docgen-templates-id.md): Lists details of a specific Box Doc Gen template.
- [Get list of all Box Doc Gen jobs for template](https://developer.box.com/reference/v2025.0/get-docgen-template-jobs-id.md): Lists the users jobs which use this template.
- [List all Box Doc Gen template tags in template](https://developer.box.com/reference/v2025.0/get-docgen-templates-id-tags.md): Lists all tags in a Box Doc Gen template.
- [List Box Doc Gen templates](https://developer.box.com/reference/v2025.0/get-docgen-templates.md): Lists Box Doc Gen templates on which the user is a collaborator.
- [Create Box Doc Gen template](https://developer.box.com/reference/v2025.0/post-docgen-templates.md): Marks a file as a Box Doc Gen template.
- [Delete Box Doc Gen template](https://developer.box.com/reference/v2025.0/delete-docgen-templates-id.md): Unmarks file as Box Doc Gen template.

#### Box Hub Collaborations

- [Box Hub Collaborations resources](https://developer.box.com/reference/v2025.0/hub-collaborations-resources.md)
- [Get Box Hub collaboration by collaboration ID](https://developer.box.com/reference/v2025.0/get-hub-collaborations-id.md): Retrieves details for a Box Hub collaboration by collaboration ID.
- [Get Box Hub collaborations](https://developer.box.com/reference/v2025.0/get-hub-collaborations.md): Retrieves all collaborations for a Box Hub.
- [Create Box Hub collaboration](https://developer.box.com/reference/v2025.0/post-hub-collaborations.md): Adds a collaboration for a single user or a single group to a Box Hub.
- [Update Box Hub collaboration](https://developer.box.com/reference/v2025.0/put-hub-collaborations-id.md): Updates a Box Hub collaboration. Can be used to change the Box Hub role.
- [Remove Box Hub collaboration](https://developer.box.com/reference/v2025.0/delete-hub-collaborations-id.md): Deletes a single Box Hub collaboration.

#### Box Hub Document

- [Box Hub Document resources](https://developer.box.com/reference/v2025.0/hub-document-resources.md)
- [List Hub Document blocks for page](https://developer.box.com/reference/v2025.0/get-hub-document-blocks.md): Retrieves a sorted list of all Hub Document Blocks on a specified page in the hub document, excluding items. Blocks are hierarchically organized by their `parent_id`. Blocks are sorted in order based on user specification in the user interface. The response will only include content blocks that belo…
- [List Hub Document Pages](https://developer.box.com/reference/v2025.0/get-hub-document-pages.md): Retrieves a list of Hub Document Pages for the specified hub. Includes both root-level pages and sub pages.

#### Box Hub Items

- [Box Hub Items resources](https://developer.box.com/reference/v2025.0/hub-items-resources.md)
- [Get Box Hub items](https://developer.box.com/reference/v2025.0/get-hub-items.md): Retrieves all items associated with a Box Hub.
- [Manage Box Hub items](https://developer.box.com/reference/v2025.0/post-hubs-id-manage-items.md): Adds and/or removes Box Hub items from a Box Hub.

#### Box Hubs

- [Box Hubs resources](https://developer.box.com/reference/v2025.0/hubs-resources.md)
- [Get Box Hub information by ID](https://developer.box.com/reference/v2025.0/get-hubs-id.md): Retrieves details for a Box Hub by its ID.
- [List all Box Hubs](https://developer.box.com/reference/v2025.0/get-hubs.md): Retrieves all Box Hubs for requesting user.
- [List all Box Hubs for requesting enterprise](https://developer.box.com/reference/v2025.0/get-enterprise-hubs.md): Retrieves all Box Hubs for a given enterprise.
- [Copy Box Hub](https://developer.box.com/reference/v2025.0/post-hubs-id-copy.md): Creates a copy of a Box Hub.
- [Create Box Hub](https://developer.box.com/reference/v2025.0/post-hubs.md): Creates a new Box Hub.
- [Update Box Hub information by ID](https://developer.box.com/reference/v2025.0/put-hubs-id.md): Updates a Box Hub. Can be used to change title, description, or Box Hub settings.
- [Delete Box Hub](https://developer.box.com/reference/v2025.0/delete-hubs-id.md): Deletes a single Box Hub.

#### Enterprise Configurations

- [Enterprise Configurations resources](https://developer.box.com/reference/v2025.0/enterprise-configurations-resources.md)
- [Get enterprise configuration](https://developer.box.com/reference/v2025.0/get-enterprise-configurations-id.md): Retrieves the configuration for an enterprise.

#### External Users

- [External Users resources](https://developer.box.com/reference/v2025.0/external-users-resources.md)
- [Submit job to delete external users](https://developer.box.com/reference/v2025.0/post-external-users-submit-delete-job.md): Delete external users from current user enterprise. This will remove each external user from all invited collaborations within the current enterprise.

#### Shield lists

- [Shield lists resources](https://developer.box.com/reference/v2025.0/shield-lists-resources.md)
- [Get all shield lists in enterprise](https://developer.box.com/reference/v2025.0/get-shield-lists.md): Retrieves all shield lists in the enterprise.
- [Get single shield list by shield list id](https://developer.box.com/reference/v2025.0/get-shield-lists-id.md): Retrieves a single shield list by its ID.
- [Create shield list](https://developer.box.com/reference/v2025.0/post-shield-lists.md): Creates a shield list.
- [Update shield list](https://developer.box.com/reference/v2025.0/put-shield-lists-id.md): Updates a shield list.
- [Delete single shield list by shield list id](https://developer.box.com/reference/v2025.0/delete-shield-lists-id.md): Delete a single shield list by its ID.

### v2026.0

#### Automate Workflows

- [List Automate workflows defined as callable actions](https://developer.box.com/reference/v2026.0/get-automate-workflows.md): Returns workflow actions from Automate for a folder, using the `WORKFLOW` action category.
- [Start Automate workflow](https://developer.box.com/reference/v2026.0/post-automate-workflows-id-start.md): Starts an Automate workflow manually by using a workflow action ID and file IDs.

#### Convert to Box note

- [Convert to Box note resources](https://developer.box.com/reference/v2026.0/notes-resources.md)
- [Convert content to Box Note](https://developer.box.com/reference/v2026.0/post-notes-convert.md): Creates a Box Note (`.boxnote` file) from supported source content. See the `content_format` field for supported formats.

#### Query

- [Query resources](https://developer.box.com/reference/v2026.0/query-resources.md)
- [Create insights for Box items](https://developer.box.com/reference/v2026.0/post-query-insights.md): Computes aggregated metrics over Box items matching a query predicate. Filters are applied first, followed by optional grouping, after which the requested metrics (such as `sum`, `avg`, `min`, `max`, and `count`) are computed for each resulting group or over the entire filtered dataset.
- [Query for Box items](https://developer.box.com/reference/v2026.0/post-query.md): Runs a query to discover Box items using a logical predicate that can filter across item fields and metadata templates. Results can be sorted, paginated, and shaped to include additional item or metadata fields.

## OpenAPI Specs

- [box-openapi](/box-openapi.json)
- [box-openapi-v2025.0](/box-openapi-v2025.0.json)
- [box-openapi-v2026.0](/box-openapi-v2026.0.json)