Modify a link's data retrieval

PATCH {{baseUrl}}/api/links/:id/

Documentation 📖

Modify the data retrieval settings for a specific link. For more details, make sure to check out our API reference.

At present you can:

• Change a link's access mode from single to recurrent or from recurrent to single.

• Modify the historical resources you want to retrieve for the link (fetch_resources).

Changing a link's access_mode

When you change a link from single to recurrent, the next day a historical update of the core resources for the link is triggered (resulting in you receiving historical_update webhooks for the link). You are billed for these historical updates.

Modifying fetch_resources

If you only modify the fetch_resources for a link, this will not trigger a historical update. In order to trigger a historical update for the link, you must change the access_mode to recurrent.

Request Body

{"access_mode"=>"choose_single_or_recurrent", "fetch_resources"=>["ARRAY", "OF", "RESOURCES"]}

HEADERS