# FileInfo


[API catalog](/reference/api/) · [Docker Sandboxes overview](/reference/api/sandboxes/latest/) · [Product manual](https://docs.docker.com/ai/sandboxes-api/) · [OpenAPI specification](/reference/api/sandboxes/api.yaml)

API version: v1


> This API is experimental. Features, interfaces,
> and behavior may change.




Schema constraints and annotations:

```json
{
  "description": "FileInfo is file metadata.",
  "properties": {
    "isDir": {
      "description": "is_dir reports whether the path is a directory and stays populated on\nevery backend and every caller. type is the richer authority, and\ntype == directory iff is_dir.",
      "type": "boolean"
    },
    "linkTarget": {
      "description": "link_target is the literal readlink() text when type is symlink,\nsince that is the only case where nothing else lets the caller learn what\nthe link names; empty otherwise.",
      "type": "string"
    },
    "mode": {
      "description": "mode is the stored Unix permission bits (0777), without type or special bits.",
      "type": "integer"
    },
    "path": {
      "description": "path is the sandbox path.",
      "type": "string"
    },
    "size": {
      "description": "size is the file size in bytes.",
      "format": "int64",
      "type": [
        "integer",
        "string"
      ]
    },
    "type": {
      "$ref": "#/components/schemas/FileType",
      "description": "type classifies the object, and Stat and List populate it for every\ncaller. Stat and List resolve an in-jail symlink and report\nthe resolved target's type; a link that cannot be resolved in-jail\n(dangling, looping, or escaping) reports symlink for itself\nrather than disclosing an out-of-jail target."
    }
  },
  "title": "FileInfo",
  "type": "object"
}
```