# CivicClerk

> Follow your agency's meetings in CivicClerk: meetings by category, agendas, packets and minutes with their text and files, agenda items with attachments, motions and votes, and the portal's search. Start workflows when a meeting is scheduled, an agenda or minutes are published, or a meeting is rescheduled or cancelled.

App · 9 actions. Web page: https://docs.lodol.com/docs/integrations/civicclerk

## Actions

### Download agenda item attachment

Save one attachment of an agenda item (a staff report, contract or exhibit) as a file for later steps.

**Inputs**

- Attachment (`attachment_id`, text, required): The attachment's id, from 'List agenda items'.

**Outputs**

- `attachment_id` (number): The attachment's id
- `content_type` (text): The file's type
- `document_ref` (text): The saved file, for later steps
- `filename` (text): The file's name
- `size_bytes` (number): The file's size in bytes
- `url` (text): Where to open the saved file

**Example output**

```json
{
  "attachment_id": 7056,
  "content_type": "application/pdf",
  "document_ref": "doc_0123456789abcdef0123456789abcdef",
  "filename": "Ordinance 2026-47.pdf",
  "size_bytes": 164415,
  "url": "/actions/core/serve-document/doc_0123456789abcdef0123456789abcdef"
}
```

### Download agenda or minutes

Save a meeting's agenda, agenda packet or minutes as a file for later steps, such as attaching it to an email.

**Inputs**

- Meeting (`meeting_id`, text, required): The meeting. Pick a recent or upcoming one, or give its id from 'List meetings' or a trigger.
- Document (`document`, text): The agenda, the agenda packet or the minutes. Defaults to the agenda. One of: `agenda` (Agenda (default)), `agenda_packet` (Agenda packet), `minutes`. Default: `agenda`.

**Outputs**

- `content_type` (text): The file's type
- `document` (text): Which document: agenda, agenda_packet or minutes
- `document_ref` (text): The saved file, for later steps
- `file_id` (number): The file's id in CivicClerk
- `filename` (text): The file's name
- `meeting_id` (number): The meeting's id
- `size_bytes` (number): The file's size in bytes
- `url` (text): Where to open the saved file

**Example output**

```json
{
  "content_type": "application/pdf",
  "document": "agenda",
  "document_ref": "doc_0123456789abcdef0123456789abcdef",
  "file_id": 2079,
  "filename": "Lockhart City Council 2026-11-05 Agenda.pdf",
  "meeting_id": 1246,
  "size_bytes": 164415,
  "url": "/actions/core/serve-document/doc_0123456789abcdef0123456789abcdef"
}
```

### Get agenda or minutes text

Get the text of a meeting's agenda, agenda packet or minutes, to summarize, search or quote in later steps.

**Inputs**

- Meeting (`meeting_id`, text, required): The meeting. Pick a recent or upcoming one, or give its id from 'List meetings' or a trigger.
- Document (`document`, text): The agenda, the agenda packet or the minutes. Defaults to the agenda. One of: `agenda` (Agenda (default)), `agenda_packet` (Agenda packet), `minutes`. Default: `agenda`.

**Outputs**

- `characters` (number): How long the whole text is
- `document` (text): Which document: agenda, agenda_packet or minutes
- `file_id` (number): The file's id
- `meeting_id` (number): The meeting's id
- `meeting_name` (text): The meeting's name
- `name` (text): The file's name as published
- `published` (text): When it was published (the agency's local time)
- `text` (text): The file's text
- `truncated` (true/false): True when the text was cut at 200,000 characters
- `url` (text): A public link to the file

**Example output**

```json
{
  "characters": 11201,
  "document": "agenda",
  "file_id": 2079,
  "meeting_id": 1246,
  "meeting_name": "Lockhart City Council",
  "name": "November 5, 2026",
  "published": "2026-10-30T18:35:20",
  "text": "PUBLIC NOTICE\nAGENDA\nLOCKHART CITY COUNCIL\n...",
  "truncated": false,
  "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2079,plainText=false)"
}
```

### Get meeting

Get one meeting: its date, time, place, category, published files with links, and optionally its agenda items.

**Inputs**

- Meeting (`meeting_id`, text, required): The meeting. Pick a recent or upcoming one, or give its id from 'List meetings' or a trigger.
- Include agenda items (`include_items`, true/false): Also return the meeting's agenda items, attachments and motions.

**Outputs**

- `items` (list): Its agenda items, when asked for; empty otherwise
- `meeting` (object): The meeting

**Example output**

```json
{
  "items": [
    {
      "attachments": [
        {
          "content_type": "application/pdf",
          "file_name": "Ordinance 2026-47.pdf",
          "id": 7056,
          "name": "Ordinance 2026-47",
          "size": 153748,
          "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetAttachmentFile(fileId=7056)"
        }
      ],
      "category": "",
      "description": "",
      "fiscal_impact": "",
      "id": 8949,
      "is_heading": false,
      "item_number": "2026-345",
      "level": 1,
      "minutes_note": "",
      "motions": [
        {
          "abstain": [],
          "motion": "Approve the June 2, 2026 meeting minutes",
          "moved_by": "Carol McCutcheon",
          "no": [],
          "pass_fail": 1,
          "result": "Passed",
          "seconded_by": "Suzanne Whatley",
          "yes": [
            "Suzanne Whatley",
            "Carol McCutcheon",
            "Jim Vonderhaar"
          ]
        }
      ],
      "number": "A.",
      "ordinance_number": "2026-47",
      "presenter": "",
      "recommended_actions": [],
      "resolution_number": "",
      "section": "PUBLIC HEARING/COUNCIL ACTION",
      "title": "Hold a public hearing, consider, and take possible action on Ordinance No. 2026-47"
    }
  ],
  "meeting": {
    "agenda_id": 1233,
    "agenda_packet_url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2081,plainText=false)",
    "agenda_status": "Agenda Posted on October 30, 2026 6:35 PM",
    "agenda_url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2079,plainText=false)",
    "category_id": 26,
    "category_name": "City Council",
    "created": "2026-08-31T14:00:48",
    "date": "2026-11-05",
    "description": "",
    "files": [
      {
        "file_id": 2079,
        "name": "November 5, 2026",
        "published": "2026-10-30T18:35:20",
        "type": "Agenda",
        "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2079,plainText=false)"
      },
      {
        "file_id": 2081,
        "name": "November 5, 2026",
        "published": "2026-10-30T18:35:20",
        "type": "Agenda Packet",
        "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2081,plainText=false)"
      }
    ],
    "id": 1246,
    "location": {
      "address": "217 SOUTH MAIN STREET, 3rd FLOOR",
      "city": "LOCKHART",
      "name": "CLARK LIBRARY ANNEX - COUNCIL CHAMBERS",
      "state": "TEXAS",
      "zip": "78644"
    },
    "location_text": "CLARK LIBRARY ANNEX - COUNCIL CHAMBERS, 217 SOUTH MAIN STREET, 3rd FLOOR, LOCKHART, TEXAS 78644",
    "meeting_url": "https://lockharttx.portal.civicclerk.com/event/1246",
    "minutes_url": null,
    "name": "Lockhart City Council",
    "notice": "",
    "start": "2026-11-05T18:30:00",
    "time": "6:30 PM",
    "video_url": null
  }
}
```

### Get motions and votes on an agenda item

Get the motions recorded on one agenda item in the minutes: who moved and seconded, the result, and who voted yes, no or abstained.

**Inputs**

- Agenda item (`item_id`, text, required): The agenda item's id, from 'List agenda items'.

**Outputs**

- `count` (number): How many
- `item_id` (number): The agenda item's id
- `motions` (list): The motions

**Example output**

```json
{
  "count": 1,
  "item_id": 8603,
  "motions": [
    {
      "abstain": [],
      "motion": "Approve the June 2, 2026 meeting minutes",
      "moved_by": "Carol McCutcheon",
      "no": [],
      "pass_fail": 1,
      "result": "Passed",
      "seconded_by": "Suzanne Whatley",
      "yes": [
        "Suzanne Whatley",
        "Carol McCutcheon",
        "Jim Vonderhaar"
      ]
    }
  ]
}
```

### List agenda items

List a meeting's agenda in order, headings and items, with each item's attachments and the motions and votes recorded on it.

**Inputs**

- Meeting (`meeting_id`, text, required): The meeting. Pick a recent or upcoming one, or give its id from 'List meetings' or a trigger.
- Which items (`which`, text): Everything, or only items, items with attachments, or items with a motion. One of: `all` (Every item and heading (default)), `items` (Only items, without section headings), `attachments` (Only items with attachments), `motions` (Only items with a motion recorded). Default: `all`.

**Outputs**

- `agenda_id` (number): The id of the meeting's agenda
- `count` (number): How many
- `items` (list): The agenda items, in order
- `meeting_id` (number): The meeting's id

**Example output**

```json
{
  "agenda_id": 1233,
  "count": 1,
  "items": [
    {
      "attachments": [
        {
          "content_type": "application/pdf",
          "file_name": "Ordinance 2026-47.pdf",
          "id": 7056,
          "name": "Ordinance 2026-47",
          "size": 153748,
          "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetAttachmentFile(fileId=7056)"
        }
      ],
      "category": "",
      "description": "",
      "fiscal_impact": "",
      "id": 8949,
      "is_heading": false,
      "item_number": "2026-345",
      "level": 1,
      "minutes_note": "",
      "motions": [
        {
          "abstain": [],
          "motion": "Approve the June 2, 2026 meeting minutes",
          "moved_by": "Carol McCutcheon",
          "no": [],
          "pass_fail": 1,
          "result": "Passed",
          "seconded_by": "Suzanne Whatley",
          "yes": [
            "Suzanne Whatley",
            "Carol McCutcheon",
            "Jim Vonderhaar"
          ]
        }
      ],
      "number": "A.",
      "ordinance_number": "2026-47",
      "presenter": "",
      "recommended_actions": [],
      "resolution_number": "",
      "section": "PUBLIC HEARING/COUNCIL ACTION",
      "title": "Hold a public hearing, consider, and take possible action on Ordinance No. 2026-47"
    }
  ],
  "meeting_id": 1246
}
```

### List meeting categories

List the agency's meeting categories, such as City Council, Planning Commission or a board.

**Inputs**: None.

**Outputs**

- `categories` (list): The categories, in the portal's order
- `count` (number): How many

**Example output**

```json
{
  "categories": [
    {
      "id": 26,
      "name": "City Council",
      "parent_id": null,
      "public": true,
      "sort": 1
    }
  ],
  "count": 1
}
```

### List meetings

List meetings by category, date range and words in their name, each with links to its published agenda, packet and minutes.

**Inputs**

- Category (`category_id`, text): Only meetings in this category, such as City Council or Planning Commission.
- On or after (`from_date`, date): Only meetings on or after this date.
- On or before (`to_date`, date): Only meetings on or before this date.
- Name contains (`search`, text): Only meetings whose name contains these words. Case doesn't matter.
- Order (`order`, text): By meeting date. Defaults to the latest first. One of: `newest` (Latest date first (default)), `oldest` (Earliest date first). Default: `newest`.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Skip (`skip`, number): How many to skip, for the next page: the 'next_skip' of the page before. At least 0.

**Outputs**

- `count` (number): How many
- `has_more` (true/false): Whether there may be more
- `meetings` (list): The meetings
- `next_skip` (number): What to put in Skip for the next page (0 when there is none)
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "meetings": [
    {
      "agenda_id": 1233,
      "agenda_packet_url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2081,plainText=false)",
      "agenda_status": "Agenda Posted on October 30, 2026 6:35 PM",
      "agenda_url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2079,plainText=false)",
      "category_id": 26,
      "category_name": "City Council",
      "created": "2026-08-31T14:00:48",
      "date": "2026-11-05",
      "description": "",
      "files": [
        {
          "file_id": 2079,
          "name": "November 5, 2026",
          "published": "2026-10-30T18:35:20",
          "type": "Agenda",
          "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2079,plainText=false)"
        },
        {
          "file_id": 2081,
          "name": "November 5, 2026",
          "published": "2026-10-30T18:35:20",
          "type": "Agenda Packet",
          "url": "https://lockharttx.api.civicclerk.com/v1/Meetings/GetMeetingFileStream(fileId=2081,plainText=false)"
        }
      ],
      "id": 1246,
      "location": {
        "address": "217 SOUTH MAIN STREET, 3rd FLOOR",
        "city": "LOCKHART",
        "name": "CLARK LIBRARY ANNEX - COUNCIL CHAMBERS",
        "state": "TEXAS",
        "zip": "78644"
      },
      "location_text": "CLARK LIBRARY ANNEX - COUNCIL CHAMBERS, 217 SOUTH MAIN STREET, 3rd FLOOR, LOCKHART, TEXAS 78644",
      "meeting_url": "https://lockharttx.portal.civicclerk.com/event/1246",
      "minutes_url": null,
      "name": "Lockhart City Council",
      "notice": "",
      "start": "2026-11-05T18:30:00",
      "time": "6:30 PM",
      "video_url": null
    }
  ],
  "next_skip": 0,
  "total": 1
}
```

### Search agendas and minutes

Search the portal's meetings, agenda items, attachments, agendas and minutes for words, as the portal's own search does.

**Inputs**

- Words (`query`, text, required): What to look for, such as a street, a business or a topic.
- Search in (`what`, text): Everything, or only meetings, agenda items, attachments, agendas or minutes. One of: `all` (Everything (default)), `meetings`, `items` (Agenda items), `attachments`, `agenda_files` (Agendas and packets), `minutes`. Default: `all`.
- Category (`category_id`, text): Only meetings in this category, such as City Council or Planning Commission.
- On or after (`from_date`, date): Only meetings on or after this date.
- On or before (`to_date`, date): Only meetings on or before this date.
- Skip (`skip`, number): How many meetings' results to skip, for the next page: the 'next_skip' of the page before. At least 0.

**Outputs**

- `count` (number): How many
- `has_more` (true/false): Whether there may be more
- `meetings` (number): How many meetings matched
- `next_skip` (number): What to put in Skip for the next page (0 when there is none)
- `results` (list): What matched, by meeting

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "meetings": 1,
  "next_skip": 0,
  "results": [
    {
      "category_name": "City Council",
      "id": 11064,
      "kind": "Agenda item",
      "meeting_id": 1344,
      "meeting_name": "City Council Meeting",
      "meeting_start": "2026-11-03T17:30:00",
      "name": "SWTP Rehab Phase 1 construction contract and budget amendment",
      "snippet": "",
      "url": "https://sugarlandtx.portal.civicclerk.com/event/1344"
    }
  ]
}
```
