---
title: "Changes to Register an instrument for a client"
method: POST
path: "/v1/clients/{clientId}/instruments"
---

# Changes to Register an instrument for a client

`POST /v1/clients/{clientId}/instruments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-09-26** `e22ef66945df`: 14 breaking, 7 warning, 8 info

## Changes

- **2026-09-26** `e22ef66945df`: 14 breaking, 7 warning, 8 info
  - for the `path` request parameter `clientId`, the format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[subschema #2]/virtual_clabe/clabe_number` request property's minLength was increased from `0` to `18`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[subschema #2]/debit_card/card_number` request property's minLength was increased from `0` to `16`
  - added the pattern `^[0-9]{10,12}$` to the request property `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[subschema #2]/virtual_clabe/account_number`
  - added the pattern `^[0-9]{16}$` to the request property `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[subschema #2]/debit_card/card_number`
  - added the pattern `^[0-9]{18}$` to the request property `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[subschema #2]/virtual_clabe/clabe_number`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/client_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/customer_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/source_bank_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[subschema #2]/virtual_clabe/destination_bank_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/client_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/customer_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/source_bank_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[subschema #2]/debit_card/destination_bank_id` request property format changed from no format to `uuid`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/rfc` request property's maxLength was set to `13`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[subschema #2]/virtual_clabe/clabe_number` request property's maxLength was set to `18`
  - the `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[subschema #2]/virtual_clabe/holder_name` request property's maxLength was set to `40`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/rfc` request property's maxLength was set to `13`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[subschema #2]/debit_card/card_number` request property's maxLength was set to `16`
  - the `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[subschema #2]/debit_card/holder_name` request property's maxLength was set to `40`
  - added the new `SENDER_RECEIVER` enum value to the `allOf[#/components/schemas/InstrumentBaseResponse]/type` response property for the response status `200`
  - api tag `Instruments` added
  - removed request discriminator
  - added the new `SENDER_RECEIVER` enum value to the request property `oneOf[#/components/schemas/RegisterClabeRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/type`
  - added the new `SENDER_RECEIVER` enum value to the request property `oneOf[#/components/schemas/RegisterDebitCardRequest]/allOf[#/components/schemas/RegisterInstrumentBase]/type`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`

---

[Operation](https://skmtc.dev/monato/apis/fincore-api/docs/v1/clients/:clientId/instruments/post.md) - [API](https://skmtc.dev/monato/apis/fincore-api.md) - [Page](https://skmtc.dev/monato/apis/fincore-api/changes/v1/clients/:clientId/instruments/post)