POST
/
jobs
/
automated
curl --request POST \
  --url https://api.tryfinch.com/jobs/automated \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --header 'Finch-API-Version: <finch-api-version>'
{
  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "job_url": "https://api.tryfinch.com/jobs/automated/453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "allowed_refreshes": 2,
  "remaining_refreshes": 1
}

Currently, only the data_sync_all job type is supported, which will 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.

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

Authorizations

Authorization
string
headerrequired

Please use your Access Token

Headers

Finch-API-Version
string
default: 2020-09-17required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Content-Type
string
default: application/jsonrequired

Used to indicate the original media type of the resource

Body

type
enum<string>
required

The type of job to start. Currently the only supported type is data_sync_all

Available options:
data_sync_all

Response

201 - application/json
job_id
string

The id of the job that has been created.

job_url
string

The url that can be used to retrieve the job status

allowed_refreshes
integer

The number of allowed refreshes per hour (per hour, fixed window)

remaining_refreshes
integer

The number of remaining refreshes available (per hour, fixed window)

Was this page helpful?