PUT/api/v1/integrations/rmm/{provider}/device-sync

Product availabilityAlgaPSA

Configure the scheduled device sync

Turns the recurring device sync on or off and sets its cadence. Writes desired state only — the scheduler reconciles the actual schedule within a few minutes, so a change is not instantaneous. Returns the integration status after the write.

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 RmmDeviceSyncUpdateBody

enabledbooleanRequired

Turn the recurring device sync on or off.

intervalMinutesinteger

Cadence in minutes. Defaults to 60. Values outside 15 to 1440 are rejected rather than clamped, so the stored cadence is always the one requested. Every run spends provider API quota, and on some providers an incremental run still reads the whole device list.

≥ 15 · ≤ 1440

Response body

Success response 200 · schema RmmIntegrationStatus

providerstringRequired

RMM provider slug.

integrationIdstring <uuid>Required

isActivebooleanRequired

Whether the integration is connected and enabled.

syncStatusstringRequiredNullable

Last sync outcome: 'completed', 'error', 'syncing', or 'pending'.

syncErrorstringRequiredNullable

Failure detail from the last run, when it failed.

connectedAtstring <date-time>RequiredNullable

lastSyncAtstring <date-time>RequiredNullable

Any sync, scheduled or manual. A manual full sync advances this too.

lastIncrementalSyncAtstring <date-time>RequiredNullable

Only the recurring device sync writes this. Use it, not lastSyncAt, to answer whether the schedule is actually running: an integration can show a recent lastSyncAt from one manual sync while nothing recurring has ever run.

deviceCountintegerRequired

Assets currently attributed to this provider.

deviceSyncEnabledbooleanRequired

Whether a recurring device sync is scheduled.

deviceSyncIntervalMinutesintegerRequired

Cadence in minutes, 15 to 1440. Meaningful only when deviceSyncEnabled is true.

Response codes

200

Updated integration status.

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.

PUT /api/v1/integrations/rmm/{provider}/device-sync

cURL

curl -X PUT "https://algapsa.com/api/v1/integrations/rmm/{provider}/device-sync" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": false,
  "intervalMinutes": 15
}'

TypeScript

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

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

200 OK·application/json

{
  "provider": "string",
  "integrationId": "01HN2K7VRB9PQ3Y0000000000",
  "isActive": false,
  "syncStatus": "string",
  "syncError": "string",
  "connectedAt": "2026-04-18T15:22:14Z",
  "lastSyncAt": "2026-04-18T15:22:14Z",
  "lastIncrementalSyncAt": "2026-04-18T15:22:14Z",
  "deviceCount": 1,
  "deviceSyncEnabled": false,
  "deviceSyncIntervalMinutes": 1
}