Fellow
App · 20 actions
Read meeting recordings, notes and action items, and update Fellow agendas.
Actions
| Action | What it does |
|---|---|
| Append agenda | Append agenda. |
| Archive action item | Archive action item. |
| Complete action item | Complete action item. |
| Create webhook | Create webhook. |
| Delete webhook | Delete webhook. |
| Find replace agenda | Find replace agenda. |
| Get action item | Get action item. |
| Get current user | Get current user. |
| Get note | Get note. |
| Get recording | Get recording. |
| Get upload | Get upload. |
| Get webhook | Get webhook. |
| List action items | List action items. |
| List notes | List notes. |
| List recordings | List recordings. |
| List uploads | List uploads. |
| List webhooks | List webhooks. |
| Prepend agenda | Prepend agenda. |
| Replace agenda | Replace agenda. |
| Upload recording | Upload recording. |
Append agenda
Append agenda.
Inputs
- Note
note_idtextRequired - Note id.
- Content fellow markdown
content_fellow_markdowntextRequired - Fellow Markdown to add at the end of the agenda, in the same format the note object's content_fellow_markdown field returns.
Outputs
dataobject- Response containing a note's agenda as Fellow Markdown.
Example output
{
"data": {
"agenda": {
"content_fellow_markdown": "example",
"note_id": "example",
"title": "example"
}
}
}Archive action item
Archive action item.
Inputs
- Action item
action_item_idtextRequired - Action item id.
Outputs
dataobject- Response containing a single action item.
Example output
{
"data": {
"action_item": {
"ai_detected": false,
"ai_suggestion_accepted_by_user": false,
"assignees": [],
"completion_type": "all",
"created_at": "example",
"due_date": "example",
"id": "example",
"note_id": "example",
"recording_offset": 1.0,
"status": "Done",
"text": "example",
"updated_at": "example"
}
}
}Complete action item
Complete action item.
Inputs
- Action item
action_item_idtextRequired - Action item id.
- Completed
completedtrue/falseRequired - Completed.
Outputs
dataobject- Response containing a single action item.
Example output
{
"data": {
"action_item": {
"ai_detected": false,
"ai_suggestion_accepted_by_user": false,
"assignees": [],
"completion_type": "all",
"created_at": "example",
"due_date": "example",
"id": "example",
"note_id": "example",
"recording_offset": 1.0,
"status": "Done",
"text": "example",
"updated_at": "example"
}
}
}Create webhook
Create webhook.
Inputs
- Url
urltextRequired - The URL endpoint that will receive webhook POST requests
- Enabled events
enabled_eventslistRequired - List of event types to subscribe to. Valid values: 'ai_note.shared_to_channel', 'ai_note.generated', 'action_item.assigned', 'action_item.completed'.
- Description
descriptiontext - Optional description for this webhook endpoint
- Status
statustext - Webhook status. Valid values: 'active', 'inactive'One of:
active,inactive. Default:active. - Scope
scopetext - Who the webhook belongs to. 'user' is the authenticated user, the default and the existing behaviour. 'workspace' is the whole account: it receives every matching event with no per-user filter, and each event is delivered once rather than once per attendee. Creating one requires a privileged API key.One of:
user,workspace. Default:user.
Outputs
dataobject- Response for webhook creation, includes the secret (only returned once).
Example output
{
"data": {
"webhook": {
"created_at": "example",
"description": "example",
"enabled_events": [],
"id": "example",
"scope": "example",
"secret": "example",
"status": "example",
"updated_at": "example",
"url": "example"
}
}
}Delete webhook
Delete webhook.
Inputs
- Webhook id
webhook_idtextRequired - Webhook id.
Outputs
dataobject- Response for webhook deletion.
Example output
{
"data": {
"deleted": false,
"webhook_id": "example"
}
}Find replace agenda
Find replace agenda.
Inputs
- Note
note_idtextRequired - Note id.
- Find
findtextRequired - Existing agenda text to replace. Must appear exactly once, or the request is rejected.
- Content fellow markdown
content_fellow_markdowntextRequired - Fellow Markdown to substitute for the matched text, in the same format the note object's content_fellow_markdown field returns. An empty string deletes the matched text.
Outputs
dataobject- Response containing a note's agenda as Fellow Markdown.
Example output
{
"data": {
"agenda": {
"content_fellow_markdown": "example",
"note_id": "example",
"title": "example"
}
}
}Get action item
Get action item.
Inputs
- Action item
action_item_idtextRequired - Action item id.
Outputs
dataobject- Response containing a single action item.
Example output
{
"data": {
"action_item": {
"ai_detected": false,
"ai_suggestion_accepted_by_user": false,
"assignees": [],
"completion_type": "all",
"created_at": "example",
"due_date": "example",
"id": "example",
"note_id": "example",
"recording_offset": 1.0,
"status": "Done",
"text": "example",
"updated_at": "example"
}
}
}Get current user
Get current user.
Inputs
None.
Outputs
dataobject- Response for the /me endpoint.
Example output
{
"data": {
"user": {
"email": "example",
"full_name": "example",
"id": "example"
},
"workspace": {
"id": "example",
"name": "example",
"subdomain": "example"
}
}
}Get note
Get note.
Inputs
- Note
note_idtextRequired - Note id.
Outputs
dataobject- Response containing a single note.
Example output
{
"data": {
"note": {
"content_fellow_markdown": "example",
"content_markdown": "example",
"created_at": "example",
"event_attendees": [],
"event_end": "example",
"event_guid": "example",
"event_is_all_day": false,
"event_start": "example",
"id": "example",
"organizer_email": "example",
"recording_ids": [],
"title": "example",
"updated_at": "example"
}
}
}Get recording
Get recording.
Inputs
- Recording
recording_idtextRequired - Recording id.
Outputs
dataobject- Response containing a single recording.
Example output
{
"data": {
"recording": {
"ai_notes": [],
"created_at": "example",
"ended_at": "example",
"event_call_url": "example",
"event_guid": "example",
"id": "example",
"media_url": "example",
"note_id": "example",
"started_at": "example",
"title": "example",
"transcript": {
"language_code": "example",
"speech_segments": []
},
"updated_at": "example",
"user_has_calendar_event": false
}
}
}Get upload
Get upload.
Inputs
- Recording
recording_idtextRequired - Recording id.
Outputs
dataobject- Response containing a single API-uploaded recording with its import status.
Example output
{
"data": {
"upload": {
"created_at": "example",
"failure_reason": "example",
"recording_id": "example",
"status": "FAILED",
"title": "example",
"updated_at": "example"
}
}
}Get webhook
Get webhook.
Inputs
- Webhook id
webhook_idtextRequired - Webhook id.
Outputs
dataobject- Response containing a single webhook.
Example output
{
"data": {
"webhook": {
"created_at": "example",
"description": "example",
"enabled_events": [],
"id": "example",
"scope": "example",
"status": "example",
"updated_at": "example",
"url": "example"
}
}
}List action items
List action items. Returns one page; use the continuation fields for more results.
Inputs
- Cursor
cursortext - Cursor.
- Page size
page_sizenumber - Page size.From 1 to 50. Default:
20. - Include
includeobject - Include.
- Order by
order_bytext - Supported ordering options for action items.One of:
created_at_desc(Created at desc),created_at_asc(Created at asc),updated_at_desc(Updated at desc),updated_at_asc(Updated at asc),due_date(Due date). - Created at start
created_at_starttext - Only return action items created at or after this date. Accepts YYYY-MM-DD or an ISO datetime, and is inclusive. A value without a time means midnight UTC, so an end bound of 2024-01-05 excludes everything later that day.
- Created at end
created_at_endtext - Only return action items created at or before this date. Accepts YYYY-MM-DD or an ISO datetime, and is inclusive. A value without a time means midnight UTC, so an end bound of 2024-01-05 excludes everything later that day.
- Updated at start
updated_at_starttext - Only return action items updated at or after this date. Accepts YYYY-MM-DD or an ISO datetime, and is inclusive. A value without a time means midnight UTC, so an end bound of 2024-01-05 excludes everything later that day. Whether updated_at moves depends on where the change was made. Edits in the note itself, including its text, completion, assignees and due date, all bump updated_at. An assignee or due date changed outside the note, such as from the action items list, is written to a separate record and leaves updated_at unchanged, so this filter does not pick that item up.
- Updated at end
updated_at_endtext - Only return action items updated at or before this date. Accepts YYYY-MM-DD or an ISO datetime, and is inclusive. A value without a time means midnight UTC, so an end bound of 2024-01-05 excludes everything later that day. Whether updated_at moves depends on where the change was made. Edits in the note itself, including its text, completion, assignees and due date, all bump updated_at. An assignee or due date changed outside the note, such as from the action items list, is written to a separate record and leaves updated_at unchanged, so this filter does not pick that item up.
- Completed
completedtrue/false - Completed.
- Archived
archivedtrue/false - Archived.
- Ai detected
ai_detectedtrue/false - Ai detected.
- Ai suggestion accepted by user
ai_suggestion_accepted_by_usertrue/false - Ai suggestion accepted by user.
- Scope
scopetext - Scope.One of:
assigned_to_me(Assigned to me),assigned_to_others(Assigned to others),all.
Outputs
dataobject- Response containing a paginated list of action items.
Example output
{
"data": {
"action_items": {
"data": [],
"page_info": {
"cursor": "example",
"page_size": 1
}
}
}
}List notes
List notes. Returns one page; use the continuation fields for more results.
Inputs
- Cursor
cursortext - Cursor.
- Page size
page_sizenumber - Page size.From 1 to 50. Default:
20. - Include event attendees
include_event_attendeestrue/false - Include event attendees.Default:
false. - Include organizer email
include_organizer_emailtrue/false - Include organizer email.Default:
false. - Include content markdown
include_content_markdowntrue/false - Include content markdown.Default:
false. - Include content fellow markdown
include_content_fellow_markdowntrue/false - Include content fellow markdown.Default:
false. - Event guid
event_guidtext - Event guid.
- Created at start
created_at_starttext - Created at start.
- Created at end
created_at_endtext - Created at end.
- Updated at start
updated_at_starttext - Updated at start.
- Updated at end
updated_at_endtext - Updated at end.
- Channel id
channel_idtext - Channel id.
- Title
titletext - Title.
- Event attendees
event_attendeeslist - Event attendees.
Outputs
dataobject- Response containing a paginated list of notes.
Example output
{
"data": {
"notes": {
"data": [],
"page_info": {
"cursor": "example",
"page_size": 1
}
}
}
}List recordings
List recordings. Returns one page; use the continuation fields for more results.
Inputs
- Cursor
cursortext - Cursor.
- Page size
page_sizenumber - Page size.From 1 to 50. Default:
20. - Include transcript
include_transcripttrue/false - Include transcript.Default:
false. - Include ai notes
include_ai_notestrue/false - Include ai notes.Default:
false. - Event guid
event_guidtext - Event guid.
- Created at start
created_at_starttext - Created at start.
- Created at end
created_at_endtext - Created at end.
- Updated at start
updated_at_starttext - Updated at start.
- Updated at end
updated_at_endtext - Updated at end.
- Channel id
channel_idtext - Channel id.
- Title
titletext - Title.
- Media url expire in
media_url_expire_innumber - Optional expiration time in seconds (1h-24h). Defaults to 12h if not specified.From 3600 to 86400.
Outputs
dataobject- Response containing a paginated list of recordings.
Example output
{
"data": {
"recordings": {
"data": [],
"page_info": {
"cursor": "example",
"page_size": 1
}
}
}
}List uploads
List uploads. Returns one page; use the continuation fields for more results.
Inputs
- Cursor
cursortext - Cursor.
- Page size
page_sizenumber - Page size.From 1 to 50. Default:
20. - Event guid
event_guidtext - Event guid.
- Created at start
created_at_starttext - Created at start.
- Created at end
created_at_endtext - Created at end.
- Updated at start
updated_at_starttext - Updated at start.
- Updated at end
updated_at_endtext - Updated at end.
- Channel id
channel_idtext - Channel id.
- Title
titletext - Title.
- Status
statustext - Status.
Outputs
dataobject- Response containing a paginated list of API-uploaded recordings with import status.
Example output
{
"data": {
"uploads": {
"data": [],
"page_info": {
"cursor": "example",
"page_size": 1
}
}
}
}List webhooks
List webhooks. Returns one page; use the continuation fields for more results.
Inputs
- Page size
page_sizenumber - Page size.
- Cursor
cursortext - Cursor.
- Filters
filterstext - Filters.
Outputs
dataobject- Response containing a paginated list of webhooks.
Example output
{
"data": {
"webhooks": {
"data": [],
"page_info": {
"cursor": "example",
"page_size": 1
}
}
}
}Prepend agenda
Prepend agenda.
Inputs
- Note
note_idtextRequired - Note id.
- Content fellow markdown
content_fellow_markdowntextRequired - Fellow Markdown to add at the start of the agenda, in the same format the note object's content_fellow_markdown field returns.
Outputs
dataobject- Response containing a note's agenda as Fellow Markdown.
Example output
{
"data": {
"agenda": {
"content_fellow_markdown": "example",
"note_id": "example",
"title": "example"
}
}
}Replace agenda
Replace agenda.
Inputs
- Note
note_idtextRequired - Note id.
- Content fellow markdown
content_fellow_markdowntext - The full agenda body in Fellow Markdown, the same format the note object's content_fellow_markdown field returns. When provided, replaces the existing agenda content.
- Title
titletext - New title for the note. When provided, renames the note.
Outputs
dataobject- Response containing a note's agenda as Fellow Markdown.
Example output
{
"data": {
"agenda": {
"content_fellow_markdown": "example",
"note_id": "example",
"title": "example"
}
}
}Upload recording
Upload recording.
Inputs
- Url
urltextRequired - Url.
- Title
titletextRequired - Title.
- Language code
language_codetext - Language code.One of:
en,en_au(En au),en_uk(En uk),en_us(En us),es,fr,de,it,pt,nl, and 93 more. - Media auth type
media_auth_typetext - Media auth type.One of:
bearer_token(Bearer token). Default:bearer_token. - Media auth token
media_auth_tokentext - Media auth token.
- Channel id
channel_idtext - Channel id.
- Event guid
event_guidtext - Event guid.
Outputs
dataobject- Response for POST /recordings/upload — the 201 confirming a recording was queued for import.
Example output
{
"data": {
"recording_id": "example"
}
}