dograh/examples/README.md

# Dograh SDK Examples

Runnable examples of the Dograh SDK in Python and TypeScript.

## Shared environment variables

Copy `.env.example` to `.env` in each example directory and fill in your values, then `source .env` (or use your preferred dotenv loader).

| Variable              | Description                                                  |
| --------------------- | ------------------------------------------------------------ |
| `DOGRAH_API_ENDPOINT` | Dograh API base URL (e.g. `http://localhost:8000`)           |
| `DOGRAH_API_TOKEN`    | API token — sent as `X-API-Key`                              |

The workflow ID and destination phone number are set as constants at the top of each example script — edit them there.

## Python

```bash
pip install dograh-sdk

export DOGRAH_API_ENDPOINT=http://localhost:8000
export DOGRAH_API_TOKEN=sk-...

# Fetch a workflow by ID and place a test phone call.
python python/fetch_workflow_and_call.py

# Create a new workflow from a definition.
python python/create_workflow.py

# Load an existing workflow, edit the startCall prompt, and save as a draft.
# Edit WORKFLOW_ID at the top of the file first.
python python/load_and_edit_workflow.py
```

## TypeScript

Uses `tsx` to run directly.

```bash
cd typescript
npm install

export DOGRAH_API_ENDPOINT=http://localhost:8000
export DOGRAH_API_TOKEN=sk-...

npm run call    # fetch_workflow_and_call.ts
npm run create  # create_workflow.ts
npm run edit    # load_and_edit_workflow.ts  (edit WORKFLOW_ID in the file first)
```