Class SourceFiles

Source files are resources for translation. You can keep files structure using folders or manage different versions of the content via branches.

Use API to keep the source files up to date, check on file revisions, and manage project branches. Before adding source files to the project, upload each file to the Storage first.

Hierarchy (view full)

CrowdinApi
- SourceFiles

Constructors

constructor

new SourceFiles(credentials, config?): SourceFiles
Parameters
- credentials: Credentials
  credentials
- Optionalconfig: ClientConfig
  optional configuration of the client
Returns SourceFiles
Inherited from CrowdinApi.constructor
- Defined in core/index.ts:224

Methods

buildReviewedSourceFiles

buildReviewedSourceFiles(projectId, request?): Promise<ResponseObject<ReviewedSourceFilesBuild>>
Parameters
- projectId: number
  project identifier
- request: BuildReviewedSourceFilesRequest = {}
  request body
Returns Promise<ResponseObject<ReviewedSourceFilesBuild>>
See
https://support.crowdin.com/enterprise/api/#operation/api.projects.strings.reviewed-builds.post
- Defined in sourceFiles/index.ts:532

checkBranchClonedStatus

checkBranchClonedStatus(projectId, branchId, cloneId): Promise<ResponseObject<Status<{}>>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- cloneId: string
  clone branch identifier
Returns Promise<ResponseObject<Status<{}>>>
See
https://developer.crowdin.com/api/v2/string-based/#operation/api.projects.branches.clones.get
- Defined in sourceFiles/index.ts:56

checkBranchMergeStatus

checkBranchMergeStatus(projectId, branchId, mergeId): Promise<ResponseObject<Status<MergeBranchAttributes>>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- mergeId: string
  merge branch identifier
Returns Promise<ResponseObject<Status<MergeBranchAttributes>>>
See
https://support.crowdin.com/developer/api/v2/string-based/#tag/Branches/operation/api.projects.branches.merges.get
- Defined in sourceFiles/index.ts:168

checkReviewedSourceFilesBuildStatus

checkReviewedSourceFilesBuildStatus(projectId, buildId): Promise<ResponseObject<ReviewedSourceFilesBuild>>
Parameters
- projectId: number
  project identifier
- buildId: number
  build identifier
Returns Promise<ResponseObject<ReviewedSourceFilesBuild>>
See
https://support.crowdin.com/enterprise/api/#operation/api.projects.strings.reviewed-builds.get
- Defined in sourceFiles/index.ts:545

clonedBranch

clonedBranch(projectId, branchId, request): Promise<ResponseObject<Status<{}>>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- request: CloneBranchRequest
  request body
Returns Promise<ResponseObject<Status<{}>>>
See
https://developer.crowdin.com/api/v2/string-based/#operation/api.projects.branches.clones.post
- Defined in sourceFiles/index.ts:41

createBranch

createBranch(projectId, request): Promise<ResponseObject<Branch>>
Parameters
- projectId: number
  project identifier
- request: CreateBranchRequest
  request body
Returns Promise<ResponseObject<Branch>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.branches.post
- Defined in sourceFiles/index.ts:104

createDirectory

createDirectory(projectId, request): Promise<ResponseObject<Directory>>
Parameters
- projectId: number
  project identifier
- request: CreateDirectoryRequest
  request body
Returns Promise<ResponseObject<Directory>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.directories.post
- Defined in sourceFiles/index.ts:254

createFile

createFile(projectId, request): Promise<ResponseObject<File>>
Parameters
- projectId: number
  project identifier
- request: CreateFileRequest
  request body
Returns Promise<ResponseObject<File>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.post
- Defined in sourceFiles/index.ts:359

deleteBranch

deleteBranch(projectId, branchId): Promise<void>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
Returns Promise<void>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.branches.delete
- Defined in sourceFiles/index.ts:127

deleteDirectory

deleteDirectory(projectId, directoryId): Promise<void>
Parameters
- projectId: number
  project identifier
- directoryId: number
  directory identifier
Returns Promise<void>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.directories.delete
- Defined in sourceFiles/index.ts:277

deleteFile

deleteFile(projectId, fileId): Promise<void>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
Returns Promise<void>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.delete
- Defined in sourceFiles/index.ts:397

downloadFile

downloadFile(projectId, fileId): Promise<ResponseObject<DownloadLink>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.download.get
- Defined in sourceFiles/index.ts:432

downloadFilePreview

downloadFilePreview(projectId, fileId): Promise<ResponseObject<DownloadLink>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.preview.get
- Defined in sourceFiles/index.ts:422

downloadReviewedSourceFiles

downloadReviewedSourceFiles(projectId, buildId): Promise<ResponseObject<DownloadLink>>
Parameters
- projectId: number
  project identifier
- buildId: number
  build identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://support.crowdin.com/enterprise/api/#operation/api.projects.strings.reviewed-builds.download.download
- Defined in sourceFiles/index.ts:558

editBranch

editBranch(projectId, branchId, request): Promise<ResponseObject<Branch>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<Branch>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.branches.patch
- Defined in sourceFiles/index.ts:138

editDirectory

editDirectory(projectId, directoryId, request): Promise<ResponseObject<Directory>>
Parameters
- projectId: number
  project identifier
- directoryId: number
  directory identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<Directory>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.directories.patch
- Defined in sourceFiles/index.ts:288

editFile

editFile(projectId, fileId, request): Promise<ResponseObject<File>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<File>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.patch
- Defined in sourceFiles/index.ts:408

getBranch

getBranch(projectId, branchId): Promise<ResponseObject<Branch>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
Returns Promise<ResponseObject<Branch>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.branches.get
- Defined in sourceFiles/index.ts:117

getBranchMergeSummary

getBranchMergeSummary(projectId, branchId, mergeId): Promise<ResponseObject<MergeBranchSummary>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- mergeId: string
  merge branch identifier
Returns Promise<ResponseObject<MergeBranchSummary>>
See
https://support.crowdin.com/developer/api/v2/string-based/#tag/Branches/operation/api.projects.branches.merges.summary.get
- Defined in sourceFiles/index.ts:183

getClonedBranch

getClonedBranch(projectId, branchId, cloneId): Promise<ResponseObject<Branch>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- cloneId: string
  clone branch identifier
Returns Promise<ResponseObject<Branch>>
See
https://developer.crowdin.com/api/v2/string-based/#operation/api.projects.branches.clones.branch.get
- Defined in sourceFiles/index.ts:26

getDirectory

getDirectory(projectId, directoryId): Promise<ResponseObject<Directory>>
Parameters
- projectId: number
  project identifier
- directoryId: number
  directory identifier
Returns Promise<ResponseObject<Directory>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.directories.get
- Defined in sourceFiles/index.ts:267

getFile

getFile(projectId, fileId): Promise<ResponseObject<File>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
Returns Promise<ResponseObject<File>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.get
- Defined in sourceFiles/index.ts:372

getFileRevision

getFileRevision(projectId, fileId, revisionId): Promise<ResponseObject<FileRevision>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
- revisionId: number
  revision identifier
Returns Promise<ResponseObject<FileRevision>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.revisions.get
- Defined in sourceFiles/index.ts:481

graphql

graphql<T>(req): Promise<ResponseObject<T>>
Type Parameters
- T
Parameters
- req: {
      operationName?: string;
      query: string;
      variables?: any;
  }
  - OptionaloperationName?: string
  - query: string
  - Optionalvariables?: any
Returns Promise<ResponseObject<T>>
Inherited from CrowdinApi.graphql
- Defined in core/index.ts:258

listFileRevisions

listFileRevisions(projectId, fileId, options?): Promise<ResponseList<FileRevision>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
- Optionaloptions: Partial<Pagination>
  optional pagination parameters for the request
Returns Promise<ResponseList<FileRevision>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.revisions.getMany
- Defined in sourceFiles/index.ts:443
listFileRevisions(projectId, fileId, limit?, offset?): Promise<ResponseList<FileRevision>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
- Optionallimit: number
  maximum number of items to retrieve (default 25)
- Optionaloffset: number
  starting offset in the collection (default 0)
Returns Promise<ResponseList<FileRevision>>
Deprecated
optional parameters should be passed through an object

See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.revisions.getMany
- Defined in sourceFiles/index.ts:456

listProjectBranches

listProjectBranches(projectId, options?): Promise<ResponseList<Branch>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: ListProjectBranchesOptions
  optional parameters for the request
Returns Promise<ResponseList<Branch>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.branches.getMany
- Defined in sourceFiles/index.ts:66
listProjectBranches(projectId, name?, limit?, offset?): Promise<ResponseList<Branch>>
Parameters
- projectId: number
  project identifier
- Optionalname: string
  filter branch by name
- Optionallimit: number
  maximum number of items to retrieve (default 25)
- Optionaloffset: number
  starting offset in the collection (default 0)
Returns Promise<ResponseList<Branch>>
Deprecated
optional parameters should be passed through an object

See
https://developer.crowdin.com/api/v2/#operation/api.projects.branches.getMany
- Defined in sourceFiles/index.ts:78

listProjectDirectories

listProjectDirectories(projectId, options?): Promise<ResponseList<Directory>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: ListProjectDirectoriesOptions
  optional parameters for the request
Returns Promise<ResponseList<Directory>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.directories.getMany
- Defined in sourceFiles/index.ts:197
listProjectDirectories(projectId, branchId?, directoryId?, limit?, offset?, filter?, recursion?): Promise<ResponseList<Directory>>
Parameters
- projectId: number
  project identifier
- OptionalbranchId: number
  filter directories by branchId
- OptionaldirectoryId: number
  filter directories by directoryId
- Optionallimit: number
  maximum number of items to retrieve (default 25)
- Optionaloffset: number
  starting offset in the collection (default 0)
- Optionalfilter: string
  use to filter directories by name
- Optionalrecursion: string
  use to list directories recursively (works only when directoryId or branchId parameter is specified)
Returns Promise<ResponseList<Directory>>
Deprecated
optional parameters should be passed through an object

See
https://developer.crowdin.com/api/v2/#operation/api.projects.directories.getMany
- Defined in sourceFiles/index.ts:212

listProjectFiles

listProjectFiles(projectId, options?): Promise<ResponseList<File>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: ListProjectFilesOptions
  optional parameters for the request
Returns Promise<ResponseList<File>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.getMany
- Defined in sourceFiles/index.ts:302
listProjectFiles(projectId, branchId?, directoryId?, limit?, offset?, recursion?, filter?): Promise<ResponseList<File>>
Parameters
- projectId: number
  project identifier
- OptionalbranchId: number
  list branch files (Note! You can either list files for the specified branch (branchId) in the same request)
- OptionaldirectoryId: number
  list directory files (Note! You can either list files for the specified directory (directoryId) in the same request)
- Optionallimit: number
  maximum number of items to retrieve (default 25)
- Optionaloffset: number
  starting offset in the collection (default 0)
- Optionalrecursion: any
  use to list files recursively
- Optionalfilter: string
  use to filter files by name
Returns Promise<ResponseList<File>>
Deprecated
optional parameters should be passed through an object

See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.getMany
- Defined in sourceFiles/index.ts:317

listReviewedSourceFilesBuild

listReviewedSourceFilesBuild(projectId, options?): Promise<ResponseList<ReviewedSourceFilesBuild>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: ListReviewedSourceFilesBuildOptions
  optional parameters for the request
Returns Promise<ResponseList<ReviewedSourceFilesBuild>>
See
https://support.crowdin.com/enterprise/api/#operation/api.projects.strings.reviewed-builds.getMany
- Defined in sourceFiles/index.ts:495
listReviewedSourceFilesBuild(projectId, branchId?, limit?, offset?): Promise<ResponseList<ReviewedSourceFilesBuild>>
Parameters
- projectId: number
  project identifier
- OptionalbranchId: number
  filter builds by branchId
- Optionallimit: number
  maximum number of items to retrieve (default 25)
- Optionaloffset: number
  starting offset in the collection (default 0)
Returns Promise<ResponseList<ReviewedSourceFilesBuild>>
Deprecated
optional parameters should be passed through an object

See
https://support.crowdin.com/enterprise/api/#operation/api.projects.strings.reviewed-builds.getMany
- Defined in sourceFiles/index.ts:507

mergeBranch

mergeBranch(projectId, branchId, request): Promise<ResponseObject<Status<MergeBranchAttributes>>>
Parameters
- projectId: number
  project identifier
- branchId: number
  branch identifier
- request: MergeBranchRequest
  request body
Returns Promise<ResponseObject<Status<MergeBranchAttributes>>>
See
https://support.crowdin.com/developer/api/v2/string-based/#tag/Branches/operation/api.projects.branches.merges.post
- Defined in sourceFiles/index.ts:153

updateOrRestoreFile

updateOrRestoreFile(projectId, fileId, request): Promise<ResponseObject<File>>
Parameters
- projectId: number
  project identifier
- fileId: number
  file identifier
- request: ReplaceFileFromStorageRequest | RestoreFile
  request body
Returns Promise<ResponseObject<File>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.files.put
- Defined in sourceFiles/index.ts:383

withFetchAll

withFetchAll(maxLimit?): this
Parameters
- OptionalmaxLimit: number
Returns this
Inherited from CrowdinApi.withFetchAll
- Defined in core/index.ts:313

Class SourceFiles

Hierarchy (view full)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns SourceFiles

Methods

buildReviewedSourceFiles

Parameters

Returns Promise<ResponseObject<ReviewedSourceFilesBuild>>

See

checkBranchClonedStatus

Parameters

Returns Promise<ResponseObject<Status<{}>>>

See

checkBranchMergeStatus

Parameters

Returns Promise<ResponseObject<Status<MergeBranchAttributes>>>

See

checkReviewedSourceFilesBuildStatus

Parameters

Returns Promise<ResponseObject<ReviewedSourceFilesBuild>>

See

clonedBranch

Parameters

Returns Promise<ResponseObject<Status<{}>>>

See

createBranch

Parameters

Returns Promise<ResponseObject<Branch>>

See

createDirectory

Parameters

Returns Promise<ResponseObject<Directory>>

See

createFile

Parameters

Returns Promise<ResponseObject<File>>

See

deleteBranch

Parameters

Returns Promise<void>

See

deleteDirectory

Parameters

Returns Promise<void>

See

deleteFile

Parameters

Returns Promise<void>

See

downloadFile

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

downloadFilePreview

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

downloadReviewedSourceFiles

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

editBranch

Parameters

Returns Promise<ResponseObject<Branch>>

See

editDirectory

Parameters

Returns Promise<ResponseObject<Directory>>

See

editFile

Parameters

Returns Promise<ResponseObject<File>>

See

getBranch

Parameters

`Optional`operationName?: string

`Optional`variables?: any