Endpoint reference

POST /api/v1/accounts/enroll

Parameters

NameLocationDetails
X-Juicebox-Accountheader / requiredEnrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
X-Juicebox-Signerheader / requiredOwner wallet or authorized bot address that signed this request.
X-Juicebox-Issued-Atheader / requiredUnix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
X-Juicebox-Expires-Atheader / requiredUnix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
X-Juicebox-Nonceheader / requiredFresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
X-Juicebox-Signatureheader / requiredEIP-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-Grantheader / optionalAuthorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
Idempotency-Keyheader / optionalSigned 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.

Request body

object

JSON schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Response 200

FieldTypeDetails
accountobject
required
Fields
FieldTypeDetails
idstring
required
Authority chain and lowercase owner address; the authority chain is independent of a transaction's destination chain.
ownerAddressstring
required
authorityChainIdinteger
required
profileobject
required
Fields
FieldTypeDetails
displayNamestring
required
biostring
required
avatarUrione of
required
createdAtinteger
required
Unix timestamp in seconds.
updatedAtinteger
required
Unix timestamp in seconds.
JSON schema
{
  "type": "object",
  "properties": {
    "account": {
      "$ref": "#/components/schemas/Account"
    }
  },
  "required": [
    "account"
  ],
  "additionalProperties": false
}