Skip to content

Commit 30a75c0

Browse files
box-apimgmtbox-apimgmt
authored
feat: add AI agents warnings; allow for more types of metadata value (#520)
feat: add AI agents warnings; allow for more types of metadata value in update metadata instance on file or folder
1 parent 5b5d3de commit 30a75c0

File tree

3 files changed

+511
-33
lines changed

3 files changed

+511
-33
lines changed

‎openapi.json

Lines changed: 255 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
"url": "http://www.apache.org/licenses/LICENSE-2.0"
1515
},
1616
"version": "2024.0",
17-
"x-box-commit-hash": "8c0223a248"
17+
"x-box-commit-hash": "f5abf083c2"
1818
},
1919
"servers": [
2020
{
@@ -3926,9 +3926,7 @@
39263926
"example": "/currentState"
39273927
},
39283928
"value": {
3929-
"description": "The value to be set or tested.\n\nRequired for `add`, `replace`, and `test` operations. For `add`,\nif the value exists already the previous value will be overwritten\nby the new value. For `replace`, the value must exist before\nreplacing.\n\nFor `test`, the existing value at the `path` location must match\nthe specified value.",
3930-
"type": "string",
3931-
"example": "reviewed"
3929+
"$ref": "#/components/schemas/MetadataInstanceValue"
39323930
},
39333931
"from": {
39343932
"description": "The location in the metadata JSON object to move or copy a value\nfrom. Required for `move` or `copy` operations and must be in the\nformat of a [JSON-Pointer](https://tools.ietf.org/html/rfc6901).",
@@ -5448,7 +5446,7 @@
54485446
},
54495447
"responses": {
54505448
"200": {
5451-
"description": "Returns a folder object for the updated folder\n\nNot all available fields are returned by default. Use the\n[fields](#param-fields) query parameter to explicitly request\nany specific fields.\n\nThis call will return synchronously. This holds true even when\nmoving folders with a large a large number of items in all of its\ndescendants. For very large folders, this means the call could\ntake minutes or hours to return.",
5449+
"description": "Returns a folder object for the updated folder\n\nNot all available fields are returned by default. Use the\n[fields](#param-fields) query parameter to explicitly request\nany specific fields.\n\nIf the user is moving folders with a large number of items in all of\ntheir descendants, the call will be run asynchronously. If the\noperation is not completed within 10 minutes, the user will receive\na 200 OK response, and the operation will continue running.",
54525450
"content": {
54535451
"application/json": {
54545452
"schema": {
@@ -7143,9 +7141,7 @@
71437141
"example": "/currentState"
71447142
},
71457143
"value": {
7146-
"description": "The value to be set or tested.\n\nRequired for `add`, `replace`, and `test` operations. For `add`,\nif the value exists already the previous value will be overwritten\nby the new value. For `replace`, the value must exist before\nreplacing.\n\nFor `test`, the existing value at the `path` location must match\nthe specified value.",
7147-
"type": "string",
7148-
"example": "reviewed"
7144+
"$ref": "#/components/schemas/MetadataInstanceValue"
71497145
},
71507146
"from": {
71517147
"description": "The location in the metadata JSON object to move or copy a value\nfrom. Required for `move` or `copy` operations and must be in the\nformat of a [JSON-Pointer](https://tools.ietf.org/html/rfc6901).",
@@ -15297,7 +15293,7 @@
1529715293
"put": {
1529815294
"operationId": "put_users_id_folders_0",
1529915295
"summary": "Transfer owned folders",
15300-
"description": "Move all of the items (files, folders and workflows) owned by a user into\nanother user's account\n\nOnly the root folder (`0`) can be transferred.\n\nFolders can only be moved across users by users with administrative\npermissions.\n\nAll existing shared links and folder-level collaborations are transferred\nduring the operation. Please note that while collaborations at the individual\nfile-level are transferred during the operation, the collaborations are\ndeleted when the original user is deleted.\n\nThis call will be performed synchronously which might lead to a slow response\nwhen the source user has a large number of items in all of its folders.\n\nIf the destination path has a metadata cascade policy attached to any of\nthe parent folders, a metadata cascade operation will be kicked off\nasynchronously.\n\nThere is currently no way to check for when this operation is finished.\n\nThe destination folder's name will be in the format `{User}'s Files and\nFolders`, where `{User}` is the display name of the user.\n\nTo make this API call your application will need to have the \"Read and write\nall files and folders stored in Box\" scope enabled.\n\nPlease make sure the destination user has access to `Relay` or `Relay Lite`,\nand has access to the files and folders involved in the workflows being\ntransferred.\n\nAdmins will receive an email when the operation is completed.",
15296+
"description": "Move all of the items (files, folders and workflows) owned by a user into\nanother user's account\n\nOnly the root folder (`0`) can be transferred.\n\nFolders can only be moved across users by users with administrative\npermissions.\n\nAll existing shared links and folder-level collaborations are transferred\nduring the operation. Please note that while collaborations at the individual\nfile-level are transferred during the operation, the collaborations are\ndeleted when the original user is deleted.\n\nIf the user has a large number of items across all folders, the call will\nbe run asynchronously. If the operation is not completed within 10 minutes,\nthe user will receive a 200 OK response, and the operation will continue running.\n\nIf the destination path has a metadata cascade policy attached to any of\nthe parent folders, a metadata cascade operation will be kicked off\nasynchronously.\n\nThere is currently no way to check for when this operation is finished.\n\nThe destination folder's name will be in the format `{User}'s Files and\nFolders`, where `{User}` is the display name of the user.\n\nTo make this API call your application will need to have the \"Read and write\nall files and folders stored in Box\" scope enabled.\n\nPlease make sure the destination user has access to `Relay` or `Relay Lite`,\nand has access to the files and folders involved in the workflows being\ntransferred.\n\nAdmins will receive an email when the operation is completed.",
1530115297
"parameters": [
1530215298
{
1530315299
"name": "user_id",
@@ -26365,13 +26361,13 @@
2636526361
{
2636626362
"properties": {
2636726363
"ask": {
26368-
"$ref": "#/components/schemas/AiStudioAgentAsk"
26364+
"$ref": "#/components/schemas/AiStudioAgentAskResponse"
2636926365
},
2637026366
"text_gen": {
26371-
"$ref": "#/components/schemas/AiStudioAgentTextGen"
26367+
"$ref": "#/components/schemas/AiStudioAgentTextGenResponse"
2637226368
},
2637326369
"extract": {
26374-
"$ref": "#/components/schemas/AiStudioAgentExtract"
26370+
"$ref": "#/components/schemas/AiStudioAgentExtractResponse"
2637526371
}
2637626372
}
2637726373
}
@@ -26440,10 +26436,63 @@
2644026436
"access_state",
2644126437
"description"
2644226438
],
26443-
"title": "AI agent capability ask",
26439+
"title": "AI agent capability ask request",
2644426440
"x-box-resource-id": "ai_studio_agent_ask",
2644526441
"x-box-tag": "ai_studio"
2644626442
},
26443+
"AiStudioAgentAskResponse": {
26444+
"description": "The AI Agent to be used for ask.",
26445+
"type": "object",
26446+
"properties": {
26447+
"type": {
26448+
"description": "The type of AI agent used to handle queries.",
26449+
"type": "string",
26450+
"example": "ai_agent_ask",
26451+
"enum": [
26452+
"ai_agent_ask"
26453+
],
26454+
"nullable": false
26455+
},
26456+
"access_state": {
26457+
"description": "The state of the AI Agent capability. Possible values are: `enabled` and `disabled`.",
26458+
"type": "string",
26459+
"example": "enabled",
26460+
"title": "Capability Access State",
26461+
"x-box-tag": "ai_studio"
26462+
},
26463+
"description": {
26464+
"description": "The description of the AI Agent.",
26465+
"type": "string",
26466+
"example": "This is ASK Agent"
26467+
},
26468+
"custom_instructions": {
26469+
"description": "Custom instructions for the agent.",
26470+
"type": "string",
26471+
"example": "This is a custom instruction",
26472+
"nullable": true
26473+
},
26474+
"long_text": {
26475+
"$ref": "#/components/schemas/AiStudioAgentLongTextToolResponse"
26476+
},
26477+
"basic_text": {
26478+
"$ref": "#/components/schemas/AiStudioAgentBasicTextToolResponse"
26479+
},
26480+
"long_text_multi": {
26481+
"$ref": "#/components/schemas/AiStudioAgentLongTextToolResponse"
26482+
},
26483+
"basic_text_multi": {
26484+
"$ref": "#/components/schemas/AiStudioAgentBasicTextToolResponse"
26485+
}
26486+
},
26487+
"required": [
26488+
"type",
26489+
"access_state",
26490+
"description"
26491+
],
26492+
"title": "AI agent capability ask",
26493+
"x-box-resource-id": "ai_studio_agent_ask_response",
26494+
"x-box-tag": "ai_studio"
26495+
},
2644726496
"AiStudioAgentBasicGenTool": {
2644826497
"description": "AI agent basic tool used to generate text.",
2644926498
"type": "object",
@@ -26461,6 +26510,31 @@
2646126510
}
2646226511
}
2646326512
],
26513+
"title": "AI agent basic text generation tool request",
26514+
"x-box-tag": "ai"
26515+
},
26516+
"AiStudioAgentBasicGenToolResponse": {
26517+
"description": "AI agent basic tool used to generate text.",
26518+
"type": "object",
26519+
"allOf": [
26520+
{
26521+
"$ref": "#/components/schemas/AiStudioAgentBasicGenTool"
26522+
},
26523+
{
26524+
"properties": {
26525+
"warnings": {
26526+
"description": "Warnings concerning tool",
26527+
"type": "array",
26528+
"items": {
26529+
"type": "string"
26530+
},
26531+
"example": [
26532+
"MODEL_INACTIVE"
26533+
]
26534+
}
26535+
}
26536+
}
26537+
],
2646426538
"title": "AI agent basic text generation tool",
2646526539
"x-box-tag": "ai"
2646626540
},
@@ -26481,6 +26555,31 @@
2648126555
}
2648226556
}
2648326557
],
26558+
"title": "AI agent basic text tool request",
26559+
"x-box-tag": "ai"
26560+
},
26561+
"AiStudioAgentBasicTextToolResponse": {
26562+
"description": "AI agent processor used to handle basic text.",
26563+
"type": "object",
26564+
"allOf": [
26565+
{
26566+
"$ref": "#/components/schemas/AiStudioAgentBasicTextTool"
26567+
},
26568+
{
26569+
"properties": {
26570+
"warnings": {
26571+
"description": "Warnings concerning tool",
26572+
"type": "array",
26573+
"items": {
26574+
"type": "string"
26575+
},
26576+
"example": [
26577+
"MODEL_INACTIVE"
26578+
]
26579+
}
26580+
}
26581+
}
26582+
],
2648426583
"title": "AI agent basic text tool",
2648526584
"x-box-tag": "ai"
2648626585
},
@@ -26527,10 +26626,57 @@
2652726626
"access_state",
2652826627
"description"
2652926628
],
26530-
"title": "AI agent capability extract",
26629+
"title": "AI agent capability extract request",
2653126630
"x-box-resource-id": "ai_studio_agent_extract",
2653226631
"x-box-tag": "ai_studio"
2653326632
},
26633+
"AiStudioAgentExtractResponse": {
26634+
"description": "The AI Agent to be used for extraction.",
26635+
"type": "object",
26636+
"properties": {
26637+
"type": {
26638+
"description": "The type of AI agent to be used for extraction.",
26639+
"type": "string",
26640+
"example": "ai_agent_extract",
26641+
"enum": [
26642+
"ai_agent_extract"
26643+
],
26644+
"nullable": false
26645+
},
26646+
"access_state": {
26647+
"description": "The state of the AI Agent capability. Possible values are: `enabled` and `disabled`.",
26648+
"type": "string",
26649+
"example": "enabled",
26650+
"title": "Capability Access State",
26651+
"x-box-tag": "ai_studio"
26652+
},
26653+
"description": {
26654+
"description": "The description of the AI Agent.",
26655+
"type": "string",
26656+
"example": "This is ASK Agent"
26657+
},
26658+
"custom_instructions": {
26659+
"description": "Custom instructions for the agent.",
26660+
"type": "string",
26661+
"example": "This is a custom instruction",
26662+
"nullable": true
26663+
},
26664+
"long_text": {
26665+
"$ref": "#/components/schemas/AiStudioAgentLongTextToolResponse"
26666+
},
26667+
"basic_text": {
26668+
"$ref": "#/components/schemas/AiStudioAgentBasicTextToolResponse"
26669+
}
26670+
},
26671+
"required": [
26672+
"type",
26673+
"access_state",
26674+
"description"
26675+
],
26676+
"title": "AI agent capability extract",
26677+
"x-box-resource-id": "ai_studio_agent_extract_response",
26678+
"x-box-tag": "ai_studio"
26679+
},
2653426680
"AiStudioAgentLongTextTool": {
2653526681
"description": "AI agent processor used to to handle longer text.",
2653626682
"type": "object",
@@ -26548,6 +26694,31 @@
2654826694
}
2654926695
}
2655026696
],
26697+
"title": "AI agent long text tool request",
26698+
"x-box-tag": "ai"
26699+
},
26700+
"AiStudioAgentLongTextToolResponse": {
26701+
"description": "AI agent processor used to to handle longer text.",
26702+
"type": "object",
26703+
"allOf": [
26704+
{
26705+
"$ref": "#/components/schemas/AiStudioAgentLongTextTool"
26706+
},
26707+
{
26708+
"properties": {
26709+
"warnings": {
26710+
"description": "Warnings concerning tool",
26711+
"type": "array",
26712+
"items": {
26713+
"type": "string"
26714+
},
26715+
"example": [
26716+
"MODEL_INACTIVE"
26717+
]
26718+
}
26719+
}
26720+
}
26721+
],
2655126722
"title": "AI agent long text tool",
2655226723
"x-box-tag": "ai"
2655326724
},
@@ -26591,10 +26762,54 @@
2659126762
"access_state",
2659226763
"description"
2659326764
],
26594-
"title": "AI agent capability text generation",
26765+
"title": "AI agent capability text generation request",
2659526766
"x-box-resource-id": "ai_studio_agent_text_gen",
2659626767
"x-box-tag": "ai_studio"
2659726768
},
26769+
"AiStudioAgentTextGenResponse": {
26770+
"description": "The AI agent used for generating text.",
26771+
"type": "object",
26772+
"properties": {
26773+
"type": {
26774+
"description": "The type of AI agent used for generating text.",
26775+
"type": "string",
26776+
"example": "ai_agent_text_gen",
26777+
"enum": [
26778+
"ai_agent_text_gen"
26779+
],
26780+
"nullable": false
26781+
},
26782+
"access_state": {
26783+
"description": "The state of the AI Agent capability. Possible values are: `enabled` and `disabled`.",
26784+
"type": "string",
26785+
"example": "enabled",
26786+
"title": "Capability Access State",
26787+
"x-box-tag": "ai_studio"
26788+
},
26789+
"description": {
26790+
"description": "The description of the AI Agent.",
26791+
"type": "string",
26792+
"example": "This is ASK Agent"
26793+
},
26794+
"custom_instructions": {
26795+
"description": "Custom instructions for the agent.",
26796+
"type": "string",
26797+
"example": "This is a custom instruction",
26798+
"nullable": true
26799+
},
26800+
"basic_gen": {
26801+
"$ref": "#/components/schemas/AiStudioAgentBasicGenToolResponse"
26802+
}
26803+
},
26804+
"required": [
26805+
"type",
26806+
"access_state",
26807+
"description"
26808+
],
26809+
"title": "AI agent capability text generation",
26810+
"x-box-resource-id": "ai_studio_agent_text_gen_response",
26811+
"x-box-tag": "ai_studio"
26812+
},
2659826813
"AiTextGen": {
2659926814
"description": "AI text gen request object",
2660026815
"type": "object",
@@ -29669,7 +29884,8 @@
2966929884
}
2967029885
],
2967129886
"title": "File (Conflict)",
29672-
"x-box-resource-id": "file_conflict"
29887+
"x-box-resource-id": "file_conflict",
29888+
"x-box-tag": null
2967329889
},
2967429890
"FileOrFolderScope": {
2967529891
"description": "A relation between a resource (file or folder) and the scopes for which the resource can be accessed",
@@ -33246,6 +33462,29 @@
3324633462
"x-box-resource-id": "metadata_filter",
3324733463
"x-box-tag": "search"
3324833464
},
33465+
"MetadataInstanceValue": {
33466+
"description": "The value to be set or tested.\n\nRequired for `add`, `replace`, and `test` operations. For `add`,\nif the value exists already the previous value will be overwritten\nby the new value. For `replace`, the value must exist before\nreplacing.\n\nFor `test`, the existing value at the `path` location must match\nthe specified value.",
33467+
"example": "reviewed",
33468+
"oneOf": [
33469+
{
33470+
"type": "string"
33471+
},
33472+
{
33473+
"type": "integer"
33474+
},
33475+
{
33476+
"type": "number",
33477+
"format": "float"
33478+
},
33479+
{
33480+
"type": "array",
33481+
"items": {
33482+
"type": "string"
33483+
}
33484+
}
33485+
],
33486+
"title": "Metadata Instance Value"
33487+
},
3324933488
"MetadataQuery": {
3325033489
"description": "Create a search using SQL-like syntax to return items that match specific\nmetadata.",
3325133490
"type": "object",

‎openapi/openapi-v2025.0.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
"url": "http://www.apache.org/licenses/LICENSE-2.0"
1515
},
1616
"version": "2025.0",
17-
"x-box-commit-hash": "8c0223a248"
17+
"x-box-commit-hash": "f5abf083c2"
1818
},
1919
"servers": [
2020
{

0 commit comments

Comments
 (0)