action attio_get_thread {
  label: "Get a thread"
  description: "Get all comments in a thread.\n\nTo view threads on records, you will need the `object_configuration:read` and `record_permission:read` scopes.\n\nTo view threads on list entries, you will need the `list_configuration:read` and `list_entry:read` scopes.\n\nRequired scopes: `comment:read`."
  provider: attio
  method: GET
  path: "/v2/threads/{thread_id}"
  encoding: json
  scopes: ["comment:read"]
  input: {
    type: "object"
    properties: {
      thread_id: {
        type: "string"
        format: "uuid"
        description: "A UUID which identifies the thread."
      }
    }
    required: ["thread_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Success"
    required: ["data"]
    properties: {
      data: {
        type: "object"
        required: ["comments", "created_at", "id"]
        properties: {
          comments: {
            type: "array"
            description: "An array of comments in the thread, sorted by `created_at`."
            items: {
              type: "object"
              required: ["id", "thread_id", "content_plaintext", "entry", "record", "resolved_at", "resolved_by", "created_at", "author"]
              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: ["workspace_id", "comment_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: ["record_id", "object_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."
                }
              }
            }
          }
          created_at: {
            type: "string"
            description: "When the thread was created."
          }
          id: {
            type: "object"
            required: ["thread_id", "workspace_id"]
            properties: {
              thread_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the thread."
              }
              workspace_id: {
                type: "string"
                format: "uuid"
                description: "The ID of the workspace the thread belongs to."
              }
            }
          }
        }
      }
    }
  }
}