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:487

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

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:500

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:209

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:314

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:232

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:352

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:387

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:377

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:513

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:243

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:363

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

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:222

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:327

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:436

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:398
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:411

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:152
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:167

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:257
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:272

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:450
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:462

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:338

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

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

Returns Promise<ResponseObject<Branch>>

See

getClonedBranch

Parameters

`Optional`operationName?: string

`Optional`variables?: any