List meeting action items
Returns the manual action items of the meeting and those generated in the latest ready minutes, in one shape.
/meetings/{meeting_id}/action-items- Required scope
meetings:read- Authentication
Authorization: Bearer
Filter with source.
Parameters
| Name | In | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|---|
meeting_id | path | string | required | – | 26–26 characters · pattern: ^mtg_[0-9A-Za-z]{22}$ | Public meeting ID (mtg_ prefix). |
source | query | string | no | – | – | Return only manual or only generated items. Allowed values: manualgenerated |
limit | query | integer | no | 20 | 1–100 · format: int32 | Page size, from 1 to 100. Default 20. Follow has_more, not the page size. |
cursor | query | string | no | – | ≤ 1024 characters | Opaque cursor from next_cursor of the previous page. Cursors are tied to the user, route, sort order and filters. |
Response
200
A page of action items.
RateLimitThe most restrictive policy that applied:"name";r=<requests left>;t=<seconds>, wheretis the number of seconds until one more request is allowed (0 when the quota is full). Absent when no rate limiter ran for the request.RateLimit-PolicyThe rate-limit policies that applied to the request, one"name";q=<burst>;w=<seconds>item per policy, for example"read";q=10;w=2, "account";q=20;w=2:qis the burst quota andwthe seconds in which an empty quota refills. Sent on every authenticated response; absent when no rate limiter ran for the request, for example when it was rejected before the key was checked.Request-IdID of this request (req_prefix), the same asrequest_idin an error body. It is also sent asX-Request-ID. Quote it when you contact support.X-Client-Request-IdYour ownX-Client-Request-Idrequest header, echoed back. It is sent only when the value you sent has 1-128 characters from A-Z a-z 0-9 . _ : -.X-RateLimit-LimitBurst quota of the most restrictive policy (qinRateLimit-Policy). Absent when no rate limiter ran.X-RateLimit-RemainingRequests left in the most restrictive policy (rinRateLimit). Absent when no rate limiter ran.X-RateLimit-ResetSeconds until one more request is allowed in the most restrictive policy (tinRateLimit; 0 when the quota is full). It is a number of seconds, not a timestamp. Absent when no rate limiter ran.
Content type: application/json
objectstringrequiredAlways
list.dataarray<object>requiredThe items of this page.
11 fields
objectstringrequiredAlways
action_item.idstring | nullrequiredPublic ID (
act_prefix). Null for generated items.sourcestringrequiredWhere the item comes from.
textstringrequiredTask title.
descriptionstring | nullrequiredLonger description, if any.
statusstringrequiredTask status. Generated items are always
open.assignee_namestring | nullrequiredName of the person responsible.
due_textstring | nullrequiredFree-text deadline from generated minutes.
due_atstring | nullrequiredDeadline of a manual item.
timestamps_msarray<integer>requiredMoments in the recording the item comes from, in milliseconds.
created_atstring | nullrequiredWhen a manual item was created. Null for generated items.
has_morebooleanrequiredWhether more items follow. Keep paging while this is true.
next_cursorstring | nullrequiredCursor for the next page, or null when
has_moreis false.
Examples
Request
curl "https://api.diko.app/api/v1/meetings/mtg_0aZ1bY2cX3dW4eV5fU6gT7/action-items" \
-H "Authorization: Bearer $DIKO_API_KEY"import os
import requests
response = requests.get(
"https://api.diko.app/api/v1/meetings/mtg_0aZ1bY2cX3dW4eV5fU6gT7/action-items",
headers={"Authorization": f"Bearer {os.environ['DIKO_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.diko.app/api/v1/meetings/mtg_0aZ1bY2cX3dW4eV5fU6gT7/action-items", {
headers: {
Authorization: `Bearer ${process.env.DIKO_API_KEY}`,
},
})
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`)
console.log(await response.json())Example response · 200 · application/json
{
"object": "list",
"data": [
{
"object": "action_item",
"id": "act_4VYK4CNn7WirPteKPtx17L",
"source": "manual",
"text": "Išsiųsti pasiūlymą",
"description": null,
"status": "open",
"assignee_name": "Jonas",
"due_text": null,
"due_at": "2026-10-17T00:00:00.000Z",
"timestamps_ms": [],
"created_at": "2026-10-11T09:31:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}Errors
This endpoint can return these errors. Every code is described in the error catalog.
| HTTP | Code | Meaning | Retry? |
|---|---|---|---|
| 400 | invalid_parameter | A path, query or body parameter has an invalid value, a required field is missing or a field is unknown (unknown fields are rejected). `error.param` names the parameter. | no |
| 400 | invalid_cursor | The `cursor` is corrupted or was issued for another user, route, sort order or set of filters. | no |
| 401 | missing_api_key | The request has no `Authorization` header. | no |
| 401 | invalid_api_key | The header is unusable (a scheme other than `Bearer`, an empty key or more than one `Authorization` header) or the key is unknown or malformed (wrong structure or checksum). The response is identical in all these cases. | no |
| 401 | api_key_expired | The key has expired. | no |
| 401 | api_key_revoked | The key was revoked: manually, after a rotation grace period ended, because of a leak or because the account was disabled. | no |
| 401 | api_key_disabled | The key is temporarily disabled. | no |
| 402 | subscription_required | The account has no active paid access. | no |
| 403 | ip_not_allowed | The key has an IP allowlist and the request IP is not on it, or it cannot be determined reliably. | no |
| 403 | account_disabled | The account is disabled. | no |
| 403 | email_not_verified | The account e-mail address is not verified. | no |
| 403 | api_access_suspended | A Diko administrator suspended API access for this account. | no |
| 403 | plan_required | The plan does not include the API. `error.details.required_plans` lists `verslas`. | no |
| 403 | insufficient_scope | The key lacks the scope this endpoint needs. `error.details` contains `required_scopes` and `granted_scopes`. | no |
| 404 | not_found | The resource does not exist, does not belong to your account or its ID is encoded incorrectly. | no |
| 429 | rate_limit_exceeded | A rate-limit policy was exceeded. `error.details.policy` names it. | yes, after Retry-After |
| 500 | internal_error | An internal server error. | conditionally |
| 503 | service_unavailable | The service is temporarily busy, for example because of database load. | yes, after Retry-After |