action attio_create_comment {
  label: "Create a comment"
  description: "Creates a new comment related to an existing thread, record or entry.\n\nTo create comments on records, you will need the `object_configuration:read` and `record_permission:read` scopes.\n\nTo create comments on list entries, you will need the `list_configuration:read` and `list_entry:read` scopes.\n\nRequired scopes: `comment:read-write`."
  provider: attio
  method: POST
  path: "/v2/comments"
  encoding: json
  scopes: ["comment:read-write"]
  input: {
    type: "object"
    required: ["data"]
    properties: {
      data: {
        type: "object"
      }
    }
  }
  output: {
    type: "object"
    description: "Success"
    required: ["data"]
    properties: {
      data: {
        type: "object"
        required: ["author", "content_plaintext", "created_at", "entry", "id", "record", "resolved_at", "resolved_by", "thread_id"]
        properties: {
          author: {
            type: "object"
            description: "Who wrote this comment. Note that the API provides the ability for API tokens to write comments on behalf of other actors."
            properties: {
              id: {
                type: "string"
                description: "An ID to identify the actor."
              }
              type: {
                type: "string"
                description: "The type of actor. [Read more information on actor types here](/docs/actors)."
                enum: ["api-token", "workspace-member", "system", "app"]
              }
            }
          }
          content_plaintext: {
            type: "string"
            description: "A plaintext representation of the content of the comment. References to workspace members are cast into email addresses, all other stylistic elements are removed."
          }
          created_at: {
            type: "string"
            description: "When the note was created."
          }
          entry: {
            type: ["object", "null"]
            description: "The entry the comment belongs to, `null` for comments on records."
            required: ["entry_id", "list_id"]
            properties: {
              entry_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the entry the comment belongs to."
              }
              list_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the list the entry belongs to."
              }
            }
          }
          id: {
            type: "object"
            required: ["comment_id", "workspace_id"]
            properties: {
              comment_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the comment."
              }
              workspace_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the workspace the comment belongs to."
              }
            }
          }
          record: {
            type: "object"
            description: "The record the comment belongs to."
            required: ["object_id", "record_id"]
            properties: {
              object_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the object the record belongs to."
              }
              record_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the record the comment belongs to."
              }
            }
          }
          resolved_at: {
            type: ["string", "null"]
            description: "Whether the comment is resolved."
          }
          resolved_by: {
            type: "object"
            description: "The actor that resolved this comment."
            properties: {
              id: {
                type: "string"
                description: "An ID to identify the actor."
              }
              type: {
                type: "string"
                description: "The type of actor. [Read more information on actor types here](/docs/actors)."
                enum: ["api-token", "workspace-member", "system", "app"]
              }
            }
          }
          thread_id: {
            type: "string"
            format: "uuid"
            description: "The ID of the thread the comment belongs to."
          }
        }
      }
    }
  }
}