POST /api/v1/plans/{id}/steps/{step}/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
`step`	path / required	integer

Request body

Field Type Details

rawSignedTransaction string
required Exact serialized EIP-155 legacy, EIP-2930, or EIP-1559 transaction signed by the plan wallet. Server policy bounds size, nonce, gas, fees, and cost.

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": {
    "rawSignedTransaction": {
      "$ref": "#/components/schemas/HexBytes",
      "description": "Exact serialized EIP-155 legacy, EIP-2930, or EIP-1559 transaction signed by the plan wallet. Server policy bounds size, nonce, gas, fees, and cost."
    },
    "ownerApproval": {
      "$ref": "#/components/schemas/TransactionApproval"
    }
  },
  "required": [
    "rawSignedTransaction"
  ],
  "additionalProperties": false
}

Response 202

Field Type Details

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

dispatch

object
required

Fields

Field Type Details

status

string
required

Values: ["already-observed","in-flight","submitted","unknown"]

hash string
required

error

object
optional

Fields

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

JSON schema

{
  "type": "object",
  "properties": {
    "plan": {
      "$ref": "#/components/schemas/Plan"
    },
    "dispatch": {
      "$ref": "#/components/schemas/Dispatch"
    }
  },
  "required": [
    "plan",
    "dispatch"
  ],
  "additionalProperties": false
}