---
title: "Authoring Context"
method: POST
path: "/projects/{project_id}/dashboards/{dashboard_id}/authoring-context"
tags: ["dashboards"]
---

# Authoring Context

`POST /projects/{project_id}/dashboards/{dashboard_id}/authoring-context`

## Path parameters

- `project_id` string, uuid, required
- `dashboard_id` string, uuid, required

## Request body

- AuthoringRequest
  - `prompt` string, required
  - `plot_id` string, uuid, nullable
  - `draft` AuthoringDraft
    - `name` string, required
    - `config` PlotConfig, required — What a saved plot stores.
      - `plan` Plan, required — The declarative data plan: named steps executed in order.
        - `steps` object, required
        - `caps` Caps — Ceilings a plan may lower but never raise above the server maximums.
          - `max_sources` integer
          - `max_summary_rows` integer
          - `max_series_points` integer
          - `max_list_rows` integer
      - `transform` string, required
      - `params` object

## Response `200`

Successful Response

- AuthoringContext
  - `session_id` string, required
  - `system` string, required
  - `prompt` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `8ed5440390f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ionworks/apis/fastapi/changes/projects/:project_id/dashboards/:dashboard_id/authoring-context/post.md)

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/ionworks/apis/fastapi/revisions/8ed5440390f0?raw)