client.files.put
A method of the Files endpoint.
- put(id: int, name: str, expires_at: str, *, description: str = None) Response
Update details about a file
API URL:
PUT /files/{id}import civis client = civis.APIClient() response = client.files.put(...)
- Parameters:
- idint
The ID of the file.
- namestr
The file name. The extension must match the previous extension.
- expires_atstr (date-time)
The date and time the file will expire.
- descriptionstr, optional
The user-defined description of the file.
- Returns:
civis.Response- idint
The ID of the file.
- namestr
The file name.
- created_atstr (date-time)
The date and time the file was created.
- file_sizeint
The file size.
- expires_atstr (date-time)
The date and time the file will expire. If not specified, the file will expire in 30 days. To keep a file indefinitely, specify null.
- descriptionstr
The user-defined description of the file.
- author
civis.Response - idint
The ID of this user.
- namestr
This user’s name.
- usernamestr
This user’s username.
- initialsstr
This user’s initials.
- onlinebool
Whether this user is online.
- author
- download_urlstr
A JSON string containing information about the URL of the file.
- file_urlstr
The URL that may be used to download the file.
- detected_info
civis.Response - include_headerbool
A boolean value indicating whether or not the first row of the file is a header row.
- column_delimiterstr
The column delimiter for the file. One of “comma”, “tab”, or “pipe”.
- compressionstr
The type of compression of the file. One of “gzip”, or “none”.
- table_columnsList[
civis.Response] An array of hashes corresponding to the columns in the file. Each hash should have keys for column “name” and “sql_type”
- namestr
The column name.
- sql_typestr
The SQL type of the column.
- table_columnsList[
- detected_info
- my_permission_levelstr
Your permission level on the object. One of “read”, “write”, or “manage”.