Files

Move or rename files

Changed on

Move or rename 1–25 files on a branch. Requires project:files:write.

post/v2/projects/{projectId}/files/move

Request

  • Base URL
    https://api.gtx.dev
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Headers

gt-api-version'2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1' | '2026-10-08.v1' required

API contract version. Must be 2026-10-08.v1 or later; requests without it or with an older version return 400.

Request body

branchIdstring

Branch ID. Defaults to the project default branch.

Example request

{
  "moves": [
    {
      "newFileName": "locales/en/home.json"
    }
  ]
}

Response

Result for each move, in request order, even when every move fails; a failed move has status: "failed" and an error. Each move clones the latest source file and its translations under the new file ID and makes the new file ID current in place of the old one.

Changes

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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