diff --git a/openapi.json b/openapi.json index f3bf1461..024557d1 100644 --- a/openapi.json +++ b/openapi.json @@ -14,7 +14,7 @@ "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "2024.0", - "x-box-commit-hash": "37fc802212" + "x-box-commit-hash": "882e37ea44" }, "servers": [ { @@ -11529,7 +11529,7 @@ } }, "304": { - "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the folder. This indicates that the folder\nhas not changed since it was last requested." + "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the file. This indicates that the file\nhas not changed since it was last requested." }, "default": { "description": "An unexpected client error.", @@ -13528,7 +13528,7 @@ ], "responses": { "200": { - "description": "Returns a full file resource if the shared link is valid and\nthe user has access to it.", + "description": "Returns a full web link resource if the shared link is valid and\nthe user has access to it.", "content": { "application/json": { "schema": { @@ -13538,7 +13538,7 @@ } }, "304": { - "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the folder. This indicates that the folder\nhas not changed since it was last requested." + "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the web link. This indicates that the web link\nhas not changed since it was last requested." }, "default": { "description": "An unexpected client error.", @@ -14215,6 +14215,51 @@ ] } }, + "/shared_items#app_items": { + "get": { + "operationId": "get_shared_items#app_items", + "summary": "Find app item for shared link", + "description": "Returns the app item represented by a shared link.\n\nThe link can originate from the current enterprise or another.", + "parameters": [ + { + "name": "boxapi", + "in": "header", + "description": "A header containing the shared link and optional password for the\nshared link.\n\nThe format for this header is `shared_link=[link]&shared_link_password=[password]`", + "required": true, + "schema": { + "type": "string" + }, + "example": "shared_link=[example.com]&shared_link_password=[xyz123]" + } + ], + "responses": { + "200": { + "description": "Returns a full app item resource if the shared link is valid and\nthe user has access to it.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AppItem" + } + } + } + }, + "default": { + "description": "An unexpected client error.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ClientError" + } + } + } + } + }, + "x-box-tag": "shared_links_app_items", + "tags": [ + "Shared links (App Items)" + ] + } + }, "/users": { "get": { "operationId": "get_users", @@ -40977,6 +41022,11 @@ "description": "Web links for files are URLs that are generated\nfor web links in Box,\nwhich provide direct, read-only access to the resource.", "x-box-tag": "shared_links_web_links" }, + { + "name": "Shared links (App Items)", + "description": "URLs generated for app items stored in Box,\nwhich provide direct, read-only access to the resource.", + "x-box-tag": "shared_links_app_items" + }, { "name": "Shield information barriers", "description": "Shield information barrier in Box defines an ethical wall.\nAn ethical wall is a mechanism that prevents exchanges or communication that\ncould lead to conflicts of interest and therefore result in\nbusiness activities ethically or legally questionable.", diff --git a/openapi/openapi-v2025.0.json b/openapi/openapi-v2025.0.json index 49f9352c..940547b9 100644 --- a/openapi/openapi-v2025.0.json +++ b/openapi/openapi-v2025.0.json @@ -14,7 +14,7 @@ "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "2025.0", - "x-box-commit-hash": "37fc802212" + "x-box-commit-hash": "882e37ea44" }, "servers": [ { diff --git a/openapi/openapi.json b/openapi/openapi.json index f3bf1461..024557d1 100644 --- a/openapi/openapi.json +++ b/openapi/openapi.json @@ -14,7 +14,7 @@ "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "2024.0", - "x-box-commit-hash": "37fc802212" + "x-box-commit-hash": "882e37ea44" }, "servers": [ { @@ -11529,7 +11529,7 @@ } }, "304": { - "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the folder. This indicates that the folder\nhas not changed since it was last requested." + "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the file. This indicates that the file\nhas not changed since it was last requested." }, "default": { "description": "An unexpected client error.", @@ -13528,7 +13528,7 @@ ], "responses": { "200": { - "description": "Returns a full file resource if the shared link is valid and\nthe user has access to it.", + "description": "Returns a full web link resource if the shared link is valid and\nthe user has access to it.", "content": { "application/json": { "schema": { @@ -13538,7 +13538,7 @@ } }, "304": { - "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the folder. This indicates that the folder\nhas not changed since it was last requested." + "description": "Returns an empty response when the `If-None-Match` header matches\nthe current `etag` value of the web link. This indicates that the web link\nhas not changed since it was last requested." }, "default": { "description": "An unexpected client error.", @@ -14215,6 +14215,51 @@ ] } }, + "/shared_items#app_items": { + "get": { + "operationId": "get_shared_items#app_items", + "summary": "Find app item for shared link", + "description": "Returns the app item represented by a shared link.\n\nThe link can originate from the current enterprise or another.", + "parameters": [ + { + "name": "boxapi", + "in": "header", + "description": "A header containing the shared link and optional password for the\nshared link.\n\nThe format for this header is `shared_link=[link]&shared_link_password=[password]`", + "required": true, + "schema": { + "type": "string" + }, + "example": "shared_link=[example.com]&shared_link_password=[xyz123]" + } + ], + "responses": { + "200": { + "description": "Returns a full app item resource if the shared link is valid and\nthe user has access to it.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AppItem" + } + } + } + }, + "default": { + "description": "An unexpected client error.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ClientError" + } + } + } + } + }, + "x-box-tag": "shared_links_app_items", + "tags": [ + "Shared links (App Items)" + ] + } + }, "/users": { "get": { "operationId": "get_users", @@ -40977,6 +41022,11 @@ "description": "Web links for files are URLs that are generated\nfor web links in Box,\nwhich provide direct, read-only access to the resource.", "x-box-tag": "shared_links_web_links" }, + { + "name": "Shared links (App Items)", + "description": "URLs generated for app items stored in Box,\nwhich provide direct, read-only access to the resource.", + "x-box-tag": "shared_links_app_items" + }, { "name": "Shield information barriers", "description": "Shield information barrier in Box defines an ethical wall.\nAn ethical wall is a mechanism that prevents exchanges or communication that\ncould lead to conflicts of interest and therefore result in\nbusiness activities ethically or legally questionable.",