Upsert bank account

PUT/v1/bank-accounts/{bankAccountId}

Path parameters

bankAccountId string required

An opaque workspace_bank_account resource identifier.

Example01JQ2T5Y5Q3R8W9N6M4K2H7P1G

Body parameters

application/json · required

label string nullable

Human-readable label for the value.

Maximum length: 2048 characters.

ExampleOperating account

bankName string nullable

bank name for this bank account.

Maximum length: 2048 characters.

ExampleNQD Bank

accountName string nullable

account name for this bank account.

Maximum length: 2048 characters.

ExampleOperating account

accountNumber string nullable

account number for this bank account.

Maximum length: 2048 characters.

ExampleConsulting services

iban string nullable

iban for this bank account.

Maximum length: 2048 characters.

ExampleSA0380000000608010167519

currencyId string nullable

Currency identifier for the amount. It selects the currency metadata used by the record.

Minimum length: 1 character. · Maximum length: 128 characters.

Example01JQ2T5Y5Q3R8W9N6M4K2H7P1F

Headers

authorization string required

Bearer workspace API key.

ExampleBearer $NQD_API_KEY

workspace-id string required

Workspace scope for the request. Required for workspace operations and must belong to the authenticated identity.

Minimum length: 1 character. · Maximum length: 128 characters.

Example01JQ2T5Y5Q3R8W9N6M4K2H7P1A

Send the complete writable representation or change set. Use the latest updatedAt for If-Match.

Response

200Success

Response headers

x-request-id string

Correlation identifier returned with every response for support and request tracing.

Example550e8400-e29b-41d4-a716-446655440000

data object

Returned records. Collections and batches use an array; single records use an object.

ShowHide 10 properties

data.id string

Opaque identifier for this resource or reference.

Example01JQ2T5Y5Q3R8W9N6M4K2H7P1G

data.label string

Human-readable label for the value.

ExampleOperating account

data.bankName string

bank name for this bank account.

ExampleNQD Bank

data.accountName string

account name for this bank account.

ExampleOperating account

data.accountNumber string

account number for this bank account.

ExampleConsulting services

data.iban string

iban for this bank account.

ExampleSA0380000000608010167519

data.currencyId string

Currency identifier for the amount. It selects the currency metadata used by the record.

Examplenull

data.archivedAt string

ISO 8601 timestamp when the record was archived, or null when it is active.

Examplenull

data.createdAt string

ISO 8601 timestamp for the authored or payment event. Recurring records preserve their scheduled occurrence.

Example2026-01-15T12:00:00.000Z

data.updatedAt string

Timestamp used for stale-edit protection. Preserve the server value when updating.

Example2026-01-15T12:00:00.000Z

Possible errors

400 Invalid request

Response headers

x-request-id string

Correlation identifier returned with every response for support and request tracing.

Example550e8400-e29b-41d4-a716-446655440000

error object

Error details returned for a failed request.

ShowHide 4 properties

error.code string

Stable machine-readable error or resource code.

Exampleinvalid_input

error.message string

Human-readable explanation of the result or error.

ExampleThe request could not be validated.

error.requestId string

Correlation identifier for support and request tracing.

Example550e8400-e29b-41d4-a716-446655440000

error.details object nullable

Additional structured details about the result or error.

ShowHide 1 property

error.details.issues object[]

Structured field issues returned when request validation fails.

ShowHide 3 properties

error.details.issues[].path string | number[]

Field path where the validation issue occurred.

One of: string alternative 1, number alternative 2

Example0 items

error.details.issues[].reason string

Machine-readable reason for the validation issue.

Allowed values: "expected_type", "required", "unexpected_property", "invalid_value", "invalid_json", "invalid_query", "unsupported_media_type", "body_too_large", "body_timeout", "conflicting_scope", "missing_header", "concurrency_required", "invalid_resource_id", "invalid_request"

Exampleinvalid_request

error.details.issues[].code string nullable

Stable machine-readable error or resource code.

Exampleinvalid_input

{
  "error": {
    "code": "invalid_input",
    "message": "The request could not be validated.",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "details": {
      "issues": [
        {
          "path": [],
          "reason": "invalid_request"
        }
      ]
    }
  }
}

View raw OpenAPI operation

Use the machine-readable contract for client generation and payload validation.

Open OpenAPI contract ↗

 
curl --include --fail-with-body --request PUT "${NQD_API_URL:-http://api.nqd.localhost:1335}/v1/bank-accounts/01JQ2T5Y5Q3R8W9N6M4K2H7P1G" \
  -H "Authorization: Bearer $NQD_API_KEY" \
  -H "Workspace-Id: $NQD_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  --data '{}'
Response 200   
{
  "data": {
    "id": "01JQ2T5Y5Q3R8W9N6M4K2H7P1G",
    "label": "Operating account",
    "bankName": "NQD Bank",
    "accountName": "Operating account",
    "accountNumber": "Consulting services",
    "iban": "SA0380000000608010167519",
    "currencyId": null,
    "archivedAt": null,
    "createdAt": "2026-01-15T12:00:00.000Z",
    "updatedAt": "2026-01-15T12:00:00.000Z"
  }
}