---
title: "Api Get Embed Nodes"
method: POST
path: "/v1/embed/nodes"
tags: ["embed v1"]
---

# Api Get Embed Nodes

`POST /v1/embed/nodes`

## Request

- Base URL: `https://api.branchly.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.branchly.io/v1/embed/nodes`
- Auth: none declared

## Headers

- `x-api-key` string, nullable

## Request body

- NodeRequest
  - `navigator_id` string, required
  - `session_id` string, required
  - `locale` string, required
  - `vertex_ids` string[], required
  - `url` string, uri, nullable

## Response `200`

Successful Response

- VertexAPIOut[]
  - `id` string, required
  - `pk` string, required
  - `label` 'entry' | 'content' | 'contact' | 'tool' | 'fallback' | 'integration' | 'style' | 'chat_navigator_style' | 'search_style' | 'search_result' | 'navigator' | 'feedback', required
  - `title` object
  - `text` object
  - `icon_url` string, nullable
  - `source` string, nullable
  - `form` FormAPIOutput
    - `tool_id` string, required
    - `form_schema` FormAPISchema, required
      - `properties` union[], required
        - union
          - StringFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'string'
            - `format` 'text' | 'email' | 'tel': HTML input type
          - TextAreaFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'text_area'
            - `format` 'text': HTML input type
          - NumberFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'number'
            - `minimum` number, nullable
          - SelectFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'select'
            - `enum` string[], required
          - DateFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'date'
            - `format` 'date'
          - TimeFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'time'
            - `format` 'time'
          - CheckboxFieldAPI
            - `name` string, required
            - `description` string, nullable
            - `required` boolean
            - `field_type` 'checkbox'
    - `arguments` FormToolArguments, required
      - `object` 'form_tool_arguments'
      - `form_title` object, required
      - `submit_message` object, required
      - `submit_button_text` object, required
      - `show_data_privacy_text` boolean
      - `data_privacy_text` object, nullable: Optional data privacy text. If provided, a checkbox should be displayed to the user.
      - `notification_email` union: Used for email forwarding of form submissions. If not provided, no email will be forwarded
        - string, email
        - string[]
    - `values` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/branchly/apis/branchly-io-api.md) · [All operations](https://skmtc.dev/branchly/apis/branchly-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/branchly/apis/branchly-io-api/revisions/9ffb024f8ec8?raw)