Returns File Protection lifecycle and readiness.
GET
/api/workspace/admin/file-protection
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Get, RequestUri = new Uri("https://example.com/api/workspace/admin/file-protection"), Headers = { { "Authorization", "Bearer <token>" }, },};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://example.com/api/workspace/admin/file-protection';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/workspace/admin/file-protection \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”access_token
string
Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.
Responses
Section titled “Responses”OK
Media typeapplication/json
object
Data
File Protection module administration detail.
object
Summary
File Protection lifecycle summary.
object
ModuleKey
string
DisplayName
string
Description
string
IsEnabled
boolean
ConfigurationState
integer format: int32
EnabledAtUtc
string format: date-time
DisabledAtUtc
string format: date-time
DisabledReason
string
RowVersion
string format: uuid
AllowedActions
Allowed lifecycle actions for the current module state.
object
CanEnable
boolean
CanReconcileSecurity
boolean
CanDisable
boolean
Readiness
Capability-specific readiness of the installed File Protection foundation.
object
IsOperationallyHealthy
boolean
IsFullyReady
boolean
Capabilities
Array<object>
Availability of one delivered File Protection capability.
object
Key
integer format: int32
IsAvailable
boolean
BlockerKeys
Array<string>
Blockers
Array<object>
One safe, machine-readable readiness problem.
object
Code
string
SuggestedAction
string
Contract
Installed public automation contract identity.
object
PackageId
string
ContractVersion
string
AssemblyVersion
string
Repository
Safe Protection Repository state visible to workspace administrators.
object
Id
string
OwnershipMode
integer format: int32
Provider
integer format: int32
ProvisioningMode
integer format: int32
State
integer format: int32
Region
string
BucketName
string
ObjectLockMode
integer format: int32
DefaultRetentionDays
integer format: int32
LastValidatedAtUtc
string format: date-time
LastErrorCode
string
RowVersion
string format: uuid
CanResumeSetup
boolean
CanChangeSetup
boolean
CanRepairCredentials
boolean
CanReconcile
boolean
RepositorySetup
Deployment-authorized repository setup choices.
object
ManagedStorageAvailable
boolean
CustomerOwnedStorageAvailable
boolean
Regions
Array<object>
Supported customer-owned Hetzner region.
object
Key
string
DisplayName
string
Errors
Array<object>
object
Code
required
string
Message
required
string
Target
string
Field
string
Metadata
object
key
additional properties
string
Type
integer format: int32
Severity
integer format: int32
Warnings
Array<object>
object
Code
required
string
Message
required
string
Target
string
Field
string
Metadata
object
key
additional properties
string
Type
integer format: int32
Severity
integer format: int32
Success
boolean
Example
{ "Data": { "Summary": { "ConfigurationState": 0 }, "Readiness": { "Capabilities": [ { "Key": 0 } ] }, "Repository": { "OwnershipMode": 0, "Provider": 0, "ProvisioningMode": 0, "State": 0, "ObjectLockMode": 0 } }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}Forbidden
Media typeapplication/json
object
type
string
title
string
status
integer format: int32
detail
string
instance
string
key
additional properties
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}