Overview
POST/integrations/providers/{providerId}/link-tokenintegrations

Mint a Plaid Link token

Only valid for plaid_link providers (400 otherwise). 404 for an unknown provider. The link token is minted for the target ecosystem `ecosystemId`; the caller must manage it (404/403 when unknown / not the caller's).

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • providerIdpathstring
Request body

application/json · optional

  • ecosystemIdstring

    Target ecosystem id (the caller must manage it)

  • serviceTypeoptionalstring

    Defaults to the provider primary service type

Example
{
  "ecosystemId": "string",
  "serviceType": "string"
}
Responses
200

Plaid link token

  • linkTokenstring
Example
{
  "linkToken": "string"
}
400

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
401

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
403

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
404

Problem Details (RFC 9457)

  • typeoptionalstring

    URI identifying the problem type; 'about:blank' when unspecified

  • titlestring

    Short, human-readable summary of the problem type

  • statusinteger

    HTTP status code, duplicated in the body

  • detailoptionalstring

    Explanation specific to this occurrence

  • instanceoptionalstring

    URI reference for this occurrence (the request path)

Example
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/integrations/providers/{providerId}/link-token" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ecosystemId": "string",
  "serviceType": "string"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/integrations/providers/{providerId}/link-token", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"ecosystemId\": \"string\",\n  \"serviceType\": \"string\"\n}",
});
const data = await res.json();