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

# Retrieve 1:1 Coaching Settings — Shilo Coaching API

> Retrieve 1:1 coaching settings for your Shilo integration: cadence, enabled status, custom focus text, custom questions, and per-user usage limits.

Use this endpoint to inspect the current 1:1 Coaching configuration for your Shilo integration. The response tells you whether coaching is enabled, how frequently coaching periods are generated (cadence), any custom focus text or questions that have been configured for your organization, and the usage limits that govern how much AI coaching content can be generated per period.

## Endpoint

```
GET https://api.shilo.ai/api/v1/coaching/settings
```

## Authentication

Include your API key in the request header:

```
x-api-key: YOUR_API_KEY
```

## Response

### 200 — Success

Returns a `CoachingSettings` object.

<ResponseField name="integration_id" type="string">
  The unique identifier of your Shilo integration.
</ResponseField>

<ResponseField name="enabled" type="boolean">
  Whether the 1:1 Coaching feature is currently enabled for your integration. This is the configured feature toggle, independent of usage limits.
</ResponseField>

<ResponseField name="cadence" type="string">
  The frequency at which new coaching periods are created. One of: `weekly`, `semimonthly`, `monthly`.
</ResponseField>

<ResponseField name="customization" type="object">
  Custom coaching content configured for your organization.

  <Expandable title="customization object">
    <ResponseField name="focus" type="string">
      A free-text coaching focus description that guides the AI when generating agent coaching agendas.
    </ResponseField>

    <ResponseField name="questions" type="array">
      Array of custom coaching questions included in every agent agenda.

      <Expandable title="question object">
        <ResponseField name="id" type="string">
          Unique identifier for this question.
        </ResponseField>

        <ResponseField name="order" type="number">
          Display order of the question in the agenda (ascending, minimum 0).
        </ResponseField>

        <ResponseField name="text" type="string">
          The text of the coaching question shown to agents.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="usage_limits" type="object">
  Controls how much AI coaching content can be generated per period.

  <Expandable title="usage_limits object">
    <ResponseField name="integration_limit_seconds" type="number | null">
      Organization-wide coaching limit in seconds. `null` means unlimited; `0` means coaching generation is fully blocked.
    </ResponseField>

    <ResponseField name="per_user_limit_seconds" type="number | null">
      Per-user coaching limit in seconds. `null` means unlimited; `0` means coaching generation is fully blocked for each user.
    </ResponseField>
  </Expandable>
</ResponseField>

### 401 — Unauthorized

Your API key is missing or invalid.

### 404 — Not Found

No coaching settings were found for your integration. Coaching may not yet be configured.

## Example Request

```bash theme={null}
curl --request GET \
  --url "https://api.shilo.ai/api/v1/coaching/settings" \
  --header "x-api-key: YOUR_API_KEY"
```

## Example Response

```json theme={null}
{
  "integration_id": "a3c9e214-1f2b-4d78-bb01-7e5f9c3d0a12",
  "enabled": true,
  "cadence": "weekly",
  "customization": {
    "focus": "Focus on objection handling and discovery question quality.",
    "questions": [
      {
        "id": "q1",
        "order": 0,
        "text": "What was the biggest challenge you faced on calls this week?"
      },
      {
        "id": "q2",
        "order": 1,
        "text": "Which objection did you struggle with most, and how did you handle it?"
      }
    ]
  },
  "usage_limits": {
    "integration_limit_seconds": 36000,
    "per_user_limit_seconds": 3600
  }
}
```