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

# Publishing & Deployment

> Run a Flow draft, publish it, review its version history, and find the current API reference.

Each Flow has a current draft, publishing controls, and version history. Use the Flow canvas to run the draft before publishing, then use the API Reference for the current programmatic build and publishing endpoints.

<h2 id="publish-your-agent">
  Publish your agent
</h2>

<Steps>
  <Step title="Open the Flow">
    Open the agent's **Flow**. The header shows the current draft state and the **Publish** control.
  </Step>

  <Step title="Run the current draft">
    Select **Execute flow** to run the draft version of the Flow before you publish it.
  </Step>

  <Step title="Publish the Flow">
    Select **Publish** when the Flow is ready to make the current draft the active version.
  </Step>

  <Step title="Review version history">
    Open the **Draft** control to view the current draft and previous Flow versions. The current active version is identified in the history.

    <Frame>
      <img src="https://mintcdn.com/beamai/5sjMFBB-gamSkrEM/02-building-agents/advanced-patterns/publishing-deployment/flow-version-history-current.png?fit=max&auto=format&n=5sjMFBB-gamSkrEM&q=85&s=3e3d299185da612d9a79c399b7409785" alt="The Flow header's Version history menu showing the current unpublished draft and a previous active version." width="800" height="600" data-path="02-building-agents/advanced-patterns/publishing-deployment/flow-version-history-current.png" />
    </Frame>
  </Step>
</Steps>

<h2 id="deployment-access">
  Use the API
</h2>

Beam's API supports programmatic agent-building and publishing workflows. Endpoint names and request formats can change, so use the generated [API Reference](/08-reference/api/overview/overview) for the current API details rather than copying endpoint examples from this guide.

<h2 id="deployment-best-practices">
  Drafts and version history
</h2>

Use **Execute flow** to test the draft. The **Draft** control opens version history, where Beam distinguishes the current draft from previous active Flow versions.

<h2 id="api-documentation">
  API documentation
</h2>

For complete API reference, authentication details, and current endpoint documentation, see the [API Reference](/08-reference/api/overview/overview).

<h2 id="next-steps">
  Next steps
</h2>

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/08-reference/api/overview/overview">
    Complete API documentation and endpoints
  </Card>

  <Card title="Multi-Agent Collaboration" icon="diagram-project" href="/02-building-agents/advanced-patterns/multi-agent-collaboration/multi-agent-collaboration">
    Coordinate multiple agents in production
  </Card>

  <Card title="Triggers & Webhooks" icon="bolt" href="/03-running-operations/task-management/triggers-webhooks/triggers-webhooks">
    Automate agent execution with triggers and webhooks
  </Card>

  <Card title="Task Executions" icon="list-check" href="/03-running-operations/task-management/task-executions/task-executions">
    Monitor and track production tasks
  </Card>
</CardGroup>