---
title: "Change your preferences"
method: PATCH
path: "/v1/account/preferences"
tags: ["account"]
---

# Change your preferences

`PATCH /v1/account/preferences`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/account/preferences`
- Auth: HTTP bearer

Sets where the questions of jobs you start go: question_delivery sets your default for this account, and connection sets the connection making this call (its OAuth app or API key), which wins over the default. build_emails turns build emails on or off for you. Leave a field out to keep it.

## Request body

- object
  - `question_delivery` 'agent' | 'form': Your new default for this account
  - `connection` object: Sets the connection making this call (its OAuth app or API key); refused from a Dashboard session
    - `question_delivery` 'agent' | 'form', nullable, required: agent: a job's questions come back to the calling agent, which answers them or asks you. form: they are asked of you on a form, in your agent's client when it shows forms, otherwise on the job's answer page. A password, code or login is always asked on the answer page.
  - `build_emails` boolean: Turns build emails on or off for you in this account

## Response `200`

Your preferences

- AccountPreferences
  - `question_delivery` 'agent' | 'form', required: Where the questions of the jobs you start in this account go, by default
  - `connection` object, nullable, required: The connection making this call: its OAuth app or API key, on every Pomerado MCP and on the API; null for your Dashboard session
    - `question_delivery` 'agent' | 'form', nullable, required: agent: a job's questions come back to the calling agent, which answers them or asks you. form: they are asked of you on a form, in your agent's client when it shows forms, otherwise on the job's answer page. A password, code or login is always asked on the answer page.
    - `effective_question_delivery` 'agent' | 'form', required: Where questions go for this connection's jobs
  - `build_emails` boolean, nullable, required: Whether a build you start on the Dashboard emails you when its question or sign-in waits for you; true unless you turned it off, and null when it couldn't be read just now

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `413`: request_too_large
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)