How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Ava Protocol

Ava Protocol Workflows API

Workflow CRUD and lifecycle actions

Documentation Provider Profile APIs.io OpenAPI GitHub

Ava Protocol Workflows API is one of 10 APIs that Ava Protocol publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Workflows. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 10 operations across 8 paths, and defines 68 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 3 base URLs: https://gateway.avaprotocol.org/api/v1, https://gateway-staging.avaprotocol.org/api/v1, http://localhost:8080/api/v1.

10 operations 8 paths 68 schemas 1 DELETE3 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://gateway.avaprotocol.org/api/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Ava Protocol Workflows API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — JWT bearer token. Obtained via POST /auth:exchange (wallet signature flow) or via the operator-run create-api-key CLI (long-lived, server-to-server). Send on e…

Paths & Operations 10

Across 8 paths, the API surfaces 10 operations — 1 DELETE, 3 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Workflows 10

Workflow CRUD and lifecycle actions

POST
/workflows
Create a workflow
createWorkflow body → 201400401403429
GET
/workflows
List workflows
listWorkflows 5 params → 200401429
GET
/workflows/{id}
Retrieve a workflow
getWorkflow 1 param → 200401404
DELETE
/workflows/{id}
Cancel a workflow
cancelWorkflow 1 param → 204401404
POST
/workflows/{id}:pause
Pause a workflow
pauseWorkflow 1 param → 200401404409
POST
/workflows/{id}:resume
Resume a workflow
resumeWorkflow 1 param → 200401404409
POST
/workflows/{id}:trigger
Manually trigger a workflow
triggerWorkflow 1 param body → 202200400401404412
POST
/workflows:simulate
Simulate a workflow without persisting it
simulateWorkflow body → 200400401
POST
/workflows:estimateFees
Estimate per-execution fees for a workflow definition
estimateWorkflowFees body → 200400401
GET
/workflows:count
Count workflows
countWorkflows 2 params → 200401

Schemas 68

The contract defines 68 schemas that model the data the API accepts and returns. The most detailed are Workflow (15 properties), CreateWorkflowRequest (9 properties), EstimateFeesRequest (9 properties), ContractWriteNodeConfig (8 properties). Each schema is shown below with its type and property counts.

ContractReadNode
CustomCodeNodeConfig
object
2 properties 2 required
EthereumAddress
string
Lowercase or checksummed hex EOA / contract address.
ETHTransferNode
FeeDiscount
object
5 properties
LoopNodeConfig
object
Iterates over an input array, running an inner Node per item. The runner node is one of the chain-aware or chain-agnostic node types; a chain-aware runner must…
3 properties 2 required
ExecutionTier
string
Pricing group for value-capture fees.
ContractWriteNode
WorkflowCount
object
1 property 1 required
FixedTimeTrigger
TriggerWorkflowRequest
object
4 properties 1 required
AwaitNode
EventCondition
object
Predicate evaluated against decoded event data.
4 properties 3 required
Fee
object
2 properties 2 required
BlockTrigger
GraphQLQueryNodeConfig
object
3 properties 2 required
PageInfo
object
4 properties 2 required
ContractWriteNodeConfig
object
8 properties 2 required
WorkflowStatus
string
Lifecycle status. enabled means actively monitored; disabled is paused. running, completed, failed are terminal-ish states emitted during/after execution.
GraphQLQueryNode
Lang
string
Language/format of an inline payload (e.g., custom code source, manual trigger data). Mirrors the proto Lang enum minus the LANG prefix. Wire values are lowerc…
BranchCondition
object
3 properties 2 required
FilterNodeConfig
object
2 properties 2 required
BalanceNode
WorkflowList
object
2 properties 2 required
EventTriggerConfig
object
Fires when matching on-chain events are observed.
3 properties 2 required
CustomCodeNode
EventTrigger
FilterNode
ChainId
integer
Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filt…
RestAPINode
Workflow
object
15 properties 6 required
CronTrigger
EventTriggerQuery
object
Single ethereum.FilterQuery — one subscription per query.
6 properties
Node
object
3 properties 3 required
Problem
object
RFC 7807 problem+json. Returned as application/problem+json on any 4xx/5xx response. type and title describe the error class; detail is human-readable; instanc…
6 properties 3 required
BlockTriggerConfig
object
Fires every N blocks on the target chain.
2 properties 2 required
LoopNode
Hex
string
Arbitrary-length hex-encoded byte string.
Ulid
string
ULID identifier (26-char Crockford base32).
ETHTransferNodeConfig
object
3 properties 3 required
CreateWorkflowRequest
object
9 properties 3 required
ManualTrigger
ContractReadNodeConfig
object
4 properties 2 required
EventMethodCall
object
4 properties 1 required
Timestamp
string
RFC 3339 timestamp.
NodeCOGS
object
4 properties 3 required
ValueFee
object
6 properties 2 required
InputVariables
object
Free-form key-value bag of values used to resolve {{variable.path}} template references inside trigger and node configs. Conventional well-known keys: settings…
BranchNode
TriggerWorkflowResponse
object
5 properties 2 required
AwaitNodeConfig
object
Pauses the workflow until a wake arrives (durable execution). Two mutually exclusive flavors: the external-signal flavor (human approval — set channel, e.g. a…
5 properties
BalanceNodeConfig
object
6 properties 2 required
FixedTimeTriggerConfig
object
Fires at one or more absolute Unix-epoch milliseconds.
1 property 1 required
Edge
object
3 properties 3 required
RestAPINodeConfig
object
5 properties 2 required
ExecutionStatus
string
Outcome of an execution. pending is in-flight; waiting is suspended mid-workflow at an await node, durably parked until a signal arrives (a human approve/rejec…
TriggerType
string
Discriminator field for the Trigger union. Mirrors the proto TriggerType enum but without the TRIGGERTYPE prefix.
EstimateFeesRequest
object
9 properties 5 required
MethodCall
object
One call to a contract method (used by ContractWrite + ContractRead).
4 properties 1 required
Trigger
object
3 properties 3 required
NativeToken
object
2 properties 2 required
CronTriggerConfig
object
Fires on one or more cron schedules.
2 properties 1 required
SimulateWorkflowRequest
object
5 properties 3 required
EstimateFeesResponse
object
7 properties 4 required
BranchNodeConfig
object
1 property 1 required
ManualTriggerConfig
object
User-initiated trigger; no chain context.
4 properties 1 required
NodeType
string
Discriminator field for the Node union. Mirrors the proto NodeType enum but without the NODETYPE prefix.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ava-protocol-workflows-api-openapi.yml Raw ↑

Other APIs Ava Protocol publishes across the network.

Ava Protocol Auth API
AE Profile APIs.io
Ava Protocol Executions API
AE Profile APIs.io
Ava Protocol Health API
AE Profile APIs.io
Ava Protocol Nodes API
AE Profile APIs.io
Ava Protocol Operators API
AE Profile APIs.io
Ava Protocol Secrets API
AE Profile APIs.io
Ava Protocol Tokens API
AE Profile APIs.io
Ava Protocol Triggers API
AE Profile APIs.io
Ava Protocol Wallets API
AE Profile APIs.io
#Workflows
← Back to A APIs
API Details
ID
ava-protocol:ava-protocol-workflows-api
Base URL
https://gateway.avaprotocol.org/api/v1
Docs
https://avaprotocol.org/docs/ava-sdk-js/rest-api
Provider
Ava Protocol
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=ava-protocol-workflows-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/ava-protocol-workflows-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Ava Protocol Workflows API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.