Status & Result - Asteroid Agents

Status
Result

Agent during execution progresses through the following statuses:

Status	Description
Starting	Agent is initializing and preparing to run
Running	Agent is actively executing tasks
Paused	Agent execution is paused
Awaiting Confirmation	Agent is waiting for external confirmation/approval
Paused by Agent	Agent logic paused execution
Completed	Agent has finished execution successfully
Failed	Agent encountered an error and stopped (API value: `failed`)
Cancelled	Agent execution was manually stopped

Status Flow

The execution result contains the structured data your agent returns when it finishes. This includes the outcome (e.g. success/failure) and your custom JSON defined by the Result Schema.

Outcome

The execution outcome is returned by the API as execution_result.outcome. You define custom outcomes in your Output nodes (e.g., success, error, item_purchased, out_of_stock).Outcomes allow you to define meaningful end states that match your business logic rather than being limited to just success or failure.

Some executions (for example, cancelled or terminated early) may not include an execution_result. In those cases, check execution status and error fields instead.

Result Schema

Optionally configure the JSON object your agent returns when it finishes. Set it on your Output nodes. The structured payload is returned by the API at execution_result.result.

Schema Format

Our schema format follows OpenAI’s Structured Outputs specification, which is a subset of JSON Schema.

Customizable: Define simple or complex JSON (nested objects, arrays/lists, many fields).
Standards-based: Compatible with OpenAI’s structured output format. See the supported schemas documentation.
API-friendly: The API returns a parsed payload at execution_result.result that conforms to your schema.

Schema Requirements

When defining your schema:

All objects must include "additionalProperties": false
All object properties must be required - include all property keys in the required array
Use the description field to guide the AI in populating fields correctly
Follow the OpenAI Structured Outputs specification

You only need to provide the schema object itself. The platform automatically wraps it in the required format with name and strict: true parameters.

Example Schema

{
  "type": "object",
  "properties": {
    "explanation": {
      "type": "string",
      "description": "Detailed explanation of the result"
    }
  },
  "additionalProperties": false,
  "required": [
    "explanation"
  ]
}

Example output returned by the API:

{
  "explanation": "Order processed successfully and confirmation email sent"
}

Complex Schema Example

For more complex data extraction:

{
  "type": "object",
  "properties": {
    "user_name": {
      "type": "string",
      "description": "The name of the user"
    },
    "username": {
      "type": "string",
      "description": "The username of the user. Must start with @",
      "pattern": "^@[a-zA-Z0-9_]+$"
    },
    "email": {
      "type": "string",
      "description": "The email of the user",
      "format": "email"
    },
    "items": {
      "type": "array",
      "description": "List of items purchased",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Item name"
          },
          "price": {
            "type": "number",
            "description": "Item price"
          }
        },
        "additionalProperties": false,
        "required": ["name", "price"]
      }
    }
  },
  "additionalProperties": false,
  "required": ["user_name", "username", "email", "items"]
}

Where to get status and results via API

Use GET /executions/{id} to retrieve execution details, including the latest status.
Read the structured output from the same response under execution_result (for example, execution_result.outcome and execution_result.result).

​Status Flow

​Outcome

​Result Schema

​Schema Format

​Schema Requirements

​Example Schema

​Complex Schema Example

​Where to get status and results via API

Status Flow

Outcome

Result Schema

Schema Format

Schema Requirements

Example Schema

Complex Schema Example

Where to get status and results via API