---
title: "Get call flow settings"
description: "Trillet OEM API: Needs resources:read."
openapi: /public/openapi/trillet-oem.yaml GET /partner/v1/tenants/{tenantId}/call-flows/{callFlowId}/settings
lastUpdated: "2026-10-28"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

`GET https://api.trillet.ai/partner/v1/tenants/{tenantId}/call-flows/{callFlowId}/settings`

Needs `resources:read`. A setting the call flow has never stored is returned as `null`.
Values are returned as stored, so an older call flow can hold values outside the ranges a
change accepts.

## Authentication

- `partnerKey` — http bearer (tpk_live_...)

## Response 200

The settings.
  - response (object)
    - `object` (string, required)
    - `callFlowId` (string, required)
    - `tenantId` (string, required)
    - `greeting` (object)
      - `inbound` (object)
        - `mode` (string | null, one of: aiFirst, customMessage, userFirst, null) — `aiFirst`: the agent speaks first with a greeting it writes. `customMessage`: the agent speaks `text`. `userFirst`: the agent waits for the caller.
        - `text` (string | null) — The greeting in `customMessage` mode.
        - `instructions` (string | null) — Instructions for the greeting in `aiFirst` mode.
      - `outbound` (object)
        - `mode` (string | null, one of: aiFirst, customMessage, userFirst, null) — `aiFirst`: the agent speaks first with a greeting it writes. `customMessage`: the agent speaks `text`. `userFirst`: the agent waits for the caller.
        - `text` (string | null) — The greeting in `customMessage` mode.
        - `instructions` (string | null) — Instructions for the greeting in `aiFirst` mode.
      - `delaySeconds` (number | null)
    - `speech` (object)
      - `responsiveness` (number | null)
      - `interruptionSensitivity` (number | null)
    - `recording` (object)
      - `enabled` (boolean | null)
    - `callHandling` (object) — Values are returned as stored. Older call flows can hold values outside the ranges `CallFlowSettingsUpdate` accepts, including fractions of a second.
      - `maxCallDurationSeconds` (number | null)
      - `checkInAfterSeconds` (number | null)
      - `checkInAttempts` (number | null)
      - `hangUpAfterCheckInSeconds` (number | null)
    - `updatedAt` (string | null, date-time)

## Response 401

Authentication failed. A key that is unknown or revoked returns `invalid_api_key`, an
account without Trillet OEM returns `partner_not_enabled`, and a user session or user API
key returns `partner_key_required`. Handle a `401` by status, not only by `error.code`.
  - response
    - (oneOf)
      - value (object)
        - `error` (object, required)
          - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
          - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
          - `message` (string, required)
          - `param` (string) — The request field the error is about, when there is one.
          - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.
      - value (object)
        - `error` (string, required)

## Response 403

`missing_scope`, or `key_restricted` on webhook endpoint routes.
  - response (object)
    - `error` (object, required)
      - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
      - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
      - `message` (string, required)
      - `param` (string) — The request field the error is about, when there is one.
      - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.

## Response 404

Not found, or not yours. For example `tenant_not_found`.
  - response (object)
    - `error` (object, required)
      - `type` (string, required, one of: invalid_request_error, authentication_error, permission_error, conflict_error, rate_limit_error, api_error, idempotency_error)
      - `code` (string, required) — A stable code. Handle errors by `code`, not by `message`.
      - `message` (string, required)
      - `param` (string) — The request field the error is about, when there is one.
      - `requestId` (string | null) — Include it when you contact support. Not present on idempotency errors.


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
