POST

/networks/{networkId}/proposals

http://managedblockchain.{region}.amazonaws.com/networks/{networkId}/proposals

Creates a proposal for a change to the network that other members of the network can vote on, for example, a proposal to add a new member to the network. Any member can create a proposal. Applies only to Hyperledger Fabric.

Access Token Required: API Key

Path Parameters

networkIdstringrequired

The unique identifier of the network for which the proposal is made.

Body Params

Tagsobject

Tags to assign to the proposal. Each tag consists of a key and an optional value. You can specify multiple key-value pairs in a single request with an overall maximum of 50 tags allowed per resource. For more information about tags, see <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ethereum-dev/tagging-resources.html">Tagging Resources</a> in the Amazon Managed Blockchain Ethereum Developer Guide, or <a href="https://docs.aws.amazon.com/managed-blockchain/latest/hyperledger-fabric-dev/tagging-resources.html">Tagging Resources</a> in the Amazon Managed Blockchain Hyperledger Fabric Developer Guide.

Actionsobjectrequired

The actions to carry out if a proposal is <code>APPROVED</code>. Applies only to Hyperledger Fabric.

MemberIdstringrequired

The unique identifier of the member that is creating the proposal. This identifier is especially useful for identifying the member making the proposal when multiple members exist in a single Amazon Web Services account.

Descriptionstring

A description for the proposal that is visible to voting members, for example, "Proposal to add Example Corp. as member."

ClientRequestTokenstringrequired

A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than one time. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an Amazon Web Services SDK or the CLI.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://managedblockchain.{region}.amazonaws.com/networks/{networkId}/proposals' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

1curl --request POST \ 2 --url 'http://managedblockchain.{region}.amazonaws.com/networks/{networkId}/proposals' \ 3 --header 'accept: application/json' \ 4 --header 'content-type: application/json'