Skip to content

Returns the authorized operational overview.

GET
/api/workspace/file-protection
curl --request GET \
--url https://example.com/api/workspace/file-protection \
--header 'Authorization: Bearer <token>'
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

OK

Media typeapplication/json
object
Data

Operational File Protection overview visible to an authorized actor.

object
IsEnabled
boolean
IsSuspended
boolean
ModuleRowVersion
string format: uuid
Agents
Array<object>
nullable

Safe state of one enrolled backup Agent.

object
Id
string
nullable
DisplayName
string
nullable
OperatingSystem

Operating systems supported by the universal File Protection tools.

integer format: int32
Allowed values: 0 1
AgentVersion
string
nullable
State

Lifecycle state reported for an enrolled Agent.

integer format: int32
Allowed values: 0 1 2 3
LastHeartbeatAtUtc
string format: date-time
nullable
SourceCount
integer format: int32
RowVersion
string format: uuid
SignalSummary

Compact active signal summary for object grids.

object
Count
integer format: int32
Severity
integer format: int32
Allowed values: 1 2
PolicyKinds
Array<integer>
nullable
Allowed values: 0 1 2 3 4 5
Conditions
Array<object>
nullable

Exact active type/severity association for combined grid filters.

object
PolicyKind
integer format: int32
Allowed values: 0 1 2 3 4 5
Severity
integer format: int32
Allowed values: 1 2
Count
integer format: int32
RequiredAgentVersion

Required Agent software for the current installation instructions.

string
nullable
RequiresUpdate

Connection availability does not establish software compatibility.

boolean
Sources
Array<object>
nullable

Safe logical protection source without a physical machine path.

object
Id
string
nullable
DisplayName
string
nullable
AssignedAgentId
string
nullable
State

State of one logical protection source.

integer format: int32
Allowed values: 0 1 2 3
Tags
Array<string>
nullable
LogicalName
string
nullable
LatestSizeBytes
integer format: int64
nullable
LastSuccessfulProtectionAtUtc
string format: date-time
nullable
LatestRun

Safe manual run projection.

object
Id
string
nullable
SourceId
string
nullable
Kind

Supported backup command kinds. Restore is deliberately absent.

integer format: int32
Allowed values: 0
State

Durable state of one manual protection run.

integer format: int32
Allowed values: 0 1 2 3 4 5 6
ProcessedBytes
integer format: int64
TotalBytes
integer format: int64
nullable
RequestedAtUtc
string format: date-time
CompletedAtUtc
string format: date-time
nullable
SafeStatusCode
string
nullable
SafeErrorCode
string
nullable
RowVersion
string format: uuid
Origin

The authority which accepted a protection operation.

integer format: int32
Allowed values: 0 1
Outcome

Successful operation result; completion includes server verification or renewal.

integer format: int32
Allowed values: 0 1 2
AttemptCount
integer format: int32
StartedAtUtc
string format: date-time
nullable
NextAttemptAtUtc
string format: date-time
nullable
LastProgressAtUtc
string format: date-time
nullable
Wait

Observed blockers. A deadline applies only while waiting; useful work pauses the budget.

object
ObservedAtUtc
string format: date-time
RemainingSeconds
integer format: int64
DeadlineAtUtc
string format: date-time
nullable
Reasons
Array<string>
nullable
PreviousAccessExpiresAtUtc
string format: date-time
nullable
MaintenanceUntilUtc
string format: date-time
nullable
RowVersion
string format: uuid
Deletion

Safe removal progress. Cancellation ends when irreversible cleanup starts.

object
RequestedAtUtc
string format: date-time
NotBeforeUtc
string format: date-time
StartedAtUtc
string format: date-time
nullable
SafeErrorCode
string
nullable
ConfirmedKind

Source selector interpreted only by the local Agent.

integer format: int32
Allowed values: 0 1 2
KindFrozenAtUtc

Once used, a confirmed local kind cannot be changed by another configuration.

string format: date-time
nullable
AllowedActions

Current source-scoped permissions; commands still authorize every request.

Array<string>
nullable
Schedule

Source-owned schedule, independent of its configuring user’s account.

object
Enabled
boolean
CronExpression
string
nullable
TimeZoneId
string
nullable
NextRunAtUtc
string format: date-time
nullable
LastRunAtUtc
string format: date-time
nullable
LatestScheduleOccurrence

Latest durable schedule decision and its authorized operation.

object
Id
string
nullable
DueAtUtc
string format: date-time
Outcome
string
nullable
RunId
string
nullable
Run

Safe manual run projection.

object
Id
string
nullable
SourceId
string
nullable
Kind

Supported backup command kinds. Restore is deliberately absent.

integer format: int32
Allowed values: 0
State

Durable state of one manual protection run.

integer format: int32
Allowed values: 0 1 2 3 4 5 6
ProcessedBytes
integer format: int64
TotalBytes
integer format: int64
nullable
RequestedAtUtc
string format: date-time
CompletedAtUtc
string format: date-time
nullable
SafeStatusCode
string
nullable
SafeErrorCode
string
nullable
RowVersion
string format: uuid
Origin

The authority which accepted a protection operation.

integer format: int32
Allowed values: 0 1
Outcome

Successful operation result; completion includes server verification or renewal.

integer format: int32
Allowed values: 0 1 2
AttemptCount
integer format: int32
StartedAtUtc
string format: date-time
nullable
NextAttemptAtUtc
string format: date-time
nullable
LastProgressAtUtc
string format: date-time
nullable
Wait

Observed blockers. A deadline applies only while waiting; useful work pauses the budget.

object
ObservedAtUtc
string format: date-time
RemainingSeconds
integer format: int64
DeadlineAtUtc
string format: date-time
nullable
Reasons
Array<string>
nullable
PreviousAccessExpiresAtUtc
string format: date-time
nullable
MaintenanceUntilUtc
string format: date-time
nullable
SignalSummary

Compact active signal summary for object grids.

object
Count
integer format: int32
Severity
integer format: int32
Allowed values: 1 2
PolicyKinds
Array<integer>
nullable
Allowed values: 0 1 2 3 4 5
Conditions
Array<object>
nullable

Exact active type/severity association for combined grid filters.

object
PolicyKind
integer format: int32
Allowed values: 0 1 2 3 4 5
Severity
integer format: int32
Allowed values: 1 2
Count
integer format: int32
AllowedActions

Current workspace-scoped permissions usable for page-level actions.

Array<string>
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"Agents": [
{
"OperatingSystem": 0,
"State": 0,
"SignalSummary": {
"Severity": 1,
"PolicyKinds": [
0
],
"Conditions": [
{
"PolicyKind": 0,
"Severity": 1
}
]
}
}
],
"Sources": [
{
"State": 0,
"LatestRun": {
"Kind": 0,
"State": 0,
"Origin": 0,
"Outcome": 0
},
"ConfirmedKind": 0,
"LatestScheduleOccurrence": {
"Run": {
"Kind": 0,
"State": 0,
"Origin": 0,
"Outcome": 0
}
},
"SignalSummary": {
"Severity": 1,
"PolicyKinds": [
0
],
"Conditions": [
{
"PolicyKind": 0,
"Severity": 1
}
]
}
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}