> ## 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.

# FAQs

> Answers to common Darwin integration questions.

<AccordionGroup>
  <Accordion title="Is Search the same as Act?">
    No. Search is read-only discovery. Act starts and coordinates durable work from one exact capability revision.
  </Accordion>

  <Accordion title="Should I rerun Search before starting work?">
    No. Preserve the `capabilityId` and `capabilityRevision` the user selected. Act rejects an invalid or stale revision rather than silently substituting another provider.
  </Accordion>

  <Accordion title="Does an update approve an Action?">
    No. Updates supply information. Approvals apply only to the exact revision and reviewed payload digest returned by Darwin.
  </Accordion>

  <Accordion title="Can I put an API key in a browser or prompt?">
    No. Keep API keys on a trusted server. Use Darwin OAuth for user-facing applications and MCP clients.
  </Accordion>

  <Accordion title="How do I recover interrupted work?">
    Persist `actionId`, then call Get action. A timeout, closed popup, completed assistant response, or client restart is not proof that work failed or completed.
  </Accordion>

  <Accordion title="Which interface should I use?">
    Use the web app for a human workflow, MCP for a compatible AI client, REST for direct language-neutral integration, and an SDK for typed server application code.
  </Accordion>

  <Accordion title="How do I handle a stale capability revision?">
    Explain that the reviewed capability changed, rerun Search, show the new result and terms, then ask the user to select again. Never substitute the new revision silently.
  </Accordion>

  <Accordion title="What counts as completion?">
    Only a backend-confirmed terminal Action state. HTTP 200, a model's final answer, a redirect, or a closed browser interaction does not prove the work completed.
  </Accordion>

  <Accordion title="Where can I check service availability?">
    See the [Darwin status page](https://status.darwin.so) for current availability and incident communication.
  </Accordion>
</AccordionGroup>