v2

latestOpenAPI 3.1.02026-08-06276982.8 KB
files

Read file or folder metadata

Read metadata of a file or folder at the target path.

This API operation reports whether the object at the target path is a file or folder. If a file, it also reports the file size and last modification time.

<Info>This acts on files and folders in the AI Hub filesystem, not your local filesystem.</Info>

<Note>Ensure the path is accessible within the context defined by the IB-Context header.</Note>

head/v2/files/{path}

Path parameters

pathstring required

Full path to the file or folder.

Headers

Authorizationstring required

Bearer HTTP authentication.

IB-Contextstring

Typically your organization ID. See Authorization and context identification for details.

IB-Retry-Configstring

Configures retry logic if no file or folder is found at the target path. Uses a constant backoff algorithm. Don't retry if this header isn't provided. Example: {'retries': 3, 'backoff-seconds': 5}

Response

Successfully retrieved metadata.

FilesGetFileMetadataResponse200 required

Empty response body