{
  "info": {
    "_postman_id": "cd2df794-5eab-4038-85e2-3809ff4d07f4",
    "name": "Box Authorize Authorization File Version Retentions API",
    "description": "Needs a description.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T01:16:03.000Z",
    "updatedAt": "2026-07-28T01:16:03.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-cd2df794-5eab-4038-85e2-3809ff4d07f4"
  },
  "item": [
    {
      "name": "file_version_retentions",
      "item": [
        {
          "name": "{file_version_retention_id}",
          "item": [
            {
              "name": "Box Get retention on file",
              "id": "204669b9-bdc2-456d-8eff-218c2d2cc9c9",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/file_version_retentions/:file_version_retention_id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "file_version_retentions",
                    ":file_version_retention_id"
                  ],
                  "variable": [
                    {
                      "id": "3366fa34-c564-4889-816c-a438caf6d53c",
                      "key": "file_version_retention_id",
                      "value": "<string>",
                      "description": "(Required) The ID of the file version retention"
                    }
                  ]
                },
                "description": "Returns information about a file version retention."
              },
              "response": [
                {
                  "id": "3886e017-12fa-4b8f-b813-6ac34ffd7961",
                  "name": "Returns a file version retention object.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/file_version_retentions/:file_version_retention_id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "file_version_retentions",
                        ":file_version_retention_id"
                      ],
                      "variable": [
                        {
                          "key": "file_version_retention_id"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"id\": \"<string>\",\n  \"type\": \"file_version_retention\",\n  \"file_version\": {\n    \"id\": \"<string>\",\n    \"type\": \"file_version\",\n    \"sha1\": \"<string>\"\n  },\n  \"file\": {\n    \"id\": \"<string>\",\n    \"type\": \"file\",\n    \"etag\": \"<string>\",\n    \"sequence_id\": \"<string>\",\n    \"name\": \"<string>\",\n    \"sha1\": \"<string>\",\n    \"file_version\": {\n      \"id\": \"<string>\",\n      \"type\": \"file_version\",\n      \"sha1\": \"<string>\"\n    }\n  },\n  \"applied_at\": \"<dateTime>\",\n  \"disposition_at\": \"<dateTime>\",\n  \"winning_retention_policy\": {\n    \"id\": \"<string>\",\n    \"type\": \"retention_policy\",\n    \"policy_name\": \"<string>\",\n    \"retention_length\": \"<string>\",\n    \"disposition_action\": \"permanently_delete\"\n  }\n}",
                  "createdAt": "2026-07-28T01:16:03.000Z",
                  "updatedAt": "2026-07-28T01:16:03.000Z",
                  "uid": "35240-3886e017-12fa-4b8f-b813-6ac34ffd7961"
                },
                {
                  "id": "f5d6d64b-ee4f-4673-921a-b1f03ff7cd7b",
                  "name": "An unexpected client error.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/file_version_retentions/:file_version_retention_id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "file_version_retentions",
                        ":file_version_retention_id"
                      ],
                      "variable": [
                        {
                          "key": "file_version_retention_id"
                        }
                      ]
                    }
                  },
                  "status": "Internal Server Error",
                  "code": 500,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"type\": \"error\",\n  \"status\": \"<integer>\",\n  \"code\": \"created\",\n  \"message\": \"<string>\",\n  \"context_info\": {\n    \"message\": \"<string>\"\n  },\n  \"help_url\": \"<string>\",\n  \"request_id\": \"<string>\"\n}",
                  "createdAt": "2026-07-28T01:16:03.000Z",
                  "updatedAt": "2026-07-28T01:16:03.000Z",
                  "uid": "35240-f5d6d64b-ee4f-4673-921a-b1f03ff7cd7b"
                }
              ],
              "createdAt": "2026-07-28T01:16:03.000Z",
              "updatedAt": "2026-07-28T01:16:03.000Z",
              "uid": "35240-204669b9-bdc2-456d-8eff-218c2d2cc9c9"
            }
          ],
          "id": "0345fa2f-9280-461f-943c-8df5f06eda38",
          "createdAt": "2026-07-28T01:16:03.000Z",
          "updatedAt": "2026-07-28T01:16:03.000Z",
          "uid": "35240-0345fa2f-9280-461f-943c-8df5f06eda38"
        },
        {
          "name": "Box List file version retentions",
          "id": "90d74c74-38fb-467b-bbc1-d9898b3f634d",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/file_version_retentions?file_id=<string>&file_version_id=<string>&policy_id=<string>&disposition_action=permanently_delete&disposition_before=<string>&disposition_after=<string>&limit=<long>&marker=<string>",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "file_version_retentions"
              ],
              "query": [
                {
                  "description": "Filters results by files with this ID.",
                  "key": "file_id",
                  "value": "<string>"
                },
                {
                  "description": "Filters results by file versions with this ID.",
                  "key": "file_version_id",
                  "value": "<string>"
                },
                {
                  "description": "Filters results by the retention policy with this ID.",
                  "key": "policy_id",
                  "value": "<string>"
                },
                {
                  "description": "Filters results by the retention policy with this disposition\naction.",
                  "key": "disposition_action",
                  "value": "permanently_delete"
                },
                {
                  "description": "Filters results by files that will have their disposition\ncome into effect before this date.",
                  "key": "disposition_before",
                  "value": "<string>"
                },
                {
                  "description": "Filters results by files that will have their disposition\ncome into effect after this date.",
                  "key": "disposition_after",
                  "value": "<string>"
                },
                {
                  "description": "The maximum number of items to return per page.",
                  "key": "limit",
                  "value": "<long>"
                },
                {
                  "description": "Defines the position marker at which to begin returning results. This is\nused when paginating using marker-based pagination.\n\nThis requires `usemarker` to be set to `true`.",
                  "key": "marker",
                  "value": "<string>"
                }
              ]
            },
            "description": "Retrieves all file version retentions for the given enterprise."
          },
          "response": [
            {
              "id": "05ab4e77-17f3-4acb-800d-4d27df234e3f",
              "name": "Returns a list of all file version retentions for the enterprise.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/file_version_retentions?file_id=<string>&file_version_id=<string>&policy_id=<string>&disposition_action=permanently_delete&disposition_before=<string>&disposition_after=<string>&limit=<long>&marker=<string>",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "file_version_retentions"
                  ],
                  "query": [
                    {
                      "description": "Filters results by files with this ID.",
                      "key": "file_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by file versions with this ID.",
                      "key": "file_version_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by the retention policy with this ID.",
                      "key": "policy_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by the retention policy with this disposition\naction.",
                      "key": "disposition_action",
                      "value": "permanently_delete"
                    },
                    {
                      "description": "Filters results by files that will have their disposition\ncome into effect before this date.",
                      "key": "disposition_before",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by files that will have their disposition\ncome into effect after this date.",
                      "key": "disposition_after",
                      "value": "<string>"
                    },
                    {
                      "description": "The maximum number of items to return per page.",
                      "key": "limit",
                      "value": "<long>"
                    },
                    {
                      "description": "Defines the position marker at which to begin returning results. This is\nused when paginating using marker-based pagination.\n\nThis requires `usemarker` to be set to `true`.",
                      "key": "marker",
                      "value": "<string>"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"limit\": \"<long>\",\n  \"next_marker\": \"<string>\",\n  \"prev_marker\": \"<string>\",\n  \"entries\": [\n    {\n      \"id\": \"<string>\",\n      \"type\": \"file_version_retention\",\n      \"file_version\": {\n        \"id\": \"<string>\",\n        \"type\": \"file_version\",\n        \"sha1\": \"<string>\"\n      },\n      \"file\": {\n        \"id\": \"<string>\",\n        \"type\": \"file\",\n        \"etag\": \"<string>\",\n        \"sequence_id\": \"<string>\",\n        \"name\": \"<string>\",\n        \"sha1\": \"<string>\",\n        \"file_version\": {\n          \"id\": \"<string>\",\n          \"type\": \"file_version\",\n          \"sha1\": \"<string>\"\n        }\n      },\n      \"applied_at\": \"<dateTime>\",\n      \"disposition_at\": \"<dateTime>\",\n      \"winning_retention_policy\": {\n        \"id\": \"<string>\",\n        \"type\": \"retention_policy\",\n        \"policy_name\": \"<string>\",\n        \"retention_length\": \"<string>\",\n        \"disposition_action\": \"remove_retention\"\n      }\n    },\n    {\n      \"id\": \"<string>\",\n      \"type\": \"file_version_retention\",\n      \"file_version\": {\n        \"id\": \"<string>\",\n        \"type\": \"file_version\",\n        \"sha1\": \"<string>\"\n      },\n      \"file\": {\n        \"id\": \"<string>\",\n        \"type\": \"file\",\n        \"etag\": \"<string>\",\n        \"sequence_id\": \"<string>\",\n        \"name\": \"<string>\",\n        \"sha1\": \"<string>\",\n        \"file_version\": {\n          \"id\": \"<string>\",\n          \"type\": \"file_version\",\n          \"sha1\": \"<string>\"\n        }\n      },\n      \"applied_at\": \"<dateTime>\",\n      \"disposition_at\": \"<dateTime>\",\n      \"winning_retention_policy\": {\n        \"id\": \"<string>\",\n        \"type\": \"retention_policy\",\n        \"policy_name\": \"<string>\",\n        \"retention_length\": \"<string>\",\n        \"disposition_action\": \"permanently_delete\"\n      }\n    }\n  ]\n}",
              "createdAt": "2026-07-28T01:16:03.000Z",
              "updatedAt": "2026-07-28T01:16:03.000Z",
              "uid": "35240-05ab4e77-17f3-4acb-800d-4d27df234e3f"
            },
            {
              "id": "8eabb89f-c43f-42f7-bf7f-b7bb1712788f",
              "name": "An unexpected client error.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/file_version_retentions?file_id=<string>&file_version_id=<string>&policy_id=<string>&disposition_action=permanently_delete&disposition_before=<string>&disposition_after=<string>&limit=<long>&marker=<string>",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "file_version_retentions"
                  ],
                  "query": [
                    {
                      "description": "Filters results by files with this ID.",
                      "key": "file_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by file versions with this ID.",
                      "key": "file_version_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by the retention policy with this ID.",
                      "key": "policy_id",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by the retention policy with this disposition\naction.",
                      "key": "disposition_action",
                      "value": "permanently_delete"
                    },
                    {
                      "description": "Filters results by files that will have their disposition\ncome into effect before this date.",
                      "key": "disposition_before",
                      "value": "<string>"
                    },
                    {
                      "description": "Filters results by files that will have their disposition\ncome into effect after this date.",
                      "key": "disposition_after",
                      "value": "<string>"
                    },
                    {
                      "description": "The maximum number of items to return per page.",
                      "key": "limit",
                      "value": "<long>"
                    },
                    {
                      "description": "Defines the position marker at which to begin returning results. This is\nused when paginating using marker-based pagination.\n\nThis requires `usemarker` to be set to `true`.",
                      "key": "marker",
                      "value": "<string>"
                    }
                  ]
                }
              },
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"type\": \"error\",\n  \"status\": \"<integer>\",\n  \"code\": \"created\",\n  \"message\": \"<string>\",\n  \"context_info\": {\n    \"message\": \"<string>\"\n  },\n  \"help_url\": \"<string>\",\n  \"request_id\": \"<string>\"\n}",
              "createdAt": "2026-07-28T01:16:03.000Z",
              "updatedAt": "2026-07-28T01:16:03.000Z",
              "uid": "35240-8eabb89f-c43f-42f7-bf7f-b7bb1712788f"
            }
          ],
          "createdAt": "2026-07-28T01:16:03.000Z",
          "updatedAt": "2026-07-28T01:16:03.000Z",
          "uid": "35240-90d74c74-38fb-467b-bbc1-d9898b3f634d"
        }
      ],
      "id": "a2edd088-d964-4075-80f8-ad4df0d4db62",
      "createdAt": "2026-07-28T01:16:03.000Z",
      "updatedAt": "2026-07-28T01:16:03.000Z",
      "uid": "35240-a2edd088-d964-4075-80f8-ad4df0d4db62"
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "/"
    }
  ]
}