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

| Key | Datatype | Required | Description | | Content-Type | string | | |

RESPONSES

status: ``