> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Software & APIs

> Execute software, APIs, MCP servers, and automations through a durable Action.

Use Act after Search has identified a software capability and its exact revision. The Action keeps execution state durable across API calls, connection steps, and client restarts.

## Start with explicit inputs

Pass the selected `capabilityId`, `capabilityRevision`, required inputs, and a stable `requestId`. Treat `connection_required` as a normal pause while the user completes provider authentication.

## Resume the same Action

After an external interaction, read the existing `actionId` and continue from its current state. Do not create replacement work because a response was interrupted or delayed.

## Verify the result

Only present completion after the Action reports `completed`, and validate the returned artifact against the acceptance criteria that shaped the original Search.

[Explore this use case in Darwin](https://darwin.so/use-cases/software-apis)