Links

Get Latest Import Operations

It requires the view-import-operations permission.
URL
Requires Auth
HTTP Method
/api/v1/getLatestImportOperations
yes
GET

Headers

Argument
Example
Required
Description
X-User-Id
myuser-name
Required
The authenticated user ID.
X-Auth-Token
myauth-token
Required
Auth token.

Example Call

Curl
Node.js
Python
PHP
Java
curl -L -X GET 'http://localhost:3000/api/v1/getLatestImportOperations' \
-H 'X-User-Id: d26x6zSkaPSe5gCyy' \
-H 'X-Auth-Token: Zu-Z6eKzIIz7MCCRGeHi29bYkXZCJ4SxFC0JAasqm92'
var request = require('request');
var options = {
'method': 'GET',
'url': 'http://localhost:3000/api/v1/getLatestImportOperations',
'headers': {
'X-User-Id': 'd26x6zSkaPSe5gCyy',
'X-Auth-Token': 'Zu-Z6eKzIIz7MCCRGeHi29bYkXZCJ4SxFC0JAasqm92'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "http://localhost:3000/api/v1/getLatestImportOperations"
payload={}
headers = {
'X-User-Id': 'd26x6zSkaPSe5gCyy',
'X-Auth-Token': 'Zu-Z6eKzIIz7MCCRGeHi29bYkXZCJ4SxFC0JAasqm92'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('http://localhost:3000/api/v1/getLatestImportOperations');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'X-User-Id' => 'd26x6zSkaPSe5gCyy',
'X-Auth-Token' => 'Zu-Z6eKzIIz7MCCRGeHi29bYkXZCJ4SxFC0JAasqm92'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("http://localhost:3000/api/v1/getLatestImportOperations")
.header("X-User-Id", "d26x6zSkaPSe5gCyy")
.header("X-Auth-Token", "Zu-Z6eKzIIz7MCCRGeHi29bYkXZCJ4SxFC0JAasqm92")
.asString();

Example Result

Success

[
{
"_id": "MJxTRZsYdho8Ww2qq",
"type": "Pending Avatars",
"importerKey": "pending-avatars",
"ts": 1635280600083,
"status": "importer_user_selection",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T11:26:24.430Z"
},
{
"_id": "YzSCu9WgqJ3wutF4T",
"type": "Pending Files",
"importerKey": "pending-files",
"ts": 1635280596592,
"status": "importer_done",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T08:32:42.609Z"
},
{
"_id": "96WJDaxXpwXC3fTD5",
"type": "Pending Files",
"importerKey": "pending-files",
"ts": 1635277590992,
"status": "importer_user_selection",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T08:32:42.609Z"
},
{
"_id": "zYc5kuFRaszfqCegB",
"type": "Pending Avatars",
"importerKey": "pending-avatars",
"ts": 1635277492185,
"status": "importer_done",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T08:32:42.609Z"
},
{
"_id": "XckCNn9ZsdywHso4f",
"type": "Pending Avatars",
"importerKey": "pending-avatars",
"ts": 1635277452755,
"status": "importer_done",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T08:32:42.609Z"
},
{
"_id": "NRqiLZ4bADfGwMRMz",
"type": "CSV",
"importerKey": "csv",
"ts": 1635247067385,
"status": "importer_file_loaded",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T08:32:42.609Z",
"contentType": "image/svg+xml",
"file": "2021926111747_d26x6zSkaPSe5gCyy_pp.svg"
},
{
"_id": "9mCbRPTbF9QHQ3RM6",
"type": "Pending Avatars",
"importerKey": "pending-avatars",
"ts": 1635247489080,
"status": "importer_done",
"valid": false,
"user": "d26x6zSkaPSe5gCyy",
"_updatedAt": "2021-10-27T08:32:42.609Z"
}
]

Error

Any of the following errors can occur on the endpoint.
  • Authorization: Requires an authentication token for the request to be made.
  • No Permission: This occurs when the authenticated user doesn't have the view-import-operations permission.
Authorization
No permission
{
"success": false,
"error": "unauthorized"
}
{
"success": false,
"error": "User does not have the permissions required for this action [error-unauthorized]"
}

Change Log

Version
Description
1.0.0
Added
Last modified 4mo ago
Deprecation for cloud services and apps is now extended to November 20, 2023. Rocket.Chat versions receive support for six months after release.