---
title: "Resolve a live delegate capability to its exact task subset"
method: POST
path: "/onboarding/v3/delegate/resolve"
tags: ["Onboarding"]
---

# Resolve a live delegate capability to its exact task subset

`POST /onboarding/v3/delegate/resolve`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/onboarding/v3/delegate/resolve`
- Auth: none required

This endpoint has no app session. The raw capability stays in a focused JSON body so it cannot enter request paths, proxy logs, or metric labels. Unknown, expired, revoked, and malformed capabilities share one 404 shape.

## Headers

- `X-Median-App-Surface` 'qa'

## Request body

- OnboardingV3DelegateResolve
  - `token` string, required

## Response `200`

Filtered setup-state subset without invite identity or recipient metadata

- OnboardingV3DelegateViewApiResponse
  - `success` true, required
  - `data` OnboardingV3DelegateView, required: The state collections are a strict subset of taskIds; recipient identity, invite identifiers, and task owners are never returned.
    - `taskIds` OnboardingV3DelegatedTaskId[], required
    - `state` OnboardingV3DelegateSetupState, required: Every tasks, data, and deferred taskId key belongs to the taskIds advertised by the containing delegate view. Incomplete task records are omitted; completed records expose only status and never owner identity.
      - `tasks` OnboardingV3DelegateTaskRecord, required
      - `data` OnboardingV3DelegateDataRecord, required
      - `deferred` OnboardingV3DelegateDeferredItem[], required
        - `id` string, required
        - `label` string, required
        - `ask` string
        - `taskId` 'processors' | 'payroll' | 'documents' | 'books', required: Tasks a delegate can complete without owner-only bank or history authority. Connect and history remain assigned to the signed-in owner.
      - `updatedAt` string, date-time, required

## Other responses

- `400`: Onboarding request body is not valid JSON
- `404`: Resource not found
- `413`: Onboarding setup request exceeds the 32768-byte route limit
- `415`: Onboarding request charset or content encoding is unsupported
- `422`: Validation error
- `429`: Rate limited by source address

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)