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.

  • authorcivis.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.

  • 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_infocivis.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.

  • my_permission_levelstr

    Your permission level on the object. One of “read”, “write”, or “manage”.