DealMakerAPI 0.104.0 → 0.104.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6a17c990890aeb23c1ff125d1c2809af8c500e23ed18deb5d57566d6eb20f602
4
- data.tar.gz: b98ad618762c6eb0172449ee3679da5b6c251c5ac64ca7449f788b97db7cee86
3
+ metadata.gz: 3e14a95ecb4a896241b9303ae221757ef37dd0427b56bef4ccf9c92041cffdd4
4
+ data.tar.gz: 8e5e49486b4cf6aa00a25955e3170efa99f07814d03d47ead89137ad3c2badf8
5
5
  SHA512:
6
- metadata.gz: 11f293525eb8501d17744911f51e8798286f0ca3ff884b9d66a6fb1a9eb2fef0964336abe1b30dc64c5d6df87ea06376c1b6d9228677b3fc21cac292b5c529e2
7
- data.tar.gz: d0488827d27996352ec35a8ef70712823828786a2b4edc3d19f5d3c6f3b76e2ba8ae2f0e7e7775fc16077c65fde617dae09f338e1b95c928b1d80455bf6c9a6b
6
+ metadata.gz: 7de5580f28d5c5e41cef9217647432eaec0d842226d39f90323146f92ae95fe7e3cbe6b434746a694d6d605d3406fe49dc53dbb2a335916d59863a510b970c3b
7
+ data.tar.gz: 4d8f054e24cdbbbfc1928a33f4c88d3b4da38f4b9e94df827fdf3cc93b64396a1b78cc7eac5a2b1dd71904950a0d98156dea8b81fd072a7cc991c20cf91dc0ad
data/README.md CHANGED
@@ -338,7 +338,7 @@ Given the high number of updates our platform performs on any investor, we’ve
338
338
  This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
339
339
 
340
340
  - API version: 1.75.0
341
- - Package version: 0.104.0
341
+ - Package version: 0.104.2
342
342
  - Generator version: 7.7.0-SNAPSHOT
343
343
  - Build package: org.openapitools.codegen.languages.RubyClientCodegen
344
344
 
@@ -355,16 +355,16 @@ gem build DealMakerAPI.gemspec
355
355
  Then either install the gem locally:
356
356
 
357
357
  ```shell
358
- gem install ./DealMakerAPI-0.104.0.gem
358
+ gem install ./DealMakerAPI-0.104.2.gem
359
359
  ```
360
360
 
361
- (for development, run `gem install --dev ./DealMakerAPI-0.104.0.gem` to install the development dependencies)
361
+ (for development, run `gem install --dev ./DealMakerAPI-0.104.2.gem` to install the development dependencies)
362
362
 
363
363
  or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
364
364
 
365
365
  Finally add this to the Gemfile:
366
366
 
367
- gem 'DealMakerAPI', '~> 0.104.0'
367
+ gem 'DealMakerAPI', '~> 0.104.2'
368
368
 
369
369
  ### Install from Git
370
370
 
@@ -503,6 +503,8 @@ Class | Method | HTTP request | Description
503
503
  *DealMakerAPI::UserApi* | [**disable_mfa**](docs/UserApi.md#disable_mfa) | **DELETE** /users/{id}/disable_mfa | Disable all the multi-factor authentication integrations for a user
504
504
  *DealMakerAPI::UserApi* | [**get_two_factor_channels**](docs/UserApi.md#get_two_factor_channels) | **GET** /users/{id}/two_factor_channels | Creates an API endpoint to return a list of existing TOTP factor
505
505
  *DealMakerAPI::UserApi* | [**get_user**](docs/UserApi.md#get_user) | **GET** /users/{id} | Get user by User ID
506
+ *DealMakerAPI::UserApi* | [**get_verification_resources**](docs/UserApi.md#get_verification_resources) | **GET** /users/verification/resources | Gets the verification process resources
507
+ *DealMakerAPI::UserApi* | [**send_verification_code**](docs/UserApi.md#send_verification_code) | **POST** /users/verification/send_code | Sends the verification code to the user
506
508
  *DealMakerAPI::UserApi* | [**setup_sms_verification**](docs/UserApi.md#setup_sms_verification) | **POST** /users/{id}/setup_sms_verification | Start a setup for a SMS Verification by creating a two factor channel of sms type
507
509
  *DealMakerAPI::UserApi* | [**update_user_password**](docs/UserApi.md#update_user_password) | **PUT** /users/{id}/update_password | Update user password
508
510
  *DealMakerAPI::UserApi* | [**verify_factor**](docs/UserApi.md#verify_factor) | **PUT** /users/{id}/verify_factor | Creates an API endpoint to verify an existing TOTP factor
@@ -550,6 +552,7 @@ Class | Method | HTTP request | Description
550
552
  - [DealMakerAPI::RequestNewDocumentRequest](docs/RequestNewDocumentRequest.md)
551
553
  - [DealMakerAPI::RunBackgroundSearchRequest](docs/RunBackgroundSearchRequest.md)
552
554
  - [DealMakerAPI::SendPortalInviteRequest](docs/SendPortalInviteRequest.md)
555
+ - [DealMakerAPI::SendVerificationCodeRequest](docs/SendVerificationCodeRequest.md)
553
556
  - [DealMakerAPI::SetupSmsVerificationRequest](docs/SetupSmsVerificationRequest.md)
554
557
  - [DealMakerAPI::TestDocumentUploadEmailRequest](docs/TestDocumentUploadEmailRequest.md)
555
558
  - [DealMakerAPI::UpdateUserPasswordRequest](docs/UpdateUserPasswordRequest.md)
@@ -584,6 +587,7 @@ Class | Method | HTTP request | Description
584
587
  - [DealMakerAPI::V1EntitiesDealsProgressColumn](docs/V1EntitiesDealsProgressColumn.md)
585
588
  - [DealMakerAPI::V1EntitiesDealsProgressKinds](docs/V1EntitiesDealsProgressKinds.md)
586
589
  - [DealMakerAPI::V1EntitiesDealsProgressPageSummary](docs/V1EntitiesDealsProgressPageSummary.md)
590
+ - [DealMakerAPI::V1EntitiesDealsProgressPageSummaryItem](docs/V1EntitiesDealsProgressPageSummaryItem.md)
587
591
  - [DealMakerAPI::V1EntitiesDeleteResult](docs/V1EntitiesDeleteResult.md)
588
592
  - [DealMakerAPI::V1EntitiesDividend](docs/V1EntitiesDividend.md)
589
593
  - [DealMakerAPI::V1EntitiesDividends](docs/V1EntitiesDividends.md)
@@ -637,6 +641,7 @@ Class | Method | HTTP request | Description
637
641
  - [DealMakerAPI::V1EntitiesUsersFactor](docs/V1EntitiesUsersFactor.md)
638
642
  - [DealMakerAPI::V1EntitiesUsersTwoFactorChannel](docs/V1EntitiesUsersTwoFactorChannel.md)
639
643
  - [DealMakerAPI::V1EntitiesUsersTwoFactorChannels](docs/V1EntitiesUsersTwoFactorChannels.md)
644
+ - [DealMakerAPI::V1EntitiesUsersVerificationResources](docs/V1EntitiesUsersVerificationResources.md)
640
645
  - [DealMakerAPI::V1EntitiesWebhooksDeal](docs/V1EntitiesWebhooksDeal.md)
641
646
  - [DealMakerAPI::V1EntitiesWebhooksSecurityToken](docs/V1EntitiesWebhooksSecurityToken.md)
642
647
  - [DealMakerAPI::V1EntitiesWebhooksSubscription](docs/V1EntitiesWebhooksSubscription.md)
@@ -0,0 +1,18 @@
1
+ # DealMakerAPI::SendVerificationCodeRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **login_token** | **String** | The token containing the user information. | |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'DealMakerAPI'
13
+
14
+ instance = DealMakerAPI::SendVerificationCodeRequest.new(
15
+ login_token: null
16
+ )
17
+ ```
18
+
data/docs/UserApi.md CHANGED
@@ -9,6 +9,8 @@ All URIs are relative to *http://api.dealmaker.tech*
9
9
  | [**disable_mfa**](UserApi.md#disable_mfa) | **DELETE** /users/{id}/disable_mfa | Disable all the multi-factor authentication integrations for a user |
10
10
  | [**get_two_factor_channels**](UserApi.md#get_two_factor_channels) | **GET** /users/{id}/two_factor_channels | Creates an API endpoint to return a list of existing TOTP factor |
11
11
  | [**get_user**](UserApi.md#get_user) | **GET** /users/{id} | Get user by User ID |
12
+ | [**get_verification_resources**](UserApi.md#get_verification_resources) | **GET** /users/verification/resources | Gets the verification process resources |
13
+ | [**send_verification_code**](UserApi.md#send_verification_code) | **POST** /users/verification/send_code | Sends the verification code to the user |
12
14
  | [**setup_sms_verification**](UserApi.md#setup_sms_verification) | **POST** /users/{id}/setup_sms_verification | Start a setup for a SMS Verification by creating a two factor channel of sms type |
13
15
  | [**update_user_password**](UserApi.md#update_user_password) | **PUT** /users/{id}/update_password | Update user password |
14
16
  | [**verify_factor**](UserApi.md#verify_factor) | **PUT** /users/{id}/verify_factor | Creates an API endpoint to verify an existing TOTP factor |
@@ -346,6 +348,138 @@ No authorization required
346
348
  - **Accept**: application/json
347
349
 
348
350
 
351
+ ## get_verification_resources
352
+
353
+ > <V1EntitiesUsersVerificationResources> get_verification_resources(login_token)
354
+
355
+ Gets the verification process resources
356
+
357
+ Get verification process resources
358
+
359
+ ### Examples
360
+
361
+ ```ruby
362
+ require 'time'
363
+ require 'DealMakerAPI'
364
+ # setup authorization
365
+ DealMakerAPI.configure do |config|end
366
+
367
+ api_instance = DealMakerAPI::UserApi.new
368
+ login_token = 'login_token_example' # String | The token containing the user information.
369
+
370
+ begin
371
+ # Gets the verification process resources
372
+ result = api_instance.get_verification_resources(login_token)
373
+ p result
374
+ rescue DealMakerAPI::ApiError => e
375
+ puts "Error when calling UserApi->get_verification_resources: #{e}"
376
+ end
377
+ ```
378
+
379
+ #### Using the get_verification_resources_with_http_info variant
380
+
381
+ This returns an Array which contains the response data, status code and headers.
382
+
383
+ > <Array(<V1EntitiesUsersVerificationResources>, Integer, Hash)> get_verification_resources_with_http_info(login_token)
384
+
385
+ ```ruby
386
+ begin
387
+ # Gets the verification process resources
388
+ data, status_code, headers = api_instance.get_verification_resources_with_http_info(login_token)
389
+ p status_code # => 2xx
390
+ p headers # => { ... }
391
+ p data # => <V1EntitiesUsersVerificationResources>
392
+ rescue DealMakerAPI::ApiError => e
393
+ puts "Error when calling UserApi->get_verification_resources_with_http_info: #{e}"
394
+ end
395
+ ```
396
+
397
+ ### Parameters
398
+
399
+ | Name | Type | Description | Notes |
400
+ | ---- | ---- | ----------- | ----- |
401
+ | **login_token** | **String** | The token containing the user information. | |
402
+
403
+ ### Return type
404
+
405
+ [**V1EntitiesUsersVerificationResources**](V1EntitiesUsersVerificationResources.md)
406
+
407
+ ### Authorization
408
+
409
+ No authorization required
410
+
411
+ ### HTTP request headers
412
+
413
+ - **Content-Type**: Not defined
414
+ - **Accept**: application/json
415
+
416
+
417
+ ## send_verification_code
418
+
419
+ > <V1EntitiesDeleteResult> send_verification_code(send_verification_code_request)
420
+
421
+ Sends the verification code to the user
422
+
423
+ Send the verification code to the user
424
+
425
+ ### Examples
426
+
427
+ ```ruby
428
+ require 'time'
429
+ require 'DealMakerAPI'
430
+ # setup authorization
431
+ DealMakerAPI.configure do |config|end
432
+
433
+ api_instance = DealMakerAPI::UserApi.new
434
+ send_verification_code_request = DealMakerAPI::SendVerificationCodeRequest.new({login_token: 'login_token_example'}) # SendVerificationCodeRequest |
435
+
436
+ begin
437
+ # Sends the verification code to the user
438
+ result = api_instance.send_verification_code(send_verification_code_request)
439
+ p result
440
+ rescue DealMakerAPI::ApiError => e
441
+ puts "Error when calling UserApi->send_verification_code: #{e}"
442
+ end
443
+ ```
444
+
445
+ #### Using the send_verification_code_with_http_info variant
446
+
447
+ This returns an Array which contains the response data, status code and headers.
448
+
449
+ > <Array(<V1EntitiesDeleteResult>, Integer, Hash)> send_verification_code_with_http_info(send_verification_code_request)
450
+
451
+ ```ruby
452
+ begin
453
+ # Sends the verification code to the user
454
+ data, status_code, headers = api_instance.send_verification_code_with_http_info(send_verification_code_request)
455
+ p status_code # => 2xx
456
+ p headers # => { ... }
457
+ p data # => <V1EntitiesDeleteResult>
458
+ rescue DealMakerAPI::ApiError => e
459
+ puts "Error when calling UserApi->send_verification_code_with_http_info: #{e}"
460
+ end
461
+ ```
462
+
463
+ ### Parameters
464
+
465
+ | Name | Type | Description | Notes |
466
+ | ---- | ---- | ----------- | ----- |
467
+ | **send_verification_code_request** | [**SendVerificationCodeRequest**](SendVerificationCodeRequest.md) | | |
468
+
469
+ ### Return type
470
+
471
+ [**V1EntitiesDeleteResult**](V1EntitiesDeleteResult.md)
472
+
473
+ ### Authorization
474
+
475
+ No authorization required
476
+
477
+ ### HTTP request headers
478
+
479
+ - **Content-Type**: application/json
480
+ - **Accept**: application/json
481
+
482
+
349
483
  ## setup_sms_verification
350
484
 
351
485
  > setup_sms_verification(id, setup_sms_verification_request)
@@ -4,14 +4,14 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **investment_proceeds** | **Float** | Investment Proceeds | [optional] |
8
- | **fees_and_adjustments** | **Float** | Fees and Adjustments | [optional] |
9
- | **total_proceeds** | **Float** | Total Proceeds | [optional] |
10
- | **processing_fees** | **Float** | Processing Fees | [optional] |
11
- | **invoice_deductions** | **Float** | Invoice Deductions | [optional] |
12
- | **holdback** | **Float** | Holdback | [optional] |
13
- | **paid_out** | **Float** | Paid Out | [optional] |
14
- | **available_for_payout** | **Float** | Available for Payout | [optional] |
7
+ | **investment_proceeds** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
8
+ | **fees_and_adjustments** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
9
+ | **total_proceeds** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
10
+ | **processing_fees** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
11
+ | **invoice_deductions** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
12
+ | **holdback** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
13
+ | **paid_out** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
14
+ | **available_for_payout** | [**V1EntitiesDealsProgressPageSummaryItem**](V1EntitiesDealsProgressPageSummaryItem.md) | | [optional] |
15
15
 
16
16
  ## Example
17
17
 
@@ -0,0 +1,28 @@
1
+ # DealMakerAPI::V1EntitiesDealsProgressPageSummaryItem
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **label** | **String** | Label | [optional] |
8
+ | **highlighted** | **Boolean** | Highlighted | [optional] |
9
+ | **negative** | **Boolean** | Negative | [optional] |
10
+ | **value** | **Float** | Value | [optional] |
11
+ | **link** | **String** | Link | [optional] |
12
+ | **description** | **String** | Description | [optional] |
13
+
14
+ ## Example
15
+
16
+ ```ruby
17
+ require 'DealMakerAPI'
18
+
19
+ instance = DealMakerAPI::V1EntitiesDealsProgressPageSummaryItem.new(
20
+ label: null,
21
+ highlighted: null,
22
+ negative: null,
23
+ value: null,
24
+ link: null,
25
+ description: null
26
+ )
27
+ ```
28
+
@@ -0,0 +1,22 @@
1
+ # DealMakerAPI::V1EntitiesUsersVerificationResources
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **totp_enabled** | **Boolean** | Check if on the authenticator app is set for the user. | [optional] |
8
+ | **sms_enabled** | **Boolean** | Check if on the sms verification is set for the user. | [optional] |
9
+ | **phone** | **String** | The last 4 digits of the users phone number. | [optional] |
10
+
11
+ ## Example
12
+
13
+ ```ruby
14
+ require 'DealMakerAPI'
15
+
16
+ instance = DealMakerAPI::V1EntitiesUsersVerificationResources.new(
17
+ totp_enabled: null,
18
+ sms_enabled: null,
19
+ phone: null
20
+ )
21
+ ```
22
+
@@ -338,6 +338,138 @@ module DealMakerAPI
338
338
  return data, status_code, headers
339
339
  end
340
340
 
341
+ # Gets the verification process resources
342
+ # Get verification process resources
343
+ # @param login_token [String] The token containing the user information.
344
+ # @param [Hash] opts the optional parameters
345
+ # @return [V1EntitiesUsersVerificationResources]
346
+ def get_verification_resources(login_token, opts = {})
347
+ data, _status_code, _headers = get_verification_resources_with_http_info(login_token, opts)
348
+ data
349
+ end
350
+
351
+ # Gets the verification process resources
352
+ # Get verification process resources
353
+ # @param login_token [String] The token containing the user information.
354
+ # @param [Hash] opts the optional parameters
355
+ # @return [Array<(V1EntitiesUsersVerificationResources, Integer, Hash)>] V1EntitiesUsersVerificationResources data, response status code and response headers
356
+ def get_verification_resources_with_http_info(login_token, opts = {})
357
+ if @api_client.config.debugging
358
+ @api_client.config.logger.debug 'Calling API: UserApi.get_verification_resources ...'
359
+ end
360
+ # verify the required parameter 'login_token' is set
361
+ if @api_client.config.client_side_validation && login_token.nil?
362
+ fail ArgumentError, "Missing the required parameter 'login_token' when calling UserApi.get_verification_resources"
363
+ end
364
+ # resource path
365
+ local_var_path = '/users/verification/resources'
366
+
367
+ # query parameters
368
+ query_params = opts[:query_params] || {}
369
+ query_params[:'login_token'] = login_token
370
+
371
+ # header parameters
372
+ header_params = opts[:header_params] || {}
373
+ # HTTP header 'Accept' (if needed)
374
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
375
+
376
+ # form parameters
377
+ form_params = opts[:form_params] || {}
378
+
379
+ # http body (model)
380
+ post_body = opts[:debug_body]
381
+
382
+ # return_type
383
+ return_type = opts[:debug_return_type] || 'V1EntitiesUsersVerificationResources'
384
+
385
+ # auth_names
386
+ auth_names = opts[:debug_auth_names] || []
387
+
388
+ new_options = opts.merge(
389
+ :operation => :"UserApi.get_verification_resources",
390
+ :header_params => header_params,
391
+ :query_params => query_params,
392
+ :form_params => form_params,
393
+ :body => post_body,
394
+ :auth_names => auth_names,
395
+ :return_type => return_type
396
+ )
397
+
398
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
399
+ if @api_client.config.debugging
400
+ @api_client.config.logger.debug "API called: UserApi#get_verification_resources\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
401
+ end
402
+ return data, status_code, headers
403
+ end
404
+
405
+ # Sends the verification code to the user
406
+ # Send the verification code to the user
407
+ # @param send_verification_code_request [SendVerificationCodeRequest]
408
+ # @param [Hash] opts the optional parameters
409
+ # @return [V1EntitiesDeleteResult]
410
+ def send_verification_code(send_verification_code_request, opts = {})
411
+ data, _status_code, _headers = send_verification_code_with_http_info(send_verification_code_request, opts)
412
+ data
413
+ end
414
+
415
+ # Sends the verification code to the user
416
+ # Send the verification code to the user
417
+ # @param send_verification_code_request [SendVerificationCodeRequest]
418
+ # @param [Hash] opts the optional parameters
419
+ # @return [Array<(V1EntitiesDeleteResult, Integer, Hash)>] V1EntitiesDeleteResult data, response status code and response headers
420
+ def send_verification_code_with_http_info(send_verification_code_request, opts = {})
421
+ if @api_client.config.debugging
422
+ @api_client.config.logger.debug 'Calling API: UserApi.send_verification_code ...'
423
+ end
424
+ # verify the required parameter 'send_verification_code_request' is set
425
+ if @api_client.config.client_side_validation && send_verification_code_request.nil?
426
+ fail ArgumentError, "Missing the required parameter 'send_verification_code_request' when calling UserApi.send_verification_code"
427
+ end
428
+ # resource path
429
+ local_var_path = '/users/verification/send_code'
430
+
431
+ # query parameters
432
+ query_params = opts[:query_params] || {}
433
+
434
+ # header parameters
435
+ header_params = opts[:header_params] || {}
436
+ # HTTP header 'Accept' (if needed)
437
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
438
+ # HTTP header 'Content-Type'
439
+ content_type = @api_client.select_header_content_type(['application/json'])
440
+ if !content_type.nil?
441
+ header_params['Content-Type'] = content_type
442
+ end
443
+
444
+ # form parameters
445
+ form_params = opts[:form_params] || {}
446
+
447
+ # http body (model)
448
+ post_body = opts[:debug_body] || @api_client.object_to_http_body(send_verification_code_request)
449
+
450
+ # return_type
451
+ return_type = opts[:debug_return_type] || 'V1EntitiesDeleteResult'
452
+
453
+ # auth_names
454
+ auth_names = opts[:debug_auth_names] || []
455
+
456
+ new_options = opts.merge(
457
+ :operation => :"UserApi.send_verification_code",
458
+ :header_params => header_params,
459
+ :query_params => query_params,
460
+ :form_params => form_params,
461
+ :body => post_body,
462
+ :auth_names => auth_names,
463
+ :return_type => return_type
464
+ )
465
+
466
+ data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
467
+ if @api_client.config.debugging
468
+ @api_client.config.logger.debug "API called: UserApi#send_verification_code\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
469
+ end
470
+ return data, status_code, headers
471
+ end
472
+
341
473
  # Start a setup for a SMS Verification by creating a two factor channel of sms type
342
474
  # Start a setup for a SMS Verification by creating a two factor channel of sms type
343
475
  # @param id [Integer]