SMsmartling
Files

List recently uploaded files

Changed on

This lists recently uploaded files, and returns a maximum of 100 files.

get/files-api/v2/projects/{projectId}/files/list

Request

  • Base URL
    https://api.smartling.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

Example:84c012a33

A unique project identifier. This can be found in the Smartling Dashboard under Account Settings > API.

Query parameters

uriMaskstring

Returns only files with a URI containing the given substring. Case is ignored. For example, the value .json will match strings.json and STRINGS.JSON but not json.strings

fileTypes[]FileType[]
lastUploadedAfterstring YYYY-MM-DDThh:mm:ssZ

Returns all files uploaded after the specified date.

lastUploadedBeforestring YYYY-MM-DDThh:mm:ssZ

Returns all files uploaded before the specified date.

orderBy'created' | 'fileUri' | 'lastUploaded' | 'created_asc' | 'created_desc' | 'fileUri_asc' | 'fileUri_desc' | 'lastUploaded_asc' | 'lastUploaded_desc'

Sets the name and direction of the parameter to order results by. If ascending or descending is not specified, the default is ascending

limitinteger

In order to get consistent pagination, make sure to specify the orderBy parameter.

offsetinteger

Standard Smartling limit and offset to paginate through results.

Response

OK

Example response

{
  "response": {
    "data": {
      "items": [
        {
          "created": "2016-12-31T00:00:00Z",
          "fileType": "json",
          "fileUri": "file.json",
          "hasInstructions": false,
          "lastUploaded": "2016-01-01T00:00:00Z"
        }
      ]
    }
  }
}

Changes

  • 2cd7a8215799Revision changes
    • breaking

      added the pattern ^[a-z0-9]{9}$ to the path request parameter projectId

    • breaking

      removed the enum value java_properties from the property items/ of the query request parameter fileTypes[]

    • breaking

      removed the enum value plain_text from the property items/ of the query request parameter fileTypes[]

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the ///// response's property type changed from string to no type, and format from YYYY-MM-DDThh:mm:ssZ to no format for status

    • breaking

      the ///// response's property type changed from string to no type, and format from YYYY-MM-DDThh:mm:ssZ to no format for status

    • warning

      added the new arb enum value to the ///// response property for the response status

    • warning

      added the new asciidoc enum value to the ///// response property for the response status

    • warning

      added the new dita enum value to the ///// response property for the response status

    • warning

      added the new ditaZip enum value to the ///// response property for the response status

    • warning

      added the new docm enum value to the ///// response property for the response status

    • warning

      added the new flare enum value to the ///// response property for the response status

    • warning

      added the new fluent enum value to the ///// response property for the response status

    • warning

      added the new freemarker enum value to the ///// response property for the response status

    • warning

      added the new imageJpg enum value to the ///// response property for the response status

    • warning

      added the new imagePng enum value to the ///// response property for the response status

    • warning

      added the new imageWebp enum value to the ///// response property for the response status

    • warning

      added the new indd enum value to the ///// response property for the response status

    • warning

      added the new javaProperties enum value to the ///// response property for the response status

    • warning

      added the new mdx enum value to the ///// response property for the response status

    • warning

      added the new pdf enum value to the ///// response property for the response status

    • warning

      added the new plainText enum value to the ///// response property for the response status

    • warning

      added the new rtf enum value to the ///// response property for the response status

    • warning

      added the new svg enum value to the ///// response property for the response status

    • warning

      added the new vsdm enum value to the ///// response property for the response status

    • warning

      added the new vsdx enum value to the ///// response property for the response status

    • warning

      added the new vtt enum value to the ///// response property for the response status

    • warning

      added the new xcstrings enum value to the ///// response property for the response status

    • warning

      added the new xliff2 enum value to the ///// response property for the response status

    • info

      added the enum value arb to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value asciidoc to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value dita to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value ditaZip to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value docm to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value flare to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value fluent to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value freemarker to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value imageJpg to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value imagePng to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value imageWebp to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value indd to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value javaProperties to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value mdx to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value pdf to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value plainText to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value rtf to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value svg to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value vsdm to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value vsdx to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value vtt to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value xcstrings to the property items/ of the query request parameter fileTypes[]

    • info

      added the enum value xliff2 to the property items/ of the query request parameter fileTypes[]

    • info

      added to the ///// response property allOf list for the response status

    • info

      added to the ///// response property allOf list for the response status

    • info

      removed the java_properties enum value from the ///// response property for the response status

    • info

      removed the plain_text enum value from the ///// response property for the response status

  • ae422098d9c5Revision changes
    • warning

      added the new xlsxTemplate enum value to the ///// response property for the response status

    • info

      added the enum value xlsxTemplate to the property items/ of the query request parameter fileTypes[]