openapi: 3.0.0 info: title: Secret Server Rest Activations SecretPolicy API description: REST API documentation for Secret Server. This document describes how to use the REST API. All requests require an authentication token; please see the authentication document for more information. The Swagger specification for this API is also available. termsOfService: https://delinea.com/eula contact: name: Support url: https://delinea.com version: 11.7.2 servers: - url: /SecretServer/api security: - BearerToken: [] tags: - name: SecretPolicy description: Retrieve and update Secret Policies paths: /v1/secret-policy/search: get: tags: - SecretPolicy summary: Search Secret Policies description: Search Secret Policies operationId: SecretPolicyService_SearchSecretPolicies parameters: - name: filter.includeInactive in: query description: Whether or not to include inactive secret policies required: false schema: type: boolean - name: filter.secretPolicyName in: query description: Results will contain this text in the policy name required: false schema: type: string - name: skip in: query description: Number of records to skip before taking results required: false schema: type: integer format: int32 - name: sortBy[0].direction in: query description: Sort direction required: false schema: type: string - name: sortBy[0].name in: query description: Sort field name required: false schema: type: string - name: sortBy[0].priority in: query description: Priority index. Sorts with lower values are executed earlier required: false schema: type: integer format: int32 - name: take in: query description: Maximum number of records to include in results required: false schema: type: integer format: int32 responses: '200': description: Secret Policies that matched content: application/json: schema: $ref: '#/components/schemas/PagingOfSecretPolicyModel' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false /v2/secret-policy/stub: get: tags: - SecretPolicy summary: Get Secret Policy Stub description: Get Secret Policy operationId: SecretPolicyService_GetSecretPolicyStubV2 responses: '200': description: Stub of a Secret Policy Detail model content: application/json: schema: $ref: '#/components/schemas/SecretPolicyDetailModelV2' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false /v2/secret-policy/{id}: get: tags: - SecretPolicy summary: Get Secret Policy description: Get Secret Policy for passed in Id operationId: SecretPolicyService_GetSecretPolicyV2 parameters: - name: id in: path description: id required: true schema: type: integer format: int32 responses: '200': description: Secret Policy if found content: application/json: schema: $ref: '#/components/schemas/SecretPolicyDetailModelV2' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false patch: tags: - SecretPolicy summary: Update a Secret Policy description: Update a Secret Policy and return detail model operationId: SecretPolicyService_UpdateSecretPolicyV2 parameters: - name: id in: path description: id required: true schema: type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretPolicyUpdateArgsV2' description: args responses: '200': description: Secret Policy that was updated content: application/json: schema: $ref: '#/components/schemas/SecretPolicyDetailModelV2' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false /v1/secret-policy/{id}/audit: get: tags: - SecretPolicy summary: Get Secret Policy Audits description: Get Secret Policy Audits for passed in Id operationId: SecretPolicyService_GetSecretPolicyAudit parameters: - name: id in: path description: id required: true schema: type: integer format: int32 - name: isExporting in: query description: isExporting required: false schema: type: boolean - name: skip in: query description: Number of records to skip before taking results required: false schema: type: integer format: int32 - name: sortBy[0].direction in: query description: Sort direction required: false schema: type: string - name: sortBy[0].name in: query description: Sort field name required: false schema: type: string - name: sortBy[0].priority in: query description: Priority index. Sorts with lower values are executed earlier required: false schema: type: integer format: int32 - name: take in: query description: Maximum number of records to include in results required: false schema: type: integer format: int32 responses: '200': description: Secret Policy Audits content: application/json: schema: $ref: '#/components/schemas/IPagingOfSecretPolicyAuditSummary' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false /v1/secret-policy/{id}/status: get: tags: - SecretPolicy summary: Get the Secret Policy status description: Gets the status of what secrets and folders the policy is applied to. operationId: SecretPolicyService_GetSecretPolicyStatus parameters: - name: id in: path description: id required: true schema: type: integer format: int32 responses: '200': description: Secret Policy status for queried policy. content: application/json: schema: $ref: '#/components/schemas/SecretPolicyStatusModel' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false /v2/secret-policy: post: tags: - SecretPolicy summary: Create a Secret Policy description: Create a Secret Policy and return detail model operationId: SecretPolicyService_CreateSecretPolicyV2 requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretPolicyCreateArgsV2' description: args responses: '200': description: Secret Policy that was created content: application/json: schema: $ref: '#/components/schemas/SecretPolicyDetailModelV2' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false components: schemas: Sort: description: Sort options. Multiple sort options can be provided in the query string. required: - name - direction properties: direction: $ref: '#/components/schemas/SortDirection' name: description: Sort field name type: string priority: description: Priority index. Sorts with lower values are executed earlier type: integer format: int32 type: object SecretPolicyUpdateArgsV2: description: SecretPolicyUpdateArgsV2 properties: data: $ref: '#/components/schemas/SecretPolicyUpdateModelV2' type: object SecretPolicyUpdateModelV2: description: Secret Policy Update Model V2 properties: active: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' generalItems: $ref: '#/components/schemas/SecretPolicyGeneralItemsUpdateModel' launcherItems: $ref: '#/components/schemas/SecretPolicyLauncherItemsUpdateModel' rpcItems: $ref: '#/components/schemas/SecretPolicyRpcItemsUpdateModel' secretPolicyDescription: $ref: '#/components/schemas/UpdateFieldValueOfString' secretPolicyName: $ref: '#/components/schemas/UpdateFieldValueOfString' securityItems: $ref: '#/components/schemas/SecretPolicySecurityItemsUpdateModel' type: object SecretPolicyRpcItemsUpdateModel: description: Secret Policy RPC Items Update Model properties: associatedSecretId1: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' associatedSecretId2: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' autoChangeOnExpiration: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' autoChangeSchedule: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfAutoChangeScheduleDataModel' heartBeatEnabled: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' passwordTypeWebScriptId: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' privilegedSecretId: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' type: object UpdateFieldValueOfBoolean: description: Active properties: dirty: description: Dirty type: boolean value: description: Value type: boolean type: object UserGroupMapModel: description: User Group Map Model properties: displayName: description: Group Name type: string groupId: description: Group Id type: integer format: int32 userGroupMapType: $ref: '#/components/schemas/UserGroupMapType' type: object AutoChangeScheduleModel: description: Auto Change Schedule Model properties: changeOnlyWhenExpired: description: The password will only be changed when the Secret has expired type: boolean changeType: description: Schedule Change Type type: string nullable: true days: description: Days of Recurrence if Daily ScheduleType type: integer format: int32 nullable: true friday: description: Occurs on Fridays when set if Weekly ScheduleType type: boolean nullable: true monday: description: Occurs on Mondays when set if Weekly ScheduleType type: boolean nullable: true monthlyDay: description: Day(s) used if DayOfWeekMonth and Monthly ScheduleType type: string nullable: true monthlyDayOfMonth: description: Day of Month if DayOfMonth and Monthly ScheduleType type: integer format: int32 nullable: true monthlyDayOrder: description: Day Order used if DayOfWeekMonth and Monthly ScheduleType type: string nullable: true monthlyDayOrderRecurrence: description: Months of Recurrence if DayOfWeekMonth and Monthly ScheduleType type: integer format: int32 nullable: true monthlyDayRecurrence: description: Months of Recurrence if DayOfMonth and Monthly ScheduleType type: integer format: int32 nullable: true monthlyScheduleType: description: Selection used if Monthly ScheduleType type: string nullable: true saturday: description: Occurs on Saturdays when set if Weekly ScheduleType type: boolean nullable: true startingOn: description: Day for Schedule to start type: string format: date-time sunday: description: Occurs on Sundays when set if Weekly ScheduleType type: boolean nullable: true thursday: description: Occurs on Thursdays when set if Weekly ScheduleType type: boolean nullable: true tuesday: description: Occurs on Tuesdays when set if Weekly ScheduleType type: boolean nullable: true wednesday: description: Occurs on Wednesdays when set if Weekly ScheduleType type: boolean nullable: true weeks: description: Weeks of Recurrence if Weekly ScheduleType type: integer format: int32 nullable: true type: object SortDirection: description: Sort direction properties: {} type: string enum: - None - Asc - Desc IPagingOfSecretPolicyAuditSummary: description: IPagingOfSecretPolicyAuditSummary properties: records: description: Records items: $ref: '#/components/schemas/SecretPolicyAuditSummary' type: array sortBy: description: SortBy items: $ref: '#/components/schemas/Sort' type: array type: object SecretPolicyStatusModel: description: Secret Policy Status Model properties: inProgressSecretCount: description: Number of secrets that are queued to change to the queried policy. type: number format: double secretCount: description: Number of secrets the policy is applied to. type: number format: double secretPercentComplete: description: Completion percentage for the applied secrets. Value is between 0 and 1 type: number format: double secretPolicyId: description: Id of the Secret Policy type: integer format: int32 type: object Severity: description: Error severity level properties: {} type: string enum: - None - Retry - Warn - Critical - Fatal PolicyApplyType: description: PolicyApplyType properties: {} type: string enum: - NotSet - Default - Enforced SecretPolicyLauncherItemsModel: description: Secret Policy Launcher Item Model properties: launcherSettings: $ref: '#/components/schemas/SecretPolicyItemOfLauncherSettingsModel' webLauncherRequiresIncognitoMode: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' type: object InternalServerErrorResponse: description: Response object for internal server errors required: - message - exceptionMessage - exceptionType - stackTrace properties: message: description: Error message type: string exceptionMessage: description: Error message from exception type: string exceptionType: description: Exception type type: string stackTrace: description: Exception stack trace type: string type: object SshCommandMenuGroupModel: description: Ssh Command Menu Group Model properties: groupId: description: Group Id type: integer format: int32 sshCommandMenuId: description: Ssh Command Menu Id type: integer format: int32 nullable: true type: object SshCommandMenuGroupMapModel: description: Ssh Command Menu Group Map Model properties: groupId: description: Group Id type: integer format: int32 sshCommandMenuId: description: Ssh Command Menu Id type: integer format: int32 nullable: true sshCommandMenuName: description: Ssh Command Menu Name type: string userGroupDisplayName: description: User Or Group Display Name type: string userGroupMapType: $ref: '#/components/schemas/UserGroupMapType' type: object UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32: description: Site Id properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' type: object SecretPolicyDataItemOfAutoChangeScheduleDataModel: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: $ref: '#/components/schemas/AutoChangeScheduleDataModel' type: object SecretPolicyDetailModelV2: description: Secret Policy Detail Model V2 properties: active: description: Indicates the policy is active type: boolean affectedFolderCount: description: The count of total folders that would be affected by changing this policy type: integer format: int32 affectedInheritingFoldersCount: description: The count of inherited secrets that would be affected by changing this policy type: integer format: int32 affectedInheritingSecretsCount: description: The count of inherited secrets that would be affected by changing this policy type: integer format: int32 affectedSecretCount: description: The count of total secrets that would be affected by changing this policy type: integer format: int32 generalItems: $ref: '#/components/schemas/SecretPolicyGeneralItemsModel' launcherItems: $ref: '#/components/schemas/SecretPolicyLauncherItemsModel' rpcItems: $ref: '#/components/schemas/SecretPolicyRpcItemsModel' secretPolicyDescription: description: Secret Policy Description type: string secretPolicyId: description: Secret Policy Id type: integer format: int32 nullable: true secretPolicyName: description: Secret Policy Name type: string securityItems: $ref: '#/components/schemas/SecretPolicySecurityItemsModel' type: object BadRequestResponse: description: Response object for invalid requests required: - message properties: message: description: Error message type: string messageDetail: description: Error message detail type: string errorCode: description: Error message code type: string modelState: description: An object describing validation errors type: object type: object UpdateFieldValueOfSecretPolicyDataItemOfLauncherSettingsData: description: RDP Launcher Settings as defined by the Secret Policy properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfLauncherSettingsData' type: object SecretPolicyCreateArgsV2: description: SecretPolicyCreateArgsV2 properties: data: $ref: '#/components/schemas/SecretPolicyCreateModelV2' type: object SecretPolicyDataItemOfLauncherSettingsData: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: $ref: '#/components/schemas/LauncherSettingsData' type: object SecretPolicyDataItemOfOptionalGuid: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: description: Value type: string format: uuid nullable: true type: object AutoChangeScheduleDataModel: description: Auto Change Schedule Data Model properties: changeOnlyWhenExpired: description: The password will only be changed when the Secret has expired type: boolean changeType: description: Schedule Change Type type: string nullable: true days: description: Days of Recurrence if Daily ScheduleType type: integer format: int32 nullable: true friday: description: Occurs on Fridays when set if Weekly ScheduleType type: boolean nullable: true monday: description: Occurs on Mondays when set if Weekly ScheduleType type: boolean nullable: true monthlyDay: description: Day(s) used if DayOfWeekMonth and Monthly ScheduleType type: string nullable: true monthlyDayOfMonth: description: Day of Month if DayOfMonth and Monthly ScheduleType type: integer format: int32 nullable: true monthlyDayOrder: description: Day Order used if DayOfWeekMonth and Monthly ScheduleType type: string nullable: true monthlyDayOrderRecurrence: description: Months of Recurrence if DayOfWeekMonth and Monthly ScheduleType type: integer format: int32 nullable: true monthlyDayRecurrence: description: Months of Recurrence if DayOfMonth and Monthly ScheduleType type: integer format: int32 nullable: true monthlyScheduleType: description: Selection used if Monthly ScheduleType type: string nullable: true saturday: description: Occurs on Saturdays when set if Weekly ScheduleType type: boolean nullable: true startingOn: description: Day for Schedule to start type: string format: date-time sunday: description: Occurs on Sundays when set if Weekly ScheduleType type: boolean nullable: true thursday: description: Occurs on Thursdays when set if Weekly ScheduleType type: boolean nullable: true tuesday: description: Occurs on Tuesdays when set if Weekly ScheduleType type: boolean nullable: true wednesday: description: Occurs on Wednesdays when set if Weekly ScheduleType type: boolean nullable: true weeks: description: Weeks of Recurrence if Weekly ScheduleType type: integer format: int32 nullable: true type: object UserGroupMapType: description: User Group Map Type properties: {} type: string enum: - User - Group SecretPolicyItemOfSshCommandMenuGroupMapModelArray: description: Array of Ssh Command Menu Groups depends on Ssh Command Restriction Type being set properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: description: Value items: $ref: '#/components/schemas/SshCommandMenuGroupMapModel' type: array type: object UpdateFieldValueOfSecretPolicyDataItemOfOptionalGuid: description: Jumpbox Route Id properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalGuid' type: object SecretPolicyAuditSummary: description: Records properties: action: description: Action type: string databaseName: description: DatabaseName type: string dateRecorded: description: DateRecorded type: string format: date-time machineName: description: MachineName type: string notes: description: Notes type: string secretPolicyAuditId: description: SecretPolicyAuditId type: integer format: int32 userId: description: UserId type: integer format: int32 username: description: Username type: string type: object UpdateFieldValueOfSecretPolicyDataItemOfOptionalCommandRestrictionType: description: Ssh Command Restriction Type depends on Enable Ssh Command Restrictions being set properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalCommandRestrictionType' type: object SecretPolicyGeneralItemsModel: description: Secret Policy General Item Model properties: jumpboxRouteId: $ref: '#/components/schemas/SecretPolicyItemOfOptionalGuid' siteId: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' type: object SecretPolicyRpcItemsModel: description: Secret Policy RPC Items Model properties: associatedSecretId1: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' associatedSecretId2: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' autoChangeOnExpiration: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' autoChangeSchedule: $ref: '#/components/schemas/SecretPolicyItemOfAutoChangeScheduleModel' heartBeatEnabled: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' passwordTypeWebScriptId: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' privilegedSecretId: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' type: object SecretPolicyDataItemOfOptionalCommandRestrictionType: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: description: Value type: string nullable: true type: object SecretPolicySecurityItemsCreateModel: description: Secret Policy Security Item Create Model properties: allowOwnersUnrestrictedSshCommands: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' approvalGroups: $ref: '#/components/schemas/SecretPolicyDataItemOfUserGroupMapDataModelArray' approvalWorkflow: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' checkOutChangePassword: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' checkOutEnabled: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' checkOutIntervalMinutes: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' enableSshCommandRestrictions: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' eventPipelinePolicy: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' hideLauncherPassword: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' isMultiFactorAuthenticationRequired: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' isProxyEnabled: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' isSessionRecordingEnabled: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' requireApprovalForAccess: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' requireApprovalForAccessForEditors: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' requireApprovalForAccessForOwnersAndApprovers: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' requireViewComment: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' runLauncherUsingSSHKeySecretId: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' sshCommandBlocklistEditors: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalGuid' sshCommandBlocklistOwners: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalGuid' sshCommandBlocklistViewers: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalGuid' sshCommandMenuGroups: $ref: '#/components/schemas/SecretPolicyDataItemOfSshCommandMenuGroupModelArray' sshCommandRestrictionType: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalCommandRestrictionType' type: object SecretPolicyGeneralItemsCreateModel: description: Secret Policy General Create Item Model properties: jumpboxRouteId: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalGuid' siteId: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' type: object SecretPolicyItemOfLauncherSettingsModel: description: Launcher Settings defined by the secret policy properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: $ref: '#/components/schemas/LauncherSettingsModel' type: object SecretPolicyDataItemOfOptionalInt32: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: description: Value type: integer format: int32 nullable: true type: object UserGroupMapDataModel: description: User Group Map Data Model properties: groupId: description: User/Group Id type: integer format: int32 userGroupMapType: $ref: '#/components/schemas/UserGroupMapType' type: object SecretPolicyLauncherItemsCreateModel: description: Secret Policy Launcher Item Create Model properties: launcherSettings: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfLauncherSettingsData' webLauncherRequiresIncognitoMode: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' type: object SecretPolicyCreateModelV2: description: Secret Policy Create Model V2 properties: active: description: Indicates the policy is active type: boolean generalItems: $ref: '#/components/schemas/SecretPolicyGeneralItemsCreateModel' launcherItems: $ref: '#/components/schemas/SecretPolicyLauncherItemsCreateModel' rpcItems: $ref: '#/components/schemas/SecretPolicyRpcItemsCreateModel' secretPolicyDescription: description: Secret Policy Description type: string secretPolicyName: description: Secret Policy Name type: string securityItems: $ref: '#/components/schemas/SecretPolicySecurityItemsCreateModel' type: object SecretPolicyDataItemOfOptionalBoolean: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: description: Value type: boolean nullable: true type: object UpdateFieldValueOfSecretPolicyDataItemOfUserGroupMapDataModelArray: description: Array of UserGroupMaps depends on Require Approval For Access being set properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfUserGroupMapDataModelArray' type: object LauncherSettingsModel: description: RDP Launcher Settings properties: allowClipboard: description: Allow Clipboard type: boolean allowDrives: description: Allow Drives type: boolean allowPrinters: description: Allow Printers type: boolean allowSmartCards: description: Allow SmartCards type: boolean connectToConsole: description: Connect To Console type: boolean launcherHeight: description: Launcher Height type: integer format: int32 nullable: true launcherWidth: description: Launcher Height type: integer format: int32 nullable: true useCustomLauncherResolution: description: Use Custom Launcher Resolution type: boolean type: object AuthenticationFailedResponse: description: Response object for authentication failures required: - message properties: message: description: Error message type: string type: object SecretPolicyRpcItemsCreateModel: description: Secret Policy RPC Items Create Model properties: associatedSecretId1: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' associatedSecretId2: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' autoChangeOnExpiration: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' autoChangeSchedule: $ref: '#/components/schemas/SecretPolicyDataItemOfAutoChangeScheduleDataModel' heartBeatEnabled: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' passwordTypeWebScriptId: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' privilegedSecretId: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalInt32' type: object SecretPolicySecurityItemsUpdateModel: description: Secret Policy Security Item Update Model properties: allowOwnersUnrestrictedSshCommands: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' approvalGroups: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfUserGroupMapDataModelArray' approvalWorkflow: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' checkOutChangePassword: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' checkOutEnabled: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' checkOutIntervalMinutes: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' enableSshCommandRestrictions: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' eventPipelinePolicy: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' hideLauncherPassword: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' isMultiFactorAuthenticationRequired: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' isProxyEnabled: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' isSessionRecordingEnabled: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' requireApprovalForAccess: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' requireApprovalForAccessForEditors: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' requireApprovalForAccessForOwnersAndApprovers: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' requireViewComment: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' runLauncherUsingSSHKeySecretId: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' sshCommandBlocklistEditors: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalGuid' sshCommandBlocklistOwners: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalGuid' sshCommandBlocklistViewers: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalGuid' sshCommandMenuGroups: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfSshCommandMenuGroupModelArray' sshCommandRestrictionType: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalCommandRestrictionType' type: object UpdateFieldValueOfSecretPolicyDataItemOfSshCommandMenuGroupModelArray: description: Array of Ssh Command Menu Groups depends on Ssh Command Restriction Type being set properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfSshCommandMenuGroupModelArray' type: object SecretPolicyModel: description: SecretPolicies properties: active: description: Whether or not the Secret Policy is Active type: boolean secretPolicyDescription: description: The Description of the Secret Policy type: string secretPolicyId: description: The Id of the Secret Policy type: integer format: int32 secretPolicyName: description: The Name of the Secret Policy type: string type: object SecretPolicyItemOfAutoChangeScheduleModel: description: Auto Change Schedule depends on Auto Change On Expiration being set properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: $ref: '#/components/schemas/AutoChangeScheduleModel' type: object SecretPolicyItemOfOptionalBoolean: description: Web Launcher Requires Incognito Mode properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: description: Value type: boolean nullable: true type: object SecretPolicyItemOfUserGroupMapModelArray: description: Array of UserGroupMaps depends on Require Approval For Access being set properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: description: Value items: $ref: '#/components/schemas/UserGroupMapModel' type: array type: object SecretPolicyItemOfOptionalGuid: description: Jumpbox Route Id properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: description: Value type: string format: uuid nullable: true type: object SecretPolicyItemOfOptionalInt32: description: Site Id properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: description: Value type: integer format: int32 nullable: true type: object PagingOfSecretPolicyModel: description: Specify paging and sorting options for querying records and returning results properties: batchCount: description: Number of result batches available with current query options type: integer format: int32 currentPage: description: Index of current result page type: integer format: int32 hasNext: description: Whether there are any results in additional pages type: boolean hasPrev: description: Whether there are any results in previous pages type: boolean nextSkip: description: Correct value of 'skip' for the next page of results type: integer format: int32 pageCount: description: Number of result pages available with current query options type: integer format: int32 prevSkip: description: Correct value of 'skip' for the previous page of results type: integer format: int32 records: description: Query results items: $ref: '#/components/schemas/SecretPolicyModel' type: array severity: $ref: '#/components/schemas/Severity' skip: description: Number of records to skip before taking results type: integer format: int32 sortBy: description: List of sort properties items: $ref: '#/components/schemas/Sort' type: array success: description: Whether the query executed successfully type: boolean take: description: Maximum number of records to include in results type: integer format: int32 total: description: Total number of results available type: integer format: int32 type: object SecretPolicyDataItemOfSshCommandMenuGroupModelArray: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: description: Value items: $ref: '#/components/schemas/SshCommandMenuGroupModel' type: array type: object SecretPolicyGeneralItemsUpdateModel: description: Secret Policy General Update Item Model properties: jumpboxRouteId: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalGuid' siteId: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalInt32' type: object LauncherSettingsData: description: Value properties: allowClipboard: description: AllowClipboard type: boolean allowDrives: description: AllowDrives type: boolean allowPrinters: description: AllowPrinters type: boolean allowSmartCards: description: AllowSmartCards type: boolean connectToConsole: description: ConnectToConsole type: boolean launcherHeight: description: LauncherHeight type: integer format: int32 nullable: true launcherWidth: description: LauncherWidth type: integer format: int32 nullable: true useCustomLauncherResolution: description: UseCustomLauncherResolution type: boolean type: object SecretPolicySecurityItemsModel: description: Secret Policy Security Item Model properties: allowOwnersUnrestrictedSshCommands: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' approvalGroups: $ref: '#/components/schemas/SecretPolicyItemOfUserGroupMapModelArray' approvalWorkflow: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' checkOutChangePassword: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' checkOutEnabled: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' checkOutIntervalMinutes: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' enableSshCommandRestrictions: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' eventPipelinePolicy: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' hideLauncherPassword: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' isMultiFactorAuthenticationRequired: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' isProxyEnabled: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' isSessionRecordingEnabled: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' requireApprovalForAccess: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' requireApprovalForAccessForEditors: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' requireApprovalForAccessForOwnersAndApprovers: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' requireViewComment: $ref: '#/components/schemas/SecretPolicyItemOfOptionalBoolean' runLauncherUsingSSHKeySecretId: $ref: '#/components/schemas/SecretPolicyItemOfOptionalInt32' sshCommandBlocklistEditors: $ref: '#/components/schemas/SecretPolicyItemOfOptionalGuid' sshCommandBlocklistOwners: $ref: '#/components/schemas/SecretPolicyItemOfOptionalGuid' sshCommandBlocklistViewers: $ref: '#/components/schemas/SecretPolicyItemOfOptionalGuid' sshCommandMenuGroups: $ref: '#/components/schemas/SecretPolicyItemOfSshCommandMenuGroupMapModelArray' sshCommandRestrictionType: $ref: '#/components/schemas/SecretPolicyItemOfOptionalCommandRestrictionType' type: object SecretPolicyLauncherItemsUpdateModel: description: Secret Policy Launcher Item Update Model properties: launcherSettings: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfLauncherSettingsData' webLauncherRequiresIncognitoMode: $ref: '#/components/schemas/UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean' type: object UpdateFieldValueOfString: description: Description properties: dirty: description: Dirty type: boolean value: description: Value type: string type: object SecretPolicyItemOfOptionalCommandRestrictionType: description: Ssh Command Restriction Type depends on Enable Ssh Command Restrictions being set properties: parentPolicyItemId: description: ParentPolicyItemId type: integer format: int32 nullable: true policyApplyType: $ref: '#/components/schemas/PolicyApplyType' policyItemId: description: PolicyItemId type: integer format: int32 value: description: Value type: string nullable: true type: object UpdateFieldValueOfSecretPolicyDataItemOfOptionalBoolean: description: Web Launcher Requires Incognito Mode properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfOptionalBoolean' type: object UpdateFieldValueOfSecretPolicyDataItemOfAutoChangeScheduleDataModel: description: Auto Change Schedule depends on Auto Change On Expiration being set properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretPolicyDataItemOfAutoChangeScheduleDataModel' type: object SecretPolicyDataItemOfUserGroupMapDataModelArray: description: Value properties: policyApplyType: $ref: '#/components/schemas/PolicyApplyType' value: description: Value items: $ref: '#/components/schemas/UserGroupMapDataModel' type: array type: object securitySchemes: BearerToken: type: apiKey description: 'Perform a POST request to `/oauth2/token`. It should include three form data parameters - `username`, `password`, and `grant_type`.The `grant_type` parameter should always have the value `password`.The access token returned should be included in the header of subsequent requests, like ''Authorization: Bearer token''. The token remains valid for a time period returned in the ''expires_in'' property (in seconds). For details, see the token request documentation.' name: Authorization in: header