|
|
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
..
|
|
|
-.TH "SYNCTHING-REST-API" "7" "Feb 20, 2022" "v1" "Syncthing"
|
|
|
+.TH "SYNCTHING-REST-API" "7" "Feb 23, 2022" "v1" "Syncthing"
|
|
|
.SH NAME
|
|
|
syncthing-rest-api \- REST API
|
|
|
.sp
|
|
|
@@ -43,6 +43,13 @@ the configuration file. To use an API key, set the request header
|
|
|
\fBX\-API\-Key\fP to the API key value. For example, \fBcurl \-X POST \-H
|
|
|
"X\-API\-Key: abc123" http://localhost:8384/rest/...\fP can be used to invoke
|
|
|
with \fBcurl\fP (add \fB\-k\fP flag when using HTTPS with a Syncthing generated or self signed certificate).
|
|
|
+.SH RESULT PAGINATION
|
|
|
+.sp
|
|
|
+Some \fIGET\fP endpoints take optional \fBpage\fP and \fBperpage\fP arguments for
|
|
|
+pagination. No more than \fBperpage\fP (defaults to 65536 if not given) result
|
|
|
+entries are returned in an array. To access further entries, passing the
|
|
|
+\fBpage\fP parameter will advance in the results by that many pages. The actually
|
|
|
+used parameters are always returned as attributes in the response object.
|
|
|
.SH SYSTEM ENDPOINTS
|
|
|
.SS GET /rest/system/browse
|
|
|
.sp
|
|
|
@@ -594,7 +601,8 @@ error. The new error will be displayed on any active GUI clients.
|
|
|
New in version 0.12.0.
|
|
|
|
|
|
.sp
|
|
|
-Returns the list of recent log entries.
|
|
|
+Returns the list of recent log entries. The optional \fBsince\fP parameter limits
|
|
|
+the results to message newer than the given timestamp in \fI\%RFC 3339\fP <\fBhttps://datatracker.ietf.org/doc/html/rfc3339.html\fP> format.
|
|
|
.INDENT 0.0
|
|
|
.INDENT 3.5
|
|
|
.sp
|
|
|
@@ -612,6 +620,9 @@ Returns the list of recent log entries.
|
|
|
.fi
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
+.SS GET /rest/system/log.txt
|
|
|
+.sp
|
|
|
+Returns the same information, formatted as a text log instead of a JSON object.
|
|
|
.SS POST /rest/system/pause
|
|
|
.sp
|
|
|
Pause the given device or all devices.
|
|
|
@@ -648,13 +659,14 @@ information for that folder will be erased:
|
|
|
.sp
|
|
|
.nf
|
|
|
.ft C
|
|
|
-$ curl \-X POST \-H "X\-API\-Key: abc123" http://localhost:8384/rest/system/reset?folder=ab1c2\-def3g
|
|
|
+curl \-X POST \-H "X\-API\-Key: abc123" http://localhost:8384/rest/system/reset?folder=ab1c2\-def3g
|
|
|
.ft P
|
|
|
.fi
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
.sp
|
|
|
-\fBCaution\fP: See \fB\-\-reset\-database\fP for \fB\&.stfolder\fP creation side\-effect and caution regarding mountpoints.
|
|
|
+\fBCaution\fP: See \fB\-\-reset\-database\fP for \fB\&.stfolder\fP creation
|
|
|
+side\-effect and caution regarding mountpoints.
|
|
|
.SS POST /rest/system/restart
|
|
|
.sp
|
|
|
Post with empty body to immediately restart Syncthing.
|
|
|
@@ -827,8 +839,8 @@ Returns the current Syncthing version information.
|
|
|
New in version 1.12.0.
|
|
|
|
|
|
.sp
|
|
|
-These endpoints facilitate access and modification of the configuration in a granular way. Config sent to the endpoints must be in the same
|
|
|
-format as returned by the corresponding GET request. When posting the
|
|
|
+These endpoints facilitate access and modification of the configuration in a granular way. Config sent to the endpoints must be in the
|
|
|
+same format as returned by the corresponding GET request. When posting the
|
|
|
configuration succeeds, the posted configuration is immediately applied, except
|
|
|
for changes that require a restart. Query \fI\%/rest/config/restart\-required\fP to check if
|
|
|
a restart is required.
|
|
|
@@ -857,6 +869,20 @@ Put the desired folder\- respectively device\-ID in place of *id*. \fBGET\fP
|
|
|
returns the folder/device for the given ID, \fBPUT\fP replaces the entire config,
|
|
|
\fBPATCH\fP replaces only the given child objects and \fBDELETE\fP removes the
|
|
|
folder/device.
|
|
|
+.SS /rest/config/defaults/folder, /rest/config/defaults/device
|
|
|
+.sp
|
|
|
+\fBGET\fP returns a template folder / device configuration object with all default
|
|
|
+values, which only needs a unique ID to be applied. \fBPUT\fP replaces the
|
|
|
+default config (omitted values are reset to the hard\-coded defaults), \fBPATCH\fP
|
|
|
+replaces only the given child objects.
|
|
|
+.SS /rest/config/defaults/ignores
|
|
|
+.sp
|
|
|
+New in version 1.19.0.
|
|
|
+
|
|
|
+.sp
|
|
|
+\fBGET\fP returns an object with a single \fBlines\fP attribute listing ignore
|
|
|
+patterns to be used by default on folders, as an array of single\-line strings.
|
|
|
+\fBPUT\fP replaces the default ignore patterns from an object of the same format.
|
|
|
.SS /rest/config/options, /rest/config/ldap, /rest/config/gui
|
|
|
.sp
|
|
|
\fBGET\fP returns the respective object, \fBPUT\fP replaces the entire object and
|
|
|
@@ -869,9 +895,9 @@ Concerns the mesh network structure.
|
|
|
New in version 1.18.0.
|
|
|
|
|
|
.sp
|
|
|
-Remove records about a pending remote device which tried to connect.
|
|
|
-Valid values for the \fBdevice\fP parameter are those from the
|
|
|
-corresponding /rest/cluster\-pending\-devices\-get endpoint.
|
|
|
+Remove records about a pending remote device which tried to connect. Valid
|
|
|
+values for the \fBdevice\fP parameter are those from the corresponding
|
|
|
+cluster\-pending\-devices\-get endpoint.
|
|
|
.INDENT 0.0
|
|
|
.INDENT 3.5
|
|
|
.sp
|
|
|
@@ -917,12 +943,11 @@ configured in our instance.
|
|
|
New in version 1.18.0.
|
|
|
|
|
|
.sp
|
|
|
-Remove records about a pending folder announced from a remote device.
|
|
|
-Valid values for the \fBfolder\fP and \fBdevice\fP parameters are those
|
|
|
-from the corresponding /rest/cluster\-pending\-folders\-get
|
|
|
-endpoint. The \fBdevice\fP parameter is optional and affects
|
|
|
-announcements of this folder from the given device, or from \fIany\fP
|
|
|
-device if omitted.
|
|
|
+Remove records about a pending folder announced from a remote device. Valid
|
|
|
+values for the \fBfolder\fP and \fBdevice\fP parameters are those from the
|
|
|
+corresponding cluster\-pending\-folders\-get endpoint. The \fBdevice\fP
|
|
|
+parameter is optional and affects announcements of this folder from the given
|
|
|
+device, or from \fIany\fP device if omitted.
|
|
|
.INDENT 0.0
|
|
|
.INDENT 3.5
|
|
|
.sp
|
|
|
@@ -934,12 +959,13 @@ $ curl \-X DELETE \-H "X\-API\-Key: abc123" http://localhost:8384/rest/cluster/p
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
.sp
|
|
|
-Returns status 200 and no content upon success, or status 500 and a
|
|
|
-plain text error on failure. A /events/pendingfolderschanged
|
|
|
-event will be generated in response.
|
|
|
+Returns status 200 and no content upon success, or status 500 and a plain text
|
|
|
+error on failure. A /events/pendingfolderschanged event will be
|
|
|
+generated in response.
|
|
|
.sp
|
|
|
-For a more permanent effect, also for future announcements of the same
|
|
|
-folder ID, the folder should be ignored in the configuration instead.
|
|
|
+For a more permanent effect, also for future announcements of the same folder
|
|
|
+ID, the folder should be ignored in the configuration
|
|
|
+instead.
|
|
|
.SS GET /rest/cluster/pending/folders
|
|
|
.sp
|
|
|
New in version 1.13.0.
|
|
|
@@ -986,6 +1012,115 @@ Other offering devices are also omitted from the result.
|
|
|
.fi
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
+.SH FOLDER ENDPOINTS
|
|
|
+.sp
|
|
|
+Runtime state of the individual shared folders.
|
|
|
+.SS GET /rest/folder/errors
|
|
|
+.sp
|
|
|
+New in version 0.14.53.
|
|
|
+
|
|
|
+.sp
|
|
|
+Takes one mandatory parameter, \fBfolder\fP, and returns the list of errors
|
|
|
+encountered during scanning or pulling.
|
|
|
+.sp
|
|
|
+The results can be paginated using the common pagination parameters\&.
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+.sp
|
|
|
+.nf
|
|
|
+.ft C
|
|
|
+{
|
|
|
+ "folder": "nnhic\-sxuae",
|
|
|
+ "errors": [
|
|
|
+ {
|
|
|
+ "path": "noperm.txt",
|
|
|
+ "error": "hashing: open /path/to/folder/noperm.txt: permission denied"
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "page": 1,
|
|
|
+ "perpage": 100
|
|
|
+}
|
|
|
+.ft P
|
|
|
+.fi
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.SS GET /rest/folder/pullerrors
|
|
|
+.sp
|
|
|
+Deprecated since version v0.14.53: This endpoint still works as before but is deprecated. Use
|
|
|
+folder\-errors\-get instead, which returns the same information.
|
|
|
+.sp
|
|
|
+See \fI\%d510e3cca3d5caae42121fa206b3decc981ae59e\fP <\fBhttps://github.com/syncthing/syncthing/commit/d510e3cca3d5caae42121fa206b3decc981ae59e\fP>
|
|
|
+
|
|
|
+.SS GET /rest/folder/versions
|
|
|
+.sp
|
|
|
+New in version 0.14.44.
|
|
|
+
|
|
|
+.sp
|
|
|
+Takes one mandatory parameter, \fBfolder\fP, and returns the list of archived
|
|
|
+files that could be recovered. How many versions are available depends on the
|
|
|
+/users/versioning configuration. Each entry specifies when the file
|
|
|
+version was archived as the \fBversionTime\fP, the \fBmodTime\fP when it was last
|
|
|
+modified before being archived, and the size in bytes.
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+.sp
|
|
|
+.nf
|
|
|
+.ft C
|
|
|
+{
|
|
|
+ "dir1/dir2/bar": [
|
|
|
+ {
|
|
|
+ "versionTime": "2022\-02\-06T20:44:12+01:00",
|
|
|
+ "modTime": "2021\-01\-14T13:21:22+01:00",
|
|
|
+ "size": 4
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "baz": [
|
|
|
+ {
|
|
|
+ "versionTime": "2022\-02\-06T20:44:20+01:00",
|
|
|
+ "modTime": "2021\-01\-14T13:23:49+01:00",
|
|
|
+ "size": 4
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "foo": [
|
|
|
+ {
|
|
|
+ "versionTime": "2022\-02\-06T20:55:31+01:00",
|
|
|
+ "modTime": "2022\-02\-06T20:44:13+01:00",
|
|
|
+ "size": 4
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "versionTime": "2022\-02\-06T20:44:20+01:00",
|
|
|
+ "modTime": "2021\-01\-14T13:21:16+01:00",
|
|
|
+ "size": 4
|
|
|
+ }
|
|
|
+ ]
|
|
|
+}
|
|
|
+.ft P
|
|
|
+.fi
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.SS POST /rest/folder/versions
|
|
|
+.sp
|
|
|
+Restore archived versions of a given set of files. Expects an object with
|
|
|
+attributes named after the relative file paths, with timestamps as values
|
|
|
+matching valid \fBversionTime\fP entries in the corresponding
|
|
|
+folder\-versions\-get response object.
|
|
|
+.sp
|
|
|
+Takes the mandatory parameter \fBfolder\fP (folder ID). Returns an object
|
|
|
+containing any error messages that occurred during restoration of the file, with
|
|
|
+the file path as attribute name.
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+.sp
|
|
|
+.nf
|
|
|
+.ft C
|
|
|
+curl \-X POST \-H X\-API\-key:... http://127.0.0.1:8384/rest/folder/versions?folder=default \-d \(aq{
|
|
|
+ "dir1/dir2/bar": "2022\-02\-06T20:44:12+01:00",
|
|
|
+ "baz": "2022\-02\-06T20:44:20+01:00"
|
|
|
+}\(aq
|
|
|
+.ft P
|
|
|
+.fi
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
.SH DATABASE ENDPOINTS
|
|
|
.SS GET /rest/db/browse
|
|
|
.sp
|
|
|
@@ -1233,19 +1368,62 @@ provides a list of strings which represent globbing patterns described by gobwas
|
|
|
.UNINDENT
|
|
|
.SS POST /rest/db/ignores
|
|
|
.sp
|
|
|
-Expects a format similar to the output of \fBGET\fP call, but only
|
|
|
+Expects a format similar to the output of db\-ignores\-get call, but only
|
|
|
containing the \fBignore\fP field (\fBexpanded\fP field should be omitted).
|
|
|
It takes one parameter, \fBfolder\fP, and either updates the content of
|
|
|
the \fB\&.stignore\fP echoing it back as a response, or returns an error.
|
|
|
+.SS GET /rest/db/localchanged
|
|
|
+.sp
|
|
|
+New in version 0.14.55.
|
|
|
+
|
|
|
+.sp
|
|
|
+Takes one mandatory parameter, \fBfolder\fP, and returns the list of files which
|
|
|
+were changed locally in a receive\-only folder. Thus they differ from the global
|
|
|
+state and could be reverted by pulling from remote devices again, see
|
|
|
+db\-revert\-post\&.
|
|
|
+.sp
|
|
|
+The results can be paginated using the common pagination parameters\&.
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+.sp
|
|
|
+.nf
|
|
|
+.ft C
|
|
|
+{
|
|
|
+ "files": [
|
|
|
+ {
|
|
|
+ "flags": "0755",
|
|
|
+ "sequence": 6,
|
|
|
+ "modified": "2015\-04\-20T23:06:12+09:00",
|
|
|
+ "name": "ls",
|
|
|
+ "size": 34640,
|
|
|
+ "version": [
|
|
|
+ "5157751870738175669:1"
|
|
|
+ ]
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "page": 1,
|
|
|
+ "perpage": 100
|
|
|
+}
|
|
|
+.ft P
|
|
|
+.fi
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.sp
|
|
|
+\fBNOTE:\fP
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+This is an expensive call, increasing CPU and RAM usage on the device.
|
|
|
+Use sparingly.
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
.SS GET /rest/db/need
|
|
|
.sp
|
|
|
Takes one mandatory parameter, \fBfolder\fP, and returns lists of files which are
|
|
|
needed by this device in order for it to become in sync.
|
|
|
.sp
|
|
|
-Furthermore takes an optional \fBpage\fP and \fBperpage\fP arguments for pagination.
|
|
|
-Pagination happens, across the union of all needed files, that is \- across all
|
|
|
-3 sections of the response.
|
|
|
-For example, given the current need state is as follows:
|
|
|
+The results can be paginated using the common pagination parameters\&. Pagination happens, across the union of all needed files,
|
|
|
+that is \- across all 3 sections of the response. For example, given the current
|
|
|
+need state is as follows:
|
|
|
.INDENT 0.0
|
|
|
.IP 1. 3
|
|
|
\fBprogress\fP has 15 items
|
|
|
@@ -1262,8 +1440,13 @@ section in the response will have 10 items. If you issue a request query with
|
|
|
2 items. If you issue a query for \fBpage=3\fP and \fBperpage=10\fP, you will only
|
|
|
have the last 10 items of the \fBrest\fP section.
|
|
|
.sp
|
|
|
-In all these calls, \fBtotal\fP will be 30 to indicate the total number of
|
|
|
-available items.
|
|
|
+\fBNOTE:\fP
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+Return format changed in version 0.14.43, removing the \fBtotal\fP count
|
|
|
+attribute.
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
.INDENT 0.0
|
|
|
.INDENT 3.5
|
|
|
.sp
|
|
|
@@ -1293,8 +1476,7 @@ available items.
|
|
|
...
|
|
|
],
|
|
|
"page": 1,
|
|
|
- "perpage": 100,
|
|
|
- "total": 2000
|
|
|
+ "perpage": 100
|
|
|
}
|
|
|
.ft P
|
|
|
.fi
|
|
|
@@ -1304,7 +1486,8 @@ available items.
|
|
|
\fBNOTE:\fP
|
|
|
.INDENT 0.0
|
|
|
.INDENT 3.5
|
|
|
-This is an expensive call, increasing CPU and RAM usage on the device. Use sparingly.
|
|
|
+This is an expensive call, increasing CPU and RAM usage on the device.
|
|
|
+Use sparingly.
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
.SS POST /rest/db/override
|
|
|
@@ -1338,7 +1521,50 @@ curl \-X POST http://127.0.0.1:8384/rest/db/prio?folder=default&file=foo/bar
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
.sp
|
|
|
-Response contains the same output as \fBGET /rest/db/need\fP
|
|
|
+Response contains the same output as db\-need\-get\&.
|
|
|
+.SS GET /rest/db/remoteneed
|
|
|
+.sp
|
|
|
+New in version 0.14.43.
|
|
|
+
|
|
|
+.sp
|
|
|
+Takes the mandatory parameters \fBfolder\fP and \fBdevice\fP, and returns the list
|
|
|
+of files which are needed by that remote device in order for it to become in
|
|
|
+sync with the shared folder.
|
|
|
+.sp
|
|
|
+The results can be paginated using the common pagination parameters\&.
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+.sp
|
|
|
+.nf
|
|
|
+.ft C
|
|
|
+{
|
|
|
+ "files": [
|
|
|
+ {
|
|
|
+ "flags": "0755",
|
|
|
+ "sequence": 6,
|
|
|
+ "modified": "2015\-04\-20T23:06:12+09:00",
|
|
|
+ "name": "ls",
|
|
|
+ "size": 34640,
|
|
|
+ "version": [
|
|
|
+ "5157751870738175669:1"
|
|
|
+ ]
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "page": 1,
|
|
|
+ "perpage": 100
|
|
|
+}
|
|
|
+.ft P
|
|
|
+.fi
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.sp
|
|
|
+\fBNOTE:\fP
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+This is an expensive call, increasing CPU and RAM usage on the device.
|
|
|
+Use sparingly.
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
.SS POST /rest/db/revert
|
|
|
.sp
|
|
|
New in version 0.14.50.
|
|
|
@@ -1503,6 +1729,11 @@ To receive only a limited number of events, add the \fBlimit=<n>\fP parameter wi
|
|
|
suitable value for \fBn\fP and only the \fIlast\fP \fBn\fP events will be returned. This
|
|
|
can be used to catch up with the latest event ID after a disconnection for
|
|
|
example: \fB/rest/events?since=0&limit=1\fP\&.
|
|
|
+.SS GET /rest/events/disk
|
|
|
+.sp
|
|
|
+This convenience endpoint provides the same event stream, but pre\-filtered to show
|
|
|
+only /events/localchangedetected and /events/remotechangedetected
|
|
|
+event types. The \fBevents\fP parameter is not used.
|
|
|
.SH STATISTICS ENDPOINTS
|
|
|
.SS GET /rest/stats/device
|
|
|
.sp
|
|
|
@@ -1532,14 +1763,13 @@ last scan time and the last synced file.
|
|
|
.sp
|
|
|
.nf
|
|
|
.ft C
|
|
|
-$ curl \-s http://localhost:8384/rest/stats/folder | json
|
|
|
{
|
|
|
- "folderid" : {
|
|
|
+ "folderid": {
|
|
|
"lastScan": "2016\-06\-02T13:28:01.288181412\-04:00",
|
|
|
- "lastFile" : {
|
|
|
- "filename" : "file/name",
|
|
|
- "at" : "2015\-04\-16T22:04:18.3066971+01:00"
|
|
|
- }
|
|
|
+ "lastFile": {
|
|
|
+ "filename": "file/name",
|
|
|
+ "at": "2015\-04\-16T22:04:18.3066971+01:00"
|
|
|
+ }
|
|
|
}
|
|
|
}
|
|
|
.ft P
|
|
|
@@ -1663,6 +1893,50 @@ Returns the data sent in the anonymous usage report.
|
|
|
.fi
|
|
|
.UNINDENT
|
|
|
.UNINDENT
|
|
|
+.SH DEBUG ENDPOINTS
|
|
|
+.SS Debug Endpoints
|
|
|
+.sp
|
|
|
+These endpoints require the \fBgui.debugging\fP configuration option to
|
|
|
+be enabled and yield an access denied error code otherwise.
|
|
|
+.SS GET /rest/debug/peerCompletion
|
|
|
+.sp
|
|
|
+Summarizes the completion precentage for each remote device. Returns an object
|
|
|
+with device IDs as keys and an integer percentage as values.
|
|
|
+.SS GET /rest/debug/httpmetrics
|
|
|
+.sp
|
|
|
+Returns statistics about each served REST API endpoint, to diagnose how much
|
|
|
+time was spent generating the responses.
|
|
|
+.SS GET /rest/debug/cpuprof
|
|
|
+.sp
|
|
|
+Used to capture a profile of what Syncthing is doing on the CPU. See
|
|
|
+/users/profiling\&.
|
|
|
+.SS GET /rest/debug/heapprof
|
|
|
+.sp
|
|
|
+Used to capture a profile of what Syncthing is doing with the heap memory. See
|
|
|
+/users/profiling\&.
|
|
|
+.SS GET /rest/debug/support
|
|
|
+.sp
|
|
|
+Collects information about the running instance for troubleshooting purposes.
|
|
|
+Returns a “support bundle” as a zipped archive, which should be sent to the
|
|
|
+developers after verifying it contains no sensitive personal information.
|
|
|
+Credentials for the web GUI and the API key are automatically redacted already.
|
|
|
+.SS GET /rest/debug/file
|
|
|
+.sp
|
|
|
+Shows diagnostics about a certain file in a shared folder. Takes the \fBfolder\fP
|
|
|
+(folder ID) and \fBfile\fP (folder relative path) parameters.
|
|
|
+.INDENT 0.0
|
|
|
+.INDENT 3.5
|
|
|
+.sp
|
|
|
+.nf
|
|
|
+.ft C
|
|
|
+$ curl \-H X\-API\-Key:... "http://localhost:8384/rest/debug/file?folder=default&file=foo/bar"
|
|
|
+.ft P
|
|
|
+.fi
|
|
|
+.UNINDENT
|
|
|
+.UNINDENT
|
|
|
+.sp
|
|
|
+The returned object contains the same info as db\-file\-get, plus a summary
|
|
|
+of \fBglobalVersions\fP\&.
|
|
|
.SH AUTHOR
|
|
|
The Syncthing Authors
|
|
|
.SH COPYRIGHT
|
Syncthing Release Automation