Files

List recently published files

Changed on

Response is limited to files published after 14 days from the time called.

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

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

publishedAfterstring YYYY-MM-DDThh:mm:ssZ required

Limits the response to only those files that have a publishDate date after the publishedAfter parameter. The items array can be empty if no files match this criteria.

fileUris[]FileUri[]

A list of fileUris to filter the response list by. Value must be exact match. Up to 20 fileUris can be specified. See getRecentlyUploadedSourceFilesList to get a project's fileUris.

[
  "/content/en/home.json"
]
localeIds[]LocaleId[]

A list of locale identifiers to filter the response list by. Up to 50 localeIds can be specified. See getProjectDetails to get a project's localeIds.

[
  "fr-FR"
]
offsetinteger

Standard Smartling limit and offset to paginate through results. Default value is 0.

limitinteger

Standard Smartling limit and offset to paginate through results. Limit is not applied if this parameter is not specified.

Response

OK

Example response

{
  "response": {
    "data": {
      "fileUri": "/content/en/home.json",
      "publishDate": "2026-01-15T10:00:00Z",
      "localeId": "fr-FR"
    }
  }
}

Changes

    • breaking

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

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

    • info

      for the path request parameter projectId, the format was generalized from uuid to no format

    • 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

      the /// response's property pattern ^[a-z]{2}(-[A-Z]{2})?$ was added for the status

    • info

      endpoint added