---
title: "Change what the assistant is for"
method: PUT
path: "/v1/assistant"
---

# Change what the assistant is for

`PUT /v1/assistant`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/assistant`
- Auth: HTTP bearer

## Request body

- object
  - `task` string
  - `on` boolean
  - `away_message` string, nullable
  - `digest` boolean
  - `until` string, date-time, nullable

## Response `200`

Default Response

- object
  - `ok` true, required

---

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