0
# Comments and Collaboration
1

2
Record-level commenting system with user mentions, collaborative features, and comment management for team coordination.
3

4
## Capabilities
5

6
### Comment Operations
7

8
Retrieve and manage comments on individual records with full CRUD support.
9

10
```python { .api }
11
def comments(self, record_id: str) -> list[object]:
12
    """
13
    Get all comments for a record.
14
    
15
    Parameters:
16
    - record_id: Record ID to get comments for
17
    
18
    Returns:
19
    List of Comment objects
20
    """
21

22
def add_comment(self, record_id: str, text: str) -> object:
23
    """
24
    Add comment to record.
25
    
26
    Parameters:
27
    - record_id: Record ID to comment on
28
    - text: Comment text content
29
    
30
    Returns:
31
    Comment object for the created comment
32
    """
33

34
class Comment:
35
    def save(self) -> 'Comment':
36
        """Save changes to comment text."""
37
    
38
    def delete(self) -> bool:
39
        """Delete comment."""
40
```
41

42
### Usage Examples
43

44
```python
45
from pyairtable import Api
46

47
api = Api('your_token')
48
table = api.table('base_id', 'table_name')
49

50
# Add comment to record
51
comment = table.add_comment('rec1234567890abcde', 'This needs review')
52

53
# Get all comments for record
54
comments = table.comments('rec1234567890abcde')
55
for comment in comments:
56
    print(f"{comment.author.name}: {comment.text}")
57

58
# Update comment
59
comment.text = 'This has been reviewed and approved'
60
comment.save()
61

62
# Delete comment
63
comment.delete()
64
```