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

# Create draft comment

> Creates a draft comment for a specific ticket.

<Info>Replace `{your-subdomain}` with your workspace's subdomain. <br /> Learn how to find your subdomain in [Workspace subdomain](/api/workspace-subdomain).</Info>


## OpenAPI

````yaml bundled/comments.yaml POST /tickets/{ticket_id}/drafts
openapi: 3.0.3
info:
  title: NeetoDesk APIs
  version: 2.0.0
servers:
  - description: NeetoDesk APIs
    url: https://{your-subdomain}.neetodesk.com/api/external/v2
    variables:
      your-subdomain:
        default: spinkart
        description: >-
          Replace **spinkart** with your [workspace's
          subdomain](/api/workspace-subdomain).
security: []
paths:
  /tickets/{ticket_id}/drafts:
    post:
      summary: Create a draft comment for a ticket
      description: Creates a draft comment for a specific ticket.
      parameters:
        - $ref: '#/components/parameters/ticket_id_param'
        - $ref: '#/components/parameters/api_key_header'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateDraftRequest'
      responses:
        '201':
          description: Created - Draft created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  draft:
                    $ref: '#/components/schemas/CreateDraftResponse'
components:
  parameters:
    ticket_id_param:
      in: path
      name: ticket_id
      description: >-
        ID of the ticket. You can use either the ticket ID (UUID) or ticket
        number (sequential number) interchangeably. Refer to [Getting Ticket
        ID](/api/getting-ticket-id) section for detailed instructions.
      required: true
      schema:
        type: string
    api_key_header:
      in: header
      name: X-Api-Key
      description: >-
        Use the X-Api-Key header to provide your workspace API key. Refer to
        [Authentication](/api/authentication) for more information.
      required: true
      schema:
        type: string
        default: your-api-key
  schemas:
    CreateDraftRequest:
      type: object
      required:
        - content
      properties:
        content:
          type: string
          description: Content for the draft comment. Cannot be blank.
          example: We are looking into the issue.
        comment_type:
          type: string
          enum:
            - reply
            - note
          description: Type of the comment. Defaults to `reply`.
          example: note
        author_email:
          type: string
          description: >-
            Optional email address of the person creating the draft. If
            provided, the signature stored in NeetoDesk for this user will be
            appended to the draft.
          example: oliver@example.com
        attachments:
          type: array
          items:
            type: string
          description: >
            Signed ids returned by [Upload attachment](/api/attachments/create)
            or

            [Reserve an attachment upload](/api/attachments/create-upload).

            The ids are kept on the draft and are not attached to anything until
            the draft is

            sent. A signed id minted in another workspace is rejected, and so is
            one whose file

            was reserved but never sent. Attachments are all-or-nothing: if any
            id in the array is

            unknown, malformed, unsent or from another workspace, the whole
            request fails and the

            draft is unchanged. Passing this replaces the ids the draft already
            held; omit it to

            leave them as they are, or pass an empty array to clear them.
            Attaching the draft's

            files when it is sent applies the workspace attachment limit, 10 MB
            by default.
          example:
            - eyJfcmFpbHMiOnsiZGF0YSI6IjEyMyJ9fQ==
    CreateDraftResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the draft
          example: aaaabbbb-cccc-dddd-eeee-ffff00004444
        comment_type:
          type: string
          description: The type of the comment
          example: reply
        created_at:
          type: string
          format: date-time
          description: Timestamp when the draft was created
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the draft was last updated
        content:
          type: string
          description: Content of the draft comment
          example: We are looking into the issue.
        attachments:
          type: array
          items:
            type: string
          description: Signed ids of the files kept on the draft.
          example:
            - eyJfcmFpbHMiOnsiZGF0YSI6IjEyMyJ9fQ==

````

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