Run a device sync now

Runs a device sync immediately, through the same code path as the scheduled job. Synchronous: the response is sent when the sync finishes, which on a large estate can take minutes. A provider failure returns an error and leaves the sync cursor untouched, so the unread window is retried rather than skipped.

Path parameters

providerstringRequired

RMM provider slug: ninjaone, levelio, tacticalrmm, tanium, or huntress. Scheduled device sync is available for the first four; huntress exposes no device listing.

Request body

Content type: application/json · schema RmmSyncTriggerBody

syncTypestring

Defaults to incremental, which resumes from the same cursor the schedule uses. 'full' re-reads every device regardless of when it was last seen.

Enum: fullincremental

Response body

Success response 200 · schema RmmSyncTriggerResponse

providerstringRequired

syncTypestringRequired

Enum: fullincremental

devicesProcessedintegerRequired

startedAtstring <date-time>Required

finishedAtstring <date-time>Required

Response codes

200

Sync completed.

400

Invalid request body, provider without a device sync, or an inactive integration.

401

Missing or invalid API key.

403

API key lacks the system_settings permission.

404

No integration configured for this provider.

POST /api/v1/integrations/rmm/{provider}/sync

cURL

curl -X POST "https://algapsa.com/api/v1/integrations/rmm/{provider}/sync" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "syncType": "full"
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/integrations/rmm/{provider}/sync", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "syncType": "full"
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/integrations/rmm/{provider}/sync");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""syncType"": ""full""
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "provider": "string",
  "syncType": "full",
  "devicesProcessed": 1,
  "startedAt": "2026-04-18T15:22:14Z",
  "finishedAt": "2026-04-18T15:22:14Z"
}