{"openapi":"3.1.0","info":{"title":"txcast Durable Agent API","version":"2.0.0","description":"Breaking agent API for authoring TypeScript durable workflows and controlling their non-human lifecycle. Human decisions and wallet signing are intentionally excluded."},"servers":[{"url":"/agent/v2"}],"paths":{"/context":{"get":{"operationId":"get_context","summary":"Get agent context","description":"Return this credential and its currently applicable organisation contexts. Use an organisation ID from this response in every organisation-scoped command.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"credential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z0-9@][A-Za-z0-9 ._/@+-]{0,79}$"},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["id","name","expiresAt"],"additionalProperties":false},"organisations":{"type":"array","items":{"type":"object","properties":{"organisation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string","minLength":3,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"kind":{"type":"string","enum":["personal","standard"]},"role":{"type":"string","enum":["owner","admin","member"]},"seatStatus":{"type":"string","enum":["active","unavailable"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","slug","kind","role","seatStatus","createdAt","updatedAt"],"additionalProperties":false},"source":{"type":"string","enum":["selected","all"]},"configuredScopes":{"type":"array","items":{"type":"string","enum":["organisation.read","registry.write","registry.contract.create","workflow.source.write","workflow.archive","run.start","run.cancel","run.source.refresh","run.visibility.public","run.execution.prepare","run.safe.signature.submit","run.execution.record","run.checkpoint.complete","run.decision.select"]},"minItems":1,"maxItems":14},"effectiveScopes":{"type":"array","items":{"type":"string","enum":["organisation.read","registry.write","registry.contract.create","workflow.source.write","workflow.archive","run.start","run.cancel","run.source.refresh","run.visibility.public","run.execution.prepare","run.safe.signature.submit","run.execution.record","run.checkpoint.complete","run.decision.select"]},"maxItems":14},"accountAccess":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"none"}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"selected"},"controlledAccountIds":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":100}},"required":["mode","controlledAccountIds"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"all"}},"required":["mode"],"additionalProperties":false}]},"status":{"type":"string","enum":["active","unavailable"]},"lastUsedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"lastUsedSource":{"anyOf":[{"type":"string","enum":["agent_api","mcp"]},{"type":"null"}]}},"required":["organisation","source","configuredScopes","effectiveScopes","accountAccess","status","lastUsedAt","lastUsedSource"],"additionalProperties":false}},"features":{"type":"object","properties":{"durableWorkflow":{"type":"boolean","default":false},"aiAssistant":{"type":"boolean","default":false},"workflowViewAuthoring":{"type":"boolean","default":false},"workflowCowTradeAuthoring":{"type":"boolean","default":false}},"additionalProperties":false,"default":{"durableWorkflow":false,"aiAssistant":false,"workflowViewAuthoring":false,"workflowCowTradeAuthoring":false}}},"required":["credential","organisations"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":null,"x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/networks":{"get":{"operationId":"list_networks","summary":"List enabled networks","description":"List the EVM networks currently enabled for txcast workflows.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"networks":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"name":{"type":"string"},"slug":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["chainId","name","slug","createdAt","updatedAt"],"additionalProperties":false}}},"required":["networks"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/audit-events":{"get":{"operationId":"list_audit_events","summary":"List organisation audit events","description":"List recent append-only organisation audit events, including non-secret agent provenance. All filters are optional; supply only filters requested by the user.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":4096}},{"name":"actorUserId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"targetType","in":"query","required":false,"schema":{"type":"string","enum":["organisation","organisation_invitation","organisation_member","billing_subscription","billing_entitlement_grant","address_book_entry","address_book_chain","controlled_account","controlled_account_chain","workflow","workflow_revision","workflow_run","workflow_run_node","workflow_run_step","workflow_run_step_attempt","notification_sink","agent_credential"]}},{"name":"targetId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512}},{"name":"eventType","in":"query","required":false,"schema":{"type":"string","enum":["organisation.created","organisation.updated","organisation.deleted","organisation.member_invited","organisation.invitation_revoked","organisation.invitation_accepted","organisation.member_removed","organisation.member_role_changed","billing.subscription_started","billing.subscription_updated","billing.subscription_ended","billing.member_seats_changed","billing.entitlement_grant_created","billing.entitlement_grant_revoked","address_book.entry_created","address_book.entry_updated","address_book.entry_deleted","address_book.chain_added","address_book.chain_updated","address_book.chain_deleted","address_book.contract_registration_confirmed","controlled_account.created","controlled_account.updated","controlled_account.deleted","controlled_account.chain_added","controlled_account.chain_deleted","workflow.created","workflow.forked","workflow.draft_replaced","workflow.revision_saved","workflow.revision_restored","workflow.archived","workflow.unarchived","workflow.revision_created","workflow.deleted","workflow_run.created","workflow_run.staged","workflow_run.started","workflow_run.completed","workflow_run.failed","workflow_run.human_response_selected","workflow_run.transaction_rejected","workflow_run.notification_accepted","workflow_run.variables_updated","workflow_run.published","workflow_run.cancelled","workflow_run.visibility_changed","workflow_run.visibility_confirmed","workflow_run.step_attempt_created","workflow_run.step_attempt_reused","workflow_run.wallet_transaction_submitted","workflow_run.wallet_transaction_confirmed","workflow_run.safe_proposed","workflow_run.safe_signature_submission_initiated","workflow_run.safe_signature_submitted","workflow_run.safe_rejection_prepared","workflow_run.safe_rejection_reused","workflow_run.safe_execution_submitted","workflow_run.safe_execution_confirmed","workflow_run.step_externally_completed","workflow_run.external_completion_recorded","workflow_run.external_completion_confirmed","workflow_run.manual_node_completed","workflow_run.event_observed","workflow_run.decision_selected","workflow_run.synced","notification.sink_configured","notification.sink_removed","agent_credential.created","agent_credential.access_granted","agent_credential.access_revoked","agent_credential.revoked"]}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"organisationSlug":{"type":"string"},"actorKind":{"type":"string","enum":["user","wallet","system"]},"actorUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"actorEmail":{"type":["string","null"]},"actorWallet":{"anyOf":[{"type":"string"},{"type":"null"}]},"eventType":{"type":"string","enum":["organisation.created","organisation.updated","organisation.deleted","organisation.member_invited","organisation.invitation_revoked","organisation.invitation_accepted","organisation.member_removed","organisation.member_role_changed","billing.subscription_started","billing.subscription_updated","billing.subscription_ended","billing.member_seats_changed","billing.entitlement_grant_created","billing.entitlement_grant_revoked","address_book.entry_created","address_book.entry_updated","address_book.entry_deleted","address_book.chain_added","address_book.chain_updated","address_book.chain_deleted","address_book.contract_registration_confirmed","controlled_account.created","controlled_account.updated","controlled_account.deleted","controlled_account.chain_added","controlled_account.chain_deleted","workflow.created","workflow.forked","workflow.draft_replaced","workflow.revision_saved","workflow.revision_restored","workflow.archived","workflow.unarchived","workflow.revision_created","workflow.deleted","workflow_run.created","workflow_run.staged","workflow_run.started","workflow_run.completed","workflow_run.failed","workflow_run.human_response_selected","workflow_run.transaction_rejected","workflow_run.notification_accepted","workflow_run.variables_updated","workflow_run.published","workflow_run.cancelled","workflow_run.visibility_changed","workflow_run.visibility_confirmed","workflow_run.step_attempt_created","workflow_run.step_attempt_reused","workflow_run.wallet_transaction_submitted","workflow_run.wallet_transaction_confirmed","workflow_run.safe_proposed","workflow_run.safe_signature_submission_initiated","workflow_run.safe_signature_submitted","workflow_run.safe_rejection_prepared","workflow_run.safe_rejection_reused","workflow_run.safe_execution_submitted","workflow_run.safe_execution_confirmed","workflow_run.step_externally_completed","workflow_run.external_completion_recorded","workflow_run.external_completion_confirmed","workflow_run.manual_node_completed","workflow_run.event_observed","workflow_run.decision_selected","workflow_run.synced","notification.sink_configured","notification.sink_removed","agent_credential.created","agent_credential.access_granted","agent_credential.access_revoked","agent_credential.revoked"]},"targetType":{"anyOf":[{"type":"string","enum":["organisation","organisation_invitation","organisation_member","billing_subscription","billing_entitlement_grant","address_book_entry","address_book_chain","controlled_account","controlled_account_chain","workflow","workflow_revision","workflow_run","workflow_run_node","workflow_run_step","workflow_run_step_attempt","notification_sink","agent_credential"]},{"type":"null"}]},"targetId":{"type":["string","null"]},"targetLabel":{"type":["string","null"]},"summary":{"type":"string"},"metadata":{"type":"object","additionalProperties":{},"default":{}},"requestProvenance":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"web"},"credential":{"type":"null"},"client":{"type":"null"},"observedMcpHost":{"type":"null"},"occurredAt":{"type":"string","format":"date-time"}},"required":["source","credential","client","observedMcpHost","occurredAt"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"assistant"},"credential":{"type":"null"},"client":{"type":"null"},"observedMcpHost":{"type":"null"},"chatId":{"type":"string","format":"uuid"},"turnId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"}},"required":["source","credential","client","observedMcpHost","chatId","turnId","occurredAt"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"system"},"credential":{"type":"null"},"client":{"type":"null"},"observedMcpHost":{"type":"null"},"occurredAt":{"type":"string","format":"date-time"}},"required":["source","credential","client","observedMcpHost","occurredAt"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"agent_api"},"credential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":80}},"required":["id","name"],"additionalProperties":false},"client":{"anyOf":[{"type":"object","properties":{"reportedName":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"},"reportedVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},"required":["reportedName","reportedVersion"],"additionalProperties":false},{"type":"null"}]},"observedMcpHost":{"type":"null"},"occurredAt":{"type":"string","format":"date-time"}},"required":["source","credential","client","observedMcpHost","occurredAt"],"additionalProperties":false},{"type":"object","properties":{"source":{"type":"string","const":"mcp"},"credential":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":80}},"required":["id","name"],"additionalProperties":false},"client":{"anyOf":[{"type":"object","properties":{"reportedName":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"},"reportedVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},"required":["reportedName","reportedVersion"],"additionalProperties":false},{"type":"null"}]},"observedMcpHost":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"},"version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},"required":["name","version"],"additionalProperties":false},{"type":"null"}]},"occurredAt":{"type":"string","format":"date-time"}},"required":["source","credential","client","observedMcpHost","occurredAt"],"additionalProperties":false}]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","organisationSlug","actorKind","actorUserId","actorEmail","actorWallet","eventType","targetType","targetId","targetLabel","summary","requestProvenance","createdAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["events","nextCursor"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/controlled-accounts":{"get":{"operationId":"list_controlled_accounts","summary":"List controlled accounts","description":"List organisation-controlled Safe and EOA accounts available to this credential in the selected organisation.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["safe","eoa"]},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"controlledAccountId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["controlledAccountId","organisationId","chainId","address","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","kind","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false}}},"required":["accounts"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"post":{"operationId":"create_controlled_account","summary":"Create controlled account","description":"Create an organisation-controlled Safe or EOA execution account on one or more enabled networks.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["safe","eoa"]},"name":{"type":"string","minLength":1,"maxLength":160},"address":{"type":"string"},"chainIds":{"type":"array","items":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"minItems":1}},"required":["kind","name","address","chainIds"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["safe","eoa"]},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"controlledAccountId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["controlledAccountId","organisationId","chainId","address","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","kind","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"status":{"type":"string","enum":["created","updated","unchanged"]}},"required":["account","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/controlled-accounts/{controlledAccountId}":{"get":{"operationId":"get_controlled_account","summary":"Get controlled account","description":"Get one organisation-controlled Safe or EOA execution account.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"controlledAccountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["safe","eoa"]},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"controlledAccountId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["controlledAccountId","organisationId","chainId","address","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","kind","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false}},"required":["account"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"patch":{"operationId":"update_controlled_account","summary":"Update controlled account","description":"Rename a controlled account or replace its enabled-network set. Removing a chain is destructive. Use expectedUpdatedAt from the latest read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"controlledAccountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"chainIds":{"type":"array","items":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"minItems":1},"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["safe","eoa"]},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"controlledAccountId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["controlledAccountId","organisationId","chainId","address","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","kind","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"status":{"type":"string","enum":["created","updated","unchanged"]}},"required":["account","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true},"delete":{"operationId":"delete_controlled_account","summary":"Delete controlled account","description":"Delete an organisation-controlled execution account and its selected credential-account references. Use expectedUpdatedAt from the latest read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"controlledAccountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/registry":{"get":{"operationId":"list_registry_entries","summary":"List address-book entries","description":"List organisation address-book resources and their per-network account and contract capabilities. All filters are optional; omit them to list every entry.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["account","contract","safe","wallet"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","address","kinds","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false}}},"required":["addresses"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/registry/{address}":{"get":{"operationId":"get_registry_address","summary":"Get address-book address","description":"Get one organisation address-book address with every configured network and capability.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","address","kinds","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false}},"required":["address"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"patch":{"operationId":"update_registry_address","summary":"Rename address-book address","description":"Rename an address-book resource across all of its networks. Use expectedUpdatedAt from the latest address read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["name","expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","address","kinds","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"status":{"type":"string","enum":["created","updated","unchanged"]}},"required":["address","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},"delete":{"operationId":"delete_registry_address","summary":"Delete address-book address","description":"Delete an address-book resource on every network. Use expectedUpdatedAt from the latest address read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/registry/{chainId}/{address}":{"get":{"operationId":"get_registry_entry","summary":"Get address-book chain entry","description":"Get one network-specific address-book entry and its account or contract capabilities.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"path","required":true,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false}},"required":["entry"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"delete":{"operationId":"delete_registry_entry","summary":"Delete address-book chain entry","description":"Delete every capability for one address on one network. Use expectedUpdatedAt from the latest chain read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"path","required":true,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/registry/accounts":{"post":{"operationId":"create_registry_account","summary":"Create address-book account","description":"Create Safe or wallet capabilities for an address on one or more enabled networks. Use contract tools separately to add contract capabilities.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chainIds":{"type":"array","items":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"minItems":1},"address":{"type":"string"},"accountKind":{"type":"string","enum":["safe","wallet"]},"name":{"type":"string","minLength":1,"maxLength":160}},"required":["chainIds","address","accountKind","name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","address","kinds","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"status":{"type":"string","const":"created"}},"required":["address","entries","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/registry/{address}/account-chains":{"post":{"operationId":"add_registry_account_chains","summary":"Add address-book account chains","description":"Add Safe or wallet capabilities on additional enabled networks. Use expectedUpdatedAt from the latest address read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chainIds":{"type":"array","items":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"minItems":1},"accountKind":{"type":"string","enum":["safe","wallet"]},"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["chainIds","accountKind","expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"name":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"minItems":1},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","address","kinds","name","chains","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"status":{"type":"string","enum":["created","updated","unchanged"]}},"required":["address","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/registry/{chainId}/{address}/account":{"put":{"operationId":"update_registry_account","summary":"Update address-book account capability","description":"Set, replace, or remove the Safe or wallet capability on one network while preserving any contract capability. Use expectedUpdatedAt from the latest chain read.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"path","required":true,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountKind":{"anyOf":[{"type":"string","enum":["safe","wallet"]},{"type":"null"}]},"expectedUpdatedAt":{"type":"string","format":"date-time"}},"required":["accountKind","expectedUpdatedAt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"status":{"type":"string","enum":["updated","unchanged"]}},"required":["entry","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/contracts":{"get":{"operationId":"list_contracts","summary":"List saved contracts","description":"List ABI-backed contracts saved in the organisation registry.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"query","required":false,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"contracts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false}}},"required":["contracts"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"post":{"operationId":"register_contract","summary":"Register contract","description":"Save a contract capability using one explicit ABI mode: none omits every ABI selection field; provided requires abi; sourcify requires the inspected abiDigest and may select sourcifyTarget.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":160},"abiSource":{"type":"string","enum":["sourcify","provided","none"]},"abi":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},"abiDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"sourcifyTarget":{"type":"string","enum":["recommended","proxy","implementation"]}},"required":["chainId","address","name","abiSource"],"allOf":[{"if":{"properties":{"abiSource":{"const":"none"}},"required":["abiSource"]},"then":{"not":{"anyOf":[{"required":["abi"]},{"required":["abiDigest"]},{"required":["sourcifyTarget"]}]}}},{"if":{"properties":{"abiSource":{"const":"provided"}},"required":["abiSource"]},"then":{"required":["abi"],"not":{"anyOf":[{"required":["sourcifyTarget"]}]}}},{"if":{"properties":{"abiSource":{"const":"sourcify"}},"required":["abiSource"]},"then":{"required":["abiDigest"],"not":{"anyOf":[{"required":["abi"]}]}}}],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]},"status":{"type":"string","enum":["created","unchanged"]}},"required":["contract","abiDigest","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/contracts/{chainId}/{address}":{"get":{"operationId":"get_contract","summary":"Get saved contract","description":"Get one saved contract and its ABI from the organisation registry.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"path","required":true,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"abiDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"required":["contract"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"put":{"operationId":"update_contract","summary":"Update contract ABI","description":"Replace or remove a saved contract ABI using one explicit ABI mode: none omits every ABI selection field; provided requires abi; sourcify requires the inspected abiDigest and may select sourcifyTarget. Always supply the current ABI digest or null and expectedUpdatedAt.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"path","required":true,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"abiSource":{"type":"string","enum":["sourcify","provided","none"]},"abi":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},"abiDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"sourcifyTarget":{"type":"string","enum":["recommended","proxy","implementation"]},"expectedUpdatedAt":{"type":"string","format":"date-time"},"expectedCurrentAbiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abiSource","expectedUpdatedAt","expectedCurrentAbiDigest"],"allOf":[{"if":{"properties":{"abiSource":{"const":"none"}},"required":["abiSource"]},"then":{"not":{"anyOf":[{"required":["abi"]},{"required":["abiDigest"]},{"required":["sourcifyTarget"]}]}}},{"if":{"properties":{"abiSource":{"const":"provided"}},"required":["abiSource"]},"then":{"required":["abi"],"not":{"anyOf":[{"required":["sourcifyTarget"]}]}}},{"if":{"properties":{"abiSource":{"const":"sourcify"}},"required":["abiSource"]},"then":{"required":["abiDigest"],"not":{"anyOf":[{"required":["abi"]}]}}}],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]},"status":{"type":"string","enum":["updated","unchanged"]}},"required":["contract","abiDigest","status"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true},"delete":{"operationId":"delete_contract","summary":"Delete contract capability","description":"Delete the contract capability while preserving any Safe or wallet capability. Contract-only chain entries are deleted to avoid inert addresses.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chainId","in":"path","required":true,"schema":{"type":"string","pattern":"^(0|[1-9]\\d*)$"}},{"name":"address","in":"path","required":true,"schema":{"type":"string"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedUpdatedAt":{"type":"string","format":"date-time"},"expectedCurrentAbiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["expectedUpdatedAt","expectedCurrentAbiDigest"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"registry.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"x-anthropic-requires-user-interaction":true,"x-txcast-requires-user-confirmation":true}},"/organisations/{organisationId}/contracts/inspect":{"post":{"operationId":"inspect_contract","summary":"Inspect contract","description":"Inspect onchain bytecode and look for verified proxy or implementation ABIs on Sourcify. This does not save anything.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"}},"required":["chainId","address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"saved":{"anyOf":[{"type":"object","properties":{"contract":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["evm_address"]},"organisationId":{"type":"string","format":"uuid"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["contract","safe","wallet"]},"minItems":1},"account":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["safe","wallet"]}},"required":["kind"],"additionalProperties":false},{"type":"null"}]},"contract":{"anyOf":[{"type":"object","properties":{"abi":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},{"type":"null"}]},"abiSource":{"anyOf":[{"type":"string","enum":["provided","sourcify"]},{"type":"null"}]},"abiSourceAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"abiDigest":{"anyOf":[{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},{"type":"null"}]}},"required":["abi"],"additionalProperties":false},{"type":"null"}]},"name":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","organisationId","chainId","address","kinds","account","contract","name","createdByUserId","createdAt","updatedAt"],"additionalProperties":false},"abiDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"required":["contract"],"additionalProperties":false},{"type":"null"}]},"code":{"type":"object","properties":{"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"hasCode":{"type":["boolean","null"]},"status":{"type":"string","enum":["valid","unknown"]},"message":{"type":"string"}},"required":["chainId","address","hasCode","status","message"],"additionalProperties":false},"abi":{"type":"object","properties":{"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"status":{"type":"string","enum":["found","not_found","unknown"]},"message":{"type":"string"},"proxy":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","minLength":1},"implementationAddress":{"type":"string"}},"required":["kind","implementationAddress"],"additionalProperties":false},{"type":"null"}]},"proxyAbi":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"sourcify"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"name":{"type":["string","null"]},"abi":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},"abiDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"required":["source","chainId","address","name","abi"],"additionalProperties":false},{"type":"null"}]},"implementationAbi":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"sourcify"},"chainId":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"address":{"type":"string"},"name":{"type":["string","null"]},"abi":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["constructor","error","event","fallback","function","receive"]}},"required":["type"],"additionalProperties":true},"minItems":1},"abiDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"required":["source","chainId","address","name","abi"],"additionalProperties":false},{"type":"null"}]},"recommended":{"anyOf":[{"type":"string","enum":["proxy","implementation"]},{"type":"null"}]}},"required":["chainId","address","status","message","proxy","proxyAbi","implementationAbi","recommended"],"additionalProperties":false}},"required":["saved","code","abi"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}},"/organisations/{organisationId}/workflows":{"get":{"operationId":"list_workflows","summary":"List durable workflows","description":"List durable workflows and their current immutable revisions using stable keyset pagination.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"includeArchived","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"beforeId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"workflows":{"type":"array","items":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"ownerUserId":{"type":"string","format":"uuid"},"currentRevisionId":{"type":"string","format":"uuid"},"forkSourceWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceProgramManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"archiveReason":{"anyOf":[{"type":"string","enum":["owner_requested","owner_membership_lost","owner_unseated"]},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","ownerUserId","currentRevisionId","forkSourceWorkflowId","forkSourceRevisionId","forkSourceProgramManifestDigest","archivedAt","archiveReason","version","createdAt","updatedAt"],"additionalProperties":false},"currentRevision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"metadata":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"required":["name","description"],"additionalProperties":false}},"required":["repository","currentRevision","metadata"],"additionalProperties":false},"maxItems":100},"nextPage":{"anyOf":[{"type":"object","properties":{"before":{"type":"string","format":"date-time"},"beforeId":{"type":"string","format":"uuid"}},"required":["before","beforeId"],"additionalProperties":false},{"type":"null"}]}},"required":["workflows","nextPage"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},"post":{"operationId":"create_workflow","summary":"Create durable workflow","description":"Create an owned durable workflow with a valid compiled version 1 that is immediately current and runnable.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"}},"required":["source"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"ownerUserId":{"type":"string","format":"uuid"},"currentRevisionId":{"type":"string","format":"uuid"},"forkSourceWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceProgramManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"archiveReason":{"anyOf":[{"type":"string","enum":["owner_requested","owner_membership_lost","owner_unseated"]},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","ownerUserId","currentRevisionId","forkSourceWorkflowId","forkSourceRevisionId","forkSourceProgramManifestDigest","archivedAt","archiveReason","version","createdAt","updatedAt"],"additionalProperties":false},"currentRevision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"}},"required":["repository","currentRevision","cas","backendArtifactDigest"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"workflow.source.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}":{"get":{"operationId":"get_workflow","summary":"Get durable workflow","description":"Read a durable workflow's current source, workflow CAS, metadata, and recent immutable revisions.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"ownerUserId":{"type":"string","format":"uuid"},"currentRevisionId":{"type":"string","format":"uuid"},"forkSourceWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceProgramManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"archiveReason":{"anyOf":[{"type":"string","enum":["owner_requested","owner_membership_lost","owner_unseated"]},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","ownerUserId","currentRevisionId","forkSourceWorkflowId","forkSourceRevisionId","forkSourceProgramManifestDigest","archivedAt","archiveReason","version","createdAt","updatedAt"],"additionalProperties":false},"currentRevision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"metadata":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"required":["name","description"],"additionalProperties":false},"inputSchema":{},"source":{"type":"string"},"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"maxItems":100},"headGraph":{"anyOf":[{"type":"object","properties":{"revisionId":{"type":"string","format":"uuid"},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"callsites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"effectKind":{"type":"string","enum":["evm.snapshot","http.snapshot","evm.waitForEvent","timer.wait","human.confirm","human.choice","human.form","notification.send","evm.transactions"]},"line":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"column":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"start":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"end":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","effectKind","line","column","start","end"],"additionalProperties":false},"maxItems":10000},"controlFlow":{"type":"object","properties":{"completeness":{"type":"string","enum":["complete","dynamic","partial"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["entry","effect","branch","loop","join","return"]},"callsiteId":{"type":"string","minLength":1,"maxLength":256},"label":{"type":"string","minLength":1,"maxLength":512}},"required":["id","kind"],"additionalProperties":false},"maxItems":20000},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1,"maxLength":256},"to":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["always","true","false","iteration","dynamic"]}},"required":["from","to","kind"],"additionalProperties":false},"maxItems":40000}},"required":["completeness","nodes","edges"],"additionalProperties":false}},"required":["revisionId","programManifestDigest","sourceDigest","callsites","controlFlow"],"additionalProperties":false},{"type":"null"}]}},"required":["repository","currentRevision","metadata","inputSchema","source","cas","revisions","headGraph"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/revisions":{"get":{"operationId":"list_workflow_revisions","summary":"List durable workflow revisions","description":"List immutable revisions in descending version order using stable pagination.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"beforeRevisionNumber","in":"query","required":false,"schema":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"maxItems":100},"nextPage":{"anyOf":[{"type":"object","properties":{"beforeRevisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991}},"required":["beforeRevisionNumber"],"additionalProperties":false},{"type":"null"}]}},"required":["revisions","nextPage"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/revisions/{revisionId}":{"get":{"operationId":"get_workflow_revision","summary":"Get durable workflow revision","description":"Read one immutable workflow revision and its canonical TypeScript source.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"source":{"type":"string"}},"required":["revision","source"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/revision-diff":{"get":{"operationId":"get_workflow_revision_diff","summary":"Get durable workflow revision diff inputs","description":"Read the canonical source and identity snapshots for two revisions so the caller can render or reconcile a diff.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fromRevisionId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"toRevisionId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"anyOf":[{"type":"object","properties":{"revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"source":{"type":"string"}},"required":["revision","source"],"additionalProperties":false},{"type":"null"}]},"to":{"type":"object","properties":{"revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"source":{"type":"string"}},"required":["revision","source"],"additionalProperties":false}},"required":["from","to"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/runs":{"get":{"operationId":"list_runs","summary":"List durable workflow runs","description":"List durable workflow runs using bounded keyset pagination. Every filter is optional; omit workflowId for an organisation-wide list and supply only filters requested by the user.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["running","completed","failed","cancelled"]},"minItems":1,"maxItems":4}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"beforeId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"status":{"type":"string","enum":["running","completed","failed","cancelled"]},"visibility":{"type":"string","enum":["organisation","public_link"]},"inputDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"inputBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"effectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unresolvedEffectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"failedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","workflowId","organisationId","revisionId","programManifestDigest","backendArtifactDigest","status","visibility","inputDigest","inputBytes","creatorUserId","effectCount","unresolvedEffectCount","startedAt","completedAt","failedAt","cancelledAt","version","createdAt","updatedAt"],"additionalProperties":false},"maxItems":100},"nextPage":{"anyOf":[{"type":"object","properties":{"before":{"type":"string","format":"date-time"},"beforeId":{"type":"string","format":"uuid"}},"required":["before","beforeId"],"additionalProperties":false},{"type":"null"}]}},"required":["runs","nextPage"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/runs/{runId}":{"get":{"operationId":"get_run","summary":"Get durable workflow run","description":"Read one durable workflow run including its frozen input and terminal output or error.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"status":{"type":"string","enum":["running","completed","failed","cancelled"]},"visibility":{"type":"string","enum":["organisation","public_link"]},"inputDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"inputBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"effectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unresolvedEffectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"failedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"input":{},"output":{"anyOf":[{},{"type":"null"}]},"outputDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Z0-9_]+$"},"message":{"type":"string","minLength":1,"maxLength":2000},"details":{}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]},"errorDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"graph":{"type":"object","properties":{"callsites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"effectKind":{"type":"string","enum":["evm.snapshot","http.snapshot","evm.waitForEvent","timer.wait","human.confirm","human.choice","human.form","notification.send","evm.transactions"]},"line":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"column":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"start":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"end":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","effectKind","line","column","start","end"],"additionalProperties":false},"maxItems":10000},"controlFlow":{"type":"object","properties":{"completeness":{"type":"string","enum":["complete","dynamic","partial"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["entry","effect","branch","loop","join","return"]},"callsiteId":{"type":"string","minLength":1,"maxLength":256},"label":{"type":"string","minLength":1,"maxLength":512}},"required":["id","kind"],"additionalProperties":false},"maxItems":20000},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1,"maxLength":256},"to":{"type":"string","minLength":1,"maxLength":256},"kind":{"type":"string","enum":["always","true","false","iteration","dynamic"]}},"required":["from","to","kind"],"additionalProperties":false},"maxItems":40000}},"required":["completeness","nodes","edges"],"additionalProperties":false},"traversedEdges":{"type":"array","items":{"type":"object","properties":{"nodeId":{"type":"string","pattern":"^(?:branch|loop):[0-9]+$"},"edgeKind":{"type":"string","enum":["true","false","iteration"]},"count":{"type":"string","pattern":"^[1-9][0-9]*$"}},"required":["nodeId","edgeKind","count"],"additionalProperties":false},"maxItems":20000}},"required":["callsites","controlFlow","traversedEdges"],"additionalProperties":false}},"required":["id","workflowId","organisationId","revisionId","programManifestDigest","backendArtifactDigest","status","visibility","inputDigest","inputBytes","creatorUserId","effectCount","unresolvedEffectCount","startedAt","completedAt","failedAt","cancelledAt","version","createdAt","updatedAt","input","output","outputDigest","error","errorDigest","graph"],"additionalProperties":false}},"required":["run"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/runs/{runId}/effects":{"get":{"operationId":"list_run_effects","summary":"List durable run effects","description":"Inspect concrete effect occurrences, attempts, selected observations, and sanitized transaction review state.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"afterOrdinal","in":"query","required":false,"schema":{"type":"integer","minimum":-1,"maximum":9999,"default":-1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":250,"default":100}}],"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"effects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"creationOrdinal":{"type":"integer","minimum":0,"maximum":9999},"key":{"type":"string","minLength":1,"maxLength":128},"kind":{"type":"string","enum":["evm.snapshot","http.snapshot","evm.waitForEvent","timer.wait","human.confirm","human.choice","human.form","notification.send","evm.transactions"]},"callsiteId":{"anyOf":[{"type":"string","pattern":"^callsite:[0-9a-f]{32}$"},{"type":"null"}]},"request":{},"requestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"frozenExecution":{"anyOf":[{},{"type":"null"}]},"frozenExecutionDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"maxResultBytes":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","waiting","action_required","in_progress","succeeded","failed","cancelled"]},"outcome":{"anyOf":[{},{"type":"null"}]},"resultDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"acceptedAt":{"type":"string","format":"date-time"},"terminalAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"version":{"type":"string","pattern":"^[1-9][0-9]*$"},"attempts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ordinal":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"operation":{"type":"string","minLength":1,"maxLength":64},"status":{"type":"string","enum":["pending","claimed","in_progress","waiting","succeeded","failed","abandoned","cancelled"]},"retryAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"finishedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"version":{"type":"string","pattern":"^[1-9][0-9]*$"}},"required":["id","ordinal","operation","status","retryAt","startedAt","finishedAt","errorCode","errorMessage","version"],"additionalProperties":false},"maxItems":100},"selectedObservation":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ordinal":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"string","enum":["automatic","manual"]},"changed":{"type":"boolean"},"chainId":{"anyOf":[{"type":"string","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"pinnedBlockNumber":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"pinnedBlockHash":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"result":{},"semanticDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"observedAt":{"type":"string","format":"date-time"}},"required":["id","ordinal","source","changed","chainId","pinnedBlockNumber","pinnedBlockHash","result","semanticDigest","observedAt"],"additionalProperties":false},{"type":"null"}]},"transaction":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"controlledAccountKind":{"type":"string","enum":["safe","eoa"]},"controlledAccountName":{"type":"string","minLength":1,"maxLength":160},"chainId":{"type":"string","pattern":"^[1-9][0-9]*$"},"accountAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"label":{"type":"string","minLength":1,"maxLength":160},"queueSequence":{"type":"string","pattern":"^[1-9][0-9]*$"},"frozenExecutionDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"calls":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kind":{"type":"string","enum":["abi","registry-abi","raw"]},"targetAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"value":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"calldata":{"type":"string","pattern":"^0x(?:[0-9a-fA-F]{2})*$"},"annotation":{}},"required":["index","kind","targetAddress","value","calldata","annotation"],"additionalProperties":false}},"execution":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"safe"},"attempt":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ordinal":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["prepared","proposed","signing","ready_to_execute","executing","confirmed_success","confirmed_failed","rejected","invalidated"]},"version":{"type":"string","pattern":"^[1-9][0-9]*$"},"safeNonce":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"owners":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"minItems":1},"threshold":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"callCount":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"typedData":{},"safeTxHash":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"evidenceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"executionTxHash":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"signatures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"signerAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"signatureDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"action":{"type":"string","enum":["proposal","confirmation"]},"status":{"type":"string","enum":["pending","processing","submitted","failed","superseded"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","signerAddress","signatureDigest","action","status","createdAt","updatedAt"],"additionalProperties":false}}},"required":["id","ordinal","status","version","safeNonce","owners","threshold","callCount","typedData","safeTxHash","evidenceDigest","executionTxHash","signatures"],"additionalProperties":false},{"type":"null"}]}},"required":["kind","attempt"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"eoa"},"attempts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"callIndex":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["action_required","claimed","broadcast","confirmed_success","confirmed_reverted","verification_failed"]},"version":{"type":"string","pattern":"^[1-9][0-9]*$"},"accountNonce":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},{"type":"null"}]},"transactionHash":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"required":["id","callIndex","status","version","accountNonce","transactionHash","errorCode","errorMessage"],"additionalProperties":false}}},"required":["kind","attempts"],"additionalProperties":false}]}},"required":["id","controlledAccountKind","controlledAccountName","chainId","accountAddress","label","queueSequence","frozenExecutionDigest","calls","execution"],"additionalProperties":false},{"type":"null"}]}},"required":["id","creationOrdinal","key","kind","callsiteId","request","requestDigest","frozenExecution","frozenExecutionDigest","maxResultBytes","status","outcome","resultDigest","acceptedAt","terminalAt","version","attempts","selectedObservation","transaction"],"additionalProperties":false},"maxItems":250},"nextAfterOrdinal":{"anyOf":[{"type":"integer","minimum":0,"maximum":9999},{"type":"null"}]}},"required":["effects","nextAfterOrdinal"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"organisation.read","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflow-source/validate":{"post":{"operationId":"validate_workflow_source","summary":"Validate durable workflow source","description":"Compile TypeScript workflow source and validate its capability envelope against this credential without changing workflow state.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"}},"required":["source"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"diagnostics":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":128},"message":{"type":"string","minLength":1,"maxLength":2000},"line":{"type":"integer","minimum":0},"column":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":0}},"required":["code","message","line","column","length"],"additionalProperties":false},"maxItems":200},"sourceDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"programManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]}},"required":["ok","diagnostics","sourceDigest","programManifestDigest"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"workflow.source.write","x-mcp-tool-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/fork":{"post":{"operationId":"fork_workflow","summary":"Fork durable workflow","description":"Fork an organisation workflow revision into a new owned workflow with its own compiled version 1.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceRevisionId":{"type":"string","format":"uuid"}},"required":["sourceRevisionId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"ownerUserId":{"type":"string","format":"uuid"},"currentRevisionId":{"type":"string","format":"uuid"},"forkSourceWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceProgramManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"archiveReason":{"anyOf":[{"type":"string","enum":["owner_requested","owner_membership_lost","owner_unseated"]},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","ownerUserId","currentRevisionId","forkSourceWorkflowId","forkSourceRevisionId","forkSourceProgramManifestDigest","archivedAt","archiveReason","version","createdAt","updatedAt"],"additionalProperties":false},"currentRevision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"}},"required":["repository","currentRevision","cas","backendArtifactDigest"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"workflow.source.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/source":{"put":{"operationId":"save_workflow","summary":"Save durable workflow","description":"Compile, capability-check, prepare an immutable backend artifact, and atomically activate the next linear revision using workflow CAS. Canonically unchanged source is a no-op.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"source":{"type":"string"}},"required":["cas","source"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"ownerUserId":{"type":"string","format":"uuid"},"currentRevisionId":{"type":"string","format":"uuid"},"forkSourceWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceProgramManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"archiveReason":{"anyOf":[{"type":"string","enum":["owner_requested","owner_membership_lost","owner_unseated"]},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","ownerUserId","currentRevisionId","forkSourceWorkflowId","forkSourceRevisionId","forkSourceProgramManifestDigest","archivedAt","archiveReason","version","createdAt","updatedAt"],"additionalProperties":false},"currentRevision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"created":{"type":"boolean"}},"required":["repository","currentRevision","cas","backendArtifactDigest","created"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"workflow.source.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/restores":{"post":{"operationId":"restore_workflow_revision","summary":"Restore durable workflow revision","description":"Append and activate a compensating revision from an earlier immutable revision using workflow CAS.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"sourceRevisionId":{"type":"string","format":"uuid"}},"required":["cas","sourceRevisionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"ownerUserId":{"type":"string","format":"uuid"},"currentRevisionId":{"type":"string","format":"uuid"},"forkSourceWorkflowId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"forkSourceProgramManifestDigest":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-f]{64}$"},{"type":"null"}]},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"archiveReason":{"anyOf":[{"type":"string","enum":["owner_requested","owner_membership_lost","owner_unseated"]},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","organisationId","ownerUserId","currentRevisionId","forkSourceWorkflowId","forkSourceRevisionId","forkSourceProgramManifestDigest","archivedAt","archiveReason","version","createdAt","updatedAt"],"additionalProperties":false},"currentRevision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"revisionNumber":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"parentRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["created","saved","forked","restored"]},"restoredFromRevisionId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"authorUserId":{"type":"string","format":"uuid"},"sourceDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"bundleDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"capabilitiesDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"createdAt":{"type":"string","format":"date-time"},"agent":{"anyOf":[{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"credentialName":{"type":"string","minLength":1,"maxLength":80},"transport":{"type":"string","enum":["rest","mcp"]}},"required":["credentialId","credentialName","transport"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workflowId","revisionNumber","parentRevisionId","operation","restoredFromRevisionId","programManifestDigest","backendArtifactDigest","authorUserId","sourceDigest","bundleDigest","capabilitiesDigest","createdAt","agent"],"additionalProperties":false},"cas":{"type":"object","properties":{"protocol":{"type":"string","const":"txcast-workflow-linear-cas-v1"},"workflowId":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"currentRevisionId":{"type":"string","format":"uuid"}},"required":["protocol","workflowId","version","currentRevisionId"],"additionalProperties":false},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"created":{"type":"boolean","const":true}},"required":["repository","currentRevision","cas","backendArtifactDigest","created"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"workflow.source.write","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}},"/organisations/{organisationId}/workflows/{workflowId}/runs":{"post":{"operationId":"start_run","summary":"Start durable workflow run","description":"Resolve references, freeze the run, and enqueue backend start atomically.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"description":"Raw JSON workflow input. Supply the JSON value itself; do not JSON-encode it as a string."}},"required":["input"],"additionalProperties":false}}}},"responses":{"202":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"status":{"type":"string","enum":["running","completed","failed","cancelled"]},"visibility":{"type":"string","enum":["organisation","public_link"]},"inputDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"inputBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"effectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unresolvedEffectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"failedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","workflowId","organisationId","revisionId","programManifestDigest","backendArtifactDigest","status","visibility","inputDigest","inputBytes","creatorUserId","effectCount","unresolvedEffectCount","startedAt","completedAt","failedAt","cancelledAt","version","createdAt","updatedAt"],"additionalProperties":false},"backendStartPending":{"type":"boolean","const":true}},"required":["run","backendStartPending"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"run.start","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}},"/organisations/{organisationId}/runs/{runId}/cancel":{"post":{"operationId":"cancel_run","summary":"Cancel durable workflow run","description":"Cancel an authorized running durable run using exact run-version CAS while preserving escaped transaction reconciliation.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workflowId":{"type":"string","format":"uuid"},"organisationId":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"programManifestDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"backendArtifactDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"status":{"type":"string","enum":["running","completed","failed","cancelled"]},"visibility":{"type":"string","enum":["organisation","public_link"]},"inputDigest":{"type":"string","pattern":"^0x[0-9a-f]{64}$"},"inputBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorUserId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"effectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unresolvedEffectCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"failedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","workflowId","organisationId","revisionId","programManifestDigest","backendArtifactDigest","status","visibility","inputDigest","inputBytes","creatorUserId","effectCount","unresolvedEffectCount","startedAt","completedAt","failedAt","cancelledAt","version","createdAt","updatedAt"],"additionalProperties":false},"backendCancelPending":{"type":"boolean"}},"required":["run","backendCancelPending"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"run.cancel","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}}},"/organisations/{organisationId}/runs/{runId}/effects/{effectId}/refresh":{"post":{"operationId":"refresh_source","summary":"Refresh durable source observation","description":"Queue a manual refresh for a completed EVM or HTTP snapshot without changing the logical effect outcome or program history.","tags":["Agent API"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"organisationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"effectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Txcast-Agent-Name","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Txcast-Agent-Version","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7e]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for safely retrying this explicit mutation.","schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedEffectVersion":{"type":"integer","exclusiveMinimum":0,"minimum":-9007199254740991,"maximum":9007199254740991}},"required":["expectedEffectVersion"],"additionalProperties":false}}}},"responses":{"202":{"description":"Successful command result","content":{"application/json":{"schema":{"type":"object","properties":{"attemptId":{"type":"string","format":"uuid"},"operation":{"type":"string","enum":["evm.snapshot.refresh","http.snapshot.refresh"]},"queued":{"type":"boolean","const":true}},"required":["attemptId","operation","queued"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"default":{"description":"Structured API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","RATE_LIMITED","VALIDATION_ERROR","INVALID_JSON","INTERNAL_ERROR","RESPONSE_VALIDATION_ERROR","PLAN_LIMIT_EXCEEDED","ORGANISATION_SEAT_REQUIRED","BILLING_PROVIDER_UNAVAILABLE","BILLING_CHECKOUT_NOT_REQUIRED","NOTIFICATION_PLATFORM_UNAVAILABLE","REAUTHENTICATION_REQUIRED","IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS","ABI_CONFLICT","ABI_DIGEST_STALE","SOURCIFY_UNAVAILABLE","COW_ORDER_ACTIVE","STALE_WORKFLOW_REVISION","FEATURE_DISABLED","MAINTENANCE_MODE","RESOURCE_LIMIT_EXCEEDED","WORKFLOW_REFERENCES_UNAVAILABLE"]},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":["string","number"]}},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}},"retryable":{"type":"boolean"},"retryAt":{"type":"string","format":"date-time"},"correlationId":{"type":"string","format":"uuid"}},"required":["code","message","retryable","correlationId"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},"x-txcast-required-credential-scope":"run.source.refresh","x-mcp-tool-annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}