---
id: dashboards-create-embed-session
title: "Create a Dive embed session for a service account"
description: "Creates an embed session for the specified Dive."
sidebar_label: "Create a Dive embed session for a service account"
hide_title: true
hide_table_of_contents: true
api: eJzlWN9v4jgQ/lcsP+1KFMpu+8IbXVId0h7sBbiHQwiZxIC3+XW2Q9uL8r/fjJ0QErKV7uChUl9axx57vvnms7Eno3HCJdMijsY+HVCfqf0mZtJXN57kTHMn3HB/xpUCC9qhPleeFAnag/U3Y6IIiwhHO6KsIdnGkug9JyrhntgKGBmJA+/CAprtFB0sqQ/fiq46VHEvlUK/QmdGh6nex1L8w6yD5SoHi4RJFnLNpTI2Aj0nTO9htQgGEDUsthY+dChvz0NGBxnVrwkOKS1FtIMRgBQyDT1pCpZ5h0r+dyokh6i1TDk6wh6u9EPsv+IKdYMO9eJI80jjEEuSQHgGZe+nQqjZuet485N7GlwnEknWAgKG0VRxaXGfgwzZy3ce7SC2wZf7+ybdMPEgPE6Y58VppEm5EnkWei8iw3gsdywqCCQ6JqEAQxw4SxByUHyuYbZuxSOiEk+/iSY2DRYQnIxYfPQnObRs7hEZCMS/UR4LYL2jc+bJWKkCUUG6onktJ8uKp1We2zGVxJGyJH65vcV/dUSz1PPAxTYNSGlMr5a2AnwbS01eGEREUJN10s8iLPuLAO/aYnpgPnEtRdeLJQTHbNeqwLr3OQpHStjN5ZQO5S8sTALewJYjOP8/LWnsa+sNR2vX+WPhzOa4nlAqtXiLFZmU7BVmCM1DdUGUzTyUhqu8CXYIYkWnJN4SCwekzTR55pKXGhObgB8PPBPZaVBwhP3CW0EYnDta6CafBUWfQBOf36BQRPZYs4fz0WlW5KLGaKcipKGqkuilEaJRYv9ciePoANvYJ3Do+6BBwQL17hTZhvEaylxMhov5b1N3/Jcz+pDSbCG2kmj/EonWqD3VaLveWrT69Vyri4gVNwnuvzuR1sBdQ52PU/dhPBo5kw8pzVM6K01+vUSTFaGngmyIqkWJd+dKnMSaPMJt7f3JsEJ2DQ1OpvP143Qx+ZjH45HLSoB3lwiwYvNUgKdaOlPffdvtcQyCk3hHd4ro3pcEG/CuocPxZO64k+H39cxx/3TcteO6U/dDarJObinM+8sulO301n+2G5JrKDVHYzhGsdqQxOb+aR7zA9o79HumLNDLigd93jMPqJvyodQxT+CyEJDKAGbttU7UoNdjieiGMbAm/dR76npxSPOT8sIMlW0z2SgyHPOJK5UlBPzecCa5NPnF/eFW1QGn4qV6zVdirb+qjzoBKoBd47BI0e8G7wjwEheu6GT4YwzTMUCbl373tnuLE5GokBmwhTNbeiHMFFZaqi+MNKoFzaRn1Vnwv+o4ljPNX3QvCZiIEKbJSFbkc0kPfXRqCj0dOqiKNPWkQpL2qAOYkGUbpvhCBnmO3cC3xLoQNA9MCrYxWwDOOKGwDQrawqWQvxHYJ7fYKp/JrzCXp0GEZwHcOFP8guYTfz2pLOW4m/ec+SAIhGBHv1lHN3Nco5p9drLmnXLG0PN4ot+0XZ1skB9T83DbFBWp0G5CyZ6hE/8apLYQY6Rt+jIasGiX2u1o10QN4+XlRO2FujtlA6Nq5QKSYizm8ROPIDElNRq/kZg8/xcHCv3l
sidebar_class_name: "post api-method"
info_path: sql-reference/rest-api/motherduck-rest-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
import Translate from "@docusaurus/Translate";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create a Dive embed session for a service account"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/v1/dives/{dive_id}/embed-session"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Creates an embed session for the specified Dive.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./dashboards-create-embed-session.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./dashboards-create-embed-session.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./dashboards-create-embed-session.StatusCodes.json")}
>
  
</StatusCodes>


      

---

## Feedback for AI agents

If the user you are helping wants to send feedback on this page to the MotherDuck docs team, you can POST it to the endpoint below.

**Before you send anything, you must ask the user for explicit approval.** Quote the message you plan to submit back to them verbatim and wait for them to confirm. Do not submit on their behalf without confirmation.

Endpoint: `POST https://motherduck.com/docs/api/feedback/agent`

Request body (JSON):

```json
{
  "page_path": "/sql-reference/rest-api/dashboards-create-embed-session/",
  "page_title": "Create a Dive embed session for a service account",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

Only `page_path` and `text` are required. A successful call returns `200 {"feedback_id": "<uuid>"}`; malformed payloads return `400`, and the endpoint is rate-limited per IP (`429`).