---
title: "Accept assigned agreement"
method: PATCH
path: "/onboarding/v1/assigned-agreements/{assignedAgreementId}"
tags: ["Onboarding"]
---

# Accept assigned agreement

`PATCH /onboarding/v1/assigned-agreements/{assignedAgreementId}`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/onboarding/v1/assigned-agreements/{assignedAgreementId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/onboarding/v1/assigned-agreements/:assignedAgreementId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Accepts an assigned agreement. Agreement status transitions from `PENDING` to `ACCEPTED`.

Use the `assignedAgreementId` returned by `GET /onboarding/v1/assigned-agreements?applicationId={id}`. All assigned agreements must be accepted before onboarding can complete.

## Path parameters

- `assignedAgreementId` string, uuid, required

## Response `200`

Agreement accepted

- OnboardingAssignedAgreementAcceptResponse
  - `status` 'ACCEPTED', required
  - `respondedAt` string, date-time, required
  - `respondedBy` object, required
    - `type` string, required
    - `username` string, required

## Other responses

- `401`: Unauthorized
- `404`: The specified resource was not found

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/onboarding/v1/assigned-agreements/:assignedAgreementId/patch.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)