Yapay zekâ API

Asistanınız Era ve kaydettiğiniz yapay zekâ ajanları — tüm modüllerle çalışırlar.

Modül kodu ai · 86 işlem · 29 veri modeli · 76 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ı: ai (hepsi), ai:read (yalnız okuma) ya da ai:<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

ai.archive_brain

Beyni arşivle — Beyni kullanmayı bırakır; bildikleri geçmişinde kalır. Şirket beyni kalır.

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

• Asıl adres: POST /api/v1/actions/ai.archive_brain

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.brain_archived

Neye yazar: brain (update) — Archives the brain; brain_binding (delete) — Disconnects it from every Era and workflow

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.brains.archiveBrain({
  id: "ID_ID"
})

era brains archive_brain \
  --id "ID_ID"

{
  "name": "era__ai__archive_brain",
  "arguments": {
    "id": "ID_ID"
  }
}

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

ai.archive_knowledge_base

Bilgi alanını arşivle — Alanı doldurmayı ve okumayı bırakır; içindekiler geçmişte kalır.

Gereken izin ai:manage · 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/ai.archive_knowledge_base

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.knowledge_base_archived

Neye yazar: knowledge_base (update) — Archives the space; brain_binding (update) — Takes it out of every connection that named it

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.knowledgeBases.archiveKnowledgeBase({
  id: "ID_ID"
})

era knowledge_bases archive_knowledge_base \
  --id "ID_ID"

{
  "name": "era__ai__archive_knowledge_base",
  "arguments": {
    "id": "ID_ID"
  }
}

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

ai.assign_task

Görevi devret — Görevi bir notla bir kişiye veya ajana verir. Ajana vermek onu uyandırır; ajan aynı yolla geri verir.

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

• Asıl adres: POST /api/v1/actions/ai.assign_task

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.task_assigned, ai.agent_requested

Neye yazar: ai_task (update) — Moves the task and appends the handoff

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

{
  "ok": true,
  "result": "…",
  "events": [
    "ai.task_assigned",
    "ai.agent_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiTasks.assignTask("AI_TASK_ID", {
  assigneeUserId: "APP_USER_ID"
})

era ai_tasks assign_task AI_TASK_ID \
  --assignee-user-id "APP_USER_ID"

{
  "name": "era__ai__assign_task",
  "arguments": {
    "id": "AI_TASK_ID",
    "assigneeUserId": "APP_USER_ID"
  }
}

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

ai.bind_brain

Beyin bağla — Bir Era, iş akışı ya da sesli asistanın hangi beyinden ve alanlardan bileceğini ve ona öğretip öğretmeyeceğini seçer.

Gereken izin ai:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/ai.bind_brain

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.brain_bound

Neye yazar: brain_binding (upsert) — Connects the brain (or changes its spaces and access)

curl -X POST https://app.getera.io/api/v1/brain_bindings/actions/bind_brain \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"subjectType":"For","subjectId":"Which one","brainId":"BRAIN_ID"}'

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.brainBindings.bindBrain({
  subjectType: "For",
  subjectId: "Which one",
  brainId: "BRAIN_ID"
})

era brain_bindings bind_brain \
  --subject-type "For" \
  --subject-id "Which one" \
  --brain-id "BRAIN_ID"

{
  "name": "era__ai__bind_brain",
  "arguments": {
    "subjectType": "For",
    "subjectId": "Which one",
    "brainId": "BRAIN_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde ai:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 bad_subject, brain_not_found, not_your_brain, archived, personal_brain, agent_not_found, subject_not_found, knowledge_base_not_in_brain · 429 çok sık istek

ai.check_budget

Yapay zekâ bütçesini kontrol et — Bir çalıştırmanın başlayıp başlayamayacağını, sınır başına harcamayla yanıtlar. Era her adımdan önce çağırır.

Gereken izin ai:read · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/ai.check_budget

Girdi

Yayımladığı olaylar: ai.budget_alert

Neye yazar: ai_budget (update) — Stamps the alert key so an alert fires once

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiBudgets.checkBudget({
  agentId: "AI_AGENT_ID"
})

era ai_budgets check_budget \
  --agent-id "AI_AGENT_ID"

{
  "name": "era__ai__check_budget",
  "arguments": {
    "agentId": "AI_AGENT_ID"
  }
}

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

ai.clear_budget

Yapay zekâ bütçesini kaldır — Sınırı kaldırır. O kapsam için harcama sınırsız olur.

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

• Asıl adres: POST /api/v1/actions/ai.clear_budget

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.budget_updated

Neye yazar: ai_budget (delete) — Removes the cap

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiBudgets.clearBudget("AI_BUDGET_ID")

era ai_budgets clear_budget AI_BUDGET_ID

{
  "name": "era__ai__clear_budget",
  "arguments": {
    "id": "AI_BUDGET_ID"
  }
}

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

ai.close_code_session

Kod oturumunu kapat — Canlı kod oturumunu bitirir; bir sonraki istek yeni bir oturum açar.

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

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.code_session_closed

Neye yazar: code_session (update) — Marks it closed

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("ai.close_code_session", {
  id: "CODE_SESSION_ID"
})

era ai close_code_session \
  --id "CODE_SESSION_ID"

{
  "name": "era__ai__close_code_session",
  "arguments": {
    "id": "CODE_SESSION_ID"
  }
}

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

ai.complete_task

Görevi tamamla — Tamamlandı işaretler. Tekrarlayan görev bir sonrakini yazar.

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

• Asıl adres: POST /api/v1/actions/ai.complete_task

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.task_completed

Neye yazar: ai_task (update) — Marks it done; ai_task (insert) — Writes the next occurrence of a repeating task

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiTasks.completeTask("AI_TASK_ID")

era ai_tasks complete_task AI_TASK_ID

{
  "name": "era__ai__complete_task",
  "arguments": {
    "id": "AI_TASK_ID"
  }
}

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

ai.connect_subscription

Kendi yapay zekâ aboneliğini bağla — Kendi yapay zekâ aboneliğinin girişini (Claude, ChatGPT, Antigravity, Grok, Copilot, Cursor …) kaydeder; böylece sohbetin, Era’ların ve iş akışların önce senin planını kullanır. Bulut girişi kasada şifrelenip saklanır; bilgisayar girişi o bilgisayarda kalır.

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

• Asıl adres: POST /api/v1/actions/ai.connect_subscription

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.subscription_connected

Neye yazar: ai_provider (upsert) — Writes the person’s own connection row (never a token)

curl -X POST https://app.getera.io/api/v1/ai_providers/actions/connect_subscription \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"provider":"claude_code","execution":"remote"}'

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiProviders.connectSubscription({
  provider: "claude_code",
  execution: "remote"
})

era ai_providers connect_subscription \
  --provider "claude_code" \
  --execution "remote"

{
  "name": "era__ai__connect_subscription",
  "arguments": {
    "provider": "claude_code",
    "execution": "remote"
  }
}

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

ai.create_agent

Ajan oluştur — Bir talimat ve araç bütçesi kaydeder. Kapalı olarak gelir.

Gereken izin ai:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/ai.create_agent

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.agent_created

Neye yazar: ai_agent (insert) — Writes the agent

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiAgents.createAgent({
  name: "Name"
})

era ai_agents create_agent \
  --name "Name"

{
  "name": "era__ai__create_agent",
  "arguments": {
    "name": "Name"
  }
}

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

ai.create_brain

Beyin oluştur — Kendi bilgi alanları olan yeni bir beyin — şirket, bir kişi, bir Era ya da bir sesli asistan için.

Gereken izin ai:manage · veriyi değiştirir

• REST kısayolu: POST /api/v1/brains
• Asıl adres: POST /api/v1/actions/ai.create_brain

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.brain_created

Neye yazar: brain (insert) — Creates the brain; knowledge_base (insert) — Creates its first knowledge spaces; brain_binding (insert) — A team brain is given to its team

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.brains.create({
  name: "Name"
})

era brains create \
  --name "Name"

{
  "name": "era__ai__create_brain",
  "arguments": {
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde ai:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_name, name_taken, not_your_brain, missing_scope_ref, agent_not_found, team_not_found, invalid_learn_from · 429 çok sık istek

ai.create_knowledge_base

Bilgi alanı ekle — Bir beynin içinde yeni bir alan — Satış, Ürün belgeleri, Müşteri başarısı, Kişisel notlar.

Gereken izin ai:manage · veriyi değiştirir

• REST kısayolu: POST /api/v1/knowledge_bases
• Asıl adres: POST /api/v1/actions/ai.create_knowledge_base

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.knowledge_base_created

Neye yazar: knowledge_base (insert) — Creates the space

curl -X POST https://app.getera.io/api/v1/knowledge_bases/actions/create_knowledge_base \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"brainId":"BRAIN_ID","name":"Name"}'

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.knowledgeBases.create({
  brainId: "BRAIN_ID",
  name: "Name"
})

era knowledge_bases create \
  --brain-id "BRAIN_ID" \
  --name "Name"

{
  "name": "era__ai__create_knowledge_base",
  "arguments": {
    "brainId": "BRAIN_ID",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde ai:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 brain_not_found, not_your_brain, archived, empty_name, name_taken · 429 çok sık istek

ai.create_task

Görev oluştur — Bir kişi veya ajan için son tarih, öncelik, liste ve tekrar kuralıyla bir yapılacak. Ajana verilirse ajanı uyandırır.

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

• Asıl adres: POST /api/v1/actions/ai.create_task

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.task_created, ai.agent_requested

Neye yazar: ai_task (insert) — Writes the task

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

{
  "ok": true,
  "result": "…",
  "events": [
    "ai.task_created",
    "ai.agent_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiTasks.createTask({
  title: "Title"
})

era ai_tasks create_task \
  --title "Title"

{
  "name": "era__ai__create_task",
  "arguments": {
    "title": "Title"
  }
}

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

ai.decide_computer_step

Bilgisayar adımını onayla ya da reddet — Bilgisayarın beklediği adıma cevap verir. “Benzer adımlar” aynı sitede aynı tür adımı 15 dakika onaylar.

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

Girdi

Ön koşullar

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

Neye yazar: computer_session (update) — Stores the decision for the worker; computer_session_event (insert) — Records who decided

curl -X POST https://app.getera.io/api/v1/actions/ai.decide_computer_step \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"id":"COMPUTER_SESSION_ID","approvalId":"APPROVAL_ID","decision":"approve"}'

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.actions.run("ai.decide_computer_step", {
  id: "COMPUTER_SESSION_ID",
  approvalId: "APPROVAL_ID",
  decision: "approve"
})

era ai decide_computer_step \
  --id "COMPUTER_SESSION_ID" \
  --approval-id "APPROVAL_ID" \
  --decision "approve"

{
  "name": "era__ai__decide_computer_step",
  "arguments": {
    "id": "COMPUTER_SESSION_ID",
    "approvalId": "APPROVAL_ID",
    "decision": "approve"
  }
}

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

ai.decide_learning

Era’nın sorusunu cevapla — Hatırla (istersen düzenleyerek) ya da Hatırlama. Onaylanan bilgi kaynağıyla birlikte saklanır; beceri yeni sürüm olarak devreye girer.

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

• Asıl adres: POST /api/v1/actions/ai.decide_learning

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.learning_decided

Neye yazar: era_learning (update) — Records the answer; an approval is written to Era’s memory or skills by the table

curl -X POST https://app.getera.io/api/v1/era_learnings/actions/decide_learning \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"id":"ID_ID","decision":"approve"}'

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.eraLearnings.decideLearning({
  id: "ID_ID",
  decision: "approve"
})

era era_learnings decide_learning \
  --id "ID_ID" \
  --decision "approve"

{
  "name": "era__ai__decide_learning",
  "arguments": {
    "id": "ID_ID",
    "decision": "approve"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde ai:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 learning_not_found, already_decided, not_yours, empty_statement, bad_memory_kind, module_required, already_expired, skill_incomplete · 429 çok sık istek

ai.delete_agent

Ajanı sil — Ajanı ve çalıştırma geçmişini kaldırır. Genellikle istediğiniz şey kapatmaktır.

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

• Asıl adres: POST /api/v1/actions/ai.delete_agent

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.agent_deleted

Neye yazar: ai_agent (delete) — Removes the agent; ai_run (delete) — Its run history goes with it, by cascade

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiAgents.deleteAgent("AI_AGENT_ID")

era ai_agents delete_agent AI_AGENT_ID

{
  "name": "era__ai__delete_agent",
  "arguments": {
    "id": "AI_AGENT_ID"
  }
}

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

ai.delete_computer

Bulut bilgisayarımı sil — Bulut bilgisayarını ve diskini siler. Geri alınamaz.

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

• Asıl adres: POST /api/v1/actions/ai.delete_computer

Girdi

Bu işlem girdi almaz.

Ön koşullar

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

Yayımladığı olaylar: ai.computer_machine_requested

Neye yazar: computer_machine (update) — Asks the worker to delete it; computer_session (update) — Stops tasks running on it

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.computerMachines.deleteComputer()

era computer_machines delete_computer

{
  "name": "era__ai__delete_computer",
  "arguments": {}
}

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

ai.delete_conversation

Sohbeti sil — Konuşmayı gizler. Kayıtlarda yaptığı değişiklikler geri alınmaz.

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

• Asıl adres: POST /api/v1/actions/ai.delete_conversation

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.conversation_deleted

Neye yazar: ai_conversation (update) — Writes the tombstone, through sql/056’s door

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiConversations.deleteConversation("AI_CONVERSATION_ID")

era ai_conversations delete_conversation AI_CONVERSATION_ID

{
  "name": "era__ai__delete_conversation",
  "arguments": {
    "id": "AI_CONVERSATION_ID"
  }
}

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

ai.delete_task

Görevi sil — Her listeden kaldırır.

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

• Asıl adres: POST /api/v1/actions/ai.delete_task

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.task_deleted

Neye yazar: ai_task (update) — Writes the tombstone through sql/082’s door

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiTasks.deleteTask("AI_TASK_ID")

era ai_tasks delete_task AI_TASK_ID

{
  "name": "era__ai__delete_task",
  "arguments": {
    "id": "AI_TASK_ID"
  }
}

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

ai.disconnect_subscription

Aboneliğimin bağlantısını kes — Era bu planı kullanmayı bırakır. Giriş, bu işlemden önce sağlayıcı tarafında iptal edilmiştir.

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

• Asıl adres: POST /api/v1/actions/ai.disconnect_subscription

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.subscription_disconnected

Neye yazar: ai_provider (delete) — Removes the connection row

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiProviders.disconnectSubscription("AI_PROVIDER_ID")

era ai_providers disconnect_subscription AI_PROVIDER_ID

{
  "name": "era__ai__disconnect_subscription",
  "arguments": {
    "id": "AI_PROVIDER_ID"
  }
}

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

ai.erase_brain_fact

Era’nın öğrendiğini kalıcı olarak sil — Kalıcı olarak sil: bilgi, önceki ve sonraki bütün halleri, bağlantıları, onunla ilgili kararlar ve içgörülerdeki izi silinir. Unut ise sadece kullanmayı bırakır.

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

• Asıl adres: POST /api/v1/actions/ai.erase_brain_fact

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.brain_fact_erased

Neye yazar: brain_erasure (insert) — Records the erasure (without the erased words); brain_fact_review (delete) — Reviews that quote it go with it; decide_decision (delete) — Decisions taken about it go with it; brain_insight (update) — Insights drawn from it lose that source; one with no source left is deleted

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.brainErasures.eraseBrainFact({
  memoryId: "MEMORY_ID"
})

era brain_erasures erase_brain_fact \
  --memory-id "MEMORY_ID"

{
  "name": "era__ai__erase_brain_fact",
  "arguments": {
    "memoryId": "MEMORY_ID"
  }
}

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

ai.erase_brain_person

Era’nın bir kişi hakkında öğrendiği her şeyi sil — İlgili kişi başvurusu (KVKK m.7 / GDPR m.17): kişi hakkındaki her bilgi, bütün halleriyle ve kişi Era’nın hafızasından silinir; kayıt bunun yapıldığını saklar.

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

• Asıl adres: POST /api/v1/actions/ai.erase_brain_person

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.brain_person_erased

Neye yazar: brain_erasure (insert) — Records the request and what was erased; brain_fact_review (delete) — Reviews that quote the facts go with them; decide_decision (delete) — Decisions taken about the facts go with them; brain_insight (update) — Insights drawn from the facts lose them; one with no source left is deleted

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.brainErasures.eraseBrainPerson({
  entityId: "ENTITY_ID"
})

era brain_erasures erase_brain_person \
  --entity-id "ENTITY_ID"

{
  "name": "era__ai__erase_brain_person",
  "arguments": {
    "entityId": "ENTITY_ID"
  }
}

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

ai.escalate_approval

Bekleyen onayı yükselt — Onaylayanlara bir talebin çok uzun beklediğini bildirir. Otomatik: onay listesi yükseltir.

Gereken izin ai:read · yalnız okur

Girdi

Yayımladığı olaylar: ai.approval_escalated

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

ai.evaluate_skill

Beceri değerlendirmesini kaydet — Bir sürümün kaç test durumunu geçtiğini saklar.

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

• Asıl adres: POST /api/v1/actions/ai.evaluate_skill

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.skill_evaluated

Neye yazar: ai_skill_version (update) — Writes the score

curl -X POST https://app.getera.io/api/v1/ai_skill_versions/AI_SKILL_VERSION_ID/actions/evaluate_skill \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"passed":1,"total":1}'

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.aiSkillVersions.evaluateSkill("AI_SKILL_VERSION_ID", {
  passed: 1,
  total: 1
})

era ai_skill_versions evaluate_skill AI_SKILL_VERSION_ID \
  --passed 1 \
  --total 1

{
  "name": "era__ai__evaluate_skill",
  "arguments": {
    "versionId": "AI_SKILL_VERSION_ID",
    "passed": 1,
    "total": 1
  }
}

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

ai.forget_computer_folder

Klasörü unut — Era bu klasörü artık adıyla tanımaz.

Gereken izin ai:handle · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/ai.forget_computer_folder

Girdi

Ön koşullar

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

Neye yazar: computer_folder (delete) — Removes the name

curl -X POST https://app.getera.io/api/v1/computer_folders/COMPUTER_FOLDER_ID/actions/forget_computer_folder \
  -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.computerFolders.forgetComputerFolder("COMPUTER_FOLDER_ID")

era computer_folders forget_computer_folder COMPUTER_FOLDER_ID

{
  "name": "era__ai__forget_computer_folder",
  "arguments": {
    "id": "COMPUTER_FOLDER_ID"
  }
}

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

ai.forget_learning

Unut (“bunu unut”) — Bir bilgiyi unutur (geçmişte kalır) ya da bir beceriyi kullanmayı bırakır (silinmez, durdurulur).

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

• Asıl adres: POST /api/v1/actions/ai.forget_learning

Girdi

Ön koşullar

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

Yayımladığı olaylar: ai.learning_forgotten

Neye yazar: brain_fact_review (insert) — Records Unut; the table applies it; ai_skill_release (update) — Pauses the skill

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

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

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.brainFactReviews.forgetLearning({
  memoryId: "MEMORY_ID"
})

era brain_fact_reviews forget_learning \
  --memory-id "MEMORY_ID"

{
  "name": "era__ai__forget_learning",
  "arguments": {
    "memoryId": "MEMORY_ID"
  }
}

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

ai.link_engine_agent

Ajanı bir asistana bağla — Bir asistanı (kişilik, beceriler, entegrasyonlar) bu ajanın yazım tarafı yapar. Boş, bağı kaldırır.

Gereken izin ai:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/ai.link_engine_agent

Girdi

Ön koşullar

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