Documentation regarding standard Server REST API use cases can be here
The resources use a data model that is supported by a set of client-side libraries that are made available on the files and libraries page.
There is a WADL document available that describes the resources API.
name | path | methods | description |
---|---|---|---|
AdministrationResource |
|
|
REST resource that provides access to the current administration connections that are currently connected to the FileCatalystServer |
ApplicationDiagnosticsResource |
|
|
REST resource that provides the ability for API consumers to access and create diagnostics packages for the application |
AuthorizationSessionResource |
|
|
Class to manage authorization session objects |
AuthorizationSessionResourceRev1 |
|
|
Class to manage authorization sessions |
CentralManagementResource |
|
|
Allows modification of central monitoring settings |
CertificateResource |
|
|
REST resource that is responsible for viewing, creating, and uploading SSL certificates to the FileCatalyst Server |
ConfigPropertiesResource |
|
|
Allows users to retrieve, update, and add configuration values to the server |
FCSessionRev1Resource |
|
|
Allows the listing of statistics for all sessions found in the system. This rest service is new and keeps backward compatibility, in order to create new resources to manage received sessions |
FCSessionsResource |
|
|
Allow the listing of statistics for all sessions found in the system |
FileSystemTestResource |
|
|
REST entry point that can be used that can be used to test credentials and access parameters of external file systems that you wish to use in the application. Tests from this resource currently performs the following operations:
|
FileSystemsResource |
|
|
Allows the retrieval of the list of filesystems and the addition of a new filesystem |
FoldersResource |
|
|
REST service to allow the listing of folders and the adding of a new folder. |
GraphImplResource |
|
|
Graph Rest Class |
GroupsResource |
|
|
REST service to allow the listing of groups and the adding of a new group. |
LicenseResource |
|
|
REST service to allow the listing and modification of the license string. |
LocalResource |
|
|
Local file system resource that allows users to interact with the local file system of the server |
LogFileImplResource |
|
|
REST service that allows users to retrieve the current logs for Server and the individual sessions that are currently
connected. Note: Most of these resources require that you supply an "adminID" as part of the REST call. This parameter is a unique value generated by the requester, and it will be used to keep the requester's session separate from the others. |
LogsResource |
|
|
Provides the user access to the logs of the application |
OAuthResource |
|
|
REST resource that provides access to OAuth authentication resources for various external file systems. Note: OAuth is currently only supported by the Dropbox file system |
ReportsResource |
|
|
Allows access to Server's reports. Reports differ from logs in that reports are numerical statistics describing file and transfer characteristics. For example transfer rate, file size, transfer time, etc. |
RunReportResource |
|
|
REST resource for running reports and collecting information from the Server |
SMTPResource |
|
|
A REST Resource That Provides Consumers With The Ability To Perform Standard SMTP Based Operations |
ServiceStatusResource |
|
|
REST service that provides access to retrieving, modifying, and deletion of Server's status as a service |
SpacesResource |
|
|
REST service to allow the listing of users and the adding of a new user. |
SystemMonitorResource |
|
|
REST resource used to provide access to the current Session and UsageData information for the Server |
SystemPropertiesResource |
|
|
REST service that allows the retrieval and setting of system wide values |
TemporaryUserResource |
|
|
REST resource for temporary user operations |
TrustedOriginsResource |
|
|
REST service to provide retrieval or updating of origins trusted by WebServer for cross-origin request support. |
UsageDataResource |
|
|
REST service that provides usage data information for the server |
UsersResource |
|
|
REST service to allow the listing of users and the adding of a new user. |
VisualImplResource |
|
|
transfer visualization rest class. |
WebSocketSessionResource |
|
|
REST resource that is responsible for handling all of the active WebSocket sessions that are connected to the Server. Currently this resource only contains methods |
WeblinkAccessResource |
|
|
REST service that will provide access to a given link. |
WeblinksResource |
|
|
REST resource that allows users to interact with the currently stored links. |
type | description |
---|---|
AccessType | |
AdaptedMap | An adapter map object that converts normal Java-based Map collections and translates them into proper XML |
AdaptedWebSocketSessionMap | An adapter map object that converts normal Java-based Map collections and translates them into proper XML |
AdminConnectionModel | The FC base REST model. All other REST models are based off this |
AdminConnectionsModel | The FC base REST model. All other REST models are based off this |
AdminPermissionType | Enumeration of connection status types |
AdminType | |
AvailableFileOperations | Enumeration representing available file operations for /rs/file/localfile and /rs/file/remotefile |
CentralManagementModel | CentralManagementModel class. Holds the central management settings for monitoring the Server. All of the values are required |
CreateSSLCertificateModel | Data object that contains all of the information for creating self-signed SSL certificates on the FileCatalyst Server |
CustomFileSystemLabelsModel | Custom file system model class. These values are returned from the server and are not user configurable. |
DataItemModel | Model used to contain the values that are used to modify configuration values in TransferAgent. Used with the /agent/config resource |
DataItemsModel | Model used to contain a collection of DataItemModel objects |
DeployedComponentNamesOnWebServer | |
EmptyModel | Shared model that contains nothing. Used mainly to demonstrate a successful call that does need a response body. 'Shared' models are models that used by more than one FC application |
Entry | |
ExpiryTimeModel | Model class that holds an expiry time value for various operations |
FCSessionModel | Model class to hold session information. This informtion is provided by the Server and is not user configurable. |
FCSessionsModel | Model class that contains a collection of sessions. This information is provided by the Server and is not user configurable. |
FileObjectModel | Shared model containing all details of a file retrieved the from the local machine. 'Shared' models are models that used by more than one FC application |
FileObjectsModel | Shared collection model representing multiple FileObjectModel objects. 'Shared' models are models that used by more than one FC application |
FileOperationModel | Model that contains information needed for renaming, deleting, or creating directories on the local file system. Used in conjunction with certain calls to /files/remotefile and /files/localfile, this model is used as the request body when POSTing file commands using those resources |
FileSystemEntry | |
FileSystemModel | File system model |
FileSystemTestResultModel | The FC base REST model. All other REST models are based off this |
FileSystemTypeModel | File system type model. Contains the type and the file system labeels for a given file system. These values are provided by the Server and are not user configurable. |
FileSystemsAdaptedMap | |
FileSystemsModel | Model that contains a collection of file systems. This information is provided by the Server and is not user configurable. |
FolderLinkModel | Name Folder Link model class |
FolderLinksModel | Model for representing the user and group links for a given virtual folder |
FolderModel | Folder model class |
FolderResourceLinkModel | Model for representing the linked resources for a given virtual folder |
FolderUsageType | Enumeration of folder usage types |
FoldersModel | Folders model class. This information is provided by the Server and is not user configurable. |
GenericIDModel | Shared model designed to hold a generic list of IDs. It is used mainly in mass delete calls. 'Shared' models are models that used by more than one FC application |
GenericResponseModel | Shaerd model designed to return general responses to the user. 'Shared' models are models that used by more than one FC application |
GraphModel | Shared model used for calls to GraphImplResource. Contains all necessary information to create a graph in a UI. 'Shared' models are models that used by more than one FC application |
GroupFolderLinkModel | Model for representing the link between a group and a folder |
GroupLinksModel | Groups model class |
GroupModel | User Group model class |
GroupsModel | Groups model class. This information is provided by the Server and is not user configurable. |
HTTPLinkModel | Model containing information about the weblink and corresponding http-downloadLink (which sends the request to FTPServlet). This information is provided by the Server and is not user configurable. |
HandlerType | |
HistogramModel | Shared model that represents the data transferred by the application calling it. 'Shared' models are models that used by more than one FC application |
HttpDownloadLinksModel | Modfel containing information about the weblink and corresponding http-downloadLink (which sends the request to FTPServlet). This information is provided by the Server and is not user configurable. |
ImageInfoModel | Shared model that contains the information for a given image. 'Shared' models are models that used by more than one FC application |
LicenseModel | Shared model that contains information about the current license installed on the application. 'Shared' models are models that used by more than one FC application |
LinkElementModel | Generic link model that links elements together |
LinkModel | Links a particular element with a permission set. |
LinkPermissionsModel | Name LinkPermissions model class. No values are required but unset values will default to False. |
LinkTargetType | Enumeration of folder usage types |
LogFilesModel | Shared model that contains a list of logs. 'Shared' models are models that used by more than one FC application |
LogsModel | Shared model that contains a list of logs. 'Shared' models are models that used by more than one FC application |
NameHrefModel | Name HREF model class |
OverrideSettingsModel | Override model used for overriding user priorities and bandwidths. |
PasswordModel | Password model class. Used for password changes. A new password and confirmation must be provided to change a password |
RemoteFileOperationModel | Model that contains information needed for renaming, deleting, or creating directories on the local file system. Used in conjunction with certain calls to /files/remotefile and /files/localfile, this model is used as the request body when POSTing file commands using those resources |
RemoteGenericIDsModel | Shared model designed to hold a generic list of IDs. It is used mainly in mass delete calls. 'Shared' models are models that used by more than one FC application |
ReportModel | Shared model storing information for reports. Reports differ from logs in that reports are numerical statistics describing file and transfer characteristics. For example transfer rate, file size, transfer time, etc. 'Shared' models are models that used by more than one FC application |
ReportRequestModel | Shared model used to request reports from a given application. 'Shared' models are models that used by more than one FC application |
RestartType | Enumeration representing different types of users |
RunReportType | Enumeration used to denote what type of report the user would like returned to them |
SMTPDispatchModel | Base class that is responsible for holding the basic data used in SMTP dispatching operations |
SMTPDispatcherDataModel | Base class that is responsible for holding the basic data used in SMTP dispatching operations |
SSLCertificateBaseModel | Simple bean style object that contains common information for SSL certificate operations |
SSLCertificateDetailsModel | Data object that contains all of the information for the currently established SSL certificate |
ServerLicenseModel | REST model that contains information about the current license installed on the server. This information is provided by the Server and is not user configurable. |
ServerSMTPDispatchModel | Class that is responsible for holding the data used in FCServer SMTP dispatching operations |
ServerStatusModel | A simple RESTModel that contains the status information for the server. This information is provided by the Server and is not user configurable. |
ServerUserType | Enumeration of user types |
ServiceStatusModel | Shared model that retrieves the status of the given application as a service. 'Shared' models are models that used by more than one FC application |
SessionAuthorizationModel | Shared model used to store session authorization information for a given client and session. 'Shared' models are models that used by more than one FC application |
SessionClientLogModel | Shared model that stores all logs for a given client recorded during a given session. 'Shared' models are models that used by more than one FC application |
SessionInfoModel | Shared model used to store information on given session with a given client. 'Shared' models are models that used by more than one FC application |
SizeModel | Shared model containing dimensions representing the size of an entity (usually an image). 'Shared' models are models that used by more than one FC application |
SpacesUserAndVirtualFoldersModel | Folders model class. This information is provided by the Server and is not user configurable. |
TYPE | |
TempUserCredientialsModel | A simple model that returns a user's credientials via REST services. Should only be used with temporary users that are created as part of the weblink feature. This information is provided by the Server and is not user configurable. |
TransferVisualsModel | Shared model storing information used to populate diagrams and graphics related to transfers. 'Shared' models are models that used by more than one FC application |
TransmitRateTimeSliceModel | Shared model representing certain statistics of a given transferred that have been gathered over a set block of time. 'Shared' models are models that used by more than one FC application |
TrustedOriginModel | Model containing list of origins that are trusted by FileCatalyst Server's WebServer module and the module name that trusts the origins specified. |
TrustedOriginsModel | Model containing information about request origins that are trusted by FileCatalyst Server's WebServer, to support cross-origin requests. |
UnavailableFileModel | Model for UI display. This model will represent a file that could not be gathered as part of a request that was made to the server. Contains information that will prove to be helpful for error messages. This information is provided by the Server and is not user configurable. |
UsageDataModel | Shared collection model holding multiple UsageDatumModel objects. 'Shared' models are models that used by more than one FC application |
UsageDatumModel | Shared model representing |
UserFolderLinkGroupModel | Users model class |
UserFolderLinkModel | User-Folder link model that links a user to a virtual folder |
UserInfoModel | Shared model used to store information of a given user. 'Shared' models are models that used by more than one FC application |
UserLinksModel | Model that contains all of the group and folder links that a given user has |
UserModel | Model class to hold user information |
UserSessionStatusModel | Model class that contains session data on a per user basis. This informaion is provided by the Server and is not user configurable. |
UserType | Enumeration of user types |
UserWeblinkModel | Model class to information for creating and sending weblinks |
UsersModel | Users model class. This is provided by the Server and is not user configurable. |
VirtualPathTargetType | Enumeration of folder usage types |
WebSocketSessionCollectionModel | The FC base REST model. All other REST models are based off this |
WebSocketSessionEntry | |
WebSocketSessionInfoModel | Simple data model that contains the information for a given WebSocket session |
WeblinkDetailsModel | Contains the details all of the files contained within a particular link. This information is provided by the Server and is not user configurable. |
WeblinkFileDOModel | Data object that contains the file name, file path, and validity of a file in a link. This information is provided by the server and is not user onfigurable. |
WeblinkModel | Model that shows the individual values for a link. This information is provided by the server and is not user configurable. |
WeblinkResultModel | Shared model used to relay weblink status information. 'Shared' models are models that used by more than one FC application |
WeblinksModel | Model that contains all of the links that are returned as part of a GET request. This information is provided by the server and is not user configurable. |
type | description |
---|---|
TYPE | |
accessType | |
adminType | |
handlerType | |
adminPermissionType | Enumeration of connection status types |
availableFileOperations | Enumeration representing available file operations for /rs/file/localfile and /rs/file/remotefile |
runReportType | Enumeration used to denote what type of report the user would like returned to them |
type | description |
---|---|
SMTPDispatcherDataModel | Base class that is responsible for holding the basic data used in SMTP dispatching operations |
sessionAuthorizationModel | Shared model used to store session authorization information for a given client and session. 'Shared' models are models that used by more than one FC application |
sessionInfoModel | Shared model used to store information on given session with a given client. 'Shared' models are models that used by more than one FC application |
userInfoModel | Shared model used to store information of a given user. 'Shared' models are models that used by more than one FC application |
adminConnectionModel | The FC base REST model. All other REST models are based off this |
adminConnectionsModel | The FC base REST model. All other REST models are based off this |
centralManagementModel | CentralManagementModel class. Holds the central management settings for monitoring the Server. All of the values are required |
createSSLCertificateModel | Data object that contains all of the information for creating self-signed SSL certificates on the FileCatalyst Server |
customFileSystemLabelsModel | Custom file system model class. These values are returned from the server and are not user configurable. |
deployedComponentNamesOnWebServer | |
expiryTimeModel | Model class that holds an expiry time value for various operations |
FCSessionModel | Model class to hold session information. This informtion is provided by the Server and is not user configurable. |
FCSessionsModel | Model class that contains a collection of sessions. This information is provided by the Server and is not user configurable. |
fileSystemModel | File system model |
fileSystemTestResultModel | The FC base REST model. All other REST models are based off this |
fileSystemTypeModel | File system type model. Contains the type and the file system labeels for a given file system. These values are provided by the Server and are not user configurable. |
fileSystemsModel | Model that contains a collection of file systems. This information is provided by the Server and is not user configurable. |
fileSystemEntry | |
fileSystemsAdaptedMap | |
folderLinkModel | Name Folder Link model class |
folderLinksModel | Model for representing the user and group links for a given virtual folder |
folderModel | Folder model class |
folderResourceLinkModel | Model for representing the linked resources for a given virtual folder |
foldersModel | Folders model class. This information is provided by the Server and is not user configurable. |
groupFolderLinkModel | Model for representing the link between a group and a folder |
groupLinksModel | Groups model class |
groupModel | User Group model class |
groupsModel | Groups model class. This information is provided by the Server and is not user configurable. |
HTTPLinkModel | Model containing information about the weblink and corresponding http-downloadLink (which sends the request to FTPServlet). This information is provided by the Server and is not user configurable. |
httpDownloadLinksModel | Modfel containing information about the weblink and corresponding http-downloadLink (which sends the request to FTPServlet). This information is provided by the Server and is not user configurable. |
linkElementModel | Generic link model that links elements together |
linkModel | Links a particular element with a permission set. |
linkPermissionsModel | Name LinkPermissions model class. No values are required but unset values will default to False. |
nameHrefModel | Name HREF model class |
overrideSettingsModel | Override model used for overriding user priorities and bandwidths. |
SSLCertificateBaseModel | Simple bean style object that contains common information for SSL certificate operations |
SSLCertificateDetailsModel | Data object that contains all of the information for the currently established SSL certificate |
serverLicenseModel | REST model that contains information about the current license installed on the server. This information is provided by the Server and is not user configurable. |
serverSMTPDispatchModel | Class that is responsible for holding the data used in FCServer SMTP dispatching operations |
serverStatusModel | A simple RESTModel that contains the status information for the server. This information is provided by the Server and is not user configurable. |
spacesUserAndVirtualFoldersModel | Folders model class. This information is provided by the Server and is not user configurable. |
tempUserCredientialsModel | A simple model that returns a user's credientials via REST services. Should only be used with temporary users that are created as part of the weblink feature. This information is provided by the Server and is not user configurable. |
trustedOriginModel | Model containing list of origins that are trusted by FileCatalyst Server's WebServer module and the module name that trusts the origins specified. |
trustedOriginsModel | Model containing information about request origins that are trusted by FileCatalyst Server's WebServer, to support cross-origin requests. |
unavailableFileModel | Model for UI display. This model will represent a file that could not be gathered as part of a request that was made to the server. Contains information that will prove to be helpful for error messages. This information is provided by the Server and is not user configurable. |
userFolderLinkGroupModel | Users model class |
userFolderLinkModel | User-Folder link model that links a user to a virtual folder |
userLinksModel | Model that contains all of the group and folder links that a given user has |
userModel | Model class to hold user information |
userSessionStatusModel | Model class that contains session data on a per user basis. This informaion is provided by the Server and is not user configurable. |
userWeblinkModel | Model class to information for creating and sending weblinks |
usersModel | Users model class. This is provided by the Server and is not user configurable. |
weblinkDetailsModel | Contains the details all of the files contained within a particular link. This information is provided by the Server and is not user configurable. |
weblinkFileDOModel | Data object that contains the file name, file path, and validity of a file in a link. This information is provided by the server and is not user onfigurable. |
weblinkModel | Model that shows the individual values for a link. This information is provided by the server and is not user configurable. |
weblinksModel | Model that contains all of the links that are returned as part of a GET request. This information is provided by the server and is not user configurable. |
folderUsageType | Enumeration of folder usage types |
linkTargetType | Enumeration of folder usage types |
serverUserType | Enumeration of user types |
virtualPathTargetType | Enumeration of folder usage types |
emptyModel | Shared model that contains nothing. Used mainly to demonstrate a successful call that does need a response body. 'Shared' models are models that used by more than one FC application |
fileObjectModel | Shared model containing all details of a file retrieved the from the local machine. 'Shared' models are models that used by more than one FC application |
fileObjectsModel | Shared collection model representing multiple FileObjectModel objects. 'Shared' models are models that used by more than one FC application |
fileOperationModel | Model that contains information needed for renaming, deleting, or creating directories on the local file system. Used in conjunction with certain calls to /files/remotefile and /files/localfile, this model is used as the request body when POSTing file commands using those resources |
genericIDModel | Shared model designed to hold a generic list of IDs. It is used mainly in mass delete calls. 'Shared' models are models that used by more than one FC application |
genericResponseModel | Shaerd model designed to return general responses to the user. 'Shared' models are models that used by more than one FC application |
graphModel | Shared model used for calls to GraphImplResource. Contains all necessary information to create a graph in a UI. 'Shared' models are models that used by more than one FC application |
histogramModel | Shared model that represents the data transferred by the application calling it. 'Shared' models are models that used by more than one FC application |
imageInfoModel | Shared model that contains the information for a given image. 'Shared' models are models that used by more than one FC application |
licenseModel | Shared model that contains information about the current license installed on the application. 'Shared' models are models that used by more than one FC application |
logFilesModel | Shared model that contains a list of logs. 'Shared' models are models that used by more than one FC application |
logsModel | Shared model that contains a list of logs. 'Shared' models are models that used by more than one FC application |
passwordModel | Password model class. Used for password changes. A new password and confirmation must be provided to change a password |
reportModel | Shared model storing information for reports. Reports differ from logs in that reports are numerical statistics describing file and transfer characteristics. For example transfer rate, file size, transfer time, etc. 'Shared' models are models that used by more than one FC application |
reportRequestModel | Shared model used to request reports from a given application. 'Shared' models are models that used by more than one FC application |
SMTPDispatchModel | Base class that is responsible for holding the basic data used in SMTP dispatching operations |
serviceStatusModel | Shared model that retrieves the status of the given application as a service. 'Shared' models are models that used by more than one FC application |
sessionClientLogModel | Shared model that stores all logs for a given client recorded during a given session. 'Shared' models are models that used by more than one FC application |
sizeModel | Shared model containing dimensions representing the size of an entity (usually an image). 'Shared' models are models that used by more than one FC application |
transferVisualsModel | Shared model storing information used to populate diagrams and graphics related to transfers. 'Shared' models are models that used by more than one FC application |
transmitRateTimeSliceModel | Shared model representing certain statistics of a given transferred that have been gathered over a set block of time. 'Shared' models are models that used by more than one FC application |
usageDataModel | Shared collection model holding multiple UsageDatumModel objects. 'Shared' models are models that used by more than one FC application |
usageDatumModel | Shared model representing |
weblinkResultModel | Shared model used to relay weblink status information. 'Shared' models are models that used by more than one FC application |
dataItemModel | Model used to contain the values that are used to modify configuration values in TransferAgent. Used with the /agent/config resource |
adaptedMap | An adapter map object that converts normal Java-based Map collections and translates them into proper XML |
entry | |
dataItemsModel | Model used to contain a collection of DataItemModel objects |
restartType | Enumeration representing different types of users |
userType | Enumeration of user types |
remoteFileOperationModel | Model that contains information needed for renaming, deleting, or creating directories on the local file system. Used in conjunction with certain calls to /files/remotefile and /files/localfile, this model is used as the request body when POSTing file commands using those resources |
remoteGenericIDsModel | Shared model designed to hold a generic list of IDs. It is used mainly in mass delete calls. 'Shared' models are models that used by more than one FC application |
webSocketSessionCollectionModel | The FC base REST model. All other REST models are based off this |
webSocketSessionInfoModel | Simple data model that contains the information for a given WebSocket session |
adaptedWebSocketSessionMap | An adapter map object that converts normal Java-based Map collections and translates them into proper XML |
webSocketSessionEntry |