Skip to main content
POST
/
v1
/
link-access-tokens
Retrieve a Link Token
curl --request POST \
  --url https://api.example.com/v1/link-access-tokens

​
Description

This endpoint exchanges a bridge public token for a link access token, facilitating the connection between the Bridge SDK and the API. The operation enables developers to convert a public token generated by the Bridge interface into a functional access token for API operations.

​
Authentication

Required Credentials:
  • Client ID (header)
  • Access Key (header)

​
Request Body Parameters

ParameterTypeRequiredDescription
public_tokenstringYesThe token received from the Bridge after user connection

​
Response

​
Success Response (201 Created)

{
  "access_token": "string",
  "link_id": "string",
  "user_id": "string",
  "expires_in": "integer"
}

​
Error Responses

400 Bad Request: Occurs when required parameters are missing or malformed. The response includes specific field-level validation errors. 401 Unauthorized: Triggered when authentication credentials are invalid or missing. 
{
  "error": {
    "code": "authentication_failed",
    "message": "No such token"
  }
}
403 Forbidden: Returned when credentials lack sufficient permissions. 
{
  "error": {
    "code": "not_authenticated",
    "message": "Authentication credentials were not provided."
  }
}