v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Metadata instances (Files)

List metadata instances on file

Retrieves all metadata for a given file.

get/files/{file_id}/metadata

Path parameters

file_idstring required

The unique identifier that represents a file.

The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123.

Query parameters

viewstring

Taxonomy field values are returned in API view by default, meaning the value is represented with a taxonomy node identifier. To retrieve the Hydrated view, where taxonomy values are represented with the full taxonomy node information, set this parameter to hydrated. This is the only supported value for this parameter.

Response

Returns all the metadata associated with a file.

This API does not support pagination and will therefore always return all of the metadata associated to the file.

limitinteger

The limit that was used for this page of results.

Example response

{
  "entries": [
    {
      "$parent": "folder_59449484661,",
      "$template": "marketingCollateral",
      "$scope": "enterprise_27335",
      "$version": 1
    }
  ],
  "limit": 100
}