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

# Reply to a comment

> Creates a new child comment under the parent comment specified by comment_id.
The request body must include the content field and can optionally include additional metadata such as schema.
The child comment can also be referred to as a reply or a thread.




## OpenAPI

````yaml POST /{team_id}/comments/{comment_id}/children
openapi: 3.0.0
info:
  description: Superthread Public API Specification
  version: '0.1'
  title: Public API
  contact:
    email: engineering@superthread.com
servers:
  - url: https://api.superthread.com/v1
security:
  - BearerAuth: []
tags:
  - name: AI
    description: >-
      [Service: AI]. Handles AI-powered functionalities, such as
      recommendations, predictions, and automation features.
  - name: Activity
    description: >-
      [Service: Activity] Manages all activities; creating notifications and
      digests
  - name: Auth
    description: >-
      [Service: Auth] Responsible for user authentication, authorization, and
      session management.
  - name: Boards
    description: >-
      [Service: Boards] Manages core collaboration features such as "boards",
      "cards", "lists", "sprints", "epics".
  - name: Comments
    description: >-
      [Service: Comments] Handles the creation, editing, and management of
      comments across various entities.
  - name: Customers
    description: >-
      [Service: Customers] Manages customers, customer tiers and statuses,
      customer settings, and customer requests on cards and projects. Requires
      the `customers` team feature; not available to workspace guests.
  - name: Favourites
    description: >-
      [Service: Favourites] Responsible for favouriting resources in the system
      for quick access.
  - name: Files
    description: >-
      [Service: Files] Manages file uploads, storage, and retrieval for user and
      project resources.
  - name: Importer
    description: >-
      [Service: Importer] Handles data import operations from external sources
      into the platform.
  - name: Integrations
    description: >-
      [Service: Integrations] Facilitates connectivity with external tools and
      services, enabling smooth integration with third-party platforms and APIs.
  - name: Pages
    description: >-
      [Service: Pages] Manages the creation and organization of both public and
      private pages, supporting structured content and navigation and
      collaboration.
  - name: Projects
    description: '[Service: Projects] Handles all project related tasks.'
  - name: Reports
    description: >-
      [Service: Reports] Generates and manages analytical reports and insights
      for users and projects.
  - name: Search
    description: >-
      [Service: Search] Provides search functionalities, including indexing and
      retrieval of platform data.
  - name: TimeTracking
    description: >
      [Service: TimeTracking] Manages time entries, active timers, time
      categories, job roles, billing rates, and audit/lock for time-tracking
      workflows.


      A member's billing rate is their own rate when one is set, otherwise their
      job role's rate, otherwise the workspace default rate. Each time entry
      keeps the rate and job role it was created with.
  - name: Resourcing
    description: >-
      [Service: TimeTracking] Plans people's capacity: working patterns, time
      off, closures, public holidays, allocations of hours to projects, and
      retainer budgets. Not available to workspace guests.
  - name: Views
    description: >-
      [Feature] Provides tools to create and customize views, enabling users to
      organize and visualize their data according to their preferences and
      workflows.
  - name: OAuth2
    description: >-
      [Feature] Supports OAuth2 integration for seamless user authentication and
      authorization, ensuring secure access to external APIs and services.
  - name: Sprints
    description: >-
      [Feature] Facilitates sprint management within agile workflows, including
      planning, progress tracking, and reporting.
  - name: Cards
    description: >-
      [Feature] A Card is the core concept used in the system to describe an
      individual task or work item. They are used across Boards, Sprints, and
      Roadmaps. Cards include features like descriptions, checklists, comments,
      priorities, tags and more.
  - name: Checklists
    description: >-
      [Feature] A Checklist is a list of items that need to be completed. It is
      used to track progress on a card.
  - name: Lists
    description: >-
      [Feature] Represents a collection of tasks or items grouped within
      different contexts in the system. Lists (externally referenced as
      "statuses") are utilized across various entities such as boards, sprints,
      and roadmaps.
  - name: Notes
    description: >-
      [Feature] Enables users to create, edit, and organize notes, supporting
      rich text, attachments, transcriptions and AI enhancements.
  - name: Tags
    description: >-
      [Feature] Groups endpoints related to the creation, retrieval, updating,
      deletion, and merging of tags within teams (workspaces).
  - name: Agents
    description: >-
      [Feature] Manages agents and runs. Provides CRUD operations for agents,
      launching cloud agents, monitoring agent status, retrieving conversations,
      and sending follow-ups.
  - name: PublishedAgents
    description: >-
      [Feature] [Service: AI] External API for agents published to websites,
      apps and custom clients. Authenticated with scoped chat sessions
      (PublishedAgentSession) or host app assertions (AgentAppAssertion), never
      with workspace member credentials. Management routes for publications and
      app registrations live under the Agents tag. Base URL: these paths are
      absolute from the API origin. The real URL is
      `https://api.superthread.com/public/agents/v1/...`, and the spec's
      `basePath` `/v1` does not apply, the same as `/public/forms` (Swagger 2.0
      has no per-path base). Generated clients default to `.../v1` and would
      call `/v1/public/agents/v1/...`, so construct them with the API origin as
      the base: in TypeScript `new Api({ baseURL: 'https://api.superthread.com'
      })`, and in Go a transport whose base path is `/`. The www forms portal
      does the same, using an axios client whose `baseURL` is the API origin.
paths:
  /{team_id}/comments/{comment_id}/children:
    parameters:
      - $ref: '#/components/parameters/path_team_id'
      - $ref: '#/components/parameters/path_comment_id'
    post:
      tags:
        - Comments
      summary: 'Add a child comment or in other words: reply to an existing comment.'
      description: >
        Creates a new child comment under the parent comment specified by
        comment_id.

        The request body must include the content field and can optionally
        include additional metadata such as schema.

        The child comment can also be referred to as a reply or a thread.
      operationId: createChildComment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateChildCommentRequest'
        description: Comment object that needs to be created
        required: true
      responses:
        '201':
          description: comment created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChildCommentResponse'
        default:
          description: client error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    $ref: '#/components/schemas/Error'
components:
  parameters:
    path_team_id:
      in: path
      name: team_id
      description: >-
        Team ID is an alphanumerical string that identifies a Team. This is
        externally referred to as a "Workspace".
      required: true
      schema:
        type: string
    path_comment_id:
      in: path
      name: comment_id
      description: Comment ID is a numerical string that identifies a Comment.
      required: true
      schema:
        type: string
  schemas:
    CreateChildCommentRequest:
      type: object
      required:
        - content
      properties:
        content:
          type: string
          example: Good point!
          maxLength: 102400
          nullable: false
        content_format:
          $ref: '#/components/schemas/ContentFormat'
        schema:
          type: integer
          example: 1
          nullable: true
    ChildCommentResponse:
      type: object
      properties:
        child_comment:
          $ref: '#/components/schemas/ChildComment'
    Error:
      type: object
      properties:
        id:
          type: string
          example: err5f744ab
        code:
          type: integer
          format: int32
          example: 403
        sec:
          $ref: '#/components/schemas/SuperthreadErrorCode'
        message:
          type: string
          example: You do not have access to this resource
          description: A user-friendly error message
        date:
          $ref: '#/components/schemas/STime'
    ContentFormat:
      type: string
      description: >-
        Format of the content field. When set to 'markdown', the server converts
        the content from GitHub Flavored Markdown to HTML before storage.
        Defaults to 'html'.
      enum:
        - html
        - markdown
      default: html
    ChildComment:
      type: object
      allOf:
        - $ref: '#/components/schemas/CommentCommon'
      properties:
        parent_id:
          type: string
          example: '1'
    SuperthreadErrorCode:
      type: string
      description: |
        Superthread Error Code (`SEC`): A structured error code.
        Format: `SEC:{ServiceID}-{InternalErrorCode}`.


          - `SEC`: Prefix for all structured error codes.
          - `ServiceID`: First 3 characters identify the service, '000' is reserved for generic errors.
          - `InternalErrorCode`: the next (last) 5 characters define the specific error.
      pattern: ^SEC:\d{3}-\d{5}$
      example: SEC:000-00014
    STime:
      type: integer
      format: int64
      example: 1608742037016
      description: unix timestamp in seconds
      x-go-type:
        type: STime
        import:
          package: github.com/superthread-com/common/pkg/types
        hints:
          noValidation: true
          kind: primitive
    CommentCommon:
      type: object
      properties:
        id:
          type: string
          example: '42'
        type:
          type: string
          enum:
            - comment
            - child_comment
        content:
          type: string
          example: Good point!
          maxLength: 102400
        is_internal:
          type: boolean
          description: >-
            Whether the comment is internal. Internal comments are visible only
            to members and hidden from guests and guest-readers.
        schema:
          type: integer
          example: 1
        page_id:
          type: string
          example: '431'
        card_id:
          type: string
          example: '433'
        user_id:
          type: string
          example: u-dsu0j19
        user:
          $ref: '#/components/schemas/Actor'
        user_updated:
          $ref: '#/components/schemas/Actor'
        external_author:
          $ref: '#/components/schemas/ExternalRequestProvenance'
        team_id:
          type: string
          example: u-dsu0j19
        time_created:
          $ref: '#/components/schemas/STime'
        time_updated:
          $ref: '#/components/schemas/STime'
        reactions:
          type: array
          items:
            $ref: '#/components/schemas/Reaction'
        health_update_metadata:
          $ref: '#/components/schemas/EpicHealthUpdateMetadata'
    Actor:
      title: Actor
      type: object
      description: describes a user or robot that created or updated a resource
      properties:
        user_id:
          type: string
          example: uDsu0j19
          x-go-custom-tag: dynamodbav:",omitempty"
        type:
          type: string
          x-go-custom-tag: dynamodbav:",omitempty"
          example: user
          default: user
          enum:
            - user
            - robot
            - system
          nullable: false
        source:
          $ref: '#/components/schemas/ActorSource'
    ExternalRequestProvenance:
      type: object
      description: >
        Where an external request, card or reply came from. Stored separately
        from the Superthread

        requester, participant and creator fields, which external requesters
        never populate. Set only

        by the internal published-agent service facades; read-only everywhere
        else.


        It carries no personal data beyond an optional display name: no email,
        host subject or

        account reference. Those exist only in the private facade type
        `ExternalRequester` (stored by

        customers) and in ai's admin conversation view. So card and comment
        events, portal

        responses and webhooks that embed Card or Comment can never carry them.
      required:
        - source
        - external_conversation
      properties:
        source:
          type: string
          enum:
            - published_agent
          nullable: false
        source_label:
          type: string
          description: >-
            Visible source label, always computed by the owning service (e.g.
            "Published agent · anonymous" or "Published agent · <app name>").
            Ignored and overwritten when sent in a request body.
          example: Published agent · anonymous
        external_conversation:
          $ref: '#/components/schemas/ExternalConversationRef'
        display_name:
          type: string
          description: >-
            Requester's display name (signed by the host app, or typed and
            unverified for anonymous visitors). Cleared on erasure.
          maxLength: 200
        redacted:
          type: boolean
          description: True once the requester's personal data was erased.
          x-omitempty: false
    Reaction:
      type: object
      properties:
        id:
          type: string
          example: sweat_smile
        unicode:
          type: string
          description: Reaction UTF-8 unicode value
        members:
          type: array
          items:
            $ref: '#/components/schemas/ReactionMember'
    EpicHealthUpdateMetadata:
      type: object
      description: Metadata about a health status update
      required:
        - previous
        - new
      properties:
        previous:
          $ref: '#/components/schemas/EpicHealthStatus'
        new:
          $ref: '#/components/schemas/EpicHealthStatus'
        time:
          $ref: '#/components/schemas/STimePtr'
    ActorSource:
      title: ActorSource
      type: object
      description: describes the source of an actor
      properties:
        type:
          type: string
          example: oauth
          enum:
            - oauth
            - import
            - email
            - agent
        client_id:
          type: string
          x-go-custom-tag: dynamodbav:",omitempty"
          description: client ID if the resource was created via oauth2 app
          example: oczapier
        import_id:
          type: string
          x-go-custom-tag: dynamodbav:",omitempty"
          description: import ID if the resource was created by an import
          example: bf1b9f76-3f95-42fc-bd7f-050b2f5f4197
        agent_id:
          type: string
          x-go-custom-tag: dynamodbav:",omitempty"
          description: agent ID if the resource was created by an agent
          example: bf1b9f76-3f95-42fc-bd7f-050b2f5f4197
        email_addr:
          type: string
          x-go-custom-tag: dynamodbav:",omitempty"
          description: email address if the resource was created via an email
          example: somebody@example.com
        email_verified:
          type: boolean
          x-go-custom-tag: dynamodbav:",omitempty"
          description: whether the email sender was verified
          example: false
        on_behalf_of:
          type: string
          x-go-custom-tag: dynamodbav:",omitempty"
          description: >-
            User ID of the human responsible for this action. For
            trigger-initiated agent actions, this is the trigger creator. For
            mention/chat-initiated actions, this is the user who invoked the
            agent.
    ExternalConversationRef:
      type: object
      description: >
        Routing reference from a Superthread object (card, customer request or
        comment) back to the

        published-agent conversation that created it or replied on it. Holds no
        personal data, so it

        is safe to carry on events. Every identifier is an opaque value issued
        by the ai service and

        is never a Superthread user, requester or participant ID.
      required:
        - publication_id
        - conversation_id
        - actor_id
        - audience
      properties:
        publication_id:
          type: string
          description: >-
            Opaque public ID of the agent publication the conversation belongs
            to.
          example: pub_01JB7Q4Z8XKQ3N6V2W1Y9T5R0M
          nullable: false
        agent_id:
          type: string
          description: The published agent.
        conversation_id:
          type: string
          description: The external conversation.
          example: xc_01JB7Q5B2C3D4E5F6G7H8J9K0L
          nullable: false
        actor_id:
          type: string
          description: >
            ai external actor. A verified requester has one actor per
            (workspace, app registration,

            external subject); an anonymous visitor has one per anonymous
            session lineage. Never a

            Superthread user ID.
          example: xa_01JB7Q5RZ0Y1X2W3V4U5T6S7R8
          nullable: false
        app_id:
          type: string
          description: >-
            App registration that verified the requester. Empty for anonymous
            requesters.
        audience:
          type: string
          description: >-
            Whether the requester was anonymous or verified by the host app when
            the object was created.
          enum:
            - anonymous
            - verified
          nullable: false
    ReactionMember:
      type: object
      properties:
        user_id:
          type: string
          description: ID of user that reacted
        time_created:
          $ref: '#/components/schemas/STime'
        variation:
          type: string
          description: Variation of reaction
    EpicHealthStatus:
      type: string
      description: The health status of an project (epic).
      enum:
        - on_track
        - at_risk
        - off_track
        - not_expected
      example: on_track
      default: on_track
    STimePtr:
      type: integer
      format: int64
      example: 1608742037016
      description: unix timestamp in seconds
      x-go-type:
        type: STime
        import:
          package: github.com/superthread-com/common/pkg/types
        hints:
          noValidation: true
          kind: primitive
      nullable: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

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