CorebanqCorebanq Developer Docs
Currenciesv1

Delete currency (hard delete)

Handler: DeleteCurrencyByID. Requires RBAC PermDelete. Physically removes the row (hard delete, not a deactivation). Success: apireply.Ok200 -> StdResponse { status, message }. To take a currency out of use while keeping it, set active=false via PUT instead.

DELETE
/v1/currencies/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/currencies/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "status": 200,
  "message": "OK"
}
{
  "status": 401,
  "message": "Unauthorized"
}
{
  "status": 403,
  "message": "Forbidden"
}
{
  "status": 404,
  "message": "Not found"
}
{
  "status": 500,
  "message": "server_error"
}

GETGet currency by ID

Handler: GetCurrencyByID → SrvGetCurrencyByID. Requires RBAC PermRead on the currency record. icon_url is rewritten using config currencies.icon.pattern before response. The id path parameter is parsed with uuid.MustParse, so a malformed UUID is not returned as a 400; supply a valid UUID.

POSTCreate currency

Handler: CreateNewCurrency. Requires RBAC PermCreate on currencies record type. Returns created models.Currency. NOTE: duplicate name (DB unique on name) currently returns 500, not 409.