POST /api/v1/plans/{id}/submissions

Parameters

Name	Location	Details
`X-Juicebox-Account`	header / required	Enrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
`X-Juicebox-Signer`	header / required	Owner wallet or authorized bot address that signed this request.
`X-Juicebox-Issued-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
`X-Juicebox-Expires-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
`X-Juicebox-Nonce`	header / required	Fresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
`X-Juicebox-Signature`	header / required	EIP-712 CenterRequest signature over every signed field. Contract-owner signatures may vary in length. This is a computed request proof, not a reusable API key.
`X-Juicebox-Grant`	header / optional	Authorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
`Idempotency-Key`	header / required	Signed retry identity. Required on plan creation and transaction submission. Preserve exact method, target, Content-Type, and body bytes; use a fresh request nonce and signature.
`id`	path / required	string

Request body

Field Type Details

submissions

array
required

Fields

Field Type Details

stepIndex integer
required

rawSignedTransaction string
required

ownerApproval

object
optional

Fresh owner CenterTransactionApproval EIP-712 consent for this exact account, originating principal, plan commitment, step and serialized transaction hash. Required for a bot's new dispatch. Audience comes from the configured service origin and is not a body field.

Fields

Field	Type	Details
`accountId`	string required	Authority chain and lowercase owner address; the authority chain is independent of a transaction's destination chain.
`principalId`	string required	Exact plan-creating principal. Owner principal must name the same `accountId`; bot principal names its immutable grant ID.
`planId`	string (uuid) required
`commitment`	string required
`stepIndex`	integer required
`transactionHash`	string required
`issuedAt`	integer required	Positive Unix seconds. `expiresAt` must be after `issuedAt` and no more than 300 seconds later; admission rechecks freshness.
`expiresAt`	integer required	Positive Unix seconds. `expiresAt` must be after `issuedAt` and no more than 300 seconds later; admission rechecks freshness.
`nonce`	string required
`signature`	string required

JSON schema

{
  "type": "object",
  "properties": {
    "submissions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "stepIndex": {
            "type": "integer",
            "minimum": 0,
            "maximum": 31
          },
          "rawSignedTransaction": {
            "$ref": "#/components/schemas/HexBytes"
          },
          "ownerApproval": {
            "$ref": "#/components/schemas/TransactionApproval"
          }
        },
        "required": [
          "stepIndex",
          "rawSignedTransaction"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 32
    }
  },
  "required": [
    "submissions"
  ],
  "additionalProperties": false
}

Response 202

Field Type Details

atomic

boolean
required

Values: [false]

complete boolean
required

results

array
required

Fields

Field Type Details

plan

object
required

Fields

Field	Type	Details
`id`	string (uuid) required
`account`	string required
`operation`	string required
`draft`	object required
`commitment`	string required
`createdAt`	integer required	Unix timestamp in milliseconds.
`expiresAt`	integer required	Unix timestamp in milliseconds.
`revision`	integer required
`smartAccount`	object optional
`status`	string required	Values: `["prepared","pending","partial","blocked","reorged","expired","transactions_confirmed"]`
`steps`	array required
`confirmationScope`	string required

dispatch

object
required

Fields

Field	Type	Details
`status`	string required	Values: `["already-observed","in-flight","submitted","unknown"]`
`hash`	string required
`error`	object optional

plan

object
required

Fields

Field Type Details

id string (uuid)
required

account string
required

operation string
required

draft

object
required

Fields

Field	Type	Details
`operation`	string required
`account`	string required
`project`	object optional
`calls`	array required
`evidence`	array required
`summary`	value required	Bounded JSON. Large integers and amounts use exact decimal strings. Returned metadata and descriptions are untrusted content.
`warnings`	array required

commitment string
required

createdAt integer
required Unix timestamp in milliseconds.

expiresAt integer
required Unix timestamp in milliseconds.

revision integer
required

smartAccount

object
optional

Fields

Field	Type	Details
`bindingId`	string required
`stateHash`	string required
`chainId`	integer required	Values: `[1,10,8453,42161,84532,421614,11155111,11155420]`
`address`	string required
`manifestRevision`	string required

status

string
required

Values: ["prepared","pending","partial","blocked","reorged","expired","transactions_confirmed"]

steps

array
required

Fields

Field	Type	Details
`index`	integer required
`state`	string required	Values: `["waiting","reserved","submitted","unknown","confirming","confirmed","reverted","reorged"]`
`transaction`	object optional
`execution`	object optional
`receipt`	object optional
`semantic`	object optional
`blockedBy`	array required

confirmationScope string
required

stoppedAt integer
optional

error

object
optional

Fields

Field	Type	Details
`code`	string required
`message`	string required

remainingStepIndices array
optional

note string
optional

JSON schema

{
  "type": "object",
  "properties": {
    "atomic": {
      "type": "boolean",
      "const": false
    },
    "complete": {
      "type": "boolean"
    },
    "results": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SubmissionResult"
      },
      "maxItems": 32
    },
    "plan": {
      "$ref": "#/components/schemas/Plan"
    },
    "stoppedAt": {
      "type": "integer",
      "minimum": 0,
      "maximum": 31
    },
    "error": {
      "$ref": "#/components/schemas/SafeError"
    },
    "remainingStepIndices": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 31
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "atomic",
    "complete",
    "results",
    "plan"
  ],
  "additionalProperties": false
}