Update an allowed path

put/providers/{providerId}/allowedPaths/{allowedPathId}

Updates an existing allowed path through a full replacement of the resource. The ID field might not be modified by this operation.

Request Samples

1

Response Samples

1{
2  "id": "f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
3  "path": "/data/shared/updated-projects",
4  "createdBy": "sasjoe",
5  "modifiedBy": "sasjoe",
6  "creationTimeStamp": "2026-02-05T10:30:00.000Z",
7  "modifiedTimeStamp": "2026-02-05T11:45:00.000Z",
8  "version": 1,
9  "links": [
10    {
11      "method": "GET",
12      "rel": "self",
13      "href": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
14      "uri": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f"
15    },
16    {
17      "method": "PUT",
18      "rel": "update",
19      "href": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
20      "uri": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f"
21    },
22    {
23      "method": "DELETE",
24      "rel": "delete",
25      "href": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
26      "uri": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f"
27    },
28    {
29      "method": "GET",
30      "rel": "up",
31      "href": "/dataSources/providers/Compute/allowedPaths",
32      "uri": "/dataSources/providers/Compute/allowedPaths"
33    }
34  ]
35}

Path Parameters

NameTypeRequiredDescription
allowedPathId
string
true

The ID for the allowed path.

providerId
string
true

The ID for the provider.

Header Parameters

NameTypeRequiredDescription
If-Match
string
true

The ETag that was returned from a GET, POST, PUT, PATCH, or HEAD of this object. If the ETag does not match, the update will fail.

Request Body

The allowed path to update.

Request body for updating an allowed path.

NameTypeRequiredDescription
id
string
true

The unique allowed path identifier (must match path parameter).

path
string
true

The file system path that users are allowed to access.

Responses

StatusMeaningDescription
200OK

The request succeeded. Allowed path updated successfully.

HeadersSchema
400Bad Request

The request was invalid. This occurs when the user provides an ID in the request that does not match the ID in the path of the URL.

Schema
404Not Found

No allowed path exists at the requested path.

Schema
406Not Acceptable

This is an example of an error that could be returned for unsupported requested media type.

Schema
412Precondition Failed

The ETag provided does not match the current version of the object.

Schema
428Precondition Required

The If-Match header was not provided when updating an existing allowed path.

Schema