openapi: 3.0.0 info: title: Secret Server Rest Activations Secrets 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: Secrets description: View and maintain Secrets paths: /v1/secrets/{id}: put: tags: - Secrets summary: Update Secret description: Update a single secret by ID operationId: SecretsService_UpdateSecret parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretUpdateArgs' description: Secret update options responses: '200': description: Secret object content: application/json: schema: $ref: '#/components/schemas/SecretModel' '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 delete: tags: - Secrets summary: Deactivate a Secret description: A deactivated secret is hidden from users who do not have a role containing the View Inactive Secrets permission. Secret Server uses these "soft deletes" to maintain the audit history for all data. However, deactivated secrets are still accessible by administrators (like a permanent Recycle Bin) to ensure that audit history is maintained and to support recovery. A user must have the "View Inactive Secrets" permission in addition to Owner permission on a secret to access the secret View page for a deleted secret. To permanently remove all information on a secret, use the "Erase Secret" function. operationId: SecretsService_Delete parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Object deletion result content: application/json: schema: $ref: '#/components/schemas/DeletedModel' '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/secrets/{id}/fields/{slug}/listdetails: get: tags: - Secrets summary: Get Secret List Field List Data description: Get the lists associated to a secret list data field operationId: SecretsService_GetListFieldListDefinitions parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - 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 - name: slug in: path description: The field slug name of the list field. This is the fieldSlugName property of the SecretField object. By default, it is the lower-case field name with all spaces replaced with dashes (-). required: true schema: type: string responses: '200': description: Combined summary of all lists assigned to the secret field. content: application/json: schema: $ref: '#/components/schemas/PagingOfCategorizedListSummary' '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 put: tags: - Secrets summary: Update Secret List Field List Data description: Updates the lists associated to a secret list data field operationId: SecretsService_UpdateListFieldListDefinitions parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: slug in: path description: Secret field name required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretListFieldListArgs' description: Secret options responses: '200': description: Combined summary of all lists assigned to the secret field. content: application/json: schema: $ref: '#/components/schemas/PagingOfCategorizedListSummary' '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 delete: tags: - Secrets summary: Delete Secret List Field List Data description: Deletes the lists associated to a secret list data field operationId: SecretsService_DeleteListFieldListDefinitions parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: listGuid in: query description: Secret options required: false schema: type: string format: uuid - name: slug in: path description: Secret field name required: true schema: type: string responses: '200': description: Combined summary of all lists assigned to the secret field. content: application/json: schema: $ref: '#/components/schemas/PagingOfCategorizedListSummary' '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/secrets: get: tags: - Secrets summary: Search Secrets description: Search, filter, sort, and page secrets operationId: SecretsService_SearchV2 parameters: - name: filter.allowDoubleLocks in: query description: Whether to allow DoubleLocks as part of the search. True by default. required: false x-nullable: true schema: type: boolean - name: filter.doNotCalculateTotal in: query description: Whether to return the total number of secrets matching the filters. False by default. If false, the total can be retrieved separately by calling /v1/secrets/search-total with the same arguments used in the search. required: false x-nullable: true schema: type: boolean - name: filter.doubleLockId in: query description: Only include Secrets with this DoubleLock ID assigned in the search results. required: false x-nullable: true schema: type: integer format: int32 - name: filter.extendedFields in: query description: An array of names of Secret Template fields to return. Only exposed fields can be returned. This parameter will be ignored if ExtFieldsCombined is sent. required: false explode: true schema: type: array items: type: string - name: filter.extendedTypeId in: query description: If not null, return only secrets matching the specified extended mapping type as defined on the secret’s template. required: false x-nullable: true schema: type: integer format: int32 - name: filter.extFieldsCombined in: query description: A comma delimited list of all extended fields to return. All fields must be marked as exposed for display. When populated this value will be used instead of ExtendedFields[]. Combining the fields decreases the size of the GET URL to avoid the 2048 character length restriction in IIS. required: false schema: type: string - name: filter.folderId in: query description: If not null, returns only secrets within the specified folder. required: false x-nullable: true schema: type: integer format: int32 - name: filter.hasLauncher in: query description: Whether to only return secrets with or without launchers. If null, returns secrets regardless of whether they have launchers. required: false x-nullable: true schema: type: boolean - name: filter.heartbeatStatus in: query description: If not null, returns only secrets with a certain heartbeat status. required: false x-nullable: true schema: type: string - name: filter.includeActive in: query description: Whether to include active secrets in results (when excluded equals true). required: false x-nullable: true schema: type: boolean - name: filter.includeInactive in: query description: Whether to include inactive secrets in results. required: false schema: type: boolean - name: filter.includeRestricted in: query description: Whether to include restricted secrets in results. Restricted secrets are secrets that are DoubleLocked, require approval, or require a comment to view. required: false schema: type: boolean - name: filter.includeSubFolders in: query description: Whether to include secrets in subfolders of the specified folder. required: false schema: type: boolean - name: filter.isExactMatch in: query description: Whether to do an exact match of the search text or a partial match. If an exact match, the entire secret name, field value, or list option in a list field must match the search text. required: false x-nullable: true schema: type: boolean - name: filter.onlyCheckedOutSecrets in: query description: Whether to only return secrets that are or are not checked out. If null, returns secrets regardless of whether they are checked out. required: false x-nullable: true schema: type: boolean - name: filter.onlyRPCEnabled in: query description: Whether to only include secrets whose template has Remote Password Changing enabled. required: false x-nullable: true schema: type: boolean - name: filter.onlySecretsCheckedOutByUser in: query description: Whether to only return secrets that are or are not checked out by the querying user. If null, returns secrets regardless of whether they are checked out. required: false x-nullable: true schema: type: boolean - name: filter.onlySharedWithMe in: query description: When true only Secrets where you are not the owner and the Secret was shared explicitly with your user id will be returned. required: false x-nullable: true schema: type: boolean - name: filter.passwordTypeIds in: query description: If not null, returns only secrets matching the specified password types. required: false explode: true schema: type: array items: type: integer - name: filter.permissionRequired in: query description: Specify whether to filter by List, View, Edit, or Owner permission. Default is List. required: false x-nullable: true schema: type: string - name: filter.scope in: query description: Specify whether to search All, Recent, or Favorites required: false x-nullable: true schema: type: string - name: filter.searchField in: query description: If set, restricts the search to only match secrets where the value of the field specified by name contains the search text. required: false schema: type: string - name: filter.searchFieldSlug in: query description: If set, restricts the search to only match secrets where the value of the field specified by the slug name contains the search text. This will override SearchField. required: false schema: type: string - name: filter.searchText in: query description: The text to match in the secret name, field value, or list field contents. required: false schema: type: string - name: filter.secretIds in: query description: If not null or empty, returns only secrets matching the specified secret ids. required: false explode: true schema: type: array items: type: integer - name: filter.secretTemplateIds in: query description: If not null or empty, returns only secrets matching the specified templates. required: false explode: true schema: type: array items: type: integer - name: filter.secretTemplateIdsCombined in: query description: A comma delimited list of all secret template IDs. When populated this value will be used instead of SecretTemplateIds[]. Combining the fields decreases the size of the GET URL to avoid the 2048 character length restriction in IIS. required: false schema: type: string - name: filter.siteId in: query description: If not null, returns only secrets within a the specified site. required: false x-nullable: true schema: type: integer format: int32 - 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 search result object content: application/json: schema: $ref: '#/components/schemas/PagingOfSecretSummary' '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/secrets/search-total: get: tags: - Secrets summary: Get Secret Search Total description: Gets the total number of secrets matching the secret search filter operationId: SecretsService_SearchTotalV2 parameters: - name: filter.allowDoubleLocks in: query description: Whether to allow DoubleLocks as part of the search. True by default. required: false x-nullable: true schema: type: boolean - name: filter.doNotCalculateTotal in: query description: Whether to return the total number of secrets matching the filters. False by default. If false, the total can be retrieved separately by calling /v1/secrets/search-total with the same arguments used in the search. required: false x-nullable: true schema: type: boolean - name: filter.doubleLockId in: query description: Only include Secrets with this DoubleLock ID assigned in the search results. required: false x-nullable: true schema: type: integer format: int32 - name: filter.extendedFields in: query description: An array of names of Secret Template fields to return. Only exposed fields can be returned. This parameter will be ignored if ExtFieldsCombined is sent. required: false explode: true schema: type: array items: type: string - name: filter.extendedTypeId in: query description: If not null, return only secrets matching the specified extended mapping type as defined on the secret’s template. required: false x-nullable: true schema: type: integer format: int32 - name: filter.extFieldsCombined in: query description: A comma delimited list of all extended fields to return. All fields must be marked as exposed for display. When populated this value will be used instead of ExtendedFields[]. Combining the fields decreases the size of the GET URL to avoid the 2048 character length restriction in IIS. required: false schema: type: string - name: filter.folderId in: query description: If not null, returns only secrets within the specified folder. required: false x-nullable: true schema: type: integer format: int32 - name: filter.hasLauncher in: query description: Whether to only return secrets with or without launchers. If null, returns secrets regardless of whether they have launchers. required: false x-nullable: true schema: type: boolean - name: filter.heartbeatStatus in: query description: If not null, returns only secrets with a certain heartbeat status. required: false x-nullable: true schema: type: string - name: filter.includeActive in: query description: Whether to include active secrets in results (when excluded equals true). required: false x-nullable: true schema: type: boolean - name: filter.includeInactive in: query description: Whether to include inactive secrets in results. required: false schema: type: boolean - name: filter.includeRestricted in: query description: Whether to include restricted secrets in results. Restricted secrets are secrets that are DoubleLocked, require approval, or require a comment to view. required: false schema: type: boolean - name: filter.includeSubFolders in: query description: Whether to include secrets in subfolders of the specified folder. required: false schema: type: boolean - name: filter.isExactMatch in: query description: Whether to do an exact match of the search text or a partial match. If an exact match, the entire secret name, field value, or list option in a list field must match the search text. required: false x-nullable: true schema: type: boolean - name: filter.onlyCheckedOutSecrets in: query description: Whether to only return secrets that are or are not checked out. If null, returns secrets regardless of whether they are checked out. required: false x-nullable: true schema: type: boolean - name: filter.onlyRPCEnabled in: query description: Whether to only include secrets whose template has Remote Password Changing enabled. required: false x-nullable: true schema: type: boolean - name: filter.onlySecretsCheckedOutByUser in: query description: Whether to only return secrets that are or are not checked out by the querying user. If null, returns secrets regardless of whether they are checked out. required: false x-nullable: true schema: type: boolean - name: filter.onlySharedWithMe in: query description: When true only Secrets where you are not the owner and the Secret was shared explicitly with your user id will be returned. required: false x-nullable: true schema: type: boolean - name: filter.passwordTypeIds in: query description: If not null, returns only secrets matching the specified password types. required: false explode: true schema: type: array items: type: integer - name: filter.permissionRequired in: query description: Specify whether to filter by List, View, Edit, or Owner permission. Default is List. required: false x-nullable: true schema: type: string - name: filter.scope in: query description: Specify whether to search All, Recent, or Favorites required: false x-nullable: true schema: type: string - name: filter.searchField in: query description: If set, restricts the search to only match secrets where the value of the field specified by name contains the search text. required: false schema: type: string - name: filter.searchFieldSlug in: query description: If set, restricts the search to only match secrets where the value of the field specified by the slug name contains the search text. This will override SearchField. required: false schema: type: string - name: filter.searchText in: query description: The text to match in the secret name, field value, or list field contents. required: false schema: type: string - name: filter.secretIds in: query description: If not null or empty, returns only secrets matching the specified secret ids. required: false explode: true schema: type: array items: type: integer - name: filter.secretTemplateIds in: query description: If not null or empty, returns only secrets matching the specified templates. required: false explode: true schema: type: array items: type: integer - name: filter.secretTemplateIdsCombined in: query description: A comma delimited list of all secret template IDs. When populated this value will be used instead of SecretTemplateIds[]. Combining the fields decreases the size of the GET URL to avoid the 2048 character length restriction in IIS. required: false schema: type: string - name: filter.siteId in: query description: If not null, returns only secrets within a the specified site. required: false x-nullable: true schema: type: integer format: int32 - 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: Integer number of matching secrets content: application/json: schema: description: Int32 type: integer format: int32 '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/secrets/lookup: get: tags: - Secrets summary: Lookup Secrets with Search description: Search, filter, sort, and page secrets, returning only secret ID and name operationId: SecretsService_SearchSecretLookup parameters: - name: filter.allowDoubleLocks in: query description: Whether to allow DoubleLocks as part of the search. True by default. required: false x-nullable: true schema: type: boolean - name: filter.doNotCalculateTotal in: query description: Whether to return the total number of secrets matching the filters. False by default. If false, the total can be retrieved separately by calling /v1/secrets/search-total with the same arguments used in the search. required: false x-nullable: true schema: type: boolean - name: filter.doubleLockId in: query description: Only include Secrets with this DoubleLock ID assigned in the search results. required: false x-nullable: true schema: type: integer format: int32 - name: filter.extendedFields in: query description: An array of names of Secret Template fields to return. Only exposed fields can be returned. required: false explode: true schema: type: array items: type: string - name: filter.extendedTypeId in: query description: If not null, return only secrets matching the specified extended mapping type as defined on the secret’s template. required: false x-nullable: true schema: type: integer format: int32 - name: filter.folderId in: query description: If not null, returns only secrets within the specified folder. required: false x-nullable: true schema: type: integer format: int32 - name: filter.heartbeatStatus in: query description: If not null, returns only secrets with a certain heartbeat status. required: false x-nullable: true schema: type: string - name: filter.includeActive in: query description: Whether to include active secrets in results (when excluded equals true). required: false x-nullable: true schema: type: boolean - name: filter.includeInactive in: query description: Whether to include inactive secrets in results. required: false schema: type: boolean - name: filter.includeRestricted in: query description: Whether to include restricted secrets in results. Restricted secrets are secrets that are DoubleLocked, require approval, or require a comment to view. required: false schema: type: boolean - name: filter.includeSubFolders in: query description: Whether to include secrets in subfolders of the specified folder. required: false schema: type: boolean - name: filter.isExactMatch in: query description: Whether to do an exact match of the search text or a partial match. If an exact match, the entire secret name, field value, or list option in a list field must match the search text. required: false x-nullable: true schema: type: boolean - name: filter.onlyRPCEnabled in: query description: Whether to only include secrets whose template has Remote Password Changing enabled. required: false x-nullable: true schema: type: boolean - name: filter.onlySecretsCheckedOutByUser in: query description: Whether to only return secrets that are or are not checked out by the querying user. If null, returns secrets regardless of whether they are checked out. required: false x-nullable: true schema: type: boolean - name: filter.onlySharedWithMe in: query description: When true only Secrets where you are not the owner and the Secret was shared explicitly with your user id will be returned. required: false x-nullable: true schema: type: boolean - name: filter.passwordTypeIds in: query description: If not null, returns only secrets matching the specified password types. required: false explode: true schema: type: array items: type: integer - name: filter.permissionRequired in: query description: Specify whether to filter by List, View, Edit, or Owner permission. Default is List. required: false x-nullable: true schema: type: string - name: filter.scope in: query description: Specify whether to search All, Recent, or Favorites required: false x-nullable: true schema: type: string - name: filter.searchField in: query description: If set, restricts the search to only match secrets where the value of the field specified by name contains the search text. required: false schema: type: string - name: filter.searchFieldSlug in: query description: If set, restricts the search to only match secrets where the value of the field specified by the slug name contains the search text. This will override SearchField. required: false schema: type: string - name: filter.searchText in: query description: The text to match in the secret name, field value, or list field contents. required: false schema: type: string - name: filter.secretTemplateId in: query description: If not null, returns only secrets matching the specified template. required: false x-nullable: true schema: type: integer format: int32 - name: filter.siteId in: query description: If not null, returns only secrets within a the specified site. required: false x-nullable: true schema: type: integer format: int32 - 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 search result object content: application/json: schema: $ref: '#/components/schemas/PagingOfSecretLookup' '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/secrets/lookup/{id}: get: tags: - Secrets summary: Lookup Secret description: Look up secret by ID and return secret name and ID operationId: SecretsService_GetLookup parameters: - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret lookup result object content: application/json: schema: $ref: '#/components/schemas/SecretLookup' '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/secrets/stub: get: tags: - Secrets summary: Get Secret Stub description: Return the default values for a new secret operationId: SecretsService_Stub parameters: - name: folderId in: query description: Containing folder ID. May be null unless secrets are required to be in folders. required: false schema: type: integer format: int32 - name: secretTemplateId in: query description: Secret template ID required: true schema: type: integer format: int32 responses: '200': description: Secret object content: application/json: schema: $ref: '#/components/schemas/SecretModel' '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/secrets/{id}: get: tags: - Secrets summary: Get Secret description: Get a single secret by ID operationId: SecretsService_GetSecretV2 parameters: - name: includeInactive in: query description: Whether to include inactive secrets in the results required: false schema: type: boolean - name: noAutoCheckout in: query description: Don't check out the secret if needed required: false schema: type: boolean - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret object content: application/json: schema: $ref: '#/components/schemas/SecretModelV2' '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/secrets/{id}/preview: get: tags: - Secrets summary: Get Secret Preview description: Get a preview of an unrestricted secret by ID. Restricted secrets will return an AccessDeniedException. operationId: SecretsService_GetSecretPreview parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret Preview object content: application/json: schema: $ref: '#/components/schemas/DashboardViewSecret' '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/secrets/{id}/summary: get: tags: - Secrets summary: Get Secret Summary description: Get the summary for a secret operationId: SecretsService_GetSummary parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret summary object content: application/json: schema: $ref: '#/components/schemas/SecretSummary' '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/secrets/{id}/fields/{slug}: get: tags: - Secrets summary: Get Secret Field description: Get a secret data field operationId: SecretsService_GetField parameters: - name: includeInactive in: query description: Whether to include inactive secrets in the results required: false schema: type: boolean - name: noAutoCheckout in: query description: Don't check out the secret if needed required: false schema: type: boolean - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string - name: slug in: path description: Secret field name required: true schema: type: string responses: '200': description: Secret field value. If the field is a file attachment, the content type will be `application/octet-stream` and the response body will be the file contents. content: application/json: schema: description: String type: string application/octet-stream: schema: description: String type: string '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' application/octet-stream: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' application/octet-stream: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' application/octet-stream: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false put: tags: - Secrets summary: Update Secret Field description: Update a secret data field operationId: SecretsService_PutField parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string - name: slug in: path description: Secret field name required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretItemUpdateArgs' multipart/form-data: schema: $ref: '#/components/schemas/SecretItemUpdateArgs' description: Secret options responses: '200': description: The updated value, or 'true' if the field is a file attachment content: application/json: schema: description: String type: string '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/secrets/{id}/fields/{slug}/list: get: tags: - Secrets summary: Get Secret List Field description: Get the items associated to a secret list data field operationId: SecretsService_GetListField parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: slug in: path description: Secret field name required: true schema: type: string responses: '200': description: Combined contents of all lists assigned to the secret field. content: application/json: schema: $ref: '#/components/schemas/CategorizedListItemValueResult' '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/secrets/favorite: get: tags: - Secrets summary: List a User's Favorite Secrets description: Returns a list of secrets which the user has favorited. operationId: SecretsService_GetFavorites responses: '200': description: Identifying information for each secret favorited content: application/json: schema: description: Identifying information for each secret favorited items: $ref: '#/components/schemas/WidgetSecretModel' type: array '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/secrets/{secretId}/transition-history: get: tags: - Secrets summary: Get secret password transition history description: Returns the secret password that will be used next during an actual rotation. operationId: SecretsService_GetSecretTransitionHistory parameters: - 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 - name: secretId in: path description: secretId required: true schema: type: integer format: int32 responses: '200': description: List of transition history passwords content: application/json: schema: $ref: '#/components/schemas/PagingOfSecretTransitionHistorySummaryModel' '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/secrets/{id}/audits: get: tags: - Secrets summary: Get Secret Audits by Filter description: Get audits for a particular Secret for the given filter. operationId: SecretsService_GetSecretAudits 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: filter.includePasswordChangeLog in: query description: Whether or not to include password changes in data 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 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret Audit Model content: application/json: schema: $ref: '#/components/schemas/PagingOfSecretAuditModel' '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/secrets/{id}/state: get: tags: - Secrets summary: Get Secret State description: Retrieve state about a Secret such as whether it requires approval, doublelock, checkout, or other restricted actions to be performed before calling the get the secret. operationId: SecretsService_GetSecretState parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret Detail State View Model content: application/json: schema: $ref: '#/components/schemas/SecretDetailStateViewModel' '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/secrets/secret-detail/{id}/general/{isEditMode?}/{loadReadOnlyFlags?}: get: tags: - Secrets summary: Get Secret Detail General description: Retrieve details about a secret. operationId: SecretsService_GetGeneral parameters: - name: id in: path description: id required: true schema: type: integer format: int32 - name: isEditMode in: query description: isEditMode required: false x-nullable: true schema: type: boolean - name: loadReadOnlyFlags in: query description: loadReadOnlyFlags required: false x-nullable: true schema: type: boolean - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret Detail State View Model content: application/json: schema: $ref: '#/components/schemas/SecretDetailGeneralModel' '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/secrets/{id}/settings: get: tags: - Secrets summary: Get Secret Settings description: Get Secret Settings operationId: SecretsService_GetSecretSettings parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret Settings content: application/json: schema: $ref: '#/components/schemas/SecretDetailSettingsModel' '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/secrets/launcher-sessions: get: tags: - Secrets summary: Get Secret Launcher Sessions By Id description: Get secret launcher sessions operationId: SecretsService_GetActiveSecretSessions parameters: - name: filter.secretId in: query description: The Id of the associated Secret. required: false x-nullable: true schema: type: integer format: int32 - 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 Launcher Sessions content: application/json: schema: $ref: '#/components/schemas/PagingOfSecretLauncherSessionSummary' '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: - Secrets summary: Update Secret Launcher Sessions description: Update or Terminate Secret Launcher Sessions operationId: SecretsService_UpdateSecretSession requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretLauncherSessionArgs' description: args responses: '200': description: Result of the update Secret Launcher Session Request content: application/json: schema: $ref: '#/components/schemas/SecretLauncherSessionActionResult' '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/secrets/{id}/ssh-restricted-commands: get: tags: - Secrets summary: Get SSH Command Restrictions on a Secret description: Gets the SSH command restrictions for a Secret operationId: SecretsService_GetSshRestrictedCommands parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 responses: '200': description: List of restricted commands content: application/json: schema: $ref: '#/components/schemas/SecretDetailRestrictedSshCommandViewModel' '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/secrets/export/job/{jobId}: get: tags: - Secrets summary: Export Secrets Job Status description: Exports secrets Job Status operationId: SecretsService_RetrieveSecretJobStatus parameters: - name: jobId in: path description: jobId required: true schema: type: string format: uuid responses: '200': description: Exported Secrets Job Status content: application/json: schema: $ref: '#/components/schemas/ExportSecretsJobResultModel' '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/secrets/export/{jobId}/details: get: tags: - Secrets summary: Export Secrets Job Details description: Exports Secret Job Details operationId: SecretsService_RetrieveExportSecretsDetails parameters: - name: jobId in: path description: jobId required: true schema: type: string format: uuid responses: '200': description: Exported Secrets Job Details content: application/json: schema: $ref: '#/components/schemas/ExportSecretsExportJobDetails' '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/secrets/export: get: tags: - Secrets summary: Export Bulk Export Secrets description: Exports Secrets from Storage operationId: SecretsService_RetrieveSecretExport parameters: - name: jobId in: query description: jobId required: false schema: type: string format: uuid responses: '200': description: Export Bulk Export Secrets content: application/json: schema: $ref: '#/components/schemas/ExportSecretsResultModelV2' '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/secrets/{id}/general: patch: tags: - Secrets summary: Update Secret General Information description: Update Secret General Information operationId: SecretsService_UpdateGeneral parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateGeneralArgs' responses: '200': description: Secret General Information content: application/json: schema: $ref: '#/components/schemas/SecretDetailGeneralViewModel' '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/secrets/{id}/email: patch: tags: - Secrets summary: Update User Secret Email Settings description: Update User Secret Email Settings operationId: SecretsService_UpdateEmail parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateEmailArgs' responses: '200': description: SecretDetailSettingsViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailSettingsModel' '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/secrets/{id}/security-general: patch: tags: - Secrets summary: Update Secret Security General Options description: Update Secret Security General Options operationId: SecretsService_UpdateSecurity parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateSecurityGeneralArgs' responses: '200': description: SecretDetailSecurityViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailSecurityViewModel' '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/secrets/{id}/general: patch: tags: - Secrets summary: Update Secret General Information description: Update Secret General Information operationId: SecretsService_UpdateGeneralV2 parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateGeneralArgs' responses: '200': description: Secret General Information content: application/json: schema: $ref: '#/components/schemas/SecretDetailGeneralModel' '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/secrets/{id}/email: patch: tags: - Secrets summary: Update User Secret Email Settings description: Update User Secret Email Settings operationId: SecretsService_UpdateEmailV2 parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateEmailArgs' responses: '200': description: SecretDetailSettingsViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailSettingsModel' '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 /v3/secrets/{id}/security-checkout: patch: tags: - Secrets summary: Update Secret Security Checkout Options description: Update Secret Security Checkout Options operationId: SecretsService_UpdateSecurityCheckoutV3 parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateSecurityCheckoutArgs' description: args responses: '200': description: A model with the updated security options if available and a success code content: application/json: schema: $ref: '#/components/schemas/SecretSecurityUpdateResponse' '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/secrets/{id}/security-multifactor-authentication: patch: tags: - Secrets summary: Update Secret Security Multifactor Authentication Options description: Update Secret Security Multifactor Authentication Options operationId: SecretsService_UpdateSecurityMultifactorAuthentication parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateSecurityMultifactorArgs' description: args responses: '200': description: SecretDetailSecurityViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailSecurityModel' '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/secrets/{id}/security-general: patch: tags: - Secrets summary: Update Secret Security General Options description: Update Secret Security General Options operationId: SecretsService_UpdateSecurityV2 parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateSecurityGeneralArgs' responses: '200': description: SecretDetailSecurityViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailSecurityModel' '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/secrets/extended-search-details: post: tags: - Secrets summary: Secret Search Extended Details description: Pass an array of secret IDs, presumably the results of a secret search and get extended details such as has launchers or is favorite. operationId: SecretsService_GetSecretExtendedSearchDetails requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretSearchExtendedArgs' description: args responses: '200': description: Secret search extended details content: application/json: schema: description: Secret search extended details items: $ref: '#/components/schemas/SecretSearchExtendedSummary' type: array '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/secrets/{id}/restricted: post: tags: - Secrets summary: Get Restricted Secret description: Get a restricted secret operationId: SecretsService_GetRestricted parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretRestrictedArgs' responses: '200': description: Secret object content: application/json: schema: $ref: '#/components/schemas/SecretModel' '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/secrets: post: tags: - Secrets summary: Create Secret description: Create a new secret operationId: SecretsService_CreateSecret requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretCreateArgs' description: Secret creation options responses: '200': description: Secret object content: application/json: schema: $ref: '#/components/schemas/SecretModel' '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/secrets/{id}/heartbeat: post: tags: - Secrets summary: Run Secret Heartbeat description: Check if secret is still valid operationId: SecretsService_RunHeartBeat parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret summary object content: application/json: schema: $ref: '#/components/schemas/SecretSummary' '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/secrets/{id}/expire: post: tags: - Secrets summary: Expire Secret description: Expire a secret operationId: SecretsService_Expire parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretRestrictedArgs' responses: '200': description: Secret summary object content: application/json: schema: $ref: '#/components/schemas/SecretSummary' '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/secrets/{id}/change-password: post: tags: - Secrets summary: Change Secret Password description: Change a secret's password operationId: SecretsService_ChangePassword parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretChangePasswordArgs' description: Secret options responses: '200': description: Secret summary object content: application/json: schema: $ref: '#/components/schemas/SecretSummary' '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/secrets/{id}/check-in: post: tags: - Secrets summary: Check In Secret description: Check in a secret. Checking a secret ends exclusive access to the secret and allows other users to check-out and view or edit it. operationId: SecretsService_CheckIn parameters: - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretRestrictedArgs' responses: '200': description: Secret summary object content: application/json: schema: $ref: '#/components/schemas/SecretSummary' '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/secrets/{id}/check-out: post: tags: - Secrets summary: Check Out Secret description: Check Out a secret operationId: SecretsService_CheckOut parameters: - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret Response Code Model object content: application/json: schema: $ref: '#/components/schemas/SecretResponseCodeModel' '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/secrets/{id}/extend-check-out: post: tags: - Secrets summary: Extend Check Out description: Extend remaining check out time. operationId: SecretsService_ExtendCheckOut parameters: - name: id in: path description: id required: true schema: type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretCheckOutExtensionArgs' description: args responses: '200': description: Secret Check Out Extension Response content: application/json: schema: $ref: '#/components/schemas/SecretCheckOutExtensionResponseModel' '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/secrets/{id}/restricted/fields/{slug}: post: tags: - Secrets summary: Get Restricted Secret Field description: Get a restricted secret data field operationId: SecretsService_RestrictedField parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: Secret ID required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string - name: slug in: path description: Secret field name required: true schema: type: string requestBody: $ref: '#/components/requestBodies/SecretRestrictedArgs' responses: '200': description: Secret field value. If the field is a file attachment, the content type will be `application/octet-stream` and the response body will be the file contents. content: application/json: schema: description: String type: string application/octet-stream: schema: description: String type: string '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' application/octet-stream: schema: $ref: '#/components/schemas/BadRequestResponse' '403': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' application/octet-stream: schema: $ref: '#/components/schemas/AuthenticationFailedResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' application/octet-stream: schema: $ref: '#/components/schemas/InternalServerErrorResponse' deprecated: false /v1/secrets/rdpproxy: post: tags: - Secrets summary: Get RDP Proxy Information description: Get RDP Proxy Information operationId: SecretsService_GetSecretRdpProxyInfo parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean requestBody: $ref: '#/components/requestBodies/SecretProxyArgs' responses: '200': description: RDP Proxy Information content: application/json: schema: $ref: '#/components/schemas/SecretRdpProxyModel' '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/secrets/sshproxy: post: tags: - Secrets summary: Get SSH Proxy Information description: Get SSH Proxy Information operationId: SecretsService_GetSecretSshProxyInfo parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean requestBody: $ref: '#/components/requestBodies/SecretProxyArgs' responses: '200': description: SSH Proxy Information content: application/json: schema: $ref: '#/components/schemas/SecretSshProxyModel' '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/secrets/sshterminal: post: tags: - Secrets summary: Get SSH Terminal Details description: Get SSH Terminal Details operationId: SecretsService_GetSecretSshTerminalDetails parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretSshTerminalArgs' description: args responses: '200': description: SSH Terminal Details content: application/json: schema: $ref: '#/components/schemas/SecretSshTerminalModel' '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/secrets/{secretId}/favorite: post: tags: - Secrets summary: Favorite a Secret description: Used to favorite or unfavorite an individual Secret operationId: SecretsService_Favorite parameters: - name: secretId in: path description: The secret to favorite or unfavorite. required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/FavoriteSecretArgs' description: args responses: '200': description: Whether or not the secret is now favorited by the user. content: application/json: schema: description: Boolean type: boolean '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/secrets/{id}/stop-password-change: post: tags: - Secrets summary: Attempt to stop a password change description: Attempt to stop a password change operationId: SecretsService_StopPasswordChange parameters: - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Attempt to stop a password change content: application/json: schema: $ref: '#/components/schemas/SecretDetailStopPasswordResultModel' '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/secrets/convert-template: post: tags: - Secrets summary: Convert Secret Template description: Convert the specificed Secrets to a different Secret Template operationId: SecretsService_ConvertTemplate requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailConvertTemplateArgs' description: args responses: '200': description: Convert template result content: application/json: schema: $ref: '#/components/schemas/SecretDetailConvertTemplateModel' '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/secrets/get-convert-info: post: tags: - Secrets summary: Get Convert Template Information description: Retrieve information about the requested conversion such as which fields exist on the target template. operationId: SecretsService_GetConvertInfo requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailConvertTemplateInfoArgs' description: args responses: '200': description: Convert template info result content: application/json: schema: $ref: '#/components/schemas/ConvertTemplateDetailsModel' '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/secrets/export: post: tags: - Secrets summary: Export Secrets description: Exports secrets operationId: SecretsService_ExportSecrets requestBody: $ref: '#/components/requestBodies/ExportSecretsArgs' responses: '200': description: Exported secrets content: application/json: schema: $ref: '#/components/schemas/SecretsExportResultModel' '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/secrets/export/job: post: tags: - Secrets summary: Export Secrets File Job Creation description: Export Secrets File Job Creation operationId: SecretsService_ExportSecretJob requestBody: $ref: '#/components/requestBodies/ExportSecretsArgs' responses: '200': description: Export Secrets File Job Created content: application/json: schema: $ref: '#/components/schemas/ExportSecretsJobResultModel' '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/secrets/{id}/rpc-script-secrets: put: tags: - Secrets summary: Update which Secrets are available for RPC scripts description: Update which Secrets are available for RPC scripts operationId: SecretsService_UpdateRpcScriptSecrets parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateRpcScriptSecretsArgs' responses: '200': description: SecretDetailRpcViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailRpcModel' '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/secrets/{id}/activate: put: tags: - Secrets summary: Undelete a Secret description: Undelete a Secret operationId: SecretsService_UndeleteSecret parameters: - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret content: application/json: schema: $ref: '#/components/schemas/SecretDetailGeneralModel' '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/secrets/{id}/rpc-script-secrets: put: tags: - Secrets summary: Update which Secrets are available for RPC scripts description: Update which Secrets are available for RPC scripts operationId: SecretsService_UpdateRpcScriptSecretsV2 parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: $ref: '#/components/requestBodies/SecretDetailUpdateRpcScriptSecretsArgs' responses: '200': description: SecretDetailRpcViewModel content: application/json: schema: $ref: '#/components/schemas/SecretDetailRpcModel' '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 /v3/secrets/{id}/security-approval: put: tags: - Secrets summary: Update Secret Security Approval Options description: Update Secret Security Approval Options operationId: SecretsService_UpdateSecurityApprovalV3 parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateSecurityApprovalArgs' description: args responses: '200': description: SecretDetailSecurityViewModel content: application/json: schema: $ref: '#/components/schemas/SecretSecurityUpdateResponse' '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/secrets/{id}/activate: put: tags: - Secrets summary: Undelete a Secret description: Undelete a Secret operationId: SecretsService_UndeleteSecretV2 parameters: - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string responses: '200': description: Secret content: application/json: schema: $ref: '#/components/schemas/SecretDetailGeneralModel' '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/secrets/{id}/expiration: put: tags: - Secrets summary: Update a Secret expiration description: Update a Secret expiration operationId: SecretsService_UpdateExpiration parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: id in: path description: id required: true schema: type: integer format: int32 - name: secretPath in: query description: A full path including folder and secret name can be passed as a query string parameter when the secret ID is set to 0. This will lookup the secret ID by path. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateExpirationArgs' description: args responses: '200': description: Updated secret settings content: application/json: schema: $ref: '#/components/schemas/SecretDetailSettingsModel' '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/secrets/{secretId}/update-ssh-restricted-commands: put: tags: - Secrets summary: Update Restricted SSH Commands on a Secret description: Update the restricted SSH commands configured on a Secret operationId: SecretsService_UpdateSshRestrictedCommands parameters: - name: autoCheckIn in: query description: Automatically check in a secret after finding or updating. required: false schema: type: boolean - name: autoCheckout in: query description: Automatically check out secret before finding or updating. required: false schema: type: boolean - name: autoComment in: query description: Leave a comment when checking in or out. required: false schema: type: string - name: forceCheckIn in: query description: If secret is checked out, then force a check in. required: false schema: type: boolean - name: secretId in: path description: secretId required: true schema: type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailSshRestrictedCommandUpdateArgs' description: args responses: '200': description: Success / Fail content: application/json: schema: description: Boolean type: boolean '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-detail/{secretId}/jumpbox-route-selection: put: tags: - Secrets summary: Update Jumpbox Route Selection description: Update Jumpbox Route Selection operationId: SecretsService_UpdateJumpboxRouteSelection parameters: - name: secretId in: path description: secretId required: true schema: type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/SecretDetailJumpboxUpdateArgs' description: args responses: '200': description: Jumpbox Route View Model content: application/json: schema: $ref: '#/components/schemas/JumpboxRouteSummaryModel' '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: SecretDetailSecurityMultifactorUpdateModel: description: Secret Security Multifactor Authentication Update properties: isMultifactorAuthenticationRequired: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' type: object SecretDetailSettingsModel: description: Secret Detail Settings properties: expirationDate: description: Expiration Date type: string format: date-time nullable: true expirationDayInterval: description: Expiration Day Interval type: integer format: int32 nullable: true expirationTemplateText: description: Expiration Template Text type: string expirationType: $ref: '#/components/schemas/SecretDetailExpirationType' jumpboxRouteSelection: $ref: '#/components/schemas/JumpboxRouteSummaryModel' oneTimePasswordSettings: $ref: '#/components/schemas/OneTimePasswordSettingsModel' rdpLauncherSettings: $ref: '#/components/schemas/RdpLauncherSettingsModel' sendEmailWhenChanged: description: Send Email When Changed type: boolean sendEmailWhenHeartbeatFails: description: Send Email When Heartbeat Fails type: boolean sendEmailWhenViewed: description: Send Email When Viewed type: boolean sshLauncherSettings: $ref: '#/components/schemas/SshLauncherSettingsModel' type: object HeartbeatStatus: description: Current status of heartbeat properties: {} type: string enum: - Failed - Success - Pending - Disabled - UnableToConnect - UnknownError - IncompatibleHost - AccountLockedOut - DnsMismatch - UnableToValidateServerPublicKey - Processing - ArgumentError - AccessDenied - NeedsImmediateRetry SortDirection: description: Sort direction properties: {} type: string enum: - None - Asc - Desc SecretSshProxyModel: description: SecretSshProxyModel properties: host: description: The host for the SSH Proxy type: string password: description: The password for the SSH Proxy type: string port: description: The port for the SSH Proxy type: integer format: int32 username: description: The username for the SSH Proxy type: string type: object ConvertTemplateFieldModel: description: A secret field mapping for conversion properties: destinationFieldId: description: The destination field ID type: integer format: int32 nullable: true sourceFieldId: description: The original source field ID type: integer format: int32 sourceFieldValue: description: A value for the source field type: string type: object SecretResponseCodeModel: description: SecretResponseCodeModel properties: responseCodes: description: ResponseCodes items: type: string type: array type: object UpdateFieldValueOfOptionalDateTime: description: Update when the pinned folder was last viewed properties: dirty: description: Dirty type: boolean value: description: Value type: string format: date-time nullable: true type: object UpdateFieldValueOfInt32Array: description: FolderIds properties: dirty: description: Dirty type: boolean value: description: Value items: type: integer format: int32 type: array type: object SecretDetailPasswordStatus: description: Password Status properties: failedAttempts: description: FailedAttempts type: integer format: int32 failedDependency: description: FailedDependency type: boolean nullable: true lastRpcDate: description: LastRpcDate type: string format: date-time nullable: true nextRpcDate: description: NextRpcDate type: string format: date-time nullable: true rpcMessage: description: RpcMessage type: string status: $ref: '#/components/schemas/PasswordChangeResult' type: object UpdateFieldValueOfOptionalInt32: description: The minimum length required for local user passwords properties: dirty: description: Dirty type: boolean value: description: Value type: integer format: int32 nullable: true type: object SecretDetailRpcScriptSecretsUpdateModel: description: Secrets available for RPC Scripts properties: resetSecretIds: $ref: '#/components/schemas/UpdateFieldValueOfInt32Array' type: object SecretDetailSshCommandUpdateData: description: Secret SSH Command Data properties: allowOwnersUnrestrictedCommands: description: AllowOwnersUnrestrictedCommands type: boolean commandRestrictionType: $ref: '#/components/schemas/CommandRestrictionType' restrictSshCommands: description: RestrictSshCommands type: boolean sshCommandBlocklists: description: SshCommandBlocklists items: $ref: '#/components/schemas/SecretDetailRestrictedSshCommandBlocklistPermissionUpdateModel' type: array sshCommandMenus: description: SshCommandMenus items: $ref: '#/components/schemas/SecretDetailRestrictedSshCommandMenuPermissionUpdateModel' type: array type: object ViewFieldValueOfOptionalDateTime: description: Time of last heartbeat check properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value type: string format: date-time nullable: true type: object SecretDetailRpcModel: description: Secret Detail RPC properties: autoChangeEnabled: description: AutoChange Enabled type: boolean autoChangeSchedule: $ref: '#/components/schemas/SecretDetailScheduleModel' canEnterNextPassword: description: Can Enter Next Password type: boolean expireText: description: Expire Text type: string hasNextPassphrase: description: Has Next Passphrase type: boolean hasNextPassword: description: Has Next Password type: boolean hasNextPrivateKey: description: Has Next Private Key type: boolean isValidForSshKeyRpc: description: is Valid For SSH Key RPC type: boolean passwordStatus: $ref: '#/components/schemas/SecretDetailPasswordStatus' passwordTypeId: description: Password Type Id type: integer format: int32 passwordTypeName: description: Password Type Name type: string passwordTypeWebScriptId: description: Password Type WebScript Id type: integer format: int32 nullable: true privilegedAccountSecretId: description: Priviliged Account Secret Id type: integer format: int32 nullable: true privilegedAccountSecretName: description: Priviliged Account Secret Name type: string resetSecrets: description: Reset Secrets items: $ref: '#/components/schemas/SecretDetailRpcSecrets' type: array type: object ConvertTemplateDetailsModel: description: ConvertTemplateDetailsModel properties: destination: $ref: '#/components/schemas/ConvertTemplateDestinationModel' source: $ref: '#/components/schemas/ConvertTemplateSourceModel' type: object SecretDetailRestrictedSshCommandViewModel: description: SecretDetailRestrictedSshCommandViewModel properties: commandRestrictionType: $ref: '#/components/schemas/CommandRestrictionType' sshCommandBlocklists: description: Blocklists items: $ref: '#/components/schemas/SecretDetailRestrictedSshCommandBlocklistViewModel' type: array sshCommandMenus: description: Allowed menus items: $ref: '#/components/schemas/SecretDetailRestrictedSshCommandMenuViewModel' type: array type: object ViewFieldLink: description: AdditionalLinks properties: isExternal: description: IsExternal type: boolean linkText: description: LinkText type: string url: description: Url type: string type: object DeletedModel: description: Information about an object that was deleted properties: id: description: ID of the deleted object type: integer format: int32 objectType: description: Type of the deleted object type: string responseCodes: description: List of response codes from the delete operation items: type: string type: array type: object SecretRdpProxyModel: description: SecretRdpProxyModel properties: domain: description: The domain for the RDP Proxy type: string host: description: The host and port for the RDP Proxy type: string password: description: The password for the SSH Proxy type: string username: description: The username for the SSH Proxy type: string type: object SecretModel: description: Secret properties: accessRequestWorkflowMapId: description: AccessRequestWorkflowMapId type: integer format: int32 nullable: true active: description: Whether the secret is active type: boolean allowOwnersUnrestrictedSshCommands: description: AllowOwnersUnrestrictedSshCommands type: boolean autoChangeEnabled: description: AutoChangeEnabled type: boolean autoChangeNextPassword: description: AutoChangeNextPassword type: string checkedOut: description: Whether the secret is currently checked out type: boolean checkOutChangePasswordEnabled: description: CheckOutChangePasswordEnabled type: boolean checkOutEnabled: description: Whether secret checkout is enabled type: boolean checkOutIntervalMinutes: description: Checkout interval, in minutes type: integer format: int32 checkOutMinutesRemaining: description: Minutes remaining in current checkout interval type: integer format: int32 checkOutUserDisplayName: description: Name of user who has checked out the secret type: string checkOutUserId: description: ID of user who has checked out the secret type: integer format: int32 doubleLockId: description: DoubleLockId type: integer format: int32 enableInheritPermissions: description: EnableInheritPermissions type: boolean enableInheritSecretPolicy: description: Whether the secret policy is inherited from the containing folder type: boolean failedPasswordChangeAttempts: description: Number of failed password change attempts type: integer format: int32 folderId: description: Containing folder ID type: integer format: int32 id: description: Secret ID type: integer format: int32 isDoubleLock: description: Whether double lock is enabled type: boolean isOutOfSync: description: Out of sync indicates that a Password is setup for autochange and has failed its last password change attempt or has exceeded the maximum RPC attempts type: boolean isRestricted: description: Whether the secret is restricted type: boolean items: description: Secret data fields items: $ref: '#/components/schemas/RestSecretItem' type: array jumpboxRouteId: description: JumpboxRouteId type: string format: uuid nullable: true lastHeartBeatCheck: description: Time of last heartbeat check type: string format: date-time lastHeartBeatStatus: $ref: '#/components/schemas/HeartbeatStatus' lastPasswordChangeAttempt: description: Time of most recent password change attempt type: string format: date-time launcherConnectAsSecretId: description: LauncherConnectAsSecretId type: integer format: int32 nullable: true name: description: Secret name type: string outOfSyncReason: description: Reason message if the secret is out of sync type: string passwordTypeWebScriptId: description: PasswordTypeWebScriptId type: integer format: int32 proxyEnabled: description: ProxyEnabled type: boolean requiresApprovalForAccess: description: RequiresApprovalForAccess type: boolean requiresComment: description: RequiresComment type: boolean responseCodes: description: ResponseCodes items: type: string type: array restrictSshCommands: description: RestrictSshCommands type: boolean secretPolicyId: description: SecretPolicyId type: integer format: int32 secretTemplateId: description: Secret template ID type: integer format: int32 secretTemplateName: description: Name of secret template type: string sessionRecordingEnabled: description: Whether session recording is enabled type: boolean siteId: description: SiteId type: integer format: int32 webLauncherRequiresIncognitoMode: description: WebLauncherRequiresIncognitoMode type: boolean type: object ViewFieldValueReadOnlyOfViewTemplateFieldDropDownOptionArray: description: AvailableDoubleLocks properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value items: $ref: '#/components/schemas/ViewTemplateFieldDropDownOption' type: array type: object ExportSecretsModel: description: Data properties: doubleLockPassword: description: The DoubleLock password of the current user. type: string exportChildFolders: description: Export Child Folders type: boolean nullable: true exportFileType: $ref: '#/components/schemas/ExportFileType' exportFolderPath: description: Export Folder Path type: boolean nullable: true exportTotp: description: Export Totp Settings type: boolean nullable: true folderId: description: The folder Id of the specific folder being exported. type: integer format: int32 nullable: true notes: description: Notes type: string password: description: The password of the current user. type: string requireMultifactorAuthenticationToExport: description: Is authentication type MFA? type: boolean nullable: true type: object ViewFieldValueOfBoolean: description: When enabled, the log will be able to be viewed online properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value type: boolean type: object SecretDetailGeneralModel: description: Secret Detail General properties: active: description: Whether the secret is active type: boolean autoChangePassword: description: Whether the password should automatically change upon expiration. type: boolean canGenerateSshKey: description: Can Generate SSH Key type: boolean enableInheritSecretPolicy: description: Whether the secret policy is inherited from the containing folder type: boolean expiration: description: Expiration type: string fields: description: Secret Fields items: type: string type: array folder: description: Containing folder ID type: integer format: int32 nullable: true heartbeatEnabled: description: Heartbeat Enabled type: boolean id: description: Secret Detail General Id type: integer format: int32 isFavorite: description: Is Favorite type: boolean isOutOfSync: description: Whether the secret is out of sync type: boolean isTotpEnabled: description: Is One Time Password Enabled type: boolean lastHeartBeatCheck: description: Time of last heartbeat check type: string format: date-time nullable: true lastHeartBeatStatus: $ref: '#/components/schemas/SecretDetailHeartbeatStatus' launchers: description: Launchers items: $ref: '#/components/schemas/SecretDetailLauncher' type: array name: description: Secret Detail General Name type: string outOfSyncReason: description: Reason message if the secret is out of sync type: string passwordCompliance: $ref: '#/components/schemas/SecretPasswordComplianceCode' secretPolicy: description: Secret Policy type: integer format: int32 nullable: true site: description: Site type: integer format: int32 nullable: true slugPrivateKey: description: Private Key Field Slug type: string slugPublicKey: description: Public Key Field Slug type: string template: description: Secret template type: integer format: int32 nullable: true totpPasswordSlug: description: One Time Password Field Slug type: string type: object SecretDetailStateActionsModel: description: Available Secret Detail State Actions properties: extendCheckOut: description: The user may extend the remaining check out time of the secret. type: boolean type: object SecretDetailSshRestrictedCommandUpdateArgs: description: Update Secret SSH Command Arguments properties: data: $ref: '#/components/schemas/SecretDetailSshCommandUpdateData' type: object UpdateFieldValueOfOptionalSecretDetailApprovalType: description: Approval Type properties: dirty: description: Dirty type: boolean value: description: Value type: string nullable: true type: object SecretRestrictedArgs: description: Restricted secret update options properties: comment: description: If the secret requires a comment to view or requires approval to view, a reason for accessing the secret must be provided. type: string doubleLockPassword: description: If the secret is DoubleLocked, this is the DoubleLock password needed to access the secret. type: string forceCheckIn: description: Force the secret to be checked in, even if checked out by someone else. The user must have the "Force Check In" permission. type: boolean includeInactive: description: If the secret is deactivated, this must be set to true in order to access the secret. The user must also have the "View Inactive Secrets" permission. type: boolean newPassword: description: New secret password. type: string noAutoCheckout: description: Don't check out the secret automatically. type: boolean ticketNumber: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the ticket number to the help desk request. type: string ticketSystemId: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the id of the help desk system configured in Secret Server that should be used to validate the ticket number. type: integer format: int32 nullable: true type: object SecretDetailRestrictedSshCommandMenuViewModel: description: Allowed menus properties: displayName: description: DisplayName type: string groupId: description: GroupId type: integer format: int32 sshCommandMenuId: description: SshCommandMenuId type: integer format: int32 nullable: true sshCommandMenuName: description: SshCommandMenuName type: string type: object SecretDetailConvertTemplateArgs: description: Wrapper around secret template conversion arguments properties: data: $ref: '#/components/schemas/ConvertTemplateActionModel' type: object FavoriteSecretArgs: description: Arguments to favorite a secret. properties: isFavorite: description: Whether or not the secret is a favorite. This is an optional argument. type: boolean nullable: true type: object CommandRestrictionType: description: Command restriction type (AllowedMenu, Blocklist) properties: {} type: string enum: - AllowedMenu - BlockedList SecretDetailJumpboxUpdateArgs: description: SecretDetailJumpboxUpdateArgs properties: jumpboxRouteId: description: JumpboxRouteId type: string format: uuid nullable: true type: object PagingOfSecretTransitionHistorySummaryModel: 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/SecretTransitionHistorySummaryModel' 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 SshKeyArgs: description: SSH key options properties: generatePassphrase: description: Whether to generate an SSH private key passphrase. Only applicable when the Secret template has a password changer with the Private Key Passphrase field mapped. If it is not mapped, this setting is ignored. type: boolean generateSshKeys: description: Whether to generate an SSH private key type: boolean type: object 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 SecretSearchExtendedSummary: description: SecretSearchExtendedSummary[] properties: hasLaunchers: description: Does this Secret have launchers the current user can use type: boolean isFavorite: description: Is this a favorite secret for the current user type: boolean lastAccessed: description: Does this Secret have launchers the current user can use type: string format: date-time nullable: true secretId: description: Secret ID type: integer format: int32 secretName: description: Secret Name type: string totalSecretViews: description: Does this Secret have launchers the current user can use type: integer format: int32 type: object UpdateFieldValueOfBoolean: description: Active properties: dirty: description: Dirty type: boolean value: description: Value type: boolean type: object SshRunLauncherType: description: Launcher Type properties: {} type: string enum: - ConnectAsSecret - ConnectAsDifferentSecret - UseSshKeyOnSecret SecretDetailRestrictedSshCommandBlocklistViewModel: description: Blocklists properties: displayName: description: DisplayName type: string rolePermissionId: description: RolePermissionId type: integer format: int32 sshCommandBlocklistId: description: SshCommandBlocklistId type: string format: uuid nullable: true sshCommandBlocklistName: description: SshCommandBlocklistName type: string type: object SecretLauncherSessionSummary: description: Secret Launcher Session Summary properties: active: description: Is the session currently Active? type: boolean endDate: description: The date the session ended type: string format: date-time nullable: true launcherTypeId: description: The type code for the launcher for the session type: integer format: int32 nullable: true secretId: description: The Id of the Secret type: integer format: int32 secretSessionId: description: The Id of the Secret Session type: integer format: int32 nullable: true startDate: description: The date the session started type: string format: date-time userName: description: The display user name of the person in the Secret Session type: string type: object SecretPasswordComplianceCode: description: Indicates if the password meets the password compliance rules setup for the secret template. properties: {} type: string enum: - Pending - Pass - Fail ConvertTemplateSourceModel: description: Source properties: fields: description: Fields items: $ref: '#/components/schemas/ConvertTemplateDetailFieldModel' type: array templateId: description: TemplateId type: integer format: int32 templateName: description: TemplateName type: string type: object SiteModel: description: Site Model properties: active: description: Active flag type: boolean siteId: description: Site Id type: integer format: int32 siteName: description: Site Name type: string type: object ViewFieldValueOfString: description: GeneratedToken properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value type: string type: object PagingOfSecretSummary: 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/SecretSummary' 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 SecretSecurityUpdateResponse: description: Response to indicate if the Secret security settings saved properly. If you still have access to the model the updated model will be returned. If checkout is now enabled then model will be null. properties: model: $ref: '#/components/schemas/SecretDetailSecurityModel' success: description: Returns as true if the update was successful. Note that any failures should throw an error type: boolean type: object SecretLauncherSessionActionResult: description: Secret Launcher Session Action Result properties: success: description: Was the operation a Success? type: boolean 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 SecretItemUpdateArgs: description: Secret field update options properties: comment: description: If the secret requires a comment to view or requires approval to view, a reason for accessing the secret must be provided. type: string doubleLockPassword: description: If the secret is DoubleLocked, this is the DoubleLock password needed to access the secret. type: string file: description: 'Uploaded file (used for file attachment fields with "Content-Type: multipart/form-data")' type: string format: binary fileAttachment: description: 'Binary file data (used for file attachment fields with "Content-Type: application/json")' type: string format: binary fileName: description: 'File name (used for file attachment fields with "Content-Type: application/json"))' type: string forceCheckIn: description: Force the secret to be checked in, even if checked out by someone else. The user must have the "Force Check In" permission. type: boolean includeInactive: description: If the secret is deactivated, this must be set to true in order to access the secret. The user must also have the "View Inactive Secrets" permission. type: boolean newPassword: description: New secret password. type: string noAutoCheckout: description: Don't check out the secret automatically. type: boolean ticketNumber: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the ticket number to the help desk request. type: string ticketSystemId: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the id of the help desk system configured in Secret Server that should be used to validate the ticket number. type: integer format: int32 nullable: true value: description: New value to assign to the secret field. type: string type: object SecretDetailSecurityGeneralUpdateModel: description: Secret General Information Update properties: doubleLockId: $ref: '#/components/schemas/UpdateFieldValueOfInt32' enableDoubleLock: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' hideLauncherPassword: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' proxyEnabled: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' requiresComment: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' sessionRecordingEnabled: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' webLauncherRequiresIncognitoMode: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' type: object SecretDetailGeneralViewModel: description: Secret Detail General View Model properties: active: $ref: '#/components/schemas/ViewFieldValueOfBoolean' autoChangePassword: $ref: '#/components/schemas/ViewFieldValueOfBoolean' canGenerateSshKey: description: CanGenerateSshKey type: boolean enableInheritSecretPolicy: $ref: '#/components/schemas/ViewFieldValueOfBoolean' expiration: $ref: '#/components/schemas/ViewFieldValueOfString' fields: description: Fields items: $ref: '#/components/schemas/ViewTemplateFieldOfString' type: array folder: $ref: '#/components/schemas/ViewFieldValueOfOptionalInt32' heartbeatEnabled: $ref: '#/components/schemas/ViewFieldValueOfBoolean' id: description: Id type: integer format: int32 isFavorite: description: IsFavorite type: boolean isOutOfSync: $ref: '#/components/schemas/ViewFieldValueOfBoolean' isTotpEnabled: description: IsTotpEnabled type: boolean lastHeartBeatCheck: $ref: '#/components/schemas/ViewFieldValueOfOptionalDateTime' lastHeartBeatStatus: $ref: '#/components/schemas/ViewFieldValueOfSecretDetailHeartbeatStatus' launchers: description: Launchers items: $ref: '#/components/schemas/SecretDetailLauncher' type: array name: $ref: '#/components/schemas/ViewFieldValueOfString' outOfSyncReason: $ref: '#/components/schemas/ViewFieldValueOfString' passwordCompliance: $ref: '#/components/schemas/SecretPasswordComplianceCode' secretPolicy: $ref: '#/components/schemas/ViewFieldValueOfOptionalInt32' site: $ref: '#/components/schemas/ViewFieldValueOfOptionalInt32' slugPrivateKey: description: SlugPrivateKey type: string slugPublicKey: description: SlugPublicKey type: string template: $ref: '#/components/schemas/ViewFieldValueOfOptionalInt32' totpPasswordSlug: description: TotpPasswordSlug type: string type: object ExportSecretsArgs: description: ExportSecretsArgs properties: data: $ref: '#/components/schemas/ExportSecretsModel' type: object SecretFieldType: description: Type properties: {} type: string enum: - Text - Notes - Url - Password - File - DropDown - List SecretLauncherSessionArgs: description: Secret Launcher Session Args properties: action: $ref: '#/components/schemas/SessionActions' message: description: Message To Send type: string secretId: description: Secret Associated To Session type: integer format: int32 secretSessionId: description: Secret Session Id, either the ID, Session Key, or Session GUID must be supplied type: integer format: int32 nullable: true secretSessionKey: description: Secret Session Key, either the ID, Session Key, or Session GUID must be supplied type: string sessionGuid: description: Secret Session Guid, this can be either the secret sessino key or launcher GUID, the ID, Session Key, or Session GUID must be supplied type: string type: object DashboardViewSecretItem: description: items properties: fileAttachmentId: description: fileAttachmentId type: integer format: int32 fileName: description: fileName type: string isAllowedToViewPassword: description: isAllowedToViewPassword type: boolean isFile: description: isFile type: boolean isNotes: description: isNotes type: boolean isPassword: description: isPassword type: boolean isUrl: description: isUrl type: boolean label: description: label type: string neverShowPassword: description: neverShowPassword type: boolean passwordIsMaskedByDefault: description: passwordIsMaskedByDefault type: boolean secretFieldId: description: secretFieldId type: integer format: int32 secretItemId: description: secretItemId type: integer format: int32 slug: description: slug type: string value: description: value type: string type: object ConvertTemplateDetailFieldModel: description: Fields properties: id: description: Id type: integer format: int32 name: description: Name type: string type: $ref: '#/components/schemas/SecretFieldType' type: object ViewFieldValueOfCommandRestrictionType: description: CommandRestrictionType properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: $ref: '#/components/schemas/CommandRestrictionType' type: object SecretListFieldListArgs: description: Secret List Field List Args properties: listGuids: description: Array of List GUIDs items: type: string format: uuid type: array type: object ExportSecretsJobResultModel: description: ExportSecretsJobResultModel properties: exportJobId: description: Unique Guid identifier for the job type: string format: uuid fileType: $ref: '#/components/schemas/ExportFileType' status: $ref: '#/components/schemas/ExportSecretJobStatus' tracking: description: Tracking URL for the Job type: string type: object ExportSecretsExportJobDetails: description: ExportSecretsExportJobDetails properties: errors: description: Secret Export Errors items: $ref: '#/components/schemas/SecretExportErrorModel' type: array exportJobId: description: Unique Guid identifier for the job type: string format: uuid secretsCount: description: Count of Exported Secrets type: integer format: int32 type: object AuthenticationFailedResponse: description: Response object for authentication failures required: - message properties: message: description: Error message type: string type: object SecretDetailGeneralUpdateModel: description: Secret General Settings Update properties: active: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' enableInheritSecretPolicy: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' folder: $ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32' generateSshKeys: description: When true autogenerate new SSH keys type: boolean nullable: true heartbeatEnabled: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' isOutOfSync: $ref: '#/components/schemas/UpdateFieldValueOfOptionalBoolean' name: $ref: '#/components/schemas/UpdateFieldValueOfString' secretFields: description: Secret Fields items: $ref: '#/components/schemas/UpdateTemplateFieldOfString' type: array secretPolicy: $ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32' site: $ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32' template: $ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32' type: object SecretDetailUpdateSecurityCheckoutArgs: description: Secret Security Checkout Message properties: data: $ref: '#/components/schemas/SecretDetailSecurityCheckoutUpdateModel' type: object SecretDetailActionType: description: Secret Detail Action Type properties: {} type: string enum: - ChangePasswordNow - ConvertTemplate - Copy - Delete - Edit - EditExpiration - EditRpc - EditSecurity - Expire - Heartbeat - EditShare - ShowSshProxyCredentials - StopChangePasswordNow - ViewAudit - ViewDependencies - ViewLaunchers - ViewExpiration - ViewHooks - ViewRpc - ViewSecurity - ViewSettings - Undelete - ForceCheckin - ViewShare - EditHooks - EditDependencies - ViewGeneralDetails - ViewHeartbeatStatus - Checkin - Checkout - GenerateOneTimePassword - ShowSshTerminalDetails - ShowRdpProxyCredentials - ViewMetadata - ViewSecretExposure - ViewCheckOut - ViewApproval - ViewListFields - Erase - ViewMfa ViewFieldValueOfWorkflowTemplate: description: ApprovalWorkflow properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: $ref: '#/components/schemas/WorkflowTemplate' type: object ViewFieldValueOfWorkflowTemplateArray: description: ApprovalWorkflowOptions properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value items: $ref: '#/components/schemas/WorkflowTemplate' type: array type: object SecretDetailUpdateGeneralArgs: description: Secret General Settings Update Message properties: data: $ref: '#/components/schemas/SecretDetailGeneralUpdateModel' type: object SecretDetailUpdateSecurityApprovalArgs: description: Secret Update Security Approval Message properties: data: $ref: '#/components/schemas/SecretDetailSecurityApprovalUpdateModel' type: object WorkflowType: description: WorkflowType properties: {} type: string enum: - AccessRequest - SecretEraseRequest PagingOfCategorizedListSummary: 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/CategorizedListSummary' 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 UpdateFieldValueOfString: description: Description properties: dirty: description: Dirty type: boolean value: description: Value type: string type: object ViewFieldValueOfSecretDetailApprovalType: description: RequireApprovalType properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: $ref: '#/components/schemas/SecretDetailApprovalType' type: object SecretCheckOutExtensionResponseModel: description: SecretCheckOutExtensionResponseModel properties: checkOutEndTime: description: CheckOutEndTime type: string format: date-time type: object SecretAuditModel: description: Secret Audit Model properties: action: description: Action of Audit type: string actionForDisplay: description: Action For Display type: string application: description: Application type: string byUserDisplayName: description: User that performed action type: string databaseName: description: Database Name type: string dateRecorded: description: Date Audit was Recorded type: string format: date-time hasProxySessionData: description: Has Proxy Session Data type: boolean nullable: true id: description: Id of Audit type: integer format: int32 notes: description: Notes of Audit type: string recordingMessage: description: Recording Message type: string recordingSessionId: description: Recording Session Id type: string recordingStatus: description: Status of Recording type: integer format: int32 status: description: Status type: string ticketNumber: description: Ticket Number of Audit type: string username: description: Username type: string type: object JumpboxRouteSummaryModel: description: Query results properties: active: description: Active type: boolean description: description: Description type: string jumpboxRouteId: description: JumpboxRouteId type: string format: uuid nullable: true name: description: Name type: string type: object Severity: description: Error severity level properties: {} type: string enum: - None - Retry - Warn - Critical - Fatal SecretCreateArgs: description: Secret create options required: - name - secretTemplateId - items properties: autoChangeEnabled: description: Whether the secret’s password is automatically rotated on a schedule. type: boolean changePasswordNow: description: Whether the Secret should be immediately queued for Remote Password Change upon successful import. type: boolean checkOutChangePasswordEnabled: description: Whether the secret’s password is automatically changed when a secret is checked in. This is a security feature that prevents a use of the password retrieved from check-out after the secret is checked in. type: boolean checkOutEnabled: description: Whether the user must check-out the secret to view it. Checking out gives the user exclusive access to the secret for a specified period or until the secret is checked in. type: boolean checkOutIntervalMinutes: description: The number of minutes that a secret will remain checked out. type: integer format: int32 nullable: true delayIndexing: description: Whether the search indexing should be delayed to the background process. This can speed up bulk secret creation scripts by offloading the task of indexing the new secrets to the background task at the trade-off of not having search indexes immediately available. type: boolean nullable: true enableInheritPermissions: description: Whether the secret inherits permissions from the containing folder. type: boolean nullable: true enableInheritSecretPolicy: description: Whether the secret policy is inherited from the containing folder. type: boolean folderId: description: If the secret is contained in a folder, the id of the containing folder. Set to null or -1 for secrets that are in the root folder. type: integer format: int32 nullable: true items: description: An array of values for the secret fields defined in the secret template. items: $ref: '#/components/schemas/RestSecretItem' type: array launcherConnectAsSecretId: description: When an SSH secret is proxied, you can choose to connect as another user and then do an su to the current secret’s user. This is a common practice for connecting with a lower privileged account and then switching to the root user. type: integer format: int32 nullable: true name: description: The name to display for the secret. type: string passwordTypeWebScriptId: description: The id of the password change script to use on applicable web password secrets. type: integer format: int32 nullable: true proxyEnabled: description: Whether sessions launched on this secret use Secret Server’s proxying or connect directly. type: boolean requiresComment: description: Whether the user must enter a comment to view the secret. type: boolean secretPolicyId: description: The id of the secret policy that controls the security and other settings of the secret. Set to null to not assign a secret policy. type: integer format: int32 nullable: true secretTemplateId: description: The id of the secret template that defines the fields and properties of the secret. type: integer format: int32 minimum: 1 sessionRecordingEnabled: description: Whether session recording is enabled. type: boolean siteId: description: The id of the distributed engine site that is used by this secret for operations such as password changing. type: integer format: int32 minimum: 1 sshKeyArgs: $ref: '#/components/schemas/SshKeyArgs' webLauncherRequiresIncognitoMode: description: Whether the web launcher will require the browser to run in incognito mode. type: boolean type: object SecretDetailStateViewModel: description: Secret Detail State View Model properties: actions: description: Allowed action for current user items: $ref: '#/components/schemas/SecretDetailActionType' type: array approvalEnd: description: Date when the current approval expires, or null if there is no open approval type: string format: date-time nullable: true availableActions: $ref: '#/components/schemas/SecretDetailStateActionsModel' checkedOutUserDisplayName: description: Display Name of User that has the secret checked out type: string checkedOutUserId: description: User Secret is checked out to type: integer format: int32 nullable: true checkOutIntervalMinutes: description: 'Number of minutes before checkout ' type: integer format: int32 nullable: true checkOutMinutesRemaining: description: Minutes remaining in check out type: integer format: int32 nullable: true folderId: description: Folder Id type: integer format: int32 nullable: true folderName: description: Folder Name type: string id: description: Secret Id type: integer format: int32 nullable: true inheritPermissions: description: Is this secret inheriting permissions from its folder type: boolean isActive: description: Active indicator type: boolean nullable: true isCheckedOut: description: Is the Secret checked out type: boolean nullable: true isCheckedOutByCurrentUser: description: Indicates whether the Secret is checked out by the current user type: boolean nullable: true passwordChangeFailed: description: The last password change failed when true type: boolean nullable: true passwordChangePending: description: Pending Password change on secret indicator type: boolean nullable: true remainingTimeWarningMinuteMarker: description: Minute mark to show check out warning type: integer format: int32 nullable: true role: description: Role that current user has on Secret type: string nullable: true secretName: description: Secret Name type: string secretState: $ref: '#/components/schemas/SecretAccessRequired' warningMinutesRemaining: description: Minutes remaining before showing check in warning type: integer format: int32 nullable: true type: object PagingOfSecretLauncherSessionSummary: 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/SecretLauncherSessionSummary' 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 ConvertTemplateDestinationModel: description: Destination properties: fields: description: Fields items: $ref: '#/components/schemas/ConvertTemplateDetailFieldModel' type: array type: object SecretUpdateArgs: description: Secret update options required: - id - name - items properties: accessRequestWorkflowMapId: description: The id of the mapping entity that associates this secret to a specific access request workflow. type: integer format: int32 nullable: true active: description: Whether the secret is in an active or deleted state. type: boolean autoChangeEnabled: description: Whether the secret’s password is automatically rotated on a schedule. type: boolean autoChangeNextPassword: description: Whether the secret should be flagged for immediate password change. type: string checkOutChangePasswordEnabled: description: Whether the secret’s password is automatically changed when a secret is checked in. This is a security feature that prevents a use of the password retrieved from check-out after the secret is checked in. type: boolean checkOutEnabled: description: Whether the user must check-out the secret to view it. Checking out gives the user exclusive access to the secret for a specified period or until the secret is checked in. type: boolean checkOutIntervalMinutes: description: The number of minutes that a secret will remain checked out. type: integer format: int32 nullable: true comment: description: If the secret requires a comment to view or requires approval to view, a reason for accessing the secret must be provided. type: string doubleLockPassword: description: If the secret is DoubleLocked, this is the DoubleLock password needed to access the secret. type: string enableInheritPermissions: description: Whether the secret inherits permissions from the containing folder. type: boolean nullable: true enableInheritSecretPolicy: description: Whether the secret policy is inherited from the containing folder. type: boolean folderId: description: If the secret is contained in a folder, the id of the containing folder. Set to null or -1 for secrets that are in the root folder. type: integer format: int32 nullable: true forceCheckIn: description: Force the secret to be checked in, even if checked out by someone else. The user must have the "Force Check In" permission. type: boolean id: description: The id of the Secret to update. Must match the {id} in the path. type: integer format: int32 minimum: 1 includeInactive: description: If the secret is deactivated, this must be set to true in order to access the secret. The user must also have the "View Inactive Secrets" permission. type: boolean items: description: A list of secret item field values. items: $ref: '#/components/schemas/RestSecretItem' type: array launcherConnectAsSecretId: description: When an SSH secret is proxied, you can choose to connect as another user and then do an su to the current secret’s user. This is a common practice for connecting with a lower privileged account and then switching to the root user. type: integer format: int32 nullable: true name: description: The name to display for the secret. type: string newPassword: description: New secret password. type: string noAutoCheckout: description: Don't check out the secret automatically. type: boolean passwordTypeWebScriptId: description: The id of the password change script to use on applicable web password secrets. type: integer format: int32 nullable: true proxyEnabled: description: Whether sessions launched on this secret use Secret Server’s proxying or connect directly. type: boolean requiresComment: description: Whether the user must enter a comment to view the secret. type: boolean secretPolicyId: description: The id of the secret policy that controls the security and other settings of the secret. Set to null to not assign a secret policy. type: integer format: int32 nullable: true sessionRecordingEnabled: description: Whether session recording is enabled. type: boolean siteId: description: The id of the distributed engine site that is used by this secret for operations such as password changing. type: integer format: int32 minimum: 1 sshKeyArgs: $ref: '#/components/schemas/SshKeyArgs' ticketNumber: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the ticket number to the help desk request. type: string ticketSystemId: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the id of the help desk system configured in Secret Server that should be used to validate the ticket number. type: integer format: int32 nullable: true webLauncherRequiresIncognitoMode: description: Whether the web launcher will require the browser to run in incognito mode. type: boolean nullable: true type: object UpdateFieldValueOfInt32: description: How many days until the password expires. properties: dirty: description: Dirty type: boolean value: description: Value type: integer format: int32 type: object SecretDetailSecurityViewModel: description: SecretDetailSecurityViewModel properties: allowOwnersUnrestrictedSshCommands: $ref: '#/components/schemas/ViewFieldValueOfBoolean' approvalWorkflow: $ref: '#/components/schemas/ViewFieldValueOfWorkflowTemplate' approvalWorkflowOptions: $ref: '#/components/schemas/ViewFieldValueOfWorkflowTemplateArray' approvers: $ref: '#/components/schemas/ViewFieldValueOfSecretDetailUserViewModelArray' availableDoubleLocks: $ref: '#/components/schemas/ViewFieldValueReadOnlyOfViewTemplateFieldDropDownOptionArray' availableRequireApprovalTypes: $ref: '#/components/schemas/ViewFieldValueOfSecretDetailApprovalTypeArray' checkOutChangePasswordEnabled: $ref: '#/components/schemas/ViewFieldValueOfBoolean' checkOutDefaultIntervalDisplay: $ref: '#/components/schemas/ViewFieldValueReadOnlyOfString' checkOutEnabled: $ref: '#/components/schemas/ViewFieldValueOfBoolean' checkOutIntervalDisplay: $ref: '#/components/schemas/ViewFieldValueReadOnlyOfString' checkOutIntervalMinutes: $ref: '#/components/schemas/ViewFieldValueOfOptionalInt32' commandRestrictionType: $ref: '#/components/schemas/ViewFieldValueOfCommandRestrictionType' doubleLockId: $ref: '#/components/schemas/ViewFieldValueOfInt32' doubleLockName: $ref: '#/components/schemas/ViewFieldValueReadOnlyOfString' hideLauncherPassword: $ref: '#/components/schemas/ViewFieldValueOfBoolean' isDoubleLock: $ref: '#/components/schemas/ViewFieldValueOfBoolean' isMultiFactorAuthenticationRequired: $ref: '#/components/schemas/ViewFieldValueOfBoolean' passwordRequirements: $ref: '#/components/schemas/SecretDetailSecurityPasswordRequirements' proxyEnabled: $ref: '#/components/schemas/ViewFieldValueOfBoolean' requireApprovalType: $ref: '#/components/schemas/ViewFieldValueOfSecretDetailApprovalType' requiresComment: $ref: '#/components/schemas/ViewFieldValueOfBoolean' restrictedSshCommandCount: description: RestrictedSshCommandCount type: integer format: int32 restrictSshCommands: $ref: '#/components/schemas/ViewFieldValueOfBoolean' sessionRecordingEnabled: $ref: '#/components/schemas/ViewFieldValueOfBoolean' shouldDisplayMultifactorAuthenticationDisasterRecoveryWarning: description: Whether additional messaging about the interaction between multifactor authentication and Disaster Recovery should be displayed type: boolean webLauncherRequiresIncognitoMode: $ref: '#/components/schemas/ViewFieldValueOfBoolean' type: object SecretDetailStopPasswordResultModel: description: SecretDetailStopPasswordResultModel properties: success: description: Success type: boolean type: object SecretSshTerminalModel: description: SecretSshTerminalModel properties: host: description: The host for the SSH Proxy type: string port: description: The port for the SSH Proxy type: integer format: int32 secretId: description: The secret id to launch type: integer format: int32 username: description: The username for the SSH Proxy type: string type: object SshLauncherSettingsModel: description: SSH Launcher Settings properties: canConnectAsCredentials: description: Can Connect As Credentials type: boolean launcherType: $ref: '#/components/schemas/SshRunLauncherType' secretId: description: Secret Id type: integer format: int32 nullable: true secretName: description: Secret Name type: string sshKeyExtendedTypeId: description: SSH Key Extended Type Id type: integer format: int32 type: object OneTimePasswordSettingsModel: description: One Time Password Settings properties: backupCodes: description: Backup Codes type: string dateChanged: description: Date Changed type: string format: date-time enabled: description: Enabled type: boolean enabledOnTemplate: description: Enabled On Template type: boolean key: description: Key type: string type: object SecretDetailExpirationType: description: Expiration Type properties: {} type: string enum: - Template - DayInterval - SpecificDate - Disabled SecretDetailUpdateRpcScriptSecretsArgs: description: RPC Script Update Message properties: data: $ref: '#/components/schemas/SecretDetailRpcScriptSecretsUpdateModel' type: object DashboardViewLauncherInfo: description: launchers properties: defaultSiteId: description: defaultSiteId type: integer format: int32 hasProxyCredentials: description: hasProxyCredentials type: boolean launcherClientClick: description: launcherClientClick type: string launcherDisplayName: description: launcherDisplayName type: string launcherImage: description: launcherImage type: string launcherPromptName: description: launcherPromptName type: string launcherTooltip: description: launcherTooltip type: string launcherTypeId: description: launcherTypeId type: integer format: int32 restrictedHosts: description: restrictedHosts items: type: string type: array restrictHost: description: restrictHost type: boolean restrictHostType: description: restrictHostType type: integer format: int32 showLauncher: description: showLauncher type: boolean sitePrompt: description: sitePrompt type: string siteSelection: description: siteSelection items: $ref: '#/components/schemas/SiteModel' type: array useProtocolHandler: description: useProtocolHandler type: boolean type: object ViewTemplateFieldOfString: description: Fields properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string dropDownOptions: description: DropDownOptions items: $ref: '#/components/schemas/ViewTemplateFieldDropDownOption' type: array fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string listType: $ref: '#/components/schemas/SecretFieldListType' maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string passwordRequirementId: description: PasswordRequirementId type: integer format: int32 nullable: true placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string slug: description: Slug type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true type: $ref: '#/components/schemas/SecretFieldType' value: description: Value type: string type: object ConvertTemplateInfoModel: description: Define which secrets are being converted to what template type properties: destinationTemplateId: description: What secret template are you converting to type: integer format: int32 secretIds: description: Which secret IDs are being converted items: type: integer format: int32 type: array type: object SecretDetailLauncher: description: Launchers properties: hasProxyCredentials: description: HasProxyCredentials type: boolean imagePath: description: ImagePath type: string isRecorded: description: IsRecorded type: boolean name: description: Name type: string showLauncher: description: ShowLauncher type: boolean typeId: description: TypeId type: integer format: int32 type: object SecretDetailExpirationUpdateModel: description: Data properties: expirationDate: $ref: '#/components/schemas/UpdateFieldValueOfOptionalDateTime' expirationDayInterval: $ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32' expirationType: $ref: '#/components/schemas/UpdateFieldValueOfSecretDetailExpirationUpdateType' type: object SecretModelV2: description: Secret V2 properties: accessRequestWorkflowMapId: description: Access Request Workflow Map Id type: integer format: int32 nullable: true active: description: Whether the secret is active type: boolean allowOwnersUnrestrictedSshCommands: description: Allow Owners Unrestricted SSH Commands type: boolean autoChangeEnabled: description: Auto Change Enabled type: boolean autoChangeNextPassword: description: Auto Change Next Password type: string checkedOut: description: Whether the secret is currently checked out type: boolean checkOutChangePasswordEnabled: description: Check Out Change Password Enabled type: boolean checkOutEnabled: description: Whether secret checkout is enabled type: boolean checkOutIntervalMinutes: description: Checkout interval, in minutes type: integer format: int32 checkOutMinutesRemaining: description: Minutes remaining in current checkout interval type: integer format: int32 checkOutUserDisplayName: description: Name of user who has checked out the secret type: string checkOutUserId: description: ID of user who has checked out the secret type: integer format: int32 doubleLockId: description: DoubleLock Id type: integer format: int32 enableInheritPermissions: description: Enable Inherit Permissions type: boolean enableInheritSecretPolicy: description: Whether the secret policy is inherited from the containing folder type: boolean failedPasswordChangeAttempts: description: Number of failed password change attempts type: integer format: int32 folderId: description: Containing folder ID type: integer format: int32 id: description: Secret ID type: integer format: int32 isDoubleLock: description: Whether double lock is enabled type: boolean isOutOfSync: description: Out of sync indicates that a Password is setup for autochange and has failed its last password change attempt or has exceeded the maximum RPC attempts type: boolean isRestricted: description: Whether the secret is restricted type: boolean items: description: Secret data fields items: $ref: '#/components/schemas/RestSecretItem' type: array jumpboxRouteId: description: Jumpbox Route Id type: string format: uuid nullable: true lastHeartBeatCheck: description: Time of last heartbeat check type: string format: date-time nullable: true lastHeartBeatStatus: $ref: '#/components/schemas/HeartbeatStatus' lastPasswordChangeAttempt: description: Time of most recent password change attempt type: string format: date-time nullable: true launcherConnectAsSecretId: description: LauncherConnectAsSecretId type: integer format: int32 nullable: true name: description: Secret name type: string outOfSyncReason: description: Reason message if the secret is out of sync type: string passwordTypeWebScriptId: description: Password Type Web Script Id type: integer format: int32 proxyEnabled: description: Proxy Enabled type: boolean requiresApprovalForAccess: description: Requires Approval For Access type: boolean requiresComment: description: Requires Comment type: boolean responseCodes: description: Response Codes items: type: string type: array restrictSshCommands: description: Restrict SSH Commands type: boolean secretPolicyId: description: Secret Policy Id type: integer format: int32 secretTemplateId: description: Secret template ID type: integer format: int32 secretTemplateName: description: Name of secret template type: string sessionRecordingEnabled: description: Whether session recording is enabled type: boolean siteId: description: Site Id type: integer format: int32 webLauncherRequiresIncognitoMode: description: Web Launcher Requires Incognito Mode type: boolean type: object ViewTemplateFieldDropDownOption: description: DropDownOptions properties: fieldValue: description: FieldValue type: string id: description: Id type: integer format: int32 text: description: Text type: string type: object SecretDetailSecurityCheckoutUpdateModel: description: Secret Security Checkout Update properties: checkOutChangePasswordEnabled: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' checkOutEnabled: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' checkOutIntervalMinutes: $ref: '#/components/schemas/UpdateFieldValueOfOptionalInt32' type: object PagingOfSecretAuditModel: 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/SecretAuditModel' 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 SecretChangePasswordArgs: description: Secret password change options properties: comment: description: If the secret requires a comment to view or requires approval to view, a reason for accessing the secret must be provided. type: string doubleLockPassword: description: If the secret is DoubleLocked, this is the DoubleLock password needed to access the secret. type: string forceCheckIn: description: Force the secret to be checked in, even if checked out by someone else. The user must have the "Force Check In" permission. type: boolean includeInactive: description: If the secret is deactivated, this must be set to true in order to access the secret. The user must also have the "View Inactive Secrets" permission. type: boolean newPassword: description: New secret password. type: string noAutoCheckout: description: Don't check out the secret automatically. type: boolean sshKeyArgs: $ref: '#/components/schemas/RotateSshKeyArgs' ticketNumber: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the ticket number to the help desk request. type: string ticketSystemId: description: If the secret requires a comment to view or requires approval and a user must provide a help desk a ticket number, this is the id of the help desk system configured in Secret Server that should be used to validate the ticket number. type: integer format: int32 nullable: true type: object SecretSearchExtendedArgs: description: SecretSearchExtendedArgs properties: data: $ref: '#/components/schemas/SecretSearchExtendedData' type: object ExportSecretsResultModelV2: description: ExportSecretsResultModelV2 properties: exportedSecretsFileText: description: Export File Text type: string format: binary fileType: $ref: '#/components/schemas/ExportFileType' type: object WidgetSecretModel: description: WidgetSecretModel[] properties: folderId: description: FolderId type: integer format: int32 folderPath: description: FolderPath type: string id: description: Id type: integer format: int32 secretName: description: SecretName type: string type: object SecretFieldListType: description: The type of list. Valid values are “None”, “Generic”, and “URL”. properties: {} type: string enum: - Generic - URL - None CategorizedListSummary: description: Query results properties: active: description: Whether or not the list is active type: boolean categorizedListId: description: List Id type: string description: description: Description of the list type: string name: description: Name of the list type: string numOptions: description: The number of options in the list type: integer format: int32 type: object SecretsExportResultModel: description: SecretsExportResultModel properties: errors: description: Secret Export Errors items: $ref: '#/components/schemas/SecretExportErrorModel' type: array exportedSecretsFileText: description: Export File Text type: string fileType: $ref: '#/components/schemas/ExportFileType' secretsCount: description: Count of Exported Secrets type: integer format: int32 type: object SecretDetailUpdateExpirationArgs: description: SecretDetailUpdateExpirationArgs properties: data: $ref: '#/components/schemas/SecretDetailExpirationUpdateModel' type: object SecretDetailScheduleModel: description: Secret Detail Autochange Schedule properties: changeEveryMonths: description: Change Every Months type: integer format: int32 nullable: true changeEveryMonthsDayNumber: description: Change Every Months Day Number type: integer format: int32 nullable: true changeEveryMonthsInstance: description: Change Every Months Instance type: string changeEveryMonthsInstanceTarget: description: Change Every MOnths Instance Target type: string days: description: Days type: integer format: int32 nullable: true friday: description: Friday type: boolean nullable: true monday: description: Monday type: boolean nullable: true monthScheduleType: description: Month Schedule Type type: string nullable: true numberMonthlyDay: description: Number Monthly Day type: integer format: int32 nullable: true onlyChangeIfExpired: description: Only Change If Expired type: boolean nullable: true saturday: description: Saturday type: boolean nullable: true scheduleType: description: Schedule Type type: string nullable: true startingOn: description: Starting On type: string format: date-time nullable: true sunday: description: Sunday type: boolean nullable: true thursday: description: Thursday type: boolean nullable: true tuesday: description: Tuesday type: boolean nullable: true wednesday: description: Wednesday type: boolean nullable: true weeks: description: Weeks type: integer format: int32 nullable: true type: object ViewFieldValueOfInt32: description: OrganizationId properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value type: integer format: int32 type: object SecretDetailUpdateSecurityGeneralArgs: description: Secret General Information Update Message properties: data: $ref: '#/components/schemas/SecretDetailSecurityGeneralUpdateModel' type: object SecretSearchExtendedData: description: Data properties: secretIds: description: Pass an array of secret IDs to get back settings on these secrets for the current user items: type: integer format: int32 type: array type: object SecretSshTerminalArgs: description: Arguments to load the SSH proxy credentials properties: secretId: description: Secret ID type: integer format: int32 type: object SecretExportErrorModel: description: Secret Export Errors properties: errorMessage: description: Error Message type: string secretName: description: Secret Name type: string type: object UpdateTemplateFieldOfString: description: Update Secret Template Field properties: dirty: description: Whether or not the field is dirty. If false, the field value will not be updated. If true, the field value will be updated. type: boolean slug: description: Secret template slug name type: string value: description: Secret field vlaue type: string type: object ExportSecretJobStatus: description: Export Job Status properties: {} type: string enum: - Pending - Completed - Failed SecretDetailEmailUpdateModel: description: Secret Email User Settings properties: sendEmailWhenChanged: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' sendEmailWhenHeartbeatFails: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' sendEmailWhenViewed: $ref: '#/components/schemas/UpdateFieldValueOfBoolean' type: object SecretDetailUpdateSecurityMultifactorArgs: description: Secret Security Multifactor Authentication Options properties: data: $ref: '#/components/schemas/SecretDetailSecurityMultifactorUpdateModel' type: object CategorizedListItemValueResult: description: CategorizedListItemValueResult properties: value: description: Value items: $ref: '#/components/schemas/ICategorizedListItemValue' type: array type: object SecretDetailExpirationUpdateType: description: Value properties: {} type: string enum: - Template - DayInterval - SpecificDate ViewFieldValueOfOptionalInt32: description: Maximum number of messages to keep in log. When null, it is unlimited properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value type: integer format: int32 nullable: true type: object SecretCheckOutExtensionModel: description: Secret Check Out Extension Model properties: minutesToAdd: description: Extend Check Out To This Duration type: integer format: int32 nullable: true notes: description: Notes To Add To Audit type: string type: object YesNoPreferenceOption: description: Allow Clipboard properties: {} type: string enum: - 'No' - 'Yes' - UsePreferenceNo - UsePreferenceYes ConvertTemplateActionModel: description: Secret template conversion model properties: fieldMapping: description: Which source fields should map to which destination fields items: $ref: '#/components/schemas/ConvertTemplateFieldModel' type: array folderId: description: The target folder ID type: integer format: int32 nullable: true isBulk: description: Whether or not this is a bulk operation or a single secret type: boolean newSecretName: description: The new name for the secret type: string secretIds: description: A list of Secret IDs that will be converted items: type: integer format: int32 type: array secretTemplateId: description: The new secret template ID that will be applied to all secrets type: integer format: int32 type: object SecretDetailConvertTemplateInfoArgs: description: Get information used to convert a secret to a different template properties: data: $ref: '#/components/schemas/ConvertTemplateInfoModel' type: object SecretDetailSecurityModel: description: Secret Detail Security properties: allowOwnersUnrestrictedSshCommands: description: Allow Owners Unrestricted SSH Commands type: boolean approvalWorkflow: $ref: '#/components/schemas/WorkflowTemplate' approvers: description: Approvers items: $ref: '#/components/schemas/SecretDetailUserViewModel' type: array checkOutChangePasswordEnabled: description: Check Out Change Password Enabled type: boolean checkOutDefaultIntervalDisplay: description: Check Out Default Interval Display type: string checkOutEnabled: description: Whether secret checkout is enabled type: boolean checkOutIntervalDisplay: description: Check Out Interval Display type: string checkOutIntervalMinutes: description: Checkout interval, in minutes type: integer format: int32 nullable: true commandRestrictionType: $ref: '#/components/schemas/CommandRestrictionType' doubleLockId: description: DoubleLock Id type: integer format: int32 doubleLockName: description: DoubleLock Name type: string hideLauncherPassword: description: Hide Launcher Password type: boolean isDoubleLock: description: Whether double lock is enabled type: boolean isMultiFactorAuthenticationRequired: description: Whether secret access requires Multifactor authentication type: boolean passwordRequirements: $ref: '#/components/schemas/SecretDetailSecurityPasswordRequirements' proxyEnabled: description: Proxy Enabled type: boolean requireApprovalType: $ref: '#/components/schemas/SecretDetailApprovalType' requiresComment: description: Requires Comment type: boolean restrictedSshCommandCount: description: Restricted SSH Command Count type: integer format: int32 restrictSshCommands: description: Restrict SSH Commands type: boolean sessionRecordingEnabled: description: Whether session recording is enabled type: boolean shouldDisplayMultifactorAuthenticationDisasterRecoveryWarning: description: Whether additional messaging about the interaction between multifactor authentication and Disaster Recovery should be displayed type: boolean type: object ICategorizedListItemValue: description: The restricted hosts. properties: category: description: Category type: string value: description: Value type: string type: object SecretProxyArgs: description: Arguments to load the proxy credentials properties: launcherType: description: The type of the launcher to proxy type: integer format: int32 machine: description: The machine name type: string secretId: description: Secret ID type: integer format: int32 siteId: description: The site ID to use (RDP proxy only) type: integer format: int32 nullable: true type: object SessionActions: description: Action To Take properties: {} type: string enum: - Terminate - LimitSession - MessageOnly 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 SecretDetailSecurityPasswordRequirements: description: PasswordRequirements properties: requirements: description: Requirements items: $ref: '#/components/schemas/SecretDetailSecurityPasswordRequirement' type: array validateOnCreate: description: ValidateOnCreate type: boolean validateOnEdit: description: ValidateOnEdit type: boolean type: object SecretDetailHeartbeatStatus: description: Current status of heartbeat properties: {} type: string enum: - Failed - Success - Pending - Disabled - UnableToConnect - UnknownError - IncompatibleHost - AccountLockedOut - DnsMismatch - UnableToValidateServerPublicKey - Processing - ArgumentError - AccessDenied - NeedsImmediateRetry SecretDetailApprovalType: description: Secret Security Approval Type properties: {} type: string enum: - None - RequireApproval - RequireEditorsApproval - RequireEveryoneApproval ViewFieldValueOfSecretDetailHeartbeatStatus: description: Current status of heartbeat properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: $ref: '#/components/schemas/SecretDetailHeartbeatStatus' type: object SecretDetailRestrictedSshCommandBlocklistPermissionUpdateModel: description: Secret Detail SSH Command Blocklist Permission Update Model properties: rolePermissionId: description: "Role Permission Id (10064\tView, 10065\tEdit, 10066\tOwner)" type: integer format: int32 sshCommandBlocklistId: description: SSH Command Blocklist Id type: string format: uuid nullable: true type: object ISecretSummaryExtendedField: description: Any requested extended fields from a lookup request properties: name: description: Name type: string value: description: Value type: string type: object SecretCheckOutExtensionArgs: description: Secret Check Out Extension Args properties: data: $ref: '#/components/schemas/SecretCheckOutExtensionModel' type: object ExportFileType: description: Export Job File Type properties: {} type: string enum: - Csv - Xml - Json ViewFieldValueReadOnlyOfString: description: Name of the Secret. properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value type: string type: object SecretDetailSecurityApprovalUpdateModel: description: Secret Security Approval Update properties: approvers: $ref: '#/components/schemas/UpdateFieldValueOfInt32Array' requireApprovalType: $ref: '#/components/schemas/UpdateFieldValueOfOptionalSecretDetailApprovalType' workflowTemplateId: $ref: '#/components/schemas/UpdateFieldValueOfInt32' type: object UpdateFieldValueOfOptionalBoolean: description: Use RADIUS Username for DUO properties: dirty: description: Dirty type: boolean value: description: Value type: boolean nullable: true type: object PasswordChangeResult: description: Status properties: {} type: string enum: - None - Pending - Success - Fail SecretLookup: description: Simple secret representation properties: id: description: Secret ID type: integer format: int32 value: description: Secret name type: string type: object SecretDetailRestrictedSshCommandMenuPermissionUpdateModel: description: Secret Detail SSH Command Menu Permission Update Model properties: groupId: description: Group Id type: integer format: int32 sshCommandMenuId: description: SSH Command Menu Id type: integer format: int32 nullable: true type: object UpdateFieldValueOfSecretDetailExpirationUpdateType: description: ExpirationType properties: dirty: description: Dirty type: boolean value: $ref: '#/components/schemas/SecretDetailExpirationUpdateType' type: object RestSecretItem: description: Secret data field item properties: fieldDescription: description: Longer description of the secret field. type: string fieldId: description: The id of the field definition from the secret template. type: integer format: int32 nullable: true fieldName: description: The display name of the secret field. type: string fileAttachmentId: description: If the field is a file attachment field, the id of the file attachment. type: integer format: int32 nullable: true filename: description: If the field is a file attachment field, the name of the attached file. type: string isFile: description: Whether the field is a file attachment. type: boolean isList: description: Whether or not the secret field is a list. type: boolean isNotes: description: Whether the field is represented as a multi-line text box. Used for long-form text fields. type: boolean isPassword: description: Whether the field is a password. Password fields are hidden by default in the UI and their value is not returned in GET calls that return secrets. To retrieve a password field value, make a GET call to /api/secrets/{secretId}/fields/{slug}. type: boolean itemId: description: The id of the secret field item. Leave empty when creating a new secret. type: integer format: int32 nullable: true itemValue: description: The value of the secret field item. For list fields, this is a comma-delimited list of the list id guids that are assigned to this field. type: string listType: $ref: '#/components/schemas/SecretFieldListType' slug: description: A unique name for the secret field on the template. Slugs cannot contain spaces and are used in many places to easily refer to a secret field without having to know the field id. type: string type: object SecretDetailUserViewModel: description: Value properties: displayName: description: DisplayName type: string groupId: description: GroupId type: integer format: int32 isGroup: description: IsGroup type: boolean type: object SecretTransitionHistorySummaryModel: description: Query results properties: dateRecorded: description: DateRecorded type: string format: date-time itemValue: description: ItemValue type: string type: object SecretDetailSecurityPasswordRequirement: description: Requirements properties: fieldDisplayName: description: FieldDisplayName type: string fieldName: description: FieldName type: string isCustom: description: IsCustom type: boolean passwordRequirementId: description: PasswordRequirementId type: integer format: int32 passwordRequirementName: description: PasswordRequirementName type: string type: object WorkflowTemplate: description: Value properties: active: description: Active type: boolean configurationJson: description: ConfigurationJson type: string description: description: Description type: string expirationMinutes: description: ExpirationMinutes type: integer format: int32 nullable: true name: description: Name type: string reusable: description: Reusable type: boolean typeName: description: TypeName type: string workflowTemplateId: description: WorkflowTemplateId type: integer format: int32 workflowType: $ref: '#/components/schemas/WorkflowType' type: object RotateSshKeyArgs: description: SSH key rotation options properties: generatePassphrase: description: Whether to generate the next SSH private key passphrase. Must be true if the passphrase is empty. type: boolean generateSshKeys: description: Whether to generate the next SSH private key. Must be true if the private key is empty. type: boolean passphrase: description: Private key passphrase type: string privateKey: description: Private key type: string type: object DashboardViewSecret: description: DashboardViewSecret properties: errorMessage: description: errorMessage type: string favorite: description: favorite type: boolean hasLauncher: description: hasLauncher type: boolean id: description: id type: integer format: int32 isTotpEnabled: description: isTotpEnabled type: boolean items: description: items items: $ref: '#/components/schemas/DashboardViewSecretItem' type: array launchers: description: launchers items: $ref: '#/components/schemas/DashboardViewLauncherInfo' type: array secretName: description: secretName type: string showViewButton: description: showViewButton type: boolean userCanEdit: description: userCanEdit type: boolean userCanShare: description: userCanShare type: boolean userCanViewAudit: description: userCanViewAudit type: boolean usesClickOnce: description: usesClickOnce type: boolean type: object SecretSummary: description: Secret summary properties: active: description: Whether the secret is active type: boolean autoChangeEnabled: description: Indicates whether or not this Secret an auto changing password type: boolean nullable: true checkedOut: description: Whether the secret is currently checked out type: boolean checkOutEnabled: description: Indicates whether or not checkout is enabled for the Secret type: boolean nullable: true checkOutUserId: description: Id of the User that has the secret checked out if it is checked out type: integer format: int32 checkOutUserName: description: The name of the User that has the secret checked out if it is checked out type: string createDate: description: When the Secret was created type: string format: date-time nullable: true daysUntilExpiration: description: How many days until this Secret expires type: integer format: int32 nullable: true doubleLockEnabled: description: Indicates whether or not DoubleLock is enabled for this password type: boolean nullable: true extendedFields: description: Any requested extended fields from a lookup request items: $ref: '#/components/schemas/ISecretSummaryExtendedField' type: array folderId: description: Containing folder ID type: integer format: int32 folderPath: description: Containing folder path type: string hasLauncher: description: Indicates if this Secret has any launchers type: boolean hidePassword: description: Indicates if the launcher password is set to be hidden type: boolean nullable: true id: description: Secret ID type: integer format: int32 inheritsPermissions: description: Indicates if this Secret inherits permissions from its folder type: boolean nullable: true isOutOfSync: description: Indicates that Heartbeat has failed or a Password is set up for autochange and has failed its last password change attempt or has exceeded the maximum RPC attempts type: boolean isRestricted: description: Whether the secret is restricted type: boolean lastAccessed: description: When the Secret was last viewed by the current User type: string format: date-time nullable: true lastHeartBeatStatus: $ref: '#/components/schemas/HeartbeatStatus' lastPasswordChangeAttempt: description: Time of most recent password change attempt type: string format: date-time nullable: true name: description: Secret name type: string outOfSyncReason: description: Reason message if the secret is out of sync type: string requiresApproval: description: Indicates if this Secret requires approval type: boolean nullable: true requiresComment: description: Indicates if this Secret requires comment type: boolean nullable: true responseCodes: description: ResponseCodes items: type: string type: array secretTemplateId: description: Secret template ID type: integer format: int32 secretTemplateName: description: Name of secret template type: string siteId: description: SiteId type: integer format: int32 type: object SecretDetailConvertTemplateModel: description: SecretDetailConvertTemplateModel properties: secretId: description: SecretId type: integer format: int32 nullable: true taskId: description: TaskId type: string type: object SecretDetailUpdateEmailArgs: description: Secret User Email Update Message properties: data: $ref: '#/components/schemas/SecretDetailEmailUpdateModel' type: object SecretDetailRpcSecrets: description: Reset Secrets properties: folderName: description: FolderName type: string order: description: Order type: integer format: int32 secretId: description: SecretId type: integer format: int32 secretName: description: SecretName type: string secretTemplateName: description: SecretTemplateName type: string type: object ViewFieldValueOfSecretDetailUserViewModelArray: description: Approvers properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value items: $ref: '#/components/schemas/SecretDetailUserViewModel' type: array type: object RdpLauncherSettingsModel: description: RDP Launcher Settings properties: allowClipboard: $ref: '#/components/schemas/YesNoPreferenceOption' allowDrives: $ref: '#/components/schemas/YesNoPreferenceOption' allowPrinters: $ref: '#/components/schemas/YesNoPreferenceOption' allowSmartCards: $ref: '#/components/schemas/YesNoPreferenceOption' connectToConsole: $ref: '#/components/schemas/YesNoPreferenceOption' launcherHeight: description: Launcher Height type: integer format: int32 nullable: true launcherWidth: description: Launcher Height type: integer format: int32 nullable: true useCustomLauncherResolution: $ref: '#/components/schemas/YesNoPreferenceOption' type: object SecretAccessRequired: description: Secret Access Required properties: {} type: string enum: - None - RequiresApproval - RequiresCheckout - RequiresComment - RequiresDoubleLockPassword - CreateDoubleLockPassword - DoubleLockNoAccess - CannotView - RequiresUndelete - RequiresCheckoutPendingRPC - RequiresCheckoutAndComment - RequiresMfaChallenge PagingOfSecretLookup: 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/SecretLookup' 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 ViewFieldValueOfSecretDetailApprovalTypeArray: description: AvailableRequireApprovalTypes properties: additionalLinks: description: AdditionalLinks items: $ref: '#/components/schemas/ViewFieldLink' type: array description: description: Description type: string fieldInputType: description: FieldInputType type: string nullable: true hasHistory: description: HasHistory type: boolean nullable: true helpLink: description: HelpLink type: string helpLinkText: description: HelpLinkText type: string hidden: description: Hidden type: boolean nullable: true hideOnView: description: HideOnView type: boolean nullable: true isRequired: description: IsRequired type: boolean nullable: true label: description: Label type: string maxLength: description: MaxLength type: integer format: int32 nullable: true name: description: Name type: string placeholder: description: Placeholder type: string readOnly: description: ReadOnly type: boolean nullable: true readOnlyReason: description: ReadOnlyReason type: string sortOrder: description: SortOrder type: integer format: int32 nullable: true value: description: Value items: $ref: '#/components/schemas/SecretDetailApprovalType' type: array type: object requestBodies: SecretDetailUpdateEmailArgs: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateEmailArgs' description: args ExportSecretsArgs: content: application/json: schema: $ref: '#/components/schemas/ExportSecretsArgs' description: args SecretRestrictedArgs: content: application/json: schema: $ref: '#/components/schemas/SecretRestrictedArgs' description: Secret options SecretProxyArgs: content: application/json: schema: $ref: '#/components/schemas/SecretProxyArgs' description: args SecretDetailUpdateSecurityGeneralArgs: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateSecurityGeneralArgs' description: args SecretDetailUpdateGeneralArgs: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateGeneralArgs' description: args SecretDetailUpdateRpcScriptSecretsArgs: content: application/json: schema: $ref: '#/components/schemas/SecretDetailUpdateRpcScriptSecretsArgs' description: args 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