|
5211 | 5211 | "tags": [ |
5212 | 5212 | "Device Management" |
5213 | 5213 | ] |
| 5214 | + }, |
| 5215 | + "post": { |
| 5216 | + "description": "Commissions a new device, into the device hierarchy and appends appropriate metadata and initial policies. Appends required metadata to proper locations.\n\nThis endpoint requires the `Device.Privileged.ReadWrite`, or the `Everything.ReadWrite` scope (permission).", |
| 5217 | + "operationId": "/Api/Defend/Device/Type/Privileged/Post", |
| 5218 | + "requestBody": { |
| 5219 | + "content": { |
| 5220 | + "application/json": { |
| 5221 | + "example": { |
| 5222 | + "deviceId": "f7e1a66f-ce2e-4351-83df-2776813ef95d" |
| 5223 | + }, |
| 5224 | + "schema": { |
| 5225 | + "properties": { |
| 5226 | + "deviceId": { |
| 5227 | + "description": "The SHIELD ID (Entra ID Device ID) of the device to target.", |
| 5228 | + "example": "75da7fa4-4a04-44c8-8f2c-c1b2fa29aa51", |
| 5229 | + "format": "uuid", |
| 5230 | + "maxLength": 36, |
| 5231 | + "minLength": 36, |
| 5232 | + "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}$", |
| 5233 | + "type": "string" |
| 5234 | + } |
| 5235 | + }, |
| 5236 | + "required": [ |
| 5237 | + "deviceId" |
| 5238 | + ], |
| 5239 | + "type": "object" |
| 5240 | + } |
| 5241 | + } |
| 5242 | + } |
| 5243 | + }, |
| 5244 | + "responses": { |
| 5245 | + "200": { |
| 5246 | + "content": { |
| 5247 | + "application/json": { |
| 5248 | + "schema": { |
| 5249 | + "$ref": "#/components/schemas/ManagedObject.PrivilegedDevice" |
| 5250 | + } |
| 5251 | + } |
| 5252 | + }, |
| 5253 | + "description": "OK" |
| 5254 | + }, |
| 5255 | + "401": { |
| 5256 | + "$ref": "#/components/responses/401" |
| 5257 | + }, |
| 5258 | + "404": { |
| 5259 | + "$ref": "#/components/responses/404" |
| 5260 | + }, |
| 5261 | + "525": { |
| 5262 | + "$ref": "#/components/responses/525" |
| 5263 | + } |
| 5264 | + }, |
| 5265 | + "summary": "Commission a New PAW.", |
| 5266 | + "tags": [ |
| 5267 | + "Device Management" |
| 5268 | + ] |
5214 | 5269 | } |
5215 | 5270 | }, |
5216 | 5271 | "/Api/Defend/Device/{deviceId}/Type/{securityClass}": { |
|
5534 | 5589 | "tags": [ |
5535 | 5590 | "User Management" |
5536 | 5591 | ] |
| 5592 | + }, |
| 5593 | + "post": { |
| 5594 | + "description": "Securely clones the specified user's properties into a new managed user object in the privileged baselines.\n\nThis endpoint requires the `User.Privileged.ReadWrite`, or the `Everything.ReadWrite` scope (permission).", |
| 5595 | + "operationId": "/Api/Defend/User/Type/Privileged/Post", |
| 5596 | + "requestBody": { |
| 5597 | + "content": { |
| 5598 | + "application/json": { |
| 5599 | + "example": { |
| 5600 | + "userId": "d886680d-a283-4fc2-803f-370d81d62366" |
| 5601 | + }, |
| 5602 | + "schema": { |
| 5603 | + "properties": { |
| 5604 | + "userId": { |
| 5605 | + "description": "The Entra ID object ID of the user to clone.", |
| 5606 | + "example": "264a8bed-0714-48fd-8b9d-0e4c4715cee5", |
| 5607 | + "format": "uuid", |
| 5608 | + "maxLength": 36, |
| 5609 | + "minLength": 36, |
| 5610 | + "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}$", |
| 5611 | + "type": "string" |
| 5612 | + } |
| 5613 | + }, |
| 5614 | + "required": [ |
| 5615 | + "userId" |
| 5616 | + ], |
| 5617 | + "type": "object" |
| 5618 | + } |
| 5619 | + } |
| 5620 | + } |
| 5621 | + }, |
| 5622 | + "responses": { |
| 5623 | + "200": { |
| 5624 | + "content": { |
| 5625 | + "application/json": { |
| 5626 | + "schema": { |
| 5627 | + "$ref": "#/components/schemas/ManagedObject.PrivilegedUser" |
| 5628 | + } |
| 5629 | + } |
| 5630 | + }, |
| 5631 | + "description": "OK" |
| 5632 | + }, |
| 5633 | + "401": { |
| 5634 | + "$ref": "#/components/responses/401" |
| 5635 | + }, |
| 5636 | + "404": { |
| 5637 | + "$ref": "#/components/responses/404" |
| 5638 | + }, |
| 5639 | + "409": { |
| 5640 | + "description": "User is already managed." |
| 5641 | + }, |
| 5642 | + "525": { |
| 5643 | + "$ref": "#/components/responses/525" |
| 5644 | + } |
| 5645 | + }, |
| 5646 | + "summary": "Create/Bring new Privileged User Into Management", |
| 5647 | + "tags": [ |
| 5648 | + "User Management" |
| 5649 | + ] |
5537 | 5650 | } |
5538 | 5651 | }, |
5539 | 5652 | "/Api/Defend/User/{userId}/Type/{securityClass}": { |
|
0 commit comments