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

# Workflow Examples

> Common Breezy Public API workflow examples.

# Workflow Examples

## List And Triage Service Requests

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /api/v1/service-requests?limit=20&offset=0
Authorization: Bearer bzy_live_...
```

Fetch a page of service requests, inspect status and lead source fields, then
update the service request status when the downstream workflow has acted.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
PATCH /api/v1/service-requests/{id}/status
Authorization: Bearer bzy_live_...
Content-Type: application/json
```

## Create A Service API Key

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
POST /api/v1/integrations/api-keys
Authorization: Bearer <user-jwt>
Content-Type: application/json
```

Use a user JWT for this workflow. API keys cannot manage other API keys.

## Create A Webhook Endpoint

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
POST /api/v1/integrations/webhooks
Authorization: Bearer <user-jwt>
Content-Type: application/json
```

Use a user JWT for this workflow. Store the returned signing secret
immediately; it is shown only once.

## Update Contact Attribution

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /api/v1/contacts?limit=20&offset=0
Authorization: Bearer bzy_live_...
```

Find the contact, then update the contact lead source when an integration
improves attribution.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
PATCH /api/v1/contacts/{id}/lead-source
Authorization: Bearer bzy_live_...
Content-Type: application/json
```