Invoke Skill Journal Record

post/api/v1/skills/journal.record/invoke

Record an accounting journal entry to Xero/QBO.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`entries`required	`any[]`	—
`memo`	`string`	—
`entry_date`	`string (date) \| null`	—
`idempotency_key`	`string \| null`	—

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`artifact_id`	`string (uuid) \| null`	—
`download_url`	`string`	—
`summary`	`string`	—
`citations`	`any[]`	—
`warnings`	`string[]`	—
`stub_fields`	`string[]`	—
`journal_id`	`string (uuid)`	—
`status`	`"queued" \| "pending_approval" \| "dry_run" \| "created" \| "rejected_unbalanced" \| "failed"`	— `queuedpending_approvaldry_runcreatedrejected_unbalancedfailed`
`total_debits`	`number \| string`	—
`total_credits`	`number \| string`	—
`balanced`	`boolean`	—
`erp`	`"xero" \| "qbo" \| "sage" \| "internal" \| null`	—
`archive_reference`	`string \| null`	ERP-assigned reference (e.g. Xero JournalNumber, QBO Id) for re-fetch.
`reversal_created`	`boolean`	—
`reversal_journal_id`	`string (uuid) \| null`	—

correlation_idrequired string —

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

403Insufficient permissions

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

404Skill not found

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/api/v1/skills/journal.record/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "entries": [
         null
       ],
       "memo": "string",
       "entry_date": null,
       "idempotency_key": null
     }'