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

# Add a scheduled brief

> Give an employee work to do by itself, every day or every week.

**A scheduled run only proposes.** It reads and asks your knowledge at once, and anything it would
change in another system waits for a person, whatever your approval policy allows. It first runs at
the next time it names. At most 20 schedules, and a limit on runs per organisation per UTC day.
Each run acts as you, authorised afresh, so it stops if you lose the role. Requires owner or admin,
signed in: an API key is refused with `403`. Every change is audited.

> [!WARNING]
>
> AI employees are in **beta**. Every route answers `404` unless your deployment has switched the
> beta on, and these routes need a second switch, off by default. See [Schedules and the daily
> summary](https://docs.mithunai.com/team/schedules-and-daily-summary.md).

## Path

**role** `string` *required*

The employee: `support`, `itsm`, `devops`, `marketer`, `sales` or `finance`.

## Body

**title** `string` *required*

What the brief is about.

**cadence** `string` *required*

`daily` or `weekly`.

**hour\_utc** `integer` *required*

The UTC hour, from 0 to 23.

**weekday** `integer`

0 for Monday to 6 for Sunday. Required when weekly; ignored when daily.

**body** `string`

The brief. Cut, not refused, past 8000 characters.

**requester** `string`

Who the work is for, where the employee needs one.

**reference** `string`

What it is about elsewhere: a ticket key, a record id.

**service** `string`

DevOps: the service it is about. Required for `devops`.

**assistant\_id** `string`

The assistant whose knowledge answers questions in this work.

## Response

`201` with the schedule.

**id** `string` *required*

The schedule.

**role** `string` *required*

The employee: `support`, `itsm`, `devops`, `marketer`, `sales` or `finance`.

**title** `string` *required*

What the brief is about.

**cadence** `string` *required*

`daily` or `weekly`.

**hour\_utc** `integer` *required*

The UTC hour, from 0 to 23.

**weekday** `integer | null` *required*

0 for Monday to 6 for Sunday. `null` when daily.

**paused** `boolean` *required*

Whether it is paused.

**last\_run** `object | null` *required*

Its latest run in the last eight days: `status` (`running`, `done`, `failed` or `skipped`),
`started_at`, `task_id` and `reason`.

Also `body`, `requester`, `reference`, `service`, `assistant_id`, `created_by` and `created_at`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.