# Solk Docs

> Solk CRM developer documentation: REST API, OAuth 2.1, MCP connector (Claude), webhooks, inbound hooks, SCIM. Every installation runs on its own host https://<company>.solk.app. Turkish pages at the root, English under /en.

## Guides — English

- [Build with Solk](https://docs.solk.app/en/index.md): Everything you need to connect Solk CRM to your own software, automation tools, and AI assistants.
- [Quickstart](https://docs.solk.app/en/quickstart.md): Create an API key, authenticate, create your first task, and subscribe to an event.
- [Installations and addresses](https://docs.solk.app/en/installs.md): Each company's Solk installation runs at its own address. The API, MCP, hook, and discovery URLs are all derived from it.
- [Users and roles](https://docs.solk.app/en/users-and-roles.md): Admin and sales roles, module permissions, record visibility, and how API tokens relate to them.
- [Companies](https://docs.solk.app/en/objects/companies.md): Customer and prospect companies — the core object every CRM record links to.
- [People](https://docs.solk.app/en/objects/people.md): Contacts at companies — activities, emails, and quotes link to people.
- [Opportunities](https://docs.solk.app/en/objects/opportunities.md): Sales projects — with stage, value, health, BANT, and checklist steps.
- [Actions and tasks](https://docs.solk.app/en/objects/actions.md): Tasks, follow-up actions from visits and trials, and dated project steps in a single to-do list.
- [Fair leads](https://docs.solk.app/en/objects/leads.md): Potential customers collected at a trade fair booth — quick capture, owner, next action, and conversion to a company.
- [Email threads](https://docs.solk.app/en/objects/emails.md): Threads synced from users' connected mailboxes, and how they link to records.
- [Record IDs](https://docs.solk.app/en/concepts/record-ids.md): The difference between the numeric ID (id) and the 15-character permanent record ID (rid), and when to use each.
- [Stages and gates](https://docs.solk.app/en/concepts/pipeline.md): Sales stages are defined per installation; when stage gates are on, an opportunity advances only once it meets their conditions.
- [Units and currency](https://docs.solk.app/en/concepts/units-currency.md): Quantities are stored in the product's unit and prices in the record's currency; totals are converted to the installation's base currency.
- [Archiving and deletion](https://docs.solk.app/en/concepts/archiving.md): In Solk, records are rarely deleted; they're closed, deactivated, or marked as former. Historical reports stay intact.
- [Apps](https://docs.solk.app/en/guides/apps.md): The 40+ prebuilt connections in Settings → Apps — what they do, how to set them up, and which data goes where.
- [Webhooks](https://docs.solk.app/en/guides/webhooks.md): Send signed JSON to a URL of your choice when something happens in the CRM (an opportunity is won, a new company is added, a form is submitted…). Zapier, Make, 
- [Inbound hooks](https://docs.solk.app/en/guides/inbound.md): Send data to the CRM through a secret URL from forms, phone systems, payment systems, data warehouses, and booking tools.
- [Storage accounts](https://docs.solk.app/en/guides/storage.md): Save record files to Google Drive, OneDrive, Dropbox, or Box; link cloud files to records; and send the daily backup to the cloud.

## REST API — English

- [REST API](https://docs.solk.app/en/rest-api/overview.md): The Solk CRM JSON API — the same endpoints the mobile app uses, with the same permission rules and the same business rules.
- [Authentication](https://docs.solk.app/en/rest-api/authentication.md): API keys, OAuth access tokens, and mobile session tokens — when to use each and how to revoke them.
- [OAuth app](https://docs.solk.app/en/rest-api/oauth.md): Build an app that users authorize with their own accounts — client registration, authorization with PKCE, tokens, and refresh.
- [Rate limits](https://docs.solk.app/en/rest-api/rate-limits.md): The per-minute request limit per token, the 429 response, and the Retry-After header.
- [Pagination and filtering](https://docs.solk.app/en/rest-api/pagination.md): Page, scope, filter, and sort parameters on list endpoints.
- [Errors](https://docs.solk.app/en/rest-api/errors.md): HTTP status codes, machine-readable error codes, and the extra fields that accompany errors.
- [SCIM 2.0](https://docs.solk.app/en/rest-api/scim.md): Automatically create, update, and deactivate users from Okta, Microsoft Entra ID, OneLogin, or JumpCloud.
- [Identify](https://docs.solk.app/en/rest-api/auth/me.md): Returns the user behind the token, their enabled modules, the installation's constants (stage keys and labels, task priorities, loss reasons…), the product list
- [Log in with username](https://docs.solk.app/en/rest-api/auth/login.md): The sign-in endpoint used by the mobile app: exchanges username + password (+ two-factor code) for a session token starting with xk_. The token lives API_TOKEN_
- [Log out](https://docs.solk.app/en/rest-api/auth/logout.md): Revokes the token used for the request. Meant for mobile session tokens (xk_); API keys are revoked on the Developers page.
- [Today](https://docs.solk.app/en/rest-api/workspace/today.md): The user's day: today's meetings and actions, overdue items, recently opened records (companies, opportunities, people, leads) and this week's visit / task targ
- [Sales dashboard](https://docs.solk.app/en/rest-api/workspace/dashboard.md): Opportunity count and value per stage (in base currency), SLA overruns, companies due for a visit, next steps, upcoming items and weekly targets.
- [Search](https://docs.solk.app/en/rest-api/workspace/search.md): Searches companies (name, city), people (name, phone, e-mail), opportunities and fair leads; up to 10–15 results per type. Passing a 15-character record ID (001
- [List notifications](https://docs.solk.app/en/rest-api/workspace/notifications.md): The user's latest 50 notifications and the unread count.
- [Mark notifications read](https://docs.solk.app/en/rest-api/workspace/notifications-read.md): Marks the given notifications (or all, when ids is omitted) as read.
- [Add to recently viewed](https://docs.solk.app/en/rest-api/workspace/recent.md): Adds a record to the user's recently viewed list (cards on Today).
- [List companies](https://docs.solk.app/en/rest-api/companies/list.md): Filters, sorts and pages active companies. counts gives customer / prospect totals and overdue visits for the filtered list.
- [Get a company](https://docs.solk.app/en/rest-api/companies/get.md): The full company card: people, opportunities, recent visits and trials, open actions, offers, orders, timeline, competitors, prices and e-mail threads (threads)
- [Create a company](https://docs.solk.app/en/rest-api/companies/create.md): Creates a company (status Prospect unless given, owned by the caller). An existing name returns 409 exists; similar names return 409 similar with a similar list
- [Update a company](https://docs.solk.app/en/rest-api/companies/update.md): Only the fields you send change; an empty string clears a text field. PUT and POST are accepted too. Requires edit rights on the company (owner, admin or a user
- [Postpone the visit](https://docs.solk.app/en/rest-api/companies/postpone.md): Moves the company's visit due date. Uses date when given, otherwise days from today (default 7).
- [Activity form options](https://docs.solk.app/en/rest-api/companies/lookup.md): What an activity (quick entry) form needs: the company's open projects, the default project, people, open actions and last stage label.
- [List people](https://docs.solk.app/en/rest-api/people/list.md): People of active companies (max 300, by name). Former employees are excluded by default.
- [Create a person](https://docs.solk.app/en/rest-api/people/create.md): Adds a person to a company. The company's first person, or one sent with is_main: true, becomes the main contact.
- [Update a person](https://docs.solk.app/en/rest-api/people/update.md): Only the fields you send change. is_former: true marks the person as left (not deleted); is_main: true makes them the main contact.
- [List opportunities](https://docs.solk.app/en/rest-api/deals/list.md): Filters, sorts and pages opportunities (sales projects). The response also carries open-stage counts, the open total in base currency and the number of SLA over
- [Get an opportunity](https://docs.solk.app/en/rest-api/deals/get.md): The full opportunity: stage, value, probability, health, checklist steps, BANT, stage-gate problems (gate_problems), visits, trials, offers, orders, tasks, stag
- [Create an opportunity](https://docs.solk.app/en/rest-api/deals/create.md): Opens a sales project for a company in the first open stage and sets up its stage steps. The annual value is quantity × unit price; value is used when those are
- [Update an opportunity](https://docs.solk.app/en/rest-api/deals/update.md): Frequently changed fields: quantity, unit price (recorded in offer history when it changes), payment terms, close date (logged), next step date, note, product, 
- [Change stage](https://docs.solk.app/en/rest-api/deals/stage.md): Moves the opportunity to another stage. Stage gates apply exactly like in the web app: an unmet rule returns 409 gate with gate_problems. Send reason for Lost /
- [Update BANT](https://docs.solk.app/en/rest-api/deals/bant.md): Sets the Budget, Authority, Need and Timing criteria; the matching checklist steps are updated too.
- [Add a step](https://docs.solk.app/en/rest-api/deals/steps-create.md): Adds a checklist step to the opportunity's current stage. Dated steps show up in Actions with kind step.
- [Toggle a step](https://docs.solk.app/en/rest-api/deals/steps-toggle.md): Marks a step done / open (flips it when done is omitted). BANT steps also update the opportunity's BANT flags.
- [Revive an opportunity](https://docs.solk.app/en/rest-api/deals/revive.md): Opens a new opportunity from a lost / cancelled one (product, quantity and line are copied and linked to the original).
- [Log an activity](https://docs.solk.app/en/rest-api/activities/log.md): Quick Entry: logs a phone call or face-to-face visit in one request. The company is matched by name (created as a prospect when missing; similar names return 40
- [List actions](https://docs.solk.app/en/rest-api/actions/list.md): Open work in one list: tasks, next actions of visits and trials, dated project steps. Use each row's kind + id with the complete / postpone endpoints.
- [Get an action](https://docs.solk.app/en/rest-api/actions/get.md): The action with its context: company, project, the chain before / after it (chain_before, chain_after), the company's other open work and e-mail threads.
- [Complete an action](https://docs.solk.app/en/rest-api/actions/complete.md): Marks the action done (or open again with done: false). done_on sets the completion day (default now).
- [Postpone an action](https://docs.solk.app/en/rest-api/actions/postpone.md): Moves the due date; the note is appended to the record with dates.
- [Close and open the next](https://docs.solk.app/en/rest-api/actions/close.md): Closes the action with its result and optionally opens the next task in the chain (same company and project). mode: keep leaves the action open and only adds th
- [Create a task](https://docs.solk.app/en/rest-api/actions/tasks-create.md): Creates a task, assigned to the caller unless assigned_to is given. Linking a company is optional (by id or name); no project is opened automatically — use opp_
- [Update a task](https://docs.solk.app/en/rest-api/actions/tasks-update.md): Only the fields you send change. status: Tamamlandı completes the task (done_on picks the day). PUT and POST are accepted too.
- [List calendar](https://docs.solk.app/en/rest-api/calendar/list.md): Meetings (events) and entries derived from actions (derived: due actions, visit dates) in a date range. Internal meetings are visible to their owner only. mode 
- [Create an event](https://docs.solk.app/en/rest-api/calendar/create.md): Adds a meeting to the calendar; it syncs to phone calendars when CalDAV is on.
- [Delete an event](https://docs.solk.app/en/rest-api/calendar/delete.md): Deletes an event added in the app (events from e-mail or CalDAV can't be deleted). POST is accepted too.
- [List fairs](https://docs.solk.app/en/rest-api/fairs/list.md): Trade fairs (active first) with lead counts.
- [List fair leads](https://docs.solk.app/en/rest-api/fairs/leads-list.md): Leads collected at a fair (max 300, newest first).
- [Create a lead](https://docs.solk.app/en/rest-api/fairs/leads-create.md): Records a lead at the fair stand; a next action opens a task for the owner.
- [Get a lead](https://docs.solk.app/en/rest-api/fairs/leads-get.md): The lead and the product list (for form options).
- [Update a lead](https://docs.solk.app/en/rest-api/fairs/leads-update.md): Changes the status; sending company rewrites all form fields (fields you omit are cleared).
- [List threads](https://docs.solk.app/en/rest-api/email/threads-list.md): E-mail threads either for one record (kind + id) or the inbox (filter, q). Content follows the user's permission to see it.
- [Get a thread](https://docs.solk.app/en/rest-api/email/threads-get.md): Messages (body: null, hidden: true when the user may not see them), linked records, companies and people, a reply draft (reply) and link suggestions.
- [Link a thread](https://docs.solk.app/en/rest-api/email/threads-action.md): opp changes the project (opp_id), link links a record (kind, obj_id), unlink removes a link, dismiss ignores a suggestion. Only the thread's owner, the company 
- [Compose options](https://docs.solk.app/en/rest-api/email/compose.md): For a new e-mail: whether the mailbox is connected, the company's people with e-mail and its open projects.
- [Send an e-mail](https://docs.solk.app/en/rest-api/email/send.md): Sends one e-mail (including replies) from the user's connected mailbox; it joins the thread and project under the web rules. Returns 400 send when no mailbox is
- [Ask a question](https://docs.solk.app/en/rest-api/ask/ask.md): A natural-language question about CRM data: with the AI module on, the model answers (mode: ai); otherwise a rule-based answer (mode: kural). blocks is a render
- [Question history](https://docs.solk.app/en/rest-api/ask/history.md): The user's last 12 questions and suggested questions.
- [Service provider config](https://docs.solk.app/en/rest-api/scim/service-provider-config.md): Supported SCIM features (PATCH yes; bulk, sort, ETag no).
- [Resource types](https://docs.solk.app/en/rest-api/scim/resource-types.md): Only the User resource.
- [Schemas](https://docs.solk.app/en/rest-api/scim/schemas.md): User and enterprise extension schemas.
- [List users](https://docs.solk.app/en/rest-api/scim/users-list.md): Users; only the userName eq "…" (or id eq) filter is supported. Paging via startIndex + count (max 200).
- [Create a user](https://docs.solk.app/en/rest-api/scim/users-create.md): Creates a user and sends a set-password invitation (role: sales). An existing e-mail returns 409 uniqueness.
- [Get a user](https://docs.solk.app/en/rest-api/scim/users-get.md): One user.
- [Replace a user](https://docs.solk.app/en/rest-api/scim/users-replace.md): Rewrites name, e-mail, department, phone and active.
- [Update a user](https://docs.solk.app/en/rest-api/scim/users-update.md): replace, add, remove operations; active: false deactivates the user (mobile sessions and API keys are revoked, records stay; the last active admin can't be deac
- [Deactivate a user](https://docs.solk.app/en/rest-api/scim/users-delete.md): Deactivates the user instead of deleting; records and history are kept. Returns 204.
- [Groups](https://docs.solk.app/en/rest-api/scim/groups.md): No group sync; returns an empty list (roles are set in the CRM).
- [Protected resource metadata](https://docs.solk.app/en/rest-api/oauth/protected-resource.md): RFC 9728 document: the MCP resource, its authorization server and scopes. Clients arrive here from resource_metadata in a 401.
- [Authorization server metadata](https://docs.solk.app/en/rest-api/oauth/authorization-server.md): RFC 8414 document: endpoint URLs, supported flows (authorization_code with PKCE S256 and refresh_token only), client auth methods.
- [Register a client](https://docs.solk.app/en/rest-api/oauth/register.md): Dynamic client registration (RFC 7591). redirect_uris must be https or loopback (http://localhost, 127.0.0.1, [::1]); max 10. token_endpoint_auth_method: none r
- [Authorize](https://docs.solk.app/en/rest-api/oauth/authorize.md): Sends the user to the consent screen (signing in first if needed). On approval it redirects to redirect_uri?code=…&state=…; on denial error=access_denied. PKCE 
- [Get a token](https://docs.solk.app/en/rest-api/oauth/token.md): Form body (application/x-www-form-urlencoded). authorization_code: code + code_verifier → a 1-hour access token (mcp_…) + a 60-day refresh token (mcpr_…). refre
- [Revoke a token](https://docs.solk.app/en/rest-api/oauth/revoke.md): Revokes an access or refresh token (RFC 7009); always returns 200. Users remove the whole grant in Settings → App connections.

## MCP — English

- [Solk MCP](https://docs.solk.app/en/mcp/overview.md): Connect AI assistants like Claude to your CRM — ask about companies and opportunities, and create tasks and activity logs right from the chat.
- [Connect](https://docs.solk.app/en/mcp/connect.md): Connect Claude, Claude Code, and other MCP clients to your Solk installation step by step, and see how OAuth discovery works.
- [Tools](https://docs.solk.app/en/mcp/tools.md): The Solk MCP server's read and write tools, their parameters, and example prompts.
- [Security](https://docs.solk.app/en/mcp/security.md): Authentication, permissions, approval, auditing, and revoking access for the MCP connection.
- [Example prompts](https://docs.solk.app/en/mcp/prompts.md): Real-world examples you can ask an assistant connected to Solk — lookups, daily planning, pipeline, and creating records.
- [Troubleshooting](https://docs.solk.app/en/mcp/troubleshooting.md): Causes of and fixes for connection, permission, missing tool, and rate limit problems.

## Changelog — English

- [Changelog](https://docs.solk.app/en/changelog.md): Changes to Solk CRM, the REST API, and MCP — newest first.

## Kılavuzlar — Türkçe

- [Solk ile geliştirin](https://docs.solk.app/index.md): Solk CRM'i kendi yazılımlarınıza, otomasyon araçlarınıza ve yapay zekâ asistanlarınıza bağlamak için ihtiyacınız olan her şey.
- [Hızlı başlangıç](https://docs.solk.app/quickstart.md): API anahtarı açın, kimliğinizi doğrulayın, ilk görevinizi oluşturun ve bir olaya abone olun.
- [Kurulumlar ve adresler](https://docs.solk.app/installs.md): Her firmanın Solk kurulumu ayrı bir adreste çalışır. API, MCP, kanca ve keşif adresleri bu adresten türer.
- [Kullanıcılar ve roller](https://docs.solk.app/users-and-roles.md): Yönetici ve satış rolleri, modül izinleri, kayıt görünürlüğü ve API belirteçlerinin bunlarla ilişkisi.
- [Firmalar](https://docs.solk.app/objects/companies.md): Müşteri ve aday firmalar — CRM'deki her kaydın bağlandığı ana nesne.
- [Kişiler](https://docs.solk.app/objects/people.md): Firmalardaki muhataplar — görüşmeler, e-postalar ve teklifler kişilere bağlanır.
- [Fırsatlar](https://docs.solk.app/objects/opportunities.md): Satış projeleri — aşama, değer, sağlık, BANT ve kontrol listesi adımlarıyla.
- [Aksiyonlar ve görevler](https://docs.solk.app/objects/actions.md): Görevler, ziyaret ve denemelerin sonraki aksiyonları ve tarihli proje adımları tek bir iş listesinde.
- [Fuar leadleri](https://docs.solk.app/objects/leads.md): Fuar standında toplanan potansiyel müşteriler — hızlı kayıt, sorumlu, sonraki aksiyon ve firmaya dönüştürme.
- [E-posta yazışmaları](https://docs.solk.app/objects/emails.md): Kullanıcıların bağlı posta kutularından eşitlenen yazışmalar ve kayıtlara bağlanışları.
- [Kayıt kimlikleri](https://docs.solk.app/concepts/record-ids.md): Sayısal kimlik (id) ile 15 karakterlik kalıcı kayıt kimliği (rid) arasındaki fark ve hangisinin nerede kullanılacağı.
- [Aşamalar ve kapılar](https://docs.solk.app/concepts/pipeline.md): Satış aşamaları kuruluma göre tanımlanır; aşama kapıları açıksa fırsat ancak koşulları sağladığında ilerler.
- [Birim ve döviz](https://docs.solk.app/concepts/units-currency.md): Miktarlar ürünün biriminde, fiyatlar kaydın dövizinde tutulur; toplamlar kurulumun ana dövizine çevrilir.
- [Pasifleştirme ve silme](https://docs.solk.app/concepts/archiving.md): Solk'ta kayıtlar çoğunlukla silinmez; kapatılır, pasife alınır ya da ayrıldı olarak işaretlenir. Geçmiş raporlar bozulmaz.
- [Uygulamalar](https://docs.solk.app/guides/apps.md): Ayarlar → Uygulamalar'daki 40'tan fazla hazır bağlantı — ne yaptıkları, nasıl kurulduklarını ve hangi verinin nereye gittiğini.
- [Web kancaları](https://docs.solk.app/guides/webhooks.md): CRM'de bir şey olduğunda (fırsat kazanıldı, yeni firma, form başvurusu…) seçtiğiniz adrese imzalı JSON gönderin. Zapier, Make, n8n ve Pipedream aynı mekanizmayı
- [Gelen kancalar](https://docs.solk.app/guides/inbound.md): Formlardan, telefon santralinden, ödeme sisteminden, veri ambarından ve randevu araçlarından CRM'e gizli bir adres üzerinden veri gönderin.
- [Depolama hesapları](https://docs.solk.app/guides/storage.md): Kayıt dosyalarını Google Drive, OneDrive, Dropbox ya da Box'a kaydedin; buluttaki dosyaları kayıtlara bağlayın; günlük yedeği buluta gönderin.

## REST API — Türkçe

- [REST API](https://docs.solk.app/rest-api/overview.md): Solk CRM'in JSON API'si — mobil uygulamanın kullandığı uçların aynısı, aynı yetki kuralları ve aynı iş kurallarıyla.
- [Kimlik doğrulama](https://docs.solk.app/rest-api/authentication.md): API anahtarı, OAuth erişim belirteci ve mobil oturum belirteci — hangisini ne zaman kullanmalı, nasıl iptal edilir.
- [OAuth uygulaması](https://docs.solk.app/rest-api/oauth.md): Kullanıcıların kendi hesaplarıyla izin verdiği bir uygulama yazın — istemci kaydı, PKCE'li yetkilendirme, belirteç ve yenileme.
- [Hız sınırları](https://docs.solk.app/rest-api/rate-limits.md): Belirteç başına dakikalık istek sınırı, 429 yanıtı ve Retry-After başlığı.
- [Sayfalama ve süzme](https://docs.solk.app/rest-api/pagination.md): Liste uçlarında sayfa, kapsam, süzgeç ve sıralama parametreleri.
- [Hatalar](https://docs.solk.app/rest-api/errors.md): HTTP durum kodları, makinece okunur hata kodları ve hatalara eşlik eden ek alanlar.
- [SCIM 2.0](https://docs.solk.app/rest-api/scim.md): Okta, Microsoft Entra ID, OneLogin ya da JumpCloud'dan kullanıcıları otomatik açın, güncelleyin ve kapatın.
- [Kimliği doğrula](https://docs.solk.app/rest-api/auth/me.md): Belirtecin hangi kullanıcıyla çalıştığını, kullanıcının açık modüllerini, kurulumun sabitlerini (aşama anahtarları ve adları, görev öncelikleri, kayıp nedenleri
- [Kullanıcı adıyla oturum aç](https://docs.solk.app/rest-api/auth/login.md): Mobil uygulamanın kullandığı oturum açma ucu: kullanıcı adı + şifre (+ iki adımlı doğrulama kodu) karşılığında xk_ ile başlayan bir oturum belirteci verir. Beli
- [Oturumu kapat](https://docs.solk.app/rest-api/auth/logout.md): İstekteki belirteci iptal eder. Mobil oturum belirteçleri (xk_) için kullanılır; API anahtarları Geliştiriciler sayfasından iptal edilir.
- [Bugün](https://docs.solk.app/rest-api/workspace/today.md): Kullanıcının günü: bugünün toplantıları ve aksiyonları, gecikenler, son açılan kayıtlar (firma, fırsat, kişi, lead) ve bu haftanın ziyaret / görev hedefleri. Mo
- [Satış panosu](https://docs.solk.app/rest-api/workspace/dashboard.md): Aşamalara göre fırsat sayısı ve değeri (ana dövizde), SLA aşımları, ziyareti gelen firmalar, sıradaki adımlar, yaklaşan işler ve haftalık hedefler.
- [Ara](https://docs.solk.app/rest-api/workspace/search.md): Firma (ad, şehir), kişi (ad, telefon, e-posta), fırsat ve fuar leadlerinde arar; her türden en çok 10–15 sonuç. 15 karakterlik bir kayıt kimliği (001…, 006…) ve
- [Bildirimleri listele](https://docs.solk.app/rest-api/workspace/notifications.md): Kullanıcının son 50 bildirimi ve okunmamış sayısı.
- [Bildirimleri okundu say](https://docs.solk.app/rest-api/workspace/notifications-read.md): Verilen bildirimleri (ya da ids yoksa tümünü) okundu yapar.
- [Son açılanlara ekle](https://docs.solk.app/rest-api/workspace/recent.md): Bir kaydı kullanıcının ‘son açılanlar’ listesine ekler (Bugün ekranındaki kartlar).
- [Firmaları listele](https://docs.solk.app/rest-api/companies/list.md): Aktif firmaları süzer, sıralar ve sayfalar. counts süzülmüş listedeki müşteri / aday sayılarını ve ziyareti geciken firmaları verir.
- [Firmayı getir](https://docs.solk.app/rest-api/companies/get.md): Firma kartının tamamı: kişiler, fırsatlar, son ziyaretler ve denemeler, açık aksiyonlar, teklifler, siparişler, zaman tüneli, rakipler, fiyatlar ve e-posta yazı
- [Firma oluştur](https://docs.solk.app/rest-api/companies/create.md): Yeni firma açar (durum verilmezse Prospect, sorumlu isteği yapan kullanıcı). Aynı adda firma varsa 409 exists, benzer adlar varsa 409 similar döner ve similar l
- [Firmayı güncelle](https://docs.solk.app/rest-api/companies/update.md): Yalnız gönderilen alanlar değişir; boş metin alanı temizler. PUT ve POST da kabul edilir. Firmayı düzenleme yetkisi gerekir (sorumlu, yönetici ya da görünürlük 
- [Ziyareti ertele](https://docs.solk.app/rest-api/companies/postpone.md): Firmanın ziyaret terminini ileri alır. date verilirse o gün, yoksa days gün sonrası (varsayılan 7).
- [Görüşme formu seçenekleri](https://docs.solk.app/rest-api/companies/lookup.md): Görüşme kaydı (hızlı giriş) formunu doldurmak için firmanın açık projeleri, varsayılan proje, kişileri, açık aksiyonları ve son aşama etiketi.
- [Kişileri listele](https://docs.solk.app/rest-api/people/list.md): Aktif firmaların kişileri (en çok 300, ada göre). Ayrılmış kişiler varsayılan olarak gelmez.
- [Kişi ekle](https://docs.solk.app/rest-api/people/create.md): Firmaya kişi ekler. Firmanın ilk kişisi ya da is_main: true ise ana kişi olur.
- [Kişiyi güncelle](https://docs.solk.app/rest-api/people/update.md): Yalnız gönderilen alanlar değişir. is_former: true kişiyi ‘ayrıldı’ yapar (silinmez); is_main: true ana kişi yapar.
- [Fırsatları listele](https://docs.solk.app/rest-api/deals/list.md): Fırsatları (satış projeleri) süzer, sıralar ve sayfalar. Yanıtta açık aşama sayıları, açık fırsatların ana dövizdeki toplamı ve SLA aşımı sayısı da gelir.
- [Fırsatı getir](https://docs.solk.app/rest-api/deals/get.md): Fırsatın tamamı: aşama, değer, olasılık, sağlık, kontrol listesi adımları, BANT, aşama kapısı sorunları (gate_problems), ziyaretler, denemeler, teklifler, sipar
- [Fırsat oluştur](https://docs.solk.app/rest-api/deals/create.md): Firma için yeni satış projesi açar; ilk açık aşamadan başlar ve aşama adımları kendiliğinden kurulur. Yıllık değer miktar × birim fiyattan hesaplanır; ikisi yok
- [Fırsatı güncelle](https://docs.solk.app/rest-api/deals/update.md): Sık değişen alanlar: miktar, birim fiyat (değişince teklif geçmişine yazılır), vade, kapanış tarihi (değişiklik günlüğe yazılır), sonraki adım tarihi, not, ürün
- [Aşamayı değiştir](https://docs.solk.app/rest-api/deals/stage.md): Fırsatı başka bir aşamaya taşır. Aşama kapıları web'deki gibi uygulanır: kural sağlanmıyorsa 409 gate ve gate_problems döner. Kaybedildi / İptal için reason (ka
- [BANT güncelle](https://docs.solk.app/rest-api/deals/bant.md): Bütçe, yetki, ihtiyaç ve zamanlama ölçütlerini işaretler; ilgili kontrol listesi adımları da güncellenir.
- [Adım ekle](https://docs.solk.app/rest-api/deals/steps-create.md): Fırsatın bulunduğu aşamaya kontrol listesi adımı ekler. Tarihli adımlar Aksiyonlar'da step türüyle görünür.
- [Adımı işaretle](https://docs.solk.app/rest-api/deals/steps-toggle.md): Adımı tamamlandı / açık yapar (done yoksa tersine çevirir). BANT adımları fırsatın BANT işaretlerini de değiştirir.
- [Fırsatı canlandır](https://docs.solk.app/rest-api/deals/revive.md): Kaybedilmiş / iptal edilmiş fırsattan yeni bir fırsat açar (ürün, miktar ve hat kopyalanır, eskisine bağlanır).
- [Görüşme kaydet](https://docs.solk.app/rest-api/activities/log.md): Hızlı Giriş: bir telefon görüşmesini ya da yüz yüze ziyareti tek istekte kaydeder. Firma adla bulunur (yoksa aday olarak açılır; benzer adlar varsa 409 similar)
- [Aksiyonları listele](https://docs.solk.app/rest-api/actions/list.md): Açık işler tek listede: görevler, ziyaret ve denemelerin sonraki aksiyonları, tarihli proje adımları. Her satırdaki kind + id ile tamamlama / erteleme uçları ça
- [Aksiyonu getir](https://docs.solk.app/rest-api/actions/get.md): Aksiyonun ayrıntısı ve bağlamı: firma, proje, önceki / sonraki zincir (chain_before, chain_after), firmanın diğer açık işleri ve e-posta yazışmaları.
- [Aksiyonu tamamla](https://docs.solk.app/rest-api/actions/complete.md): Aksiyonu tamamlandı (ya da done: false ile açık) yapar. done_on tamamlanma gününü belirler (varsayılan şimdi).
- [Aksiyonu ertele](https://docs.solk.app/rest-api/actions/postpone.md): Termini ileri alır; not, kaydın açıklamasına tarihli satır olarak eklenir.
- [Kapat ve sonrakini aç](https://docs.solk.app/rest-api/actions/close.md): Aksiyonu sonucuyla kapatır ve isteğe bağlı olarak zincirdeki sonraki görevi açar (aynı firma ve projeye bağlı). mode: keep aksiyonu açık bırakıp yalnız sonraki 
- [Görev oluştur](https://docs.solk.app/rest-api/actions/tasks-create.md): Görev açar; assigned_to yoksa isteği yapana atanır. Firma bağlamak isteğe bağlıdır (kimlik ya da adla); kendiliğinden proje açılmaz — opp_id ile mevcut projeye,
- [Görevi güncelle](https://docs.solk.app/rest-api/actions/tasks-update.md): Yalnız gönderilen alanlar değişir. status: Tamamlandı görevi kapatır (done_on ile gün seçilir). PUT ve POST da kabul edilir.
- [Takvimi listele](https://docs.solk.app/rest-api/calendar/list.md): Tarih aralığındaki toplantılar (events) ve aksiyonlardan türeyen girişler (derived: termini gelen aksiyonlar, ziyaret günleri). İç toplantılar yalnız sahibine g
- [Etkinlik oluştur](https://docs.solk.app/rest-api/calendar/create.md): Takvime toplantı ekler; CalDAV açıksa telefon takvimine de gider.
- [Etkinliği sil](https://docs.solk.app/rest-api/calendar/delete.md): Uygulamada eklenmiş bir etkinliği siler (e-postadan ya da CalDAV'dan gelenler silinmez). POST da kabul edilir.
- [Fuarları listele](https://docs.solk.app/rest-api/fairs/list.md): Fuarlar (aktif olanlar önce) ve lead sayıları.
- [Fuar leadlerini listele](https://docs.solk.app/rest-api/fairs/leads-list.md): Fuarda toplanan leadler (en çok 300, yeniden eskiye).
- [Lead ekle](https://docs.solk.app/rest-api/fairs/leads-create.md): Fuar standında lead kaydeder; sonraki aksiyon verilirse sorumluya görev açılır.
- [Leadi getir](https://docs.solk.app/rest-api/fairs/leads-get.md): Lead ve ürün listesi (form seçenekleri için).
- [Leadi güncelle](https://docs.solk.app/rest-api/fairs/leads-update.md): Durumu değiştirir; company gönderilirse tüm form alanları yeniden yazılır (gönderilmeyenler boşalır).
- [Yazışmaları listele](https://docs.solk.app/rest-api/email/threads-list.md): E-posta yazışmaları: bir kaydınkiler (kind + id) ya da gelen kutusu (filter, q). İçerik kullanıcının görme iznine göre gelir.
- [Yazışmayı getir](https://docs.solk.app/rest-api/email/threads-get.md): İletiler (görme izni yoksa body: null, hidden: true), bağlı kayıtlar, firmalar ve kişiler, yanıt taslağı (reply) ve bağlama önerileri.
- [Yazışmayı kayda bağla](https://docs.solk.app/rest-api/email/threads-action.md): opp projeyi değiştirir (opp_id), link bir kayda bağlar (kind, obj_id), unlink bağı kaldırır, dismiss öneriyi yok sayar. Yalnız yazışmanın sahibi, firmanın sorum
- [E-posta hazırlığı](https://docs.solk.app/rest-api/email/compose.md): Yeni e-posta için: hesabın bağlı olup olmadığı, firmanın e-postalı kişileri ve açık projeleri.
- [E-posta gönder](https://docs.solk.app/rest-api/email/send.md): Kullanıcının bağlı e-posta hesabından tek e-posta (yanıt dahil) gönderir; ileti yazışmaya ve projeye web'deki kurallarla bağlanır. Hesap bağlı değilse 400 send 
- [Soru sor](https://docs.solk.app/rest-api/ask/ask.md): CRM verisine doğal dilde soru: Yapay Zekâ modülü açıksa model yanıtlar (mode: ai), değilse kural tabanlı yanıt gelir (mode: kural). blocks ekrana çizilecek yapı
- [Son sorular](https://docs.solk.app/rest-api/ask/history.md): Kullanıcının son 12 sorusu ve önerilen sorular.
- [Sağlayıcı yapılandırması](https://docs.solk.app/rest-api/scim/service-provider-config.md): Desteklenen SCIM özellikleri (PATCH var; toplu işlem, sıralama, ETag yok).
- [Kaynak türleri](https://docs.solk.app/rest-api/scim/resource-types.md): Yalnız User kaynağı.
- [Şemalar](https://docs.solk.app/rest-api/scim/schemas.md): Kullanıcı ve kurumsal uzantı şemaları.
- [Kullanıcıları listele](https://docs.solk.app/rest-api/scim/users-list.md): Kullanıcılar; yalnız userName eq "…" (ya da id eq) süzgeci desteklenir. Sayfalama startIndex + count (en çok 200).
- [Kullanıcı aç](https://docs.solk.app/rest-api/scim/users-create.md): Kullanıcı açar ve şifre belirleme daveti gönderir (rol: satışçı). Aynı e-posta varsa 409 uniqueness.
- [Kullanıcıyı getir](https://docs.solk.app/rest-api/scim/users-get.md): Tek kullanıcı.
- [Kullanıcıyı değiştir](https://docs.solk.app/rest-api/scim/users-replace.md): Ad, e-posta, departman, telefon ve active alanlarını yeniden yazar.
- [Kullanıcıyı güncelle](https://docs.solk.app/rest-api/scim/users-update.md): replace, add, remove işlemleri; active: false kullanıcıyı kapatır (mobil oturumları ve API anahtarları düşer, kayıtları kalır; son etkin yönetici kapatılamaz). 
- [Kullanıcıyı kapat](https://docs.solk.app/rest-api/scim/users-delete.md): Kullanıcıyı siler gibi kapatır; kayıtlar ve geçmiş korunur. 204 döner.
- [Gruplar](https://docs.solk.app/rest-api/scim/groups.md): Grup eşitleme yok; boş liste döner (roller CRM'de atanır).
- [Korunan kaynak bilgisi](https://docs.solk.app/rest-api/oauth/protected-resource.md): RFC 9728 belgesi: MCP kaynağının adresi, yetkilendirme sunucusu ve kapsamlar. İstemciler 401 yanıtındaki resource_metadata'dan buraya gelir.
- [Yetkilendirme sunucusu bilgisi](https://docs.solk.app/rest-api/oauth/authorization-server.md): RFC 8414 belgesi: uç adresleri, desteklenen akışlar (yalnız authorization_code + PKCE S256 ve refresh_token), istemci kimlik doğrulama yöntemleri.
- [İstemci kaydı](https://docs.solk.app/rest-api/oauth/register.md): Dinamik istemci kaydı (RFC 7591). redirect_uris https ya da yerel geri döngü (http://localhost, 127.0.0.1, [::1]) olmalı; en çok 10. token_endpoint_auth_method:
- [Yetkilendir](https://docs.solk.app/rest-api/oauth/authorize.md): Kullanıcıyı onay ekranına götürür (oturum yoksa önce giriş). Onaylanınca redirect_uri?code=…&state=… adresine döner; reddedilirse error=access_denied. PKCE (S25
- [Belirteç al](https://docs.solk.app/rest-api/oauth/token.md): Form gövdesi (application/x-www-form-urlencoded). authorization_code: kod + code_verifier → 1 saatlik erişim belirteci (mcp_…) + 60 günlük yenileme belirteci (m
- [Belirteci iptal et](https://docs.solk.app/rest-api/oauth/revoke.md): Erişim ya da yenileme belirtecini iptal eder (RFC 7009); her zaman 200 döner. Kullanıcı izni tümden Ayarlar → Uygulama bağlantıları'ndan kaldırır.

## MCP — Türkçe

- [Solk MCP](https://docs.solk.app/mcp/overview.md): Claude gibi yapay zekâ asistanlarını CRM'inize bağlayın — firmaları ve fırsatları sorun, görev ve görüşme kaydını sohbetten açın.
- [Bağlanma](https://docs.solk.app/mcp/connect.md): Claude, Claude Code ve diğer MCP istemcilerini Solk kurulumunuza adım adım bağlayın; OAuth keşfinin nasıl çalıştığını görün.
- [Araçlar](https://docs.solk.app/mcp/tools.md): Solk MCP sunucusunun okuma ve yazma araçları, parametreleri ve örnek istemleri.
- [Güvenlik](https://docs.solk.app/mcp/security.md): MCP bağlantısında kimlik, yetki, onay, denetim ve erişimi geri alma.
- [Örnek istemler](https://docs.solk.app/mcp/prompts.md): Solk bağlı bir asistana sorabileceğiniz gerçek iş örnekleri — arama, günlük plan, satış hattı, kayıt açma.
- [Sorun giderme](https://docs.solk.app/mcp/troubleshooting.md): Bağlanamama, izin, eksik araç ve hız sınırı sorunlarının nedenleri ve çözümleri.

## Sürüm notları — Türkçe

- [Sürüm notları](https://docs.solk.app/changelog.md): Solk CRM, REST API ve MCP'deki değişiklikler — en yenisi üstte.

## Machine-readable

- [OpenAPI 3.1](https://docs.solk.app/openapi.json): REST API definition
- [Full content, Turkish](https://docs.solk.app/llms-full.txt)
- [Full content, English](https://docs.solk.app/en/llms-full.txt)