# Fellow

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

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/fellow

## Actions

### Append agenda

Append agenda.

**Inputs**

- Note (`note_id`, text, required): Note id.
- Content fellow markdown (`content_fellow_markdown`, text, required): Fellow Markdown to add at the end of the agenda, in the same format the note object's content_fellow_markdown field returns.

**Outputs**

- `data` (object): Response containing a note's agenda as Fellow Markdown.

**Example output**

```json
{
  "data": {
    "agenda": {
      "content_fellow_markdown": "example",
      "note_id": "example",
      "title": "example"
    }
  }
}
```

### Archive action item

Archive action item.

**Inputs**

- Action item (`action_item_id`, text, required): Action item id.

**Outputs**

- `data` (object): Response containing a single action item.

**Example output**

```json
{
  "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_id`, text, required): Action item id.
- Completed (`completed`, true/false, required): Completed.

**Outputs**

- `data` (object): Response containing a single action item.

**Example output**

```json
{
  "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 (`url`, text, required): The URL endpoint that will receive webhook POST requests
- Enabled events (`enabled_events`, list, required): List of event types to subscribe to. Valid values: 'ai_note.shared_to_channel', 'ai_note.generated', 'action_item.assigned', 'action_item.completed'.
- Description (`description`, text): Optional description for this webhook endpoint
- Status (`status`, text): Webhook status. Valid values: 'active', 'inactive'. One of: `active`, `inactive`. Default: `active`.
- Scope (`scope`, text): 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**

- `data` (object): Response for webhook creation, includes the secret (only returned once).

**Example output**

```json
{
  "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_id`, text, required): Webhook id.

**Outputs**

- `data` (object): Response for webhook deletion.

**Example output**

```json
{
  "data": {
    "deleted": false,
    "webhook_id": "example"
  }
}
```

### Find replace agenda

Find replace agenda.

**Inputs**

- Note (`note_id`, text, required): Note id.
- Find (`find`, text, required): Existing agenda text to replace. Must appear exactly once, or the request is rejected.
- Content fellow markdown (`content_fellow_markdown`, text, required): 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**

- `data` (object): Response containing a note's agenda as Fellow Markdown.

**Example output**

```json
{
  "data": {
    "agenda": {
      "content_fellow_markdown": "example",
      "note_id": "example",
      "title": "example"
    }
  }
}
```

### Get action item

Get action item.

**Inputs**

- Action item (`action_item_id`, text, required): Action item id.

**Outputs**

- `data` (object): Response containing a single action item.

**Example output**

```json
{
  "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**

- `data` (object): Response for the /me endpoint.

**Example output**

```json
{
  "data": {
    "user": {
      "email": "example",
      "full_name": "example",
      "id": "example"
    },
    "workspace": {
      "id": "example",
      "name": "example",
      "subdomain": "example"
    }
  }
}
```

### Get note

Get note.

**Inputs**

- Note (`note_id`, text, required): Note id.

**Outputs**

- `data` (object): Response containing a single note.

**Example output**

```json
{
  "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_id`, text, required): Recording id.

**Outputs**

- `data` (object): Response containing a single recording.

**Example output**

```json
{
  "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_id`, text, required): Recording id.

**Outputs**

- `data` (object): Response containing a single API-uploaded recording with its import status.

**Example output**

```json
{
  "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_id`, text, required): Webhook id.

**Outputs**

- `data` (object): Response containing a single webhook.

**Example output**

```json
{
  "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 (`cursor`, text): Cursor.
- Page size (`page_size`, number): Page size. From 1 to 50. Default: `20`.
- Include (`include`, object): Include.
- Order by (`order_by`, text): 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_start`, text): 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_end`, text): 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_start`, text): 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_end`, text): 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 (`completed`, true/false): Completed.
- Archived (`archived`, true/false): Archived.
- Ai detected (`ai_detected`, true/false): Ai detected.
- Ai suggestion accepted by user (`ai_suggestion_accepted_by_user`, true/false): Ai suggestion accepted by user.
- Scope (`scope`, text): Scope. One of: `assigned_to_me` (Assigned to me), `assigned_to_others` (Assigned to others), `all`.

**Outputs**

- `data` (object): Response containing a paginated list of action items.

**Example output**

```json
{
  "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 (`cursor`, text): Cursor.
- Page size (`page_size`, number): Page size. From 1 to 50. Default: `20`.
- Include event attendees (`include_event_attendees`, true/false): Include event attendees. Default: `false`.
- Include organizer email (`include_organizer_email`, true/false): Include organizer email. Default: `false`.
- Include content markdown (`include_content_markdown`, true/false): Include content markdown. Default: `false`.
- Include content fellow markdown (`include_content_fellow_markdown`, true/false): Include content fellow markdown. Default: `false`.
- Event guid (`event_guid`, text): Event guid.
- Created at start (`created_at_start`, text): Created at start.
- Created at end (`created_at_end`, text): Created at end.
- Updated at start (`updated_at_start`, text): Updated at start.
- Updated at end (`updated_at_end`, text): Updated at end.
- Channel id (`channel_id`, text): Channel id.
- Title (`title`, text): Title.
- Event attendees (`event_attendees`, list): Event attendees.

**Outputs**

- `data` (object): Response containing a paginated list of notes.

**Example output**

```json
{
  "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 (`cursor`, text): Cursor.
- Page size (`page_size`, number): Page size. From 1 to 50. Default: `20`.
- Include transcript (`include_transcript`, true/false): Include transcript. Default: `false`.
- Include ai notes (`include_ai_notes`, true/false): Include ai notes. Default: `false`.
- Event guid (`event_guid`, text): Event guid.
- Created at start (`created_at_start`, text): Created at start.
- Created at end (`created_at_end`, text): Created at end.
- Updated at start (`updated_at_start`, text): Updated at start.
- Updated at end (`updated_at_end`, text): Updated at end.
- Channel id (`channel_id`, text): Channel id.
- Title (`title`, text): Title.
- Media url expire in (`media_url_expire_in`, number): Optional expiration time in seconds (1h-24h). Defaults to 12h if not specified. From 3600 to 86400.

**Outputs**

- `data` (object): Response containing a paginated list of recordings.

**Example output**

```json
{
  "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 (`cursor`, text): Cursor.
- Page size (`page_size`, number): Page size. From 1 to 50. Default: `20`.
- Event guid (`event_guid`, text): Event guid.
- Created at start (`created_at_start`, text): Created at start.
- Created at end (`created_at_end`, text): Created at end.
- Updated at start (`updated_at_start`, text): Updated at start.
- Updated at end (`updated_at_end`, text): Updated at end.
- Channel id (`channel_id`, text): Channel id.
- Title (`title`, text): Title.
- Status (`status`, text): Status.

**Outputs**

- `data` (object): Response containing a paginated list of API-uploaded recordings with import status.

**Example output**

```json
{
  "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_size`, number): Page size.
- Cursor (`cursor`, text): Cursor.
- Filters (`filters`, text): Filters.

**Outputs**

- `data` (object): Response containing a paginated list of webhooks.

**Example output**

```json
{
  "data": {
    "webhooks": {
      "data": [],
      "page_info": {
        "cursor": "example",
        "page_size": 1
      }
    }
  }
}
```

### Prepend agenda

Prepend agenda.

**Inputs**

- Note (`note_id`, text, required): Note id.
- Content fellow markdown (`content_fellow_markdown`, text, required): Fellow Markdown to add at the start of the agenda, in the same format the note object's content_fellow_markdown field returns.

**Outputs**

- `data` (object): Response containing a note's agenda as Fellow Markdown.

**Example output**

```json
{
  "data": {
    "agenda": {
      "content_fellow_markdown": "example",
      "note_id": "example",
      "title": "example"
    }
  }
}
```

### Replace agenda

Replace agenda.

**Inputs**

- Note (`note_id`, text, required): Note id.
- Content fellow markdown (`content_fellow_markdown`, text): 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 (`title`, text): New title for the note. When provided, renames the note.

**Outputs**

- `data` (object): Response containing a note's agenda as Fellow Markdown.

**Example output**

```json
{
  "data": {
    "agenda": {
      "content_fellow_markdown": "example",
      "note_id": "example",
      "title": "example"
    }
  }
}
```

### Upload recording

Upload recording.

**Inputs**

- Url (`url`, text, required): Url.
- Title (`title`, text, required): Title.
- Language code (`language_code`, text): 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_type`, text): Media auth type. One of: `bearer_token` (Bearer token). Default: `bearer_token`.
- Media auth token (`media_auth_token`, text): Media auth token.
- Channel id (`channel_id`, text): Channel id.
- Event guid (`event_guid`, text): Event guid.

**Outputs**

- `data` (object): Response for POST /recordings/upload — the 201 confirming a recording was queued for import.

**Example output**

```json
{
  "data": {
    "recording_id": "example"
  }
}
```
