> ## Documentation Index
> Fetch the complete documentation index at: https://cantonfoundation-generated-reference-full-stack-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v2/commands/async/submit

> Submit a single composite command.

<div class="x2mdx-ref-page x2mdx-ref-page--operation x2mdx-ref-page--manual-api" />

<div class="x2mdx-ref-hero">
  <p class="x2mdx-ref-summary">Submit a single composite command.</p>

  <div class="x2mdx-ref-badges">
    <span class="x2mdx-ref-badge x2mdx-ref-badge--protocol">OpenAPI</span>

    <a class="x2mdx-ref-badge x2mdx-ref-badge--changed" href="#history-updated-3-5">Updated 3.5</a>
  </div>
</div>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request POST \
    --url 'http://localhost:7575/v2/commands/async/submit' \
    --header 'Authorization: Bearer $TOKEN' \
    --header 'Content-Type: application/json' \
    --data '{
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }'
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import json
  import requests

  url = "http://localhost:7575/v2/commands/async/submit"
  headers = {'Authorization': 'Bearer <token>', 'Content-Type': 'application/json'}
  payload = json.loads(r'''{
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }''')
  response = requests.request(
      "POST", url, headers=headers, json=payload
  )

  print(response.text)
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const response = await fetch('http://localhost:7575/v2/commands/async/submit', {
    method: 'POST',
    headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
    body: JSON.stringify({
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }),
  });

  console.log(await response.text());
  ```

  ```php PHP theme={"theme":{"light":"github-light","dark":"github-dark"}}
  <?php
  $curl = curl_init();

  curl_setopt_array($curl, [
      CURLOPT_URL => 'http://localhost:7575/v2/commands/async/submit',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => <<<'JSON'
  {
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }
  JSON,
      CURLOPT_HTTPHEADER => [
          "Authorization: Bearer <token>",
          "Content-Type: application/json"
      ],
  ]);

  $response = curl_exec($curl);
  echo $response;
  ```

  ```go Go theme={"theme":{"light":"github-light","dark":"github-dark"}}
  package main

  import (
    "bytes"
    "fmt"
    "io"
    "net/http"
  )

  func main() {
    req, _ := http.NewRequest("POST", "http://localhost:7575/v2/commands/async/submit", bytes.NewBufferString(`{
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }`))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")
    response, _ := http.DefaultClient.Do(req)
    defer response.Body.Close()
    body, _ := io.ReadAll(response.Body)
    fmt.Println(string(body))
  }
  ```

  ```java Java theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import java.net.URI;
  import java.net.http.HttpClient;
  import java.net.http.HttpRequest;
  import java.net.http.HttpResponse;

  var request = HttpRequest.newBuilder()
      .uri(URI.create("http://localhost:7575/v2/commands/async/submit"))
      .header("Authorization", "Bearer <token>")
      .header("Content-Type", "application/json")
      .method("POST", HttpRequest.BodyPublishers.ofString("""
  {
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }
  """))
      .build();
  var response = HttpClient.newHttpClient().send(
      request, HttpResponse.BodyHandlers.ofString());
  System.out.println(response.body());
  ```

  ```ruby Ruby theme={"theme":{"light":"github-light","dark":"github-dark"}}
  require 'net/http'
  require 'uri'

  uri = URI('http://localhost:7575/v2/commands/async/submit')
  request = Net::HTTP::Post.new(uri)
  request['Authorization'] = 'Bearer <token>'
  request['Content-Type'] = 'application/json'
  request.body = <<~JSON
  {
    "commands": [
      {
        "CreateAndExerciseCommand": {
          "templateId": "<string>",
          "createArguments": "<string>",
          "choice": "<string>",
          "choiceArgument": "<string>"
        }
      }
    ],
    "commandId": "<string>",
    "actAs": [
      "<string>"
    ],
    "userId": "<string>",
    "readAs": [
      "<string>"
    ],
    "workflowId": "<string>",
    "deduplicationPeriod": {
      "DeduplicationDuration": {
        "value": {
          "seconds": 123,
          "nanos": 123,
          "unknownFields": {
            "fields": "<object>"
          }
        }
      }
    },
    "minLedgerTimeAbs": "<string>",
    "minLedgerTimeRel": {
      "seconds": 123,
      "nanos": 123,
      "unknownFields": {
        "fields": {}
      }
    },
    "submissionId": "<string>",
    "disclosedContracts": [
      {
        "templateId": "<string>",
        "contractId": "<string>",
        "createdEventBlob": "<string>",
        "synchronizerId": "<string>"
      }
    ],
    "synchronizerId": "<string>",
    "packageIdSelectionPreference": [
      "<string>"
    ],
    "prefetchContractKeys": [
      {
        "templateId": "<string>",
        "contractKey": "<string>",
        "limit": 123
      }
    ],
    "tapsMaxPasses": 123
  }
  JSON
  response = Net::HTTP.start(uri.hostname, uri.port) do |http|
    http.request(request)
  end
  puts response.body
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {}
  ```

  ```text 400 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  <string>
  ```

  ```json default theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "code": "<string>",
    "cause": "<string>",
    "correlationId": "<string>",
    "traceId": "<string>",
    "context": {},
    "resources": [
      [
        "<string>"
      ]
    ],
    "errorCategory": 123,
    "grpcCodeValue": 123,
    "retryInfo": "<string>",
    "definiteAnswer": false
  }
  ```
</ResponseExample>

## Authorizations

### httpAuth

<ParamField header="Authorization" type="string" required>
  HTTP bearer authentication. Send the token as `Authorization: Bearer &lt;token&gt;`. Ledger API standard JWT token
</ParamField>

### apiKeyAuth

<ParamField header="Sec-WebSocket-Protocol" type="string" required>
  API key authentication in the header. Ledger API standard JWT token (websocket)
</ParamField>

## Body

<div class="x2mdx-ref-badges">
  <span class="x2mdx-ref-badge x2mdx-ref-badge--neutral">application/json</span>
</div>

<ParamField body="commands" type="object[]" required>
  OpenAPI type: <code>Command\[]</code>.

  Individual elements of this atomic command. Must be non-empty. Required: must be non-empty

  <Expandable title="child attributes">
    <ParamField body="Variant 1" type="object">
      <Expandable title="child attributes">
        <ParamField body="CreateAndExerciseCommand" type="object" required>
          OpenAPI type: <code>CreateAndExerciseCommand</code>.

          Create a contract and exercise a choice on it in the same transaction.

          <Expandable title="child attributes">
            <ParamField body="templateId" type="string" required>
              The template of the contract the client wants to create. Both package-name and package-id reference identifier formats for the template-id are supported. Note: The package-id reference identifier format is deprecated. We plan to end support for this format in version 3.4. Required
            </ParamField>

            <ParamField body="createArguments" type="object" required>
              The arguments required for creating a contract from this template. Required
            </ParamField>

            <ParamField body="choice" type="string" required>
              The name of the choice the client wants to exercise. Must be a valid NameString (as described in `value.proto`). Required
            </ParamField>

            <ParamField body="choiceArgument" type="object" required>
              The argument for this choice. Required
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="Variant 2" type="object">
      <Expandable title="child attributes">
        <ParamField body="CreateCommand" type="object" required>
          OpenAPI type: <code>CreateCommand</code>.

          Create a new contract instance based on a template.

          <Expandable title="child attributes">
            <ParamField body="templateId" type="string" required>
              The template of contract the client wants to create. Both package-name and package-id reference identifier formats for the template-id are supported. Note: The package-id reference identifier format is deprecated. We plan to end support for this format in version 3.4. Required
            </ParamField>

            <ParamField body="createArguments" type="object" required>
              The arguments required for creating a contract from this template. Required
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="Variant 3" type="object">
      <Expandable title="child attributes">
        <ParamField body="ExerciseByKeyCommand" type="object" required>
          OpenAPI type: <code>ExerciseByKeyCommand</code>.

          Exercise a choice on an existing contract specified by its key.

          <Expandable title="child attributes">
            <ParamField body="templateId" type="string" required>
              The template of contract the client wants to exercise. Both package-name and package-id reference identifier formats for the template-id are supported. Note: The package-id reference identifier format is deprecated. We plan to end support for this format in version 3.4. Required
            </ParamField>

            <ParamField body="contractKey" type="object" required>
              The key of the contract the client wants to exercise upon. Required
            </ParamField>

            <ParamField body="choice" type="string" required>
              The name of the choice the client wants to exercise. Must be a valid NameString (as described in `value.proto`) Required
            </ParamField>

            <ParamField body="choiceArgument" type="object" required>
              The argument for this choice. Required
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="Variant 4" type="object">
      <Expandable title="child attributes">
        <ParamField body="ExerciseCommand" type="object" required>
          OpenAPI type: <code>ExerciseCommand</code>.

          Exercise a choice on an existing contract.

          <Expandable title="child attributes">
            <ParamField body="templateId" type="string" required>
              The template or interface of the contract the client wants to exercise. Both package-name and package-id reference identifier formats for the template-id are supported. Note: The package-id reference identifier format is deprecated. We plan to end support for this format in version 3.4. To exercise a choice on an interface, specify the interface identifier in the template\_id field. Required
            </ParamField>

            <ParamField body="contractId" type="string" required>
              The ID of the contract the client wants to exercise upon. Must be a valid LedgerString (as described in `value.proto`). Required
            </ParamField>

            <ParamField body="choice" type="string" required>
              The name of the choice the client wants to exercise. Must be a valid NameString (as described in `value.proto`) Required
            </ParamField>

            <ParamField body="choiceArgument" type="object" required>
              The argument for this choice. Required
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="commandId" type="string" required>
  Uniquely identifies the command. The triple (user\_id, act\_as, command\_id) constitutes the change ID for the intended ledger change, where act\_as is interpreted as a set of party names. The change ID can be used for matching the intended ledger changes with all their completions. Must be a valid LedgerString (as described in `value.proto`). Required
</ParamField>

<ParamField body="actAs" type="string[]" required>
  Set of parties on whose behalf the command should be executed. If ledger API authorization is enabled, then the authorization metadata must authorize the sender of the request to act on behalf of each of the given parties. Each element must be a valid PartyIdString (as described in `value.proto`). Required: must be non-empty
</ParamField>

<ParamField body="userId" type="string">
  Uniquely identifies the participant user that issued the command. Must be a valid UserIdString (as described in `value.proto`). Required unless authentication is used with a user token. In that case, the token's user-id will be used for the request's user\_id. Optional
</ParamField>

<ParamField body="readAs" type="string[]">
  Set of parties on whose behalf (in addition to all parties listed in `act_as`) contracts can be retrieved. This affects Daml operations such as `fetch`, `fetchByKey`, `lookupByKey`, `exercise`, and `exerciseByKey`. Note: A participant node of a Daml network can host multiple parties. Each contract present on the participant node is only visible to a subset of these parties. A command can only use contracts that are visible to at least one of the parties in `act_as` or `read_as`. This visibility check is independent from the Daml authorization rules for fetch operations. If ledger API authorization is enabled, then the authorization metadata must authorize the sender of the request to read contract data on behalf of each of the given parties. Optional: can be empty
</ParamField>

<ParamField body="workflowId" type="string">
  Identifier of the on-ledger workflow that this command is a part of. Must be a valid LedgerString (as described in `value.proto`). Optional
</ParamField>

<ParamField body="deduplicationPeriod" type="object">
  OpenAPI type: <code>DeduplicationPeriod</code>.

  Specifies the deduplication period for the change ID. If omitted, the participant will assume the configured maximum deduplication time. Optional

  <Expandable title="child attributes">
    <ParamField body="Variant 1" type="object">
      <Expandable title="child attributes">
        <ParamField body="DeduplicationDuration" type="object" required>
          OpenAPI type: <code>DeduplicationDuration</code>.

          <Expandable title="child attributes">
            <ParamField body="value" type="object" required>
              OpenAPI type: <code>Duration</code>.

              <Expandable title="child attributes">
                <ParamField body="seconds" type="number" required>
                  OpenAPI type: <code>integer (int64)</code>.
                </ParamField>

                <ParamField body="nanos" type="number" required>
                  OpenAPI type: <code>integer (int32)</code>.
                </ParamField>

                <ParamField body="unknownFields" type="object">
                  OpenAPI type: <code>UnknownFieldSet</code>.

                  This field is automatically added as part of protobuf to json mapping

                  <Expandable title="child attributes">
                    <ParamField body="fields" type="object" required>
                      OpenAPI type: <code>Map\_Int\_Field</code>.
                    </ParamField>
                  </Expandable>
                </ParamField>
              </Expandable>
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="Variant 2" type="object">
      <Expandable title="child attributes">
        <ParamField body="DeduplicationOffset" type="object" required>
          OpenAPI type: <code>DeduplicationOffset</code>.

          <Expandable title="child attributes">
            <ParamField body="value" type="number" required>
              OpenAPI type: <code>integer (int64)</code>.
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="Variant 3" type="object">
      <Expandable title="child attributes">
        <ParamField body="Empty" type="object" required>
          OpenAPI type: <code>Empty</code>.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="minLedgerTimeAbs" type="string">
  Lower bound for the ledger time assigned to the resulting transaction. Note: The ledger time of a transaction is assigned as part of command interpretation. Use this property if you expect that command interpretation will take a considerate amount of time, such that by the time the resulting transaction is sequenced, its assigned ledger time is not valid anymore. Must not be set at the same time as min\_ledger\_time\_rel. Optional
</ParamField>

<ParamField body="minLedgerTimeRel" type="object">
  OpenAPI type: <code>Duration</code>.

  Same as min\_ledger\_time\_abs, but specified as a duration, starting from the time the command is received by the server. Must not be set at the same time as min\_ledger\_time\_abs. Optional

  <Expandable title="child attributes">
    <ParamField body="seconds" type="number" required>
      OpenAPI type: <code>integer (int64)</code>.
    </ParamField>

    <ParamField body="nanos" type="number" required>
      OpenAPI type: <code>integer (int32)</code>.
    </ParamField>

    <ParamField body="unknownFields" type="object">
      OpenAPI type: <code>UnknownFieldSet</code>.

      This field is automatically added as part of protobuf to json mapping

      <Expandable title="child attributes">
        <ParamField body="fields" type="object" required>
          OpenAPI type: <code>Map\_Int\_Field</code>.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="submissionId" type="string">
  A unique identifier to distinguish completions for different submissions with the same change ID. Typically a random UUID. Applications are expected to use a different UUID for each retry of a submission with the same change ID. Must be a valid LedgerString (as described in `value.proto`). If omitted, the participant or the committer may set a value of their choice. Optional
</ParamField>

<ParamField body="disclosedContracts" type="object[]">
  OpenAPI type: <code>DisclosedContract\[]</code>.

  Additional contracts used to resolve contract & contract key lookups. Optional: can be empty

  <Expandable title="child attributes">
    <ParamField body="templateId" type="string">
      The template id of the contract. The identifier uses the package-id reference format. If provided, used to validate the template id of the contract serialized in the created\_event\_blob. Optional
    </ParamField>

    <ParamField body="contractId" type="string">
      The contract id If provided, used to validate the contract id of the contract serialized in the created\_event\_blob. Optional
    </ParamField>

    <ParamField body="createdEventBlob" type="string" required>
      Opaque byte string containing the complete payload required by the Daml engine to reconstruct a contract not known to the receiving participant. Required: must be non-empty
    </ParamField>

    <ParamField body="synchronizerId" type="string">
      The ID of the synchronizer where the contract is currently assigned Optional
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="synchronizerId" type="string">
  Must be a valid synchronizer id Optional
</ParamField>

<ParamField body="packageIdSelectionPreference" type="string[]">
  The package-id selection preference of the client for resolving package names and interface instances in command submission and interpretation Optional: can be empty
</ParamField>

<ParamField body="prefetchContractKeys" type="object[]">
  OpenAPI type: <code>PrefetchContractKey\[]</code>.

  Fetches the contract keys into the caches to speed up the command processing. Each entry specifies a key and a limit on how many contracts to prefetch for that key. The limit does not count disclosed contracts, and should reflect the number of additional contracts expected to be resolved during interpretation of the commands. If a key appears multiple times, the last entry's limit wins. Optional: can be empty

  <Expandable title="child attributes">
    <ParamField body="templateId" type="string" required>
      The template of contract the client wants to prefetch. Both package-name and package-id reference identifier formats for the template-id are supported. Note: The package-id reference identifier format is deprecated. We plan to end support for this format in version 3.4. Required
    </ParamField>

    <ParamField body="contractKey" type="object" required>
      The key of the contract the client wants to prefetch. Required
    </ParamField>

    <ParamField body="limit" type="number">
      OpenAPI type: <code>integer (int32)</code>.

      The number of contracts to prefetch for this key, if available. This is in addition to disclosed contracts. - for backward compatibility reason, absence is interpreted as 1 - 0 is forbidden - capped at 2^31 - 1. The system may impose further limits. Optional
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="tapsMaxPasses" type="number">
  OpenAPI type: <code>integer (int32)</code>.

  The maximum number of passes for the Topology-Aware Package Selection (TAPS). Higher values can increase the chance of successful package selection for routing of interpreted transactions. If unset, this defaults to the value defined in the participant configuration. The provided value must not exceed the limit specified in the participant configuration. Optional
</ParamField>

## Responses

### 200

<div class="x2mdx-ref-badges">
  <span class="x2mdx-ref-badge x2mdx-ref-badge--neutral">application/json</span>
</div>

<ResponseField name="value" type="SubmitResponse" required />

### 400

Invalid value, Invalid value for: body

<div class="x2mdx-ref-badges">
  <span class="x2mdx-ref-badge x2mdx-ref-badge--neutral">text/plain</span>
</div>

<ResponseField name="value" type="string" required />

### default

<div class="x2mdx-ref-badges">
  <span class="x2mdx-ref-badge x2mdx-ref-badge--neutral">application/json</span>
</div>

<ResponseField name="code" type="string" required />

<ResponseField name="cause" type="string" required />

<ResponseField name="correlationId" type="string" />

<ResponseField name="traceId" type="string" />

<ResponseField name="context" type="Map_String" required />

<ResponseField name="resources" type="Tuple2_String_String[]" />

<ResponseField name="errorCategory" type="integer (int32)" required />

<ResponseField name="grpcCodeValue" type="integer (int32)" />

<ResponseField name="retryInfo" type="string" />

<ResponseField name="definiteAnswer" type="boolean" />

## History

<div class="x2mdx-ref-history" aria-label="Reference history">
  <div class="x2mdx-ref-history-event x2mdx-ref-history-event--changed" id="history-updated-3-5">
    <div class="x2mdx-ref-history-event-head">
      <span class="x2mdx-ref-history-event-label">Updated</span>
      <code class="x2mdx-ref-history-event-version">3.5</code>
    </div>

    <p class="x2mdx-ref-history-event-detail">The POST /v2/commands/async/submit operation changed in this snapshot.</p>
  </div>
</div>