Light mode version of Land Your Home
V1Chains

Post Chain Transaction

POST
/v1/chains/{chainId}/transactions

Adds a transaction for a property to this chain, next to transactionId, which needs chainNode.canEdit. relation: "dependency" makes transactionId depend on the new transaction; "requirement" makes the new transaction depend on transactionId. An existing transaction on the property is reused unless useExistingTransaction is false. If that property is already in this chain, or in another chain, nothing is written and the response is 409 conflict (the other chain's ids are included in error.details only if the user is a party there).

Required variables:

  • baseUrl
  • apiKey (needs transactions:write)
  • userToken
  • newChainId, newTransactionId (set by Post Chain)

Authorization

bearerAuth userTokenAuth
AuthorizationBearer <token>

Partner API key (lyh_...): identifies the calling partner, its scopes and rate limit.

In: header

X-User-Token<token>

The user's OAuth 2.1 access token, issued by Land Your Home's OAuth server to this partner's OAuth client. Requests run as this user.

In: header

Path Parameters

chainId*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/chains/string/transactions"
{  "data": {    "transactionId": "b939a7de-a264-4855-b37d-d9721cea8797",    "propertyId": "f3679980-8a76-461d-a2f1-68b3f59b9a3e",    "existing": false  }}