Creates one logical source without accepting a machine path.
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://example.com/api/workspace/file-protection/sources"), Headers = { { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"DisplayName\": \"example\", \"Tags\": [ \"example\" ], \"AssignedAgentId\": \"example\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};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/file-protection/sources';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"DisplayName":"example","Tags":["example"],"AssignedAgentId":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/workspace/file-protection/sources \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "DisplayName": "example", "Tags": [ "example" ], "AssignedAgentId": "example" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.
Request Body
Section titled “Request Body”Creates a logical source. The physical path is configured locally.
object
Examplegenerated
{ "DisplayName": "example", "Tags": [ "example" ], "AssignedAgentId": "example"}Creates a logical source. The physical path is configured locally.
object
Examplegenerated
{ "DisplayName": "example", "Tags": [ "example" ], "AssignedAgentId": "example"}Creates a logical source. The physical path is configured locally.
object
Examplegenerated
{ "DisplayName": "example", "Tags": [ "example" ], "AssignedAgentId": "example"}Responses
Section titled “Responses”OK
object
Safe logical protection source without a physical machine path.
object
State of one logical protection source.
Safe manual run projection.
object
Supported backup command kinds. Restore is deliberately absent.
Durable state of one manual protection run.
The authority which accepted a protection operation.
Successful operation result; completion includes server verification or renewal.
Observed blockers. A deadline applies only while waiting; useful work pauses the budget.
object
Safe removal progress. Cancellation ends when irreversible cleanup starts.
object
Source selector interpreted only by the local Agent.
Once used, a confirmed local kind cannot be changed by another configuration.
Current source-scoped permissions; commands still authorize every request.
Source-owned schedule, independent of its configuring user’s account.
object
Latest durable schedule decision and its authorized operation.
object
Safe manual run projection.
object
Supported backup command kinds. Restore is deliberately absent.
Durable state of one manual protection run.
The authority which accepted a protection operation.
Successful operation result; completion includes server verification or renewal.
Observed blockers. A deadline applies only while waiting; useful work pauses the budget.
object
Compact active signal summary for object grids.
object
Exact active type/severity association for combined grid filters.
object
object
object
object
object
Example
{ "Data": { "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 } ]}