qsafe-sdk 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 402116b0189c5d11aad227ada1b2b39b57b4b212e5db942f7a4d07568bd172fe
+  data.tar.gz: 8d984d577a3af5640a3a5d9f376e72d7b60fef55c0b47a434ab6cb18b5c534a0
+SHA512:
+  metadata.gz: 9a03123fe51e8e7aaf4dd1225707e1ef42cb92e973465349f45f4e370fc1f0225eaaed3e36618201c1e4798899b5481322fe517f0122768c31768fb19355adaf
+  data.tar.gz: b38114303f8c8038f88495a7c1f9fe964bb67a44c5cec0fd40732cf94b9f11f7a65a8952b4aff36350d70712a52b11d2d023de8acb1c60834ba1f409d4fe0d70

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0.1'
+  gem 'pry-byebug'
+  gem 'rubocop', '~> 0.66.0'
+end

data/README.md

@@ -0,0 +1,210 @@
+# qsafe-sdk
+
+QSafe - the Ruby gem for the QSafe PQC API
+
+Post-quantum cryptography SaaS API supporting ML-KEM (Kyber) and ML-DSA (Dilithium) algorithms.
+Provides keypair management and cryptographic operations (encrypt, decrypt, sign, verify).
+
+## Authentication
+- **JWT Bearer Token** — user-based auth, obtained from `/auth/login` or `/auth/register`
+- **API Key (header)** — programmatic access via `X-API-Key` header
+- **API Key (query)** — programmatic access via `?api_key=` query parameter
+
+## Quick Start
+1. Register → `POST /auth/register`
+2. Login → `POST /auth/login` → copy `data.token`
+3. Generate keypair → `POST /generate-keypair`
+4. Encrypt / Sign with the keypair ID
+
+
+This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
+
+- API version: 1.0.0
+- Package version: 1.0.0
+- Generator version: 7.9.0
+- Build package: org.openapitools.codegen.languages.RubyClientCodegen
+
+## Installation
+
+### Build a gem
+
+To build the Ruby code into a gem:
+
+```shell
+gem build qsafe-sdk.gemspec
+```
+
+Then either install the gem locally:
+
+```shell
+gem install ./qsafe-sdk-1.0.0.gem
+```
+
+(for development, run `gem install --dev ./qsafe-sdk-1.0.0.gem` to install the development dependencies)
+
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
+
+Finally add this to the Gemfile:
+
+    gem 'qsafe-sdk', '~> 1.0.0'
+
+### Install from Git
+
+If the Ruby gem is hosted at a git repository: https://github.com/qsafe/sdk-ruby, then add the following in the Gemfile:
+
+    gem 'qsafe-sdk', :git => 'https://github.com/qsafe/sdk-ruby.git'
+
+### Include the Ruby code directly
+
+Include the Ruby code directly using `-I` as follows:
+
+```shell
+ruby -Ilib script.rb
+```
+
+## Getting Started
+
+Please follow the [installation](#installation) procedure and then run the following code:
+
+```ruby
+# Load the gem
+require 'qsafe-sdk'
+
+# Setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+  # Configure a proc to get access tokens in lieu of the static access_token configuration
+  config.access_token_getter = -> { 'YOUR TOKEN GETTER PROC' } 
+end
+
+api_instance = QSafe::APIKeysApi.new
+create_api_key_request = QSafe::CreateApiKeyRequest.new({name: 'Production API Key'}) # CreateApiKeyRequest | 
+
+begin
+  #Create API key (JWT only)
+  result = api_instance.create_api_key(create_api_key_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Exception when calling APIKeysApi->create_api_key: #{e}"
+end
+
+```
+
+## Documentation for API Endpoints
+
+All URIs are relative to *https://rushikesh66-pqc-api.hf.space*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*QSafe::APIKeysApi* | [**create_api_key**](docs/APIKeysApi.md#create_api_key) | **POST** /api-keys | Create API key (JWT only)
+*QSafe::APIKeysApi* | [**get_api_key**](docs/APIKeysApi.md#get_api_key) | **GET** /api-keys/{keyId} | Get API key details (JWT only)
+*QSafe::APIKeysApi* | [**get_api_key_usage**](docs/APIKeysApi.md#get_api_key_usage) | **GET** /api-keys/{keyId}/usage | Get API key usage stats (JWT only)
+*QSafe::APIKeysApi* | [**list_api_keys**](docs/APIKeysApi.md#list_api_keys) | **GET** /api-keys | List API keys (JWT only)
+*QSafe::APIKeysApi* | [**rotate_api_key**](docs/APIKeysApi.md#rotate_api_key) | **POST** /api-keys/{keyId}/rotate | Rotate API key — generates new key value (JWT only)
+*QSafe::APIKeysApi* | [**update_api_key**](docs/APIKeysApi.md#update_api_key) | **PATCH** /api-keys/{keyId} | Update API key (JWT only)
+*QSafe::AuthenticationApi* | [**change_password**](docs/AuthenticationApi.md#change_password) | **POST** /auth/change-password | Change password (JWT only)
+*QSafe::AuthenticationApi* | [**get_auth_info**](docs/AuthenticationApi.md#get_auth_info) | **GET** /auth/info | Get current auth context (JWT or API key)
+*QSafe::AuthenticationApi* | [**login_user**](docs/AuthenticationApi.md#login_user) | **POST** /auth/login | Login and get JWT token
+*QSafe::AuthenticationApi* | [**register_user**](docs/AuthenticationApi.md#register_user) | **POST** /auth/register | Register a new user
+*QSafe::CryptographicOperationsApi* | [**decrypt_data**](docs/CryptographicOperationsApi.md#decrypt_data) | **POST** /keypairs/{keypairId}/decrypt | Decrypt data with a keypair's private key
+*QSafe::CryptographicOperationsApi* | [**encrypt_data**](docs/CryptographicOperationsApi.md#encrypt_data) | **POST** /keypairs/{keypairId}/encrypt | Encrypt data with a keypair's public key
+*QSafe::CryptographicOperationsApi* | [**sign_data**](docs/CryptographicOperationsApi.md#sign_data) | **POST** /keypairs/{keypairId}/sign | Sign data with a keypair's private key
+*QSafe::CryptographicOperationsApi* | [**verify_signature**](docs/CryptographicOperationsApi.md#verify_signature) | **POST** /keypairs/{keypairId}/verify | Verify a signature
+*QSafe::DebugApi* | [**debug_redis_test**](docs/DebugApi.md#debug_redis_test) | **GET** /debug/redis-test | Test Redis and internal services
+*QSafe::HealthApi* | [**get_health**](docs/HealthApi.md#get_health) | **GET** /health | Health check
+*QSafe::KeypairsApi* | [**generate_keypair**](docs/KeypairsApi.md#generate_keypair) | **POST** /generate-keypair | Generate a new keypair
+*QSafe::KeypairsApi* | [**list_keypairs**](docs/KeypairsApi.md#list_keypairs) | **GET** /keypairs | List keypairs
+*QSafe::KeypairsApi* | [**revoke_keypair**](docs/KeypairsApi.md#revoke_keypair) | **PATCH** /keypairs/{keypairId}/revoke | Revoke a keypair
+*QSafe::KeypairsApi* | [**update_keypair**](docs/KeypairsApi.md#update_keypair) | **PATCH** /keypairs/{keypairId} | Update keypair metadata / tags
+*QSafe::UtilitiesApi* | [**get_rate_limit_status**](docs/UtilitiesApi.md#get_rate_limit_status) | **GET** /rate-limit/status | Get rate limit status for the current API key
+
+
+## Documentation for Models
+
+ - [QSafe::ApiKey](docs/ApiKey.md)
+ - [QSafe::AuthResponse](docs/AuthResponse.md)
+ - [QSafe::AuthResponseData](docs/AuthResponseData.md)
+ - [QSafe::ChangePassword200Response](docs/ChangePassword200Response.md)
+ - [QSafe::ChangePasswordRequest](docs/ChangePasswordRequest.md)
+ - [QSafe::CreateApiKey201Response](docs/CreateApiKey201Response.md)
+ - [QSafe::CreateApiKeyRequest](docs/CreateApiKeyRequest.md)
+ - [QSafe::DebugRedisTest200Response](docs/DebugRedisTest200Response.md)
+ - [QSafe::DebugRedisTest200ResponseRateLimitTest](docs/DebugRedisTest200ResponseRateLimitTest.md)
+ - [QSafe::DebugRedisTest200ResponseServicesStatus](docs/DebugRedisTest200ResponseServicesStatus.md)
+ - [QSafe::DebugRedisTest500Response](docs/DebugRedisTest500Response.md)
+ - [QSafe::DecryptData200Response](docs/DecryptData200Response.md)
+ - [QSafe::DecryptData200ResponseData](docs/DecryptData200ResponseData.md)
+ - [QSafe::DecryptRequest](docs/DecryptRequest.md)
+ - [QSafe::DecryptRequestEphemeralCrypto](docs/DecryptRequestEphemeralCrypto.md)
+ - [QSafe::EncryptData200Response](docs/EncryptData200Response.md)
+ - [QSafe::EncryptData200ResponseData](docs/EncryptData200ResponseData.md)
+ - [QSafe::EncryptRequest](docs/EncryptRequest.md)
+ - [QSafe::EncryptRequestEphemeralStorage](docs/EncryptRequestEphemeralStorage.md)
+ - [QSafe::Error](docs/Error.md)
+ - [QSafe::GenerateKeypair201Response](docs/GenerateKeypair201Response.md)
+ - [QSafe::GenerateKeypairRequest](docs/GenerateKeypairRequest.md)
+ - [QSafe::GenerateKeypairRequestKeyPolicy](docs/GenerateKeypairRequestKeyPolicy.md)
+ - [QSafe::GetApiKey200Response](docs/GetApiKey200Response.md)
+ - [QSafe::GetApiKeyUsage200Response](docs/GetApiKeyUsage200Response.md)
+ - [QSafe::GetApiKeyUsage200ResponseData](docs/GetApiKeyUsage200ResponseData.md)
+ - [QSafe::GetApiKeyUsage200ResponseDataDailyUsageInner](docs/GetApiKeyUsage200ResponseDataDailyUsageInner.md)
+ - [QSafe::GetAuthInfo200Response](docs/GetAuthInfo200Response.md)
+ - [QSafe::GetAuthInfo200ResponseData](docs/GetAuthInfo200ResponseData.md)
+ - [QSafe::GetHealth200Response](docs/GetHealth200Response.md)
+ - [QSafe::GetHealth200ResponseServices](docs/GetHealth200ResponseServices.md)
+ - [QSafe::GetHealth200ResponseServicesApi](docs/GetHealth200ResponseServicesApi.md)
+ - [QSafe::GetHealth200ResponseServicesEphemeralStorage](docs/GetHealth200ResponseServicesEphemeralStorage.md)
+ - [QSafe::GetHealth200ResponseServicesRedis](docs/GetHealth200ResponseServicesRedis.md)
+ - [QSafe::GetRateLimitStatus200Response](docs/GetRateLimitStatus200Response.md)
+ - [QSafe::GetRateLimitStatus200ResponseData](docs/GetRateLimitStatus200ResponseData.md)
+ - [QSafe::GetRateLimitStatus200ResponseDataCurrentUsage](docs/GetRateLimitStatus200ResponseDataCurrentUsage.md)
+ - [QSafe::GetRateLimitStatus200ResponseDataLimits](docs/GetRateLimitStatus200ResponseDataLimits.md)
+ - [QSafe::GetRateLimitStatus200ResponseDataResetTimes](docs/GetRateLimitStatus200ResponseDataResetTimes.md)
+ - [QSafe::Keypair](docs/Keypair.md)
+ - [QSafe::ListApiKeys200Response](docs/ListApiKeys200Response.md)
+ - [QSafe::ListApiKeys200ResponseData](docs/ListApiKeys200ResponseData.md)
+ - [QSafe::ListApiKeys200ResponseDataPagination](docs/ListApiKeys200ResponseDataPagination.md)
+ - [QSafe::ListKeypairs200Response](docs/ListKeypairs200Response.md)
+ - [QSafe::ListKeypairs200ResponseData](docs/ListKeypairs200ResponseData.md)
+ - [QSafe::ListKeypairs200ResponseDataPagination](docs/ListKeypairs200ResponseDataPagination.md)
+ - [QSafe::LoginRequest](docs/LoginRequest.md)
+ - [QSafe::RegisterRequest](docs/RegisterRequest.md)
+ - [QSafe::RevokeKeypair200Response](docs/RevokeKeypair200Response.md)
+ - [QSafe::RevokeKeypairRequest](docs/RevokeKeypairRequest.md)
+ - [QSafe::RotateApiKey200Response](docs/RotateApiKey200Response.md)
+ - [QSafe::SignData200Response](docs/SignData200Response.md)
+ - [QSafe::SignData200ResponseData](docs/SignData200ResponseData.md)
+ - [QSafe::SignRequest](docs/SignRequest.md)
+ - [QSafe::SignRequestEphemeralStorage](docs/SignRequestEphemeralStorage.md)
+ - [QSafe::UpdateApiKeyRequest](docs/UpdateApiKeyRequest.md)
+ - [QSafe::UpdateKeypair200Response](docs/UpdateKeypair200Response.md)
+ - [QSafe::UpdateKeypairRequest](docs/UpdateKeypairRequest.md)
+ - [QSafe::User](docs/User.md)
+ - [QSafe::VerifyRequest](docs/VerifyRequest.md)
+ - [QSafe::VerifySignature200Response](docs/VerifySignature200Response.md)
+ - [QSafe::VerifySignature200ResponseData](docs/VerifySignature200ResponseData.md)
+
+
+## Documentation for Authorization
+
+
+Authentication schemes defined for the API:
+### BearerAuth
+
+- **Type**: Bearer authentication (JWT)
+
+### ApiKeyHeader
+
+
+- **Type**: API key
+- **API key parameter name**: X-API-Key
+- **Location**: HTTP header
+
+### ApiKeyQuery
+
+
+- **Type**: API key
+- **API key parameter name**: api_key
+- **Location**: URL query string
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/docs/APIKeysApi.md

@@ -0,0 +1,427 @@
+# QSafe::APIKeysApi
+
+All URIs are relative to *https://rushikesh66-pqc-api.hf.space*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**create_api_key**](APIKeysApi.md#create_api_key) | **POST** /api-keys | Create API key (JWT only) |
+| [**get_api_key**](APIKeysApi.md#get_api_key) | **GET** /api-keys/{keyId} | Get API key details (JWT only) |
+| [**get_api_key_usage**](APIKeysApi.md#get_api_key_usage) | **GET** /api-keys/{keyId}/usage | Get API key usage stats (JWT only) |
+| [**list_api_keys**](APIKeysApi.md#list_api_keys) | **GET** /api-keys | List API keys (JWT only) |
+| [**rotate_api_key**](APIKeysApi.md#rotate_api_key) | **POST** /api-keys/{keyId}/rotate | Rotate API key — generates new key value (JWT only) |
+| [**update_api_key**](APIKeysApi.md#update_api_key) | **PATCH** /api-keys/{keyId} | Update API key (JWT only) |
+
+
+## create_api_key
+
+> <CreateApiKey201Response> create_api_key(create_api_key_request)
+
+Create API key (JWT only)
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::APIKeysApi.new
+create_api_key_request = QSafe::CreateApiKeyRequest.new({name: 'Production API Key'}) # CreateApiKeyRequest | 
+
+begin
+  # Create API key (JWT only)
+  result = api_instance.create_api_key(create_api_key_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->create_api_key: #{e}"
+end
+```
+
+#### Using the create_api_key_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateApiKey201Response>, Integer, Hash)> create_api_key_with_http_info(create_api_key_request)
+
+```ruby
+begin
+  # Create API key (JWT only)
+  data, status_code, headers = api_instance.create_api_key_with_http_info(create_api_key_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateApiKey201Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->create_api_key_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_api_key_request** | [**CreateApiKeyRequest**](CreateApiKeyRequest.md) |  |  |
+
+### Return type
+
+[**CreateApiKey201Response**](CreateApiKey201Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_api_key
+
+> <GetApiKey200Response> get_api_key(key_id)
+
+Get API key details (JWT only)
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::APIKeysApi.new
+key_id = 'ak_1234567890' # String | API key identifier
+
+begin
+  # Get API key details (JWT only)
+  result = api_instance.get_api_key(key_id)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->get_api_key: #{e}"
+end
+```
+
+#### Using the get_api_key_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetApiKey200Response>, Integer, Hash)> get_api_key_with_http_info(key_id)
+
+```ruby
+begin
+  # Get API key details (JWT only)
+  data, status_code, headers = api_instance.get_api_key_with_http_info(key_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetApiKey200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->get_api_key_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key_id** | **String** | API key identifier |  |
+
+### Return type
+
+[**GetApiKey200Response**](GetApiKey200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_api_key_usage
+
+> <GetApiKeyUsage200Response> get_api_key_usage(key_id, opts)
+
+Get API key usage stats (JWT only)
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::APIKeysApi.new
+key_id = 'ak_1234567890' # String | API key identifier
+opts = {
+  time_range: '1h' # String | 
+}
+
+begin
+  # Get API key usage stats (JWT only)
+  result = api_instance.get_api_key_usage(key_id, opts)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->get_api_key_usage: #{e}"
+end
+```
+
+#### Using the get_api_key_usage_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetApiKeyUsage200Response>, Integer, Hash)> get_api_key_usage_with_http_info(key_id, opts)
+
+```ruby
+begin
+  # Get API key usage stats (JWT only)
+  data, status_code, headers = api_instance.get_api_key_usage_with_http_info(key_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetApiKeyUsage200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->get_api_key_usage_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key_id** | **String** | API key identifier |  |
+| **time_range** | **String** |  | [optional][default to &#39;24h&#39;] |
+
+### Return type
+
+[**GetApiKeyUsage200Response**](GetApiKeyUsage200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_api_keys
+
+> <ListApiKeys200Response> list_api_keys(opts)
+
+List API keys (JWT only)
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::APIKeysApi.new
+opts = {
+  page: 1, # Integer | 
+  limit: 10, # Integer | 
+  status: 'active' # String | 
+}
+
+begin
+  # List API keys (JWT only)
+  result = api_instance.list_api_keys(opts)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->list_api_keys: #{e}"
+end
+```
+
+#### Using the list_api_keys_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListApiKeys200Response>, Integer, Hash)> list_api_keys_with_http_info(opts)
+
+```ruby
+begin
+  # List API keys (JWT only)
+  data, status_code, headers = api_instance.list_api_keys_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListApiKeys200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->list_api_keys_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **page** | **Integer** |  | [optional][default to 1] |
+| **limit** | **Integer** |  | [optional][default to 10] |
+| **status** | **String** |  | [optional] |
+
+### Return type
+
+[**ListApiKeys200Response**](ListApiKeys200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## rotate_api_key
+
+> <RotateApiKey200Response> rotate_api_key(key_id)
+
+Rotate API key — generates new key value (JWT only)
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::APIKeysApi.new
+key_id = 'ak_1234567890' # String | API key identifier
+
+begin
+  # Rotate API key — generates new key value (JWT only)
+  result = api_instance.rotate_api_key(key_id)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->rotate_api_key: #{e}"
+end
+```
+
+#### Using the rotate_api_key_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<RotateApiKey200Response>, Integer, Hash)> rotate_api_key_with_http_info(key_id)
+
+```ruby
+begin
+  # Rotate API key — generates new key value (JWT only)
+  data, status_code, headers = api_instance.rotate_api_key_with_http_info(key_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <RotateApiKey200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->rotate_api_key_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key_id** | **String** | API key identifier |  |
+
+### Return type
+
+[**RotateApiKey200Response**](RotateApiKey200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## update_api_key
+
+> <GetApiKey200Response> update_api_key(key_id, update_api_key_request)
+
+Update API key (JWT only)
+
+### Examples
+
+```ruby
+require 'time'
+require 'qsafe-sdk'
+# setup authorization
+QSafe.configure do |config|
+  # Configure Bearer authorization (JWT): BearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = QSafe::APIKeysApi.new
+key_id = 'ak_1234567890' # String | API key identifier
+update_api_key_request = QSafe::UpdateApiKeyRequest.new # UpdateApiKeyRequest | 
+
+begin
+  # Update API key (JWT only)
+  result = api_instance.update_api_key(key_id, update_api_key_request)
+  p result
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->update_api_key: #{e}"
+end
+```
+
+#### Using the update_api_key_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetApiKey200Response>, Integer, Hash)> update_api_key_with_http_info(key_id, update_api_key_request)
+
+```ruby
+begin
+  # Update API key (JWT only)
+  data, status_code, headers = api_instance.update_api_key_with_http_info(key_id, update_api_key_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetApiKey200Response>
+rescue QSafe::ApiError => e
+  puts "Error when calling APIKeysApi->update_api_key_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key_id** | **String** | API key identifier |  |
+| **update_api_key_request** | [**UpdateApiKeyRequest**](UpdateApiKeyRequest.md) |  |  |
+
+### Return type
+
+[**GetApiKey200Response**](GetApiKey200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/ApiKey.md

@@ -0,0 +1,36 @@
+# QSafe::ApiKey
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **permissions** | **Array<String>** |  | [optional] |
+| **rate_limits** | [**GetRateLimitStatus200ResponseDataLimits**](GetRateLimitStatus200ResponseDataLimits.md) |  | [optional] |
+| **is_active** | **Boolean** |  | [optional] |
+| **created_at** | **Time** |  | [optional] |
+| **last_used** | **Time** |  | [optional] |
+| **expires_at** | **Time** |  | [optional] |
+| **allowed_ips** | **Array<String>** |  | [optional] |
+| **allowed_origins** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'qsafe-sdk'
+
+instance = QSafe::ApiKey.new(
+  id: ak_1234567890,
+  name: Production API Key,
+  permissions: ["read","crypto_encrypt","crypto_decrypt"],
+  rate_limits: null,
+  is_active: true,
+  created_at: null,
+  last_used: null,
+  expires_at: null,
+  allowed_ips: ["192.168.1.0/24"],
+  allowed_origins: ["https://app.example.com"]
+)
+```
+