Toplantılar API

Era toplantılarınıza katılır — not alan bir botla ya da bilgisayarınızdan botsuz —, öncesinde ön bilgi verir, sonrasında notları, görevleri, takip e-postasını ve sonraki adımları yazar.

Modül kodu meetings · 33 işlem · 4 veri modeli · 16 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: meetings (hepsi), meetings:read (yalnız okuma) ya da meetings:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

meetings.accept_action_item

Aksiyon maddesini göreve çevir — Taahhüt, son tarihiyle sahibine (ya da sana) fırsata veya müşteriye bağlı bir görev olur.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.accept_action_item

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.action_item_accepted

Neye yazar: meeting_action_item (update) — proposed → accepted (the task follows)

curl -X POST https://app.getera.io/api/v1/meeting_action_items/MEETING_ACTION_ITEM_ID/actions/accept_action_item \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"assigneeUserId":"APP_USER_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.action_item_accepted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingActionItems.acceptActionItem("MEETING_ACTION_ITEM_ID", {
  assigneeUserId: "APP_USER_ID"
})

era meeting_action_items accept_action_item MEETING_ACTION_ITEM_ID \
  --assignee-user-id "APP_USER_ID"

{
  "name": "era__meetings__accept_action_item",
  "arguments": {
    "id": "MEETING_ACTION_ITEM_ID",
    "assigneeUserId": "APP_USER_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 item_not_found, item_closed, not_member · 429 çok sık istek

meetings.accept_next_meeting

Önerilen sonraki toplantıyı ekle — Era’nın anlaşıldığını duyduğu sonraki toplantıyı ekler — aynı kişiler, aynı fırsat — Era ona da katılır ve hazırlanır.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.accept_next_meeting

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.scheduled, meetings.next_meeting_booked

Neye yazar: meeting (insert) — Writes the next meeting; meeting (update) — suggestion → accepted

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/accept_next_meeting \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"startsAt":"2026-11-02T09:00:00Z"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.scheduled",
    "meetings.next_meeting_booked"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.acceptNextMeeting("MEETING_ID", {
  startsAt: "2026-11-02T09:00:00Z"
})

era meetings accept_next_meeting MEETING_ID \
  --starts-at "2026-11-02T09:00:00Z"

{
  "name": "era__meetings__accept_next_meeting",
  "arguments": {
    "id": "MEETING_ID",
    "startsAt": "2026-11-02T09:00:00Z"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_suggestion, suggestion_closed, bad_time, bad_join_url · 429 çok sık istek

meetings.accept_stage

Fırsatı önerilen aşamaya taşı — Era toplantıyı okudu ve fırsatın sonraki aşamasını öneriyor; bu onu taşır.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.accept_stage

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.stage_accepted

Neye yazar: meeting (update) — suggestion → accepted (the stage change follows)

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/accept_stage \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.stage_accepted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.acceptStage("MEETING_ID")

era meetings accept_stage MEETING_ID

{
  "name": "era__meetings__accept_stage",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_suggestion, suggestion_closed · 429 çok sık istek

meetings.add_action_item

Toplantıya aksiyon maddesi ekle — Era’nın kaçırdığı bir şey — kim, ne, ne zamana.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.add_action_item

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.action_item_created

Neye yazar: meeting_action_item (insert) — Writes the item (proposed)

curl -X POST https://app.getera.io/api/v1/meeting_action_items/actions/add_action_item \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"meetingId":"MEETING_ID","text":"What"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.action_item_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingActionItems.addActionItem({
  meetingId: "MEETING_ID",
  text: "What"
})

era meeting_action_items add_action_item \
  --meeting-id "MEETING_ID" \
  --text "What"

{
  "name": "era__meetings__add_action_item",
  "arguments": {
    "meetingId": "MEETING_ID",
    "text": "What"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, empty_text, not_member · 429 çok sık istek

meetings.approve_follow_up

Takip e-postasını onayla ve gönder — Era’nın taslağı, bağladıysan kendi Gmail ya da Outlook’undan (senin adınla), yoksa işletmenin göndericisinden gider.

Gereken izin meetings:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/meetings.approve_follow_up

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.follow_up_approved

Neye yazar: meeting (update) — draft → approved (the send follows)

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/approve_follow_up \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.follow_up_approved"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.approveFollowUp("MEETING_ID")

era meetings approve_follow_up MEETING_ID

{
  "name": "era__meetings__approve_follow_up",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_follow_up, follow_up_closed, invalid_recipient, send_from_unusable · 429 çok sık istek

meetings.connect_calendar

Toplantılara takvim bağla — Era Google ya da Outlook takvimini okur, her toplantı için brif hazırlar ve kuralının seçtiklerine katılır.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.connect_calendar

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.calendar_connected

Neye yazar: meeting_calendar (insert) — Writes the calendar and its rule

curl -X POST https://app.getera.io/api/v1/meeting_calendars/actions/connect_calendar \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"provider":"google","credentialId":"Connected account"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.calendar_connected"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingCalendars.connectCalendar({
  provider: "google",
  credentialId: "Connected account"
})

era meeting_calendars connect_calendar \
  --provider "google" \
  --credential-id "Connected account"

{
  "name": "era__meetings__connect_calendar",
  "arguments": {
    "provider": "google",
    "credentialId": "Connected account"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 calendar_connected · 429 çok sık istek

meetings.delete

Toplantıyı sil — Toplantıyı, dökümünü, notlarını ve aksiyon maddelerini siler (unutulma hakkı). Oluşmuş görevler kalır.

Gereken izin meetings:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• REST kısayolu: DELETE /api/v1/meetings/{id}
• Asıl adres: POST /api/v1/actions/meetings.delete

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.deleted

Neye yazar: meeting (delete) — Removes the meeting; meeting_action_item (delete) — Its action items go with it

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/delete \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.delete("MEETING_ID")

era meetings delete MEETING_ID

{
  "name": "era__meetings__delete",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, meeting_live · 429 çok sık istek

meetings.discard_follow_up

Takip e-postasından vazgeç — Bu toplantı için e-posta yok.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.discard_follow_up

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — draft → discarded

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/discard_follow_up \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.discardFollowUp("MEETING_ID")

era meetings discard_follow_up MEETING_ID

{
  "name": "era__meetings__discard_follow_up",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_follow_up, follow_up_closed · 429 çok sık istek

meetings.disconnect_calendar

Toplantı takviminin bağlantısını kes — Era onu okumayı bırakır; yaklaşan toplantıları düşer, geçmiş notlar kalır.

Gereken izin meetings:write · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/meetings.disconnect_calendar

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting_calendar (delete) — Removes the calendar; meeting (update) — Its unrecorded upcoming meetings → cancelled

curl -X POST https://app.getera.io/api/v1/meeting_calendars/MEETING_CALENDAR_ID/actions/disconnect_calendar \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingCalendars.disconnectCalendar("MEETING_CALENDAR_ID")

era meeting_calendars disconnect_calendar MEETING_CALENDAR_ID

{
  "name": "era__meetings__disconnect_calendar",
  "arguments": {
    "id": "MEETING_CALENDAR_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 calendar_not_found, not_your_calendar · 429 çok sık istek

meetings.dismiss_action_item

Aksiyon maddesini kaldır — Era taahhüt sandı ama değildi.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.dismiss_action_item

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting_action_item (update) — → dismissed

curl -X POST https://app.getera.io/api/v1/meeting_action_items/MEETING_ACTION_ITEM_ID/actions/dismiss_action_item \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingActionItems.dismissActionItem("MEETING_ACTION_ITEM_ID")

era meeting_action_items dismiss_action_item MEETING_ACTION_ITEM_ID

{
  "name": "era__meetings__dismiss_action_item",
  "arguments": {
    "id": "MEETING_ACTION_ITEM_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 item_not_found, item_closed · 429 çok sık istek

meetings.dismiss_suggestion

Öneriyi geç — Fırsat olduğu yerde kalsın ya da sonraki toplantı eklenmesin.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.dismiss_suggestion

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — suggestion → dismissed

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/dismiss_suggestion \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"kind":"stage"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.dismissSuggestion("MEETING_ID", {
  kind: "stage"
})

era meetings dismiss_suggestion MEETING_ID \
  --kind "stage"

{
  "name": "era__meetings__dismiss_suggestion",
  "arguments": {
    "id": "MEETING_ID",
    "kind": "stage"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_suggestion, suggestion_closed · 429 çok sık istek

meetings.edit_follow_up

Takip e-postasını düzenle — Era’nın toplantıdan sonra hazırladığı e-postanın alıcısı, konusu ya da metni.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.edit_follow_up

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — Rewrites the draft

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/edit_follow_up \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"to":"To"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.editFollowUp("MEETING_ID", {
  to: "To"
})

era meetings edit_follow_up MEETING_ID \
  --to "To"

{
  "name": "era__meetings__edit_follow_up",
  "arguments": {
    "id": "MEETING_ID",
    "to": "To"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_follow_up, follow_up_closed, invalid_recipient, invalid_send_from · 429 çok sık istek

meetings.expire_audio

Toplantının kaydını sil — Ses şimdi (sahibi istedi) ya da saklama süresinden sonra silinir; döküm ve notlar kalır.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.expire_audio

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — Drops the recording link

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/expire_audio \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.expireAudio("MEETING_ID")

era meetings expire_audio MEETING_ID

{
  "name": "era__meetings__expire_audio",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_recording · 429 çok sık istek

meetings.fail

Toplantı işlenemedi — Kayıt alınamadı ya da okunamadı; ayrılan tutar geri verilir. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.fail

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.capture_failed

Neye yazar: meeting (update) — → failed, released

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, already_filed · 429 çok sık istek

meetings.file_notes

Toplantı notlarını kaydet — Özet, kararlar, aksiyon maddeleri, takip taslağı ve öneriler — ve iş akışlarına toplantının bittiğini söyler. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.file_notes

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.ended, meetings.action_item_created

Neye yazar: meeting (update) — → ready, with the notes and proposals; meeting_action_item (insert) — One row per commitment (proposed)

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_transcript, invalid_payload · 429 çok sık istek

meetings.file_transcript

Toplantı dökümünü kaydet — Konuşulanlar, süre ve kayıt; not alıcının gerçek dakikaları ücretlenir. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.file_transcript

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — → processing, with transcript, length and cost

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, already_filed, invalid_payload, no_transcript · 429 çok sık istek

meetings.forget_speaker

Hatırlanan bir konuşmacı adını unut — Era sonraki toplantılarda bu adı o sese koymaz.

Gereken izin meetings:write · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/meetings.forget_speaker

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting_speaker_alias (delete) — Removes it

curl -X POST https://app.getera.io/api/v1/meeting_speaker_aliases/MEETING_SPEAKER_ALIASE_ID/actions/forget_speaker \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingSpeakerAliases.forgetSpeaker("MEETING_SPEAKER_ALIASE_ID")

era meeting_speaker_aliases forget_speaker MEETING_SPEAKER_ALIASE_ID

{
  "name": "era__meetings__forget_speaker",
  "arguments": {
    "id": "MEETING_SPEAKER_ALIASE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 alias_not_found · 429 çok sık istek

meetings.link_invite

Takvim davetini kaydet — Google ya da Outlook’un açtığı etkinlik (ve görüntülü bağlantısı) ya da neden açılamadığı. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.link_invite

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.invite_sent

Neye yazar: meeting (update) — invite → sent / failed, with the event id

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_invite · 429 çok sık istek

meetings.link_task

Aksiyon maddesini görevine bağla — Kabul edilen maddenin dönüştüğü görevi kaydeder. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.link_task

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting_action_item (update) — Writes the task id

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 item_not_found · 429 çok sık istek

meetings.mark_follow_up_sent

Takip e-postasının gönderimini kaydet — Göndericiye verildi ya da reddedildi. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.mark_follow_up_sent

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.follow_up_sent

Neye yazar: meeting (update) — approved → sent / failed

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, no_follow_up · 429 çok sık istek

meetings.record_capture

Kaydın durumunu not et — Katılıyor, bekleme odası, kaydediyor, bitti ya da başarısız — sağlayıcıdan ya da Era Desktop’tan. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.record_capture

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.started, meetings.capture_failed

Neye yazar: meeting (update) — Moves the capture state; a failure releases the reservation

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, invalid_state · 429 çok sık istek

meetings.record_on_desktop

Toplantıyı bilgisayarımda kaydet — Era Desktop toplantının sesini ve mikrofonunu kendi bilgisayarında kaydeder — kimse bot görmez. Herkese söylediğini onaylarsın.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.record_on_desktop

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — capture → requested on the device, consent noted

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/record_on_desktop \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"deviceId":"DEVICE_ID"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.recordOnDesktop("MEETING_ID", {
  deviceId: "DEVICE_ID"
})

era meetings record_on_desktop MEETING_ID \
  --device-id "DEVICE_ID"

{
  "name": "era__meetings__record_on_desktop",
  "arguments": {
    "id": "MEETING_ID",
    "deviceId": "DEVICE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, not_upcoming, already_capturing, consent_required · 429 çok sık istek

meetings.rename_speaker

Bir konuşmacının kim olduğunu söyle — Dökümdeki bir sese ad verir (ekip arkadaşı, müşteri, herhangi biri). Toplantı uygulamasının verdiği ad sonraki toplantılar için hatırlanır.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.rename_speaker

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — The speaker and every turn of it get the name; meeting_speaker_alias (insert) — The platform’s name for them is remembered

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/rename_speaker \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"speakerKey":"Speaker","name":"Who it is"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.renameSpeaker("MEETING_ID", {
  speakerKey: "Speaker",
  name: "Who it is"
})

era meetings rename_speaker MEETING_ID \
  --speaker-key "Speaker" \
  --name "Who it is"

{
  "name": "era__meetings__rename_speaker",
  "arguments": {
    "id": "MEETING_ID",
    "speakerKey": "Speaker",
    "name": "Who it is"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, empty_name, invalid_recipient, speaker_not_found, not_member · 429 çok sık istek

meetings.save_brief

Toplantı brifini kaydet — Kim geliyor, neyi önemsiyorlar, ne söz verdik, dikkat, fırsat — görüşmeden önce. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.save_brief

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.brief_ready

Neye yazar: meeting (update) — Writes the brief

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, invalid_payload · 429 çok sık istek

meetings.schedule

Toplantı ekle — Era’nın katılacağı ya da hazırlanacağı bir toplantı — Zoom, Meet ya da Teams bağlantısını yapıştır; yüz yüze için boş bırak.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.schedule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.scheduled

Neye yazar: meeting (insert) — Writes the meeting

curl -X POST https://app.getera.io/api/v1/meetings/actions/schedule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.scheduled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.schedule({
  title: "Name"
})

era meetings schedule \
  --title "Name"

{
  "name": "era__meetings__schedule",
  "arguments": {
    "title": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_title, bad_join_url, bad_time, not_member, invalid_payload · 429 çok sık istek

meetings.send_bot

Era’nın not alıcısını toplantıya gönder — Bir bot Zoom, Meet, Teams ya da Webex görüşmesine katılır, kayıt bildirimini sohbete yazar ve kaydeder. Dakikalar önce kontrol edilip ayrılır.

Gereken izin meetings:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/meetings.send_bot

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — capture → requested

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/send_bot \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.sendBot("MEETING_ID")

era meetings send_bot MEETING_ID

{
  "name": "era__meetings__send_bot",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, not_upcoming, already_capturing, no_join_link, unsupported_platform, no_bot_key, bot_minutes_used_up · 429 çok sık istek

meetings.send_invite

Takvim davetini gönder — Toplantıyı Google ya da Outlook takvimine yazar ve herkesi davet eder (bağlantısı yoksa Meet ya da Teams bağlantısı açılır).

Gereken izin meetings:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır)

• Asıl adres: POST /api/v1/actions/meetings.send_invite

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — invite → pending (the calendar write follows)

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/send_invite \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.sendInvite("MEETING_ID")

era meetings send_invite MEETING_ID

{
  "name": "era__meetings__send_invite",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, not_upcoming, invite_sent, no_attendees, no_calendar · 429 çok sık istek

meetings.set_sharing

Toplantıyı kimin göreceğini seç — Sahibi her zaman; ayrıca müşterisini ya da fırsatını açabilenler (varsayılan), yalnızca sen ya da çalışma alanındaki herkes.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.set_sharing

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting (update) — Writes who sees it

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/set_sharing \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"sharing":"record"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.setSharing("MEETING_ID", {
  sharing: "record"
})

era meetings set_sharing MEETING_ID \
  --sharing "record"

{
  "name": "era__meetings__set_sharing",
  "arguments": {
    "id": "MEETING_ID",
    "sharing": "record"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, invalid_payload, not_your_meeting · 429 çok sık istek

meetings.skip

Toplantıyı kaydetme — Era bu toplantıya girmez: bot yok, kayıt yok. Brif kalır.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.skip

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.skipped

Neye yazar: meeting (update) — upcoming → skipped

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/skip \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.skipped"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.skip("MEETING_ID")

era meetings skip MEETING_ID

{
  "name": "era__meetings__skip",
  "arguments": {
    "id": "MEETING_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, not_upcoming · 429 çok sık istek

meetings.sync_calendar

Takvimin toplantılarını oku — Google ya da Outlook’taki önümüzdeki günlerin etkinlikleri, takvimin katılım kuralıyla toplantı olur. Yalnızca sistem.

Gereken izin meetings:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.sync_calendar

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.scheduled

Neye yazar: meeting (insert) — New events become meetings; meeting (update) — Moved or cancelled events follow; meeting_calendar (update) — Last read time / error

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 calendar_not_found, invalid_payload · 429 çok sık istek

meetings.update

Toplantıyı değiştir — Ad, saat, bağlantı, Era’nın nasıl kaydedeceği ve hangi müşteri, fırsat, konuşma ve bilgi tabanına ait olduğu.

Gereken izin meetings:write · veriyi değiştirir

• REST kısayolu: PATCH /api/v1/meetings/{id}
• Asıl adres: POST /api/v1/actions/meetings.update

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: meetings.updated

Neye yazar: meeting (update) — Rewrites the meeting’s details and links

curl -X POST https://app.getera.io/api/v1/meetings/MEETING_ID/actions/update \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "meetings.updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetings.update("MEETING_ID", {
  title: "Name"
})

era meetings update MEETING_ID \
  --title "Name"

{
  "name": "era__meetings__update",
  "arguments": {
    "id": "MEETING_ID",
    "title": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 meeting_not_found, empty_title, bad_join_url, bad_time, not_member, not_upcoming, invalid_payload · 429 çok sık istek

meetings.update_action_item

Aksiyon maddesini değiştir — Göreve dönüşmeden önce: metin, kim yapacak, ne zamana.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.update_action_item

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting_action_item (update) — Rewrites the item

curl -X POST https://app.getera.io/api/v1/meeting_action_items/MEETING_ACTION_ITEM_ID/actions/update_action_item \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"text":"What"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingActionItems.updateActionItem("MEETING_ACTION_ITEM_ID", {
  text: "What"
})

era meeting_action_items update_action_item MEETING_ACTION_ITEM_ID \
  --text "What"

{
  "name": "era__meetings__update_action_item",
  "arguments": {
    "id": "MEETING_ACTION_ITEM_ID",
    "text": "What"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde meetings:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 item_not_found, item_closed, empty_text, not_member · 429 çok sık istek

meetings.update_calendar

Toplantı takvimini değiştir — Era’nın kimlere katılacağı, nasıl kaydedeceği, notların nereye gideceği ya da takvimi duraklat.

Gereken izin meetings:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/meetings.update_calendar

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: meeting_calendar (update) — Rewrites the rule

curl -X POST https://app.getera.io/api/v1/meeting_calendars/MEETING_CALENDAR_ID/actions/update_calendar \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"joinRule":"all"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.meetingCalendars.updateCalendar("MEETING_CALENDAR_ID", {
  joinRule: "all"
})