# Check the Plaid onboarding with Plaid

Ask Plaid where the end customer's review stands and which OAuth banks have registered it, and store the answer. `note` carries a sentence when the bank list could not be read. Admin only.

Access class: `workspace:admin`.

## Endpoint

`POST /v1/integrations/plaid/partner/refresh`

## Request body

Content type: `application/json`.

```json
{}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "configured": true,
    "customer": {
      "active": true,
      "application": {},
      "companyName": "string",
      "createdAt": "2026-01-01T00:00:00Z",
      "endCustomerClientId": "",
      "flowdownStatus": "string",
      "lastOauthSyncAt": "2026-01-01T00:00:00Z",
      "oauthInstitutions": [
        "string"
      ],
      "productionSecretSet": true,
      "questionnaireStatus": "string",
      "sandboxSecretSet": true,
      "status": "string",
      "updatedAt": "2026-01-01T00:00:00Z"
    },
    "note": "string"
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
