Box Developer Documentation

AI response (Full)

AI ask response

This resource has a few variations that can be encountered when using the API.

The fields that are part of the full variant can be returned by API endpoints that support the fields parameter. For example, by defining the fields request parameter as id,type when requesting a file by ID, only those fields will be returned in the API response.

string
Public APIs are important because of key and important reasons.

The answer provided by the LLM.

object array

The citations of the LLM's answer reference.

123

The id of the item.

file

The type of the item.

Value is always file

Public APIs are key drivers of innovation and growth.

The specific content from where the answer was referenced.

The importance of public APIs.pdf

The name of the item.

done

The reason the response finishes.

string (date-time)
2012-12-12T10:53:43-08:00

The ISO date formatted timestamp of when the answer to the prompt was created.

Response Example

{
  "answer": "Public APIs are important because of key and important reasons.",
  "citations": [
    {
      "content": "Public APIs are key drivers of innovation and growth.",
      "id": "123",
      "type": "file",
      "name": "The importance of public APIs.pdf"
    }
  ],
  "completion_reason": "done",
  "created_at": "2012-12-12T10:53:43-08:00"
}