curl --request POST \
--url https://api.redbark.com/v2/connections/{id}/reauthorize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Redbark-Version: <api-key>' \
--data '
{
"return_url": "<string>"
}
'const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Redbark-Version': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({return_url: '<string>'})
};
fetch('https://api.redbark.com/v2/connections/{id}/reauthorize', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.redbark.com/v2/connections/{id}/reauthorize"
payload = { "return_url": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Redbark-Version": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "ls_7Kp3Lm5nQr7sTu9vWx1yZa",
"object": "link_session",
"provider": "fiskil",
"institution": "<string>",
"status": "pending",
"url": "<string>",
"connection": "<string>",
"start_token": "<string>",
"return_url": "<string>",
"failure_reason": "<string>",
"expires_at": "2026-08-21T09:30:00.000Z",
"completed_at": "2026-08-21T09:30:00.000Z",
"metadata": {},
"livemode": true,
"created": "2026-08-21T09:30:00.000Z",
"updated": "2026-08-21T09:30:00.000Z"
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Reauthorize a connection
Returns a link session bound to this connection. Completing it renews the existing connection in place: the connection keeps its id and its accounts, no new connection is created, and exactly one connection.refreshed event is emitted. Fiskil amends the same consent and resets its period, SnapTrade reconnects the same brokerage authorization, Akahu restores the same bank, and Plaid reopens Plaid Link in update mode on the same Item. A reauthorization takes no connection slot. Returns 404 resource_missing when the connection no longer exists (for example once an expired consent has been deleted), in which case start a new link session instead, and 403 subscription_required when the account has no active trial or subscription.
curl --request POST \
--url https://api.redbark.com/v2/connections/{id}/reauthorize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Redbark-Version: <api-key>' \
--data '
{
"return_url": "<string>"
}
'const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Redbark-Version': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({return_url: '<string>'})
};
fetch('https://api.redbark.com/v2/connections/{id}/reauthorize', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.redbark.com/v2/connections/{id}/reauthorize"
payload = { "return_url": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Redbark-Version": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "ls_7Kp3Lm5nQr7sTu9vWx1yZa",
"object": "link_session",
"provider": "fiskil",
"institution": "<string>",
"status": "pending",
"url": "<string>",
"connection": "<string>",
"start_token": "<string>",
"return_url": "<string>",
"failure_reason": "<string>",
"expires_at": "2026-08-21T09:30:00.000Z",
"completed_at": "2026-08-21T09:30:00.000Z",
"metadata": {},
"livemode": true,
"created": "2026-08-21T09:30:00.000Z",
"updated": "2026-08-21T09:30:00.000Z"
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Authorization: Bearer rbk_live_...
The API release your integration is built against, e.g. 2026-10-01.wattle. Required on every request.
Path Parameters
The id of the object.
"conn_2Bc4De6fGh8jKl0mNp3qRs"
Body
Response
The link session
"ls_7Kp3Lm5nQr7sTu9vWx1yZa"
link_session fiskil, akahu, snaptrade, plaid pending, completed, expired, failed Hosted page to send the user to while pending
Returned once, in the creating response, and only to Redbark's own apps; null everywhere else. Send it as the X-Redbark-Link-Start request header when opening url.
"2026-08-21T09:30:00.000Z"
"2026-08-21T09:30:00.000Z"
Up to 50 string pairs. Set a key to null in an update to unset it.
Show child attributes
Show child attributes
"2026-08-21T09:30:00.000Z"
"2026-08-21T09:30:00.000Z"

