@spec create(
  ArchAstro.Client.t(),
  String.t(),
  ArchAstro.Types.Operations.PostApiV1TasksTaskComments.Input.t()
) :: {:ok, ArchAstro.Types.TaskComment.t()} | {:error, ArchAstro.Error.reason()}

Create a comment on a task

Posts a new comment on the specified task and returns the created comment. The task's owner is resolved from the task itself.

The newly created comment.

@spec delete(ArchAstro.Client.t(), String.t(), String.t()) ::
  {:ok, :ok} | {:error, ArchAstro.Error.reason()}

Delete a task comment

Permanently removes a comment from its task. This action cannot be undone. The task's owner is resolved from the task itself.

Only the comment's author, an admin of the comment's organization, or an admin of the owning team may delete a comment. Returns 403 Forbidden otherwise.

Empty body. The server responds with HTTP 204 No Content on success.

@spec list(
  ArchAstro.Client.t(),
  String.t(),
  ArchAstro.Types.Operations.GetApiV1TasksTaskComments.Params.t()
) ::
  {:ok, ArchAstro.Types.Operations.GetApiV1TasksTaskComments.Response.t()}
  | {:error, ArchAstro.Error.reason()}

List comments on a task

Returns a bounded page of comments on the specified task, ordered by creation time ascending. App-scoped developer and server-to-server callers explicitly provide the owning team, user, or agent and org.

Successful response

@spec replace(
  ArchAstro.Client.t(),
  String.t(),
  String.t(),
  ArchAstro.Types.Operations.PutApiV1TasksTaskCommentsComment.Input.t()
) :: {:ok, ArchAstro.Types.TaskComment.t()} | {:error, ArchAstro.Error.reason()}

Update a task comment

Replaces the body of an existing comment and returns the updated comment. The task's owner is resolved from the task itself.

Only the comment's author, an admin of the comment's organization, or an admin of the owning team may edit a comment. Returns 403 Forbidden otherwise.

The updated comment.