Skip to content

POST /v1/workflows/{requestId}/transactions

Availability
Private Preview
Method and path
POST /v1/workflows/{requestId}/transactions
API version
1.0.0-private-preview
Base URL
https://api.torq.finance
Authentication
SecretKey, WalletSession, PublishableKey
Idempotency
Not declared by this operation.
Rate limits
Read x-ratelimit-* and x-request-id response headers. Do not hard-code a quota.

Authentication requirements

  • SecretKey
  • WalletSession
  • PublishableKey

Request examples

terminal
curl -X POST 'https://api.torq.finance/v1/workflows/sample_requestid/transactions' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer $TORQ_SECRET_KEY' \
  -H 'x-torq-wallet-session: $TORQ_WALLET_SESSION' \
  -H 'Content-Type: application/json' \
  --data '{"order":0,"chainId":11155111,"txHash":"0xabababababababababababababababababababababababababababababababab"}'
Run a safe sample

This calls the docs preview and returns sample data shaped by the governed OpenAPI response. It never accepts credentials or changes protocol state.

Run the sample call to inspect a schema-shaped response without credentials or side effects.
Request body
WorkflowTransactionRegistration

Parameters

requestId
path
Yes
string

Request schema

WorkflowTransactionRegistration WorkflowTransactionRegistration

order
integer
Yes
—
chainId
integer
Yes
—
txHash
string
Yes
—
Inspect nested properties

order integer · required

minimum: 0

chainId integer · required

minimum: 1

txHash string · required

pattern: ^0x[a-fA-F0-9]{64}$

Responses

200
Successful response
TrackedWorkflow
400
Invalid request
TorqApiError
401
Authentication required
TorqApiError
403
Insufficient scope or authority
TorqApiError
409
State or idempotency conflict
TorqApiError
429
Rate limit exceeded
TorqApiError
500
Internal failure
TorqApiError

200 response schema

TrackedWorkflow TrackedWorkflow

requestId
string
Yes
—
status
enum
Yes
—
transactions
object[]
Yes
—
canonicalPostconditions
CanonicalPostcondition[]
Yes
—
failureCode
string | null
No
—
Inspect nested properties

requestId string · required

minimum length: 1 · maximum length: 200

status enum · required

one of: prepared, submitted, mined, indexed, persisted_visible, final_success, failed

transactions object[] · required

items object

canonicalPostconditions CanonicalPostcondition[] · required

items CanonicalPostcondition

entityType
string
Yes
—
entityId
string
Yes
—
field
string
Yes
—
expected
unknown
Yes
—
Inspect nested properties

entityType string · required

minimum length: 1 · maximum length: 200

entityId string · required

minimum length: 1 · maximum length: 200

field string · required

minimum length: 1 · maximum length: 200

expected unknown · required

failureCode string | null · optional

nullable

400, 401, 403, 409, 429, 500 response schema

TorqApiError TorqApiError

ok
boolean
Yes
—
code
string
Yes
—
message
string
Yes
—
requestId
string
Yes
—
retryable
boolean
Yes
—
blockedReason
string | null
No
—
docsUrl
string (uri)
No
—
Inspect nested properties

ok boolean · required

code string · required

minimum length: 1 · maximum length: 200

message string · required

minimum length: 1 · maximum length: 200

requestId string · required

minimum length: 1 · maximum length: 200

retryable boolean · required

blockedReason string | null · optional

nullable

docsUrl string (uri) · optional

Related guides

For retry behavior and blocked-state handling, see Errors and rate limits.