Fellow

App · 20 actions

Read meeting recordings, notes and action items, and update Fellow agendas.

Actions

ActionWhat it does
Append agendaAppend agenda.
Archive action itemArchive action item.
Complete action itemComplete action item.
Create webhookCreate webhook.
Delete webhookDelete webhook.
Find replace agendaFind replace agenda.
Get action itemGet action item.
Get current userGet current user.
Get noteGet note.
Get recordingGet recording.
Get uploadGet upload.
Get webhookGet webhook.
List action itemsList action items.
List notesList notes.
List recordingsList recordings.
List uploadsList uploads.
List webhooksList webhooks.
Prepend agendaPrepend agenda.
Replace agendaReplace agenda.
Upload recordingUpload recording.

Append agenda

Append agenda.

Inputs

Notenote_idtextRequired
Note id.
Content fellow markdowncontent_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 itemaction_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 itemaction_item_idtextRequired
Action item id.
Completedcompletedtrue/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

UrlurltextRequired
The URL endpoint that will receive webhook POST requests
Enabled eventsenabled_eventslistRequired
List of event types to subscribe to. Valid values: 'ai_note.shared_to_channel', 'ai_note.generated', 'action_item.assigned', 'action_item.completed'.
Descriptiondescriptiontext
Optional description for this webhook endpoint
Statusstatustext
Webhook status. Valid values: 'active', 'inactive'One of: active, inactive. Default: active.
Scopescopetext
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 idwebhook_idtextRequired
Webhook id.

Outputs

dataobject
Response for webhook deletion.
Example output
{
  "data": {
    "deleted": false,
    "webhook_id": "example"
  }
}

Find replace agenda

Find replace agenda.

Inputs

Notenote_idtextRequired
Note id.
FindfindtextRequired
Existing agenda text to replace. Must appear exactly once, or the request is rejected.
Content fellow markdowncontent_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 itemaction_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

Notenote_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

Recordingrecording_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

Recordingrecording_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 idwebhook_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

Cursorcursortext
Cursor.
Page sizepage_sizenumber
Page size.From 1 to 50. Default: 20.
Includeincludeobject
Include.
Order byorder_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 startcreated_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 endcreated_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 startupdated_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 endupdated_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.
Completedcompletedtrue/false
Completed.
Archivedarchivedtrue/false
Archived.
Ai detectedai_detectedtrue/false
Ai detected.
Ai suggestion accepted by userai_suggestion_accepted_by_usertrue/false
Ai suggestion accepted by user.
Scopescopetext
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

Cursorcursortext
Cursor.
Page sizepage_sizenumber
Page size.From 1 to 50. Default: 20.
Include event attendeesinclude_event_attendeestrue/false
Include event attendees.Default: false.
Include organizer emailinclude_organizer_emailtrue/false
Include organizer email.Default: false.
Include content markdowninclude_content_markdowntrue/false
Include content markdown.Default: false.
Include content fellow markdowninclude_content_fellow_markdowntrue/false
Include content fellow markdown.Default: false.
Event guidevent_guidtext
Event guid.
Created at startcreated_at_starttext
Created at start.
Created at endcreated_at_endtext
Created at end.
Updated at startupdated_at_starttext
Updated at start.
Updated at endupdated_at_endtext
Updated at end.
Channel idchannel_idtext
Channel id.
Titletitletext
Title.
Event attendeesevent_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

Cursorcursortext
Cursor.
Page sizepage_sizenumber
Page size.From 1 to 50. Default: 20.
Include transcriptinclude_transcripttrue/false
Include transcript.Default: false.
Include ai notesinclude_ai_notestrue/false
Include ai notes.Default: false.
Event guidevent_guidtext
Event guid.
Created at startcreated_at_starttext
Created at start.
Created at endcreated_at_endtext
Created at end.
Updated at startupdated_at_starttext
Updated at start.
Updated at endupdated_at_endtext
Updated at end.
Channel idchannel_idtext
Channel id.
Titletitletext
Title.
Media url expire inmedia_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

Cursorcursortext
Cursor.
Page sizepage_sizenumber
Page size.From 1 to 50. Default: 20.
Event guidevent_guidtext
Event guid.
Created at startcreated_at_starttext
Created at start.
Created at endcreated_at_endtext
Created at end.
Updated at startupdated_at_starttext
Updated at start.
Updated at endupdated_at_endtext
Updated at end.
Channel idchannel_idtext
Channel id.
Titletitletext
Title.
Statusstatustext
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 sizepage_sizenumber
Page size.
Cursorcursortext
Cursor.
Filtersfilterstext
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

Notenote_idtextRequired
Note id.
Content fellow markdowncontent_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

Notenote_idtextRequired
Note id.
Content fellow markdowncontent_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.
Titletitletext
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

UrlurltextRequired
Url.
TitletitletextRequired
Title.
Language codelanguage_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 typemedia_auth_typetext
Media auth type.One of: bearer_token (Bearer token). Default: bearer_token.
Media auth tokenmedia_auth_tokentext
Media auth token.
Channel idchannel_idtext
Channel id.
Event guidevent_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"
  }
}

On this page