Class: FinchAPI::Resources::Jobs::Automated

Inherits:
Object
  • Object
show all
Defined in:
lib/finch_api/resources/jobs/automated.rb

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ Automated

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Automated.

Parameters:



92
93
94
 
# File 'lib/finch_api/resources/jobs/automated.rb', line 92

def initialize(client:)
  @client = client
end

Instance Method Details

#create(type: , params: , request_options: {}) ⇒ FinchAPI::Models::Jobs::AutomatedCreateResponse

Enqueue an automated job.

‘data_sync_all`: Enqueue a job to re-sync all data for a connection. `data_sync_all` has a concurrency limit of 1 job at a time per connection. This means that if this endpoint is called while a job is already in progress for this connection, Finch will return the `job_id` of the job that is currently in progress. Finch allows a fixed window rate limit of 1 forced refresh per hour per connection.

‘w4_form_employee_sync`: Enqueues a job for sync W-4 data for a particular individual, identified by `individual_id`. This feature is currently in beta.

This endpoint is available for Scale tier customers as an add-on. To request access to this endpoint, please contact your Finch account manager.

Parameters:

  • type (Symbol, FinchAPI::Jobs::AutomatedCreateParams::Type) —

    The type of job to start.

  • params (FinchAPI::Jobs::AutomatedCreateParams::Params)
  • request_options (FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



33
34
35
36
37
38
39
40
41
42
 
# File 'lib/finch_api/resources/jobs/automated.rb', line 33

def create(params)
  parsed, options = FinchAPI::Jobs::AutomatedCreateParams.dump_request(params)
  @client.request(
    method: :post,
    path: "jobs/automated",
    body: parsed,
    model: FinchAPI::Models::Jobs::AutomatedCreateResponse,
    options: options
  )
end

#list(limit: nil, offset: nil, request_options: {}) ⇒ FinchAPI::Models::Jobs::AutomatedListResponse

Get all automated jobs. Automated jobs are completed by a machine. By default, jobs are sorted in descending order by submission time. For scheduled jobs such as data syncs, only the next scheduled job is shown.

Parameters:

  • limit (Integer) —

    Number of items to return

  • offset (Integer) —

    Index to start from (defaults to 0)

  • request_options (FinchAPI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



78
79
80
81
82
83
84
85
86
87
 
# File 'lib/finch_api/resources/jobs/automated.rb', line 78

def list(params = {})
  parsed, options = FinchAPI::Jobs::AutomatedListParams.dump_request(params)
  @client.request(
    method: :get,
    path: "jobs/automated",
    query: parsed,
    model: FinchAPI::Models::Jobs::AutomatedListResponse,
    options: options
  )
end

#retrieve(job_id, request_options: {}) ⇒ FinchAPI::Jobs::AutomatedAsyncJob

Get an automated job by ‘job_id`.

Parameters:

Returns:

See Also:



54
55
56
57
58
59
60
61
 
# File 'lib/finch_api/resources/jobs/automated.rb', line 54

def retrieve(job_id, params = {})
  @client.request(
    method: :get,
    path: ["jobs/automated/%1$s", job_id],
    model: FinchAPI::Jobs::AutomatedAsyncJob,
    options: params[:request_options]
  )
end