API / Documentation

entry_add_comment (api_user, _task_ref, **kw)

Add a comment to given entry

PARAMS:

• _task_ref - admin-only, task to resume
• content - the text content of the commment
• stream - the stream in which the entry this comment is on resides
• entry - the entry this comment is on
• uuid - a unique identifier for this comment
• nick - the actor making the comment

RETURNS: comment_ref

EXAMPLE API RETURN:

{'status': 'ok',
 'rv': {'comment': {'stream': 'stream/test@example.com/comments',
                    'uuid': '1234567890abcdef',
                    'entry': 'stream/root@example.com/presence/12345',
                    'owner': 'root@example.com',
                    'actor': 'test@example.com',
                    'extra': {'content': 'a comment!',
                              'entry_stream': 'stream/root@example.com/presence',
                              'entry_title': 'please comment on me',
                              'entry_actor': 'root@example.com',
                              'entry_uuid': '12345',
                              }
                    }
        }
 }