Jump to

• Request
• Response

Bulk Create Organization Networks

post

/v1/uwaas/orgs/{orgId}/organization-networks

Create one to ten organization-network configurations synchronously for the organization identified by external `orgId`. For each organization-network, existing resources referenced by the configuration must already exist within the system.

Request

Path Parameters

• orgId(required): string
  External organization identifier.

  Example:

  org-founder-bank

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• items(required): array items
  Minimum Number of Items: 1

  Maximum Number of Items: 10

{
    "type":"object",
    "additionalProperties":false,
    "properties":{
        "items":{
            "type":"array",
            "minItems":1,
            "maxItems":10,
            "items":{
                "$ref":"#/components/schemas/CreateOrganizationNetworkRequest"
            }
        }
    },
    "required":[
        "items"
    ]
}

Nested Schema : items

Type: array

Minimum Number of Items: 1

Maximum Number of Items: 10

Show Source

• Array of: object CreateOrganizationNetworkRequest

{
    "type":"array",
    "minItems":1,
    "maxItems":10,
    "items":{
        "$ref":"#/components/schemas/CreateOrganizationNetworkRequest"
    }
}

Nested Schema : CreateOrganizationNetworkRequest

Type: object

Show Source

• accessType(required): string
  Allowed Values: [ "INSTANCE", "GLOBAL" ]

  Example: INSTANCE
• blockchainType(required): string
  Maximum Length: 64

  Example: BESU
• chainId(required): string
  Maximum Length: 128

  Example: 1500
• instanceId(required): string
  Maximum Length: 255

  Example: 4fb56966-7646-487b-9a5f-747162e919fd-org8
• status(required): string
  Allowed Values: [ "ACTIVE", "INACTIVE" ]

  Example: ACTIVE

{
    "type":"object",
    "additionalProperties":false,
    "properties":{
        "accessType":{
            "$ref":"#/components/schemas/OrganizationNetworkAccessType"
        },
        "instanceId":{
            "type":"string",
            "maxLength":255,
            "example":"4fb56966-7646-487b-9a5f-747162e919fd-org8"
        },
        "blockchainType":{
            "type":"string",
            "maxLength":64,
            "example":"BESU"
        },
        "chainId":{
            "type":"string",
            "maxLength":128,
            "example":"1500"
        },
        "status":{
            "$ref":"#/components/schemas/OrganizationNetworkStatus"
        }
    },
    "required":[
        "accessType",
        "instanceId",
        "blockchainType",
        "chainId",
        "status"
    ]
}

Back to Top

Response

Supported Media Types

• application/json

201 Response

Organization networks created successfully.

Body ()

Root Schema : BulkCreateOrganizationNetworksResponse

Type: object

Show Source

• items(required): array items

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/OrganizationNetworkResponse"
            }
        }
    },
    "required":[
        "items"
    ]
}

Nested Schema : items

Type: array

Show Source

• Array of: object OrganizationNetworkResponse

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/OrganizationNetworkResponse"
    }
}

Nested Schema : OrganizationNetworkResponse

Type: object

Show Source

• accessType(required): string
  Allowed Values: [ "INSTANCE", "GLOBAL" ]

  Example: INSTANCE
• blockchainType(required): string
  Maximum Length: 64

  Example: BESU
• chainId(required): string
  Maximum Length: 128

  Example: 1337
• createdAt: string (date-time)
• createdBy: string
  Example: system
• instanceId(required): string
  Example: besu-instance-1
• organizationNetworkId(required): integer (int64)
  Example: 1
• orgId(required): string
  External organization identifier from orgId.

  Example: default_org
• rpcProxyUrl(required): string
  Maximum Length: 500

  Example: http://rpc-proxy.default.svc:8545
• status(required): string
  Allowed Values: [ "ACTIVE", "INACTIVE" ]

  Example: ACTIVE
• updatedAt: string (date-time)
• updatedBy: string
  Example: system
• walletServiceUrl(required): string
  Maximum Length: 500

  Example: http://obp-besu-wallet-service.default.svc:8080

{
    "type":"object",
    "properties":{
        "organizationNetworkId":{
            "type":"integer",
            "format":"int64",
            "example":1
        },
        "orgId":{
            "type":"string",
            "description":"External organization identifier from orgId.",
            "example":"default_org"
        },
        "accessType":{
            "$ref":"#/components/schemas/OrganizationNetworkAccessType"
        },
        "instanceId":{
            "type":"string",
            "example":"besu-instance-1"
        },
        "blockchainType":{
            "type":"string",
            "maxLength":64,
            "example":"BESU"
        },
        "chainId":{
            "type":"string",
            "maxLength":128,
            "example":"1337"
        },
        "rpcProxyUrl":{
            "type":"string",
            "maxLength":500,
            "example":"http://rpc-proxy.default.svc:8545"
        },
        "walletServiceUrl":{
            "type":"string",
            "maxLength":500,
            "example":"http://obp-besu-wallet-service.default.svc:8080"
        },
        "status":{
            "$ref":"#/components/schemas/OrganizationNetworkStatus"
        },
        "createdBy":{
            "type":"string",
            "nullable":true,
            "example":"system"
        },
        "updatedBy":{
            "type":"string",
            "nullable":true,
            "example":"system"
        },
        "createdAt":{
            "type":"string",
            "format":"date-time",
            "nullable":true
        },
        "updatedAt":{
            "type":"string",
            "format":"date-time",
            "nullable":true
        }
    },
    "required":[
        "organizationNetworkId",
        "orgId",
        "accessType",
        "instanceId",
        "blockchainType",
        "chainId",
        "rpcProxyUrl",
        "walletServiceUrl",
        "status"
    ]
}

400 Response

Bad request.

Body ()

Root Schema : Error

Type: object

Show Source

• details(required): array details
• error(required): string
  Example: Wallet Not Found
• errorCode(required): string
  Example: WALLET_NOT_FOUND
• message(required): string
  Example: Wallet with id 123 was not found.
• path(required): string
  Example: /v1/uwaas/wallets/123
• status(required): integer
  Example: 404
• timestamp(required): string (date-time)
  Example: 2026-07-16T14:23:11.123Z

{
    "type":"object",
    "properties":{
        "timestamp":{
            "type":"string",
            "format":"date-time",
            "example":"2026-07-16T14:23:11.123Z"
        },
        "status":{
            "type":"integer",
            "example":404
        },
        "error":{
            "type":"string",
            "example":"Wallet Not Found"
        },
        "path":{
            "type":"string",
            "example":"/v1/uwaas/wallets/123"
        },
        "errorCode":{
            "type":"string",
            "example":"WALLET_NOT_FOUND"
        },
        "message":{
            "type":"string",
            "example":"Wallet with id 123 was not found."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "timestamp",
        "status",
        "error",
        "path",
        "errorCode",
        "message",
        "details"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

403 Response

Forbidden.

Body ()

Root Schema : Error

Type: object

Show Source

• details(required): array details
• error(required): string
  Example: Wallet Not Found
• errorCode(required): string
  Example: WALLET_NOT_FOUND
• message(required): string
  Example: Wallet with id 123 was not found.
• path(required): string
  Example: /v1/uwaas/wallets/123
• status(required): integer
  Example: 404
• timestamp(required): string (date-time)
  Example: 2026-07-16T14:23:11.123Z

{
    "type":"object",
    "properties":{
        "timestamp":{
            "type":"string",
            "format":"date-time",
            "example":"2026-07-16T14:23:11.123Z"
        },
        "status":{
            "type":"integer",
            "example":404
        },
        "error":{
            "type":"string",
            "example":"Wallet Not Found"
        },
        "path":{
            "type":"string",
            "example":"/v1/uwaas/wallets/123"
        },
        "errorCode":{
            "type":"string",
            "example":"WALLET_NOT_FOUND"
        },
        "message":{
            "type":"string",
            "example":"Wallet with id 123 was not found."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "timestamp",
        "status",
        "error",
        "path",
        "errorCode",
        "message",
        "details"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

404 Response

Requested resource was not found.

Body ()

Root Schema : Error

Type: object

Show Source

• details(required): array details
• error(required): string
  Example: Wallet Not Found
• errorCode(required): string
  Example: WALLET_NOT_FOUND
• message(required): string
  Example: Wallet with id 123 was not found.
• path(required): string
  Example: /v1/uwaas/wallets/123
• status(required): integer
  Example: 404
• timestamp(required): string (date-time)
  Example: 2026-07-16T14:23:11.123Z

{
    "type":"object",
    "properties":{
        "timestamp":{
            "type":"string",
            "format":"date-time",
            "example":"2026-07-16T14:23:11.123Z"
        },
        "status":{
            "type":"integer",
            "example":404
        },
        "error":{
            "type":"string",
            "example":"Wallet Not Found"
        },
        "path":{
            "type":"string",
            "example":"/v1/uwaas/wallets/123"
        },
        "errorCode":{
            "type":"string",
            "example":"WALLET_NOT_FOUND"
        },
        "message":{
            "type":"string",
            "example":"Wallet with id 123 was not found."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "timestamp",
        "status",
        "error",
        "path",
        "errorCode",
        "message",
        "details"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

409 Response

Organization network already exists.

Body ()

Root Schema : Error

Type: object

Show Source

• details(required): array details
• error(required): string
  Example: Wallet Not Found
• errorCode(required): string
  Example: WALLET_NOT_FOUND
• message(required): string
  Example: Wallet with id 123 was not found.
• path(required): string
  Example: /v1/uwaas/wallets/123
• status(required): integer
  Example: 404
• timestamp(required): string (date-time)
  Example: 2026-07-16T14:23:11.123Z

{
    "type":"object",
    "properties":{
        "timestamp":{
            "type":"string",
            "format":"date-time",
            "example":"2026-07-16T14:23:11.123Z"
        },
        "status":{
            "type":"integer",
            "example":404
        },
        "error":{
            "type":"string",
            "example":"Wallet Not Found"
        },
        "path":{
            "type":"string",
            "example":"/v1/uwaas/wallets/123"
        },
        "errorCode":{
            "type":"string",
            "example":"WALLET_NOT_FOUND"
        },
        "message":{
            "type":"string",
            "example":"Wallet with id 123 was not found."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "timestamp",
        "status",
        "error",
        "path",
        "errorCode",
        "message",
        "details"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

500 Response

Internal server error.

Body ()

Root Schema : Error

Type: object

Show Source

• details(required): array details
• error(required): string
  Example: Wallet Not Found
• errorCode(required): string
  Example: WALLET_NOT_FOUND
• message(required): string
  Example: Wallet with id 123 was not found.
• path(required): string
  Example: /v1/uwaas/wallets/123
• status(required): integer
  Example: 404
• timestamp(required): string (date-time)
  Example: 2026-07-16T14:23:11.123Z

{
    "type":"object",
    "properties":{
        "timestamp":{
            "type":"string",
            "format":"date-time",
            "example":"2026-07-16T14:23:11.123Z"
        },
        "status":{
            "type":"integer",
            "example":404
        },
        "error":{
            "type":"string",
            "example":"Wallet Not Found"
        },
        "path":{
            "type":"string",
            "example":"/v1/uwaas/wallets/123"
        },
        "errorCode":{
            "type":"string",
            "example":"WALLET_NOT_FOUND"
        },
        "message":{
            "type":"string",
            "example":"Wallet with id 123 was not found."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "timestamp",
        "status",
        "error",
        "path",
        "errorCode",
        "message",
        "details"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top