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

# Nest from MyNesting XML

> Submit a nesting request from a MyNesting XML document. Returns a `RequestId`; the result is delivered asynchronously to your `ResultsWebhookUri`.

**Body**

- `MyNestingXML` — the MyNesting XML document, as a string.
- `ResultsWebhookUri` — the URL the completed result is `POST`ed to.



## OpenAPI

````yaml /openapi.json post /v1/nesting/mynesting
openapi: 3.0.0
info:
  title: NestAPI
  version: '1.0'
servers:
  - url: https://api.nestapi.com
    description: Production
security: []
tags:
  - name: account
    description: API key and account management
  - name: admin
  - name: ApiAdmin
  - name: auth
  - name: billing
  - name: fairness
    description: >-
      Per-customer nesting-minutes fairness config, weights and usage (requires
      an Admin API key)
  - name: importer
  - name: nesting
    description: Submit nesting jobs, retrieve results and exports
  - name: plan
  - name: proxy
  - name: public
    description: Health check and public utility endpoints
  - name: subscriptionstatus
paths:
  /v1/nesting/mynesting:
    parameters:
      - $ref: '#/components/parameters/Accept'
    post:
      tags:
        - nesting
      summary: Nest from MyNesting XML
      description: >-
        Submit a nesting request from a MyNesting XML document. Returns a
        `RequestId`; the result is delivered asynchronously to your
        `ResultsWebhookUri`.


        **Body**


        - `MyNestingXML` — the MyNesting XML document, as a string.

        - `ResultsWebhookUri` — the URL the completed result is `POST`ed to.
      operationId: MyNestingRequest
      parameters:
        - name: MyNestingXML
          in: query
          schema:
            type: string
        - name: ResultsWebhookUri
          in: query
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MyNestingRequest'
      responses:
        '200':
          description: Nesting request accepted. Returns a RequestId for tracking.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNestingResult'
        '400':
          description: Invalid request — check the MyNesting XML and required fields.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNestingResult'
        '401':
          description: API key is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNestingResult'
      deprecated: false
      security:
        - Bearer: []
components:
  parameters:
    Accept:
      name: Accept
      in: header
      description: Accept Header
      required: true
      schema:
        type: string
        enum:
          - application/json
  schemas:
    MyNestingRequest:
      title: MyNestingRequest
      properties:
        MyNestingXML:
          type: string
        ResultsWebhookUri:
          $ref: '#/components/schemas/Uri'
      description: >-
        Submit a nesting request from a MyNesting XML document. Async: returns a
        RequestId; the result is delivered to your ResultsWebhookUri.
      type: object
    ApiNestingResult:
      title: ApiNestingResult
      properties:
        RequestId:
          type: string
          nullable: false
      description: ApiNestingResult
      type: object
    Uri:
      title: Uri
      properties: {}
      description: Uri
      type: object
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header

````