Skip to content

Enables File Protection and additively reconciles its security foundation.

POST
/api/workspace/admin/file-protection/enable
curl --request POST \
--url https://example.com/api/workspace/admin/file-protection/enable \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "RowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'
access_token
string

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

Enables File Protection and reconciles its security foundation.

object
RowVersion
string format: uuid
nullable
Examplegenerated
{
"RowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

OK

Media typeapplication/json
object
Data

File Protection module administration detail.

object
Summary

File Protection lifecycle summary.

object
ModuleKey
string
nullable
DisplayName
string
nullable
Description
string
nullable
IsEnabled
boolean
ConfigurationState
integer format: int32
Allowed values: 0 1 2 3 4 5
EnabledAtUtc
string format: date-time
nullable
DisabledAtUtc
string format: date-time
nullable
DisabledReason
string
nullable
RowVersion
string format: uuid
nullable
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>
nullable

Availability of one delivered File Protection capability.

object
Key
integer format: int32
Allowed values: 0 1 2 3 4
IsAvailable
boolean
BlockerKeys
Array<string>
nullable
Blockers
Array<object>
nullable

One safe, machine-readable readiness problem.

object
Code
string
nullable
SuggestedAction
string
nullable
Contract

Installed public automation contract identity.

object
PackageId
string
nullable
ContractVersion
string
nullable
AssemblyVersion
string
nullable
Repository

Safe Protection Repository state visible to workspace administrators.

object
Id
string
nullable
OwnershipMode
integer format: int32
Allowed values: 0 1 2
Provider
integer format: int32
Allowed values: 0
ProvisioningMode
integer format: int32
Allowed values: 0 1
State
integer format: int32
Allowed values: 0 1 2
Region
string
nullable
BucketName
string
nullable
ObjectLockMode
integer format: int32
Allowed values: 0
DefaultRetentionDays
integer format: int32
LastValidatedAtUtc
string format: date-time
nullable
LastErrorCode
string
nullable
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>
nullable

Supported customer-owned Hetzner region.

object
Key
string
nullable
DisplayName
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": {
"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
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Conflict

Media typeapplication/json
object
Data

File Protection module administration detail.

object
Summary

File Protection lifecycle summary.

object
ModuleKey
string
nullable
DisplayName
string
nullable
Description
string
nullable
IsEnabled
boolean
ConfigurationState
integer format: int32
Allowed values: 0 1 2 3 4 5
EnabledAtUtc
string format: date-time
nullable
DisabledAtUtc
string format: date-time
nullable
DisabledReason
string
nullable
RowVersion
string format: uuid
nullable
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>
nullable

Availability of one delivered File Protection capability.

object
Key
integer format: int32
Allowed values: 0 1 2 3 4
IsAvailable
boolean
BlockerKeys
Array<string>
nullable
Blockers
Array<object>
nullable

One safe, machine-readable readiness problem.

object
Code
string
nullable
SuggestedAction
string
nullable
Contract

Installed public automation contract identity.

object
PackageId
string
nullable
ContractVersion
string
nullable
AssemblyVersion
string
nullable
Repository

Safe Protection Repository state visible to workspace administrators.

object
Id
string
nullable
OwnershipMode
integer format: int32
Allowed values: 0 1 2
Provider
integer format: int32
Allowed values: 0
ProvisioningMode
integer format: int32
Allowed values: 0 1
State
integer format: int32
Allowed values: 0 1 2
Region
string
nullable
BucketName
string
nullable
ObjectLockMode
integer format: int32
Allowed values: 0
DefaultRetentionDays
integer format: int32
LastValidatedAtUtc
string format: date-time
nullable
LastErrorCode
string
nullable
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>
nullable

Supported customer-owned Hetzner region.

object
Key
string
nullable
DisplayName
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": {
"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
}
]
}