SimpleFIN

Revoke access credentials

Permanently invalidates the connection's SimpleFIN credentials (and any unclaimed setup token). Actual's subsequent pulls receive an authorization error until the account is relinked with a new connection.

POST

/destinations/simplefin/connections/{connectionId}/revoke

curl --request POST \
  --url https://api.synci.io/api/v1/destinations/simplefin/connections/{connectionId}/revoke \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "accounts": [
      {
        "financial_account_id": "<string>",
        "first_pulled_at": "<string>",
        "id": "<string>",
        "last_pulled_at": "<string>",
        "name": "<string>",
        "still_shared": "<string>"
      }
    ],
    "all_accounts": true,
    "app": "<string>",
    "claimed_at": "<string>",
    "created_at": "<string>",
    "enabled": "<string>",
    "financial_accounts": [
      "<string>"
    ],
    "health": {
      "failure_count": "<string>",
      "integrator_message": "<string>",
      "last_attempt_at": "<string>",
      "status": "<string>",
      "transient_failure_count": "<string>",
      "transient_message": "<string>"
    },
    "id": "<string>",
    "last_pulled_at": "<string>",
    "name": "<string>",
    "revoked_at": "<string>",
    "setup_token": "<string>",
    "setup_token_expires_at": "<string>",
    "status": "<string>",
    "updated_at": "<string>"
  },
  "message": "SimpleFIN connection revoked."
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

connectionIdintegerrequired

The SimpleFIN connection ID

Response

dataobjectrequired

Show child attributes

messagestringrequired

Still need help? Ask the team