# 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://.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. - [Menu and inbox](https://docs.solk.app/en/guides/navigation.md): A calm sidebar — 8 main pages, Records (Companies · Opportunities · People), More; pinning and ordering pages (Settings › Menu); one inbox for notifications, co - [Keyboard shortcuts](https://docs.solk.app/en/guides/shortcuts.md): Search and commands with Ctrl+K or /, G + a letter to jump between pages, one key to create records, and canvas shortcuts. - [Using Solk on your phone](https://docs.solk.app/en/guides/mobile.md): Solk on your phone — the mobile app (iOS / Android) and the phone browser: bottom bar and the New menu, notes, approvals, call recording, adding to the home scr - [Notifications](https://docs.solk.app/en/guides/notifications.md): How Solk keeps you informed — the Notifications page and the toast that slides in at the top right (web), the in-app card that slides down from the top and phon - [Solk support](https://docs.solk.app/en/guides/support.md): Writing to the Solk team from inside the app — a question, a bug, a feature request or your plan; screenshots, page and version info, replies by notification an - [Sharing, business cards and caller ID](https://docs.solk.app/en/guides/mobile-pro.md): Field features of the Advanced and Enterprise plans in the mobile app — add files and e-mails shared from the phone to a record, create a contact from a busines - [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. - [Sign in with Google and Microsoft](https://docs.solk.app/en/guides/sso.md): Users sign in with their company Google Workspace or Microsoft 365 account, without a password — registered users only. - [Email sending](https://docs.solk.app/en/guides/system-email.md): How invite, password setup, notification and overdue-work emails are sent — through Solk by default (no setup), optionally from your own domain (Resend, Amazon - [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. - [Custom fields](https://docs.solk.app/en/concepts/custom-fields.md): Add your own fields to companies, people and opportunities — used on record pages, in tables, lists, reports, workflows, Excel, the REST API and the Claude conn - [Relationships](https://docs.solk.app/en/concepts/relations.md): Link records to each other — parent company and branches, people who work with several companies, a partner or dealer on an opportunity; define your own relatio - [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 — one-click setup, what they do, and which data goes where. - [Phone system and SMS](https://docs.solk.app/en/guides/phone.md): Netgsm, Verimor, Bulutfon, AloTech, Tegsoft, Yeastar, 3CX, Karel, KobiKom and any phone system that can send events; call lists in Solveline and other call cent - [Accounting & ERP](https://docs.solk.app/en/guides/erp.md): Connections to Paraşüt, BizimHesap, DİA, Logo, Netsis, Mikro, Nebim, Uyumsoft, Canias, ETA, Zirve, Akınsoft, SAP Business One, SAP S/4HANA Cloud, Business Centr - [Solk Connector Agent](https://docs.solk.app/en/guides/erp-agent.md): A Windows program that reads the database of ETA, Zirve, Akınsoft Wolvox and other desktop systems on SQL Server / Firebird and sends accounts, balances, invoic - [e-Invoice, e-Archive and e-Despatch](https://docs.solk.app/en/guides/e-documents.md): e-Despatch from shipments, e-Invoice / e-Archive from despatches or orders; scenarios (public sector, export, export-registered), withholding, exchange rate and - [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, or Dropbox; link cloud files to records; and send the daily backup to the cloud. - [Today](https://docs.solk.app/en/guides/today.md): Start your day here — the AI box and suggestions, a strip for overdue and due-today work, meetings, mentions and weekly visits, meetings day by day with a side - [Calendar](https://docs.solk.app/en/guides/calendar.md): Meetings, tasks and actions in one calendar — drag to move, stretch to change the duration, edit or delete from the drawer. - [Dashboard](https://docs.solk.app/en/guides/dashboard.md): Sales performance on one screen — visit efficiency, hit rate, won amount against quota, average time to close, the visit-to-win flow, the rep table with a compa - [Dashboards and the report builder](https://docs.solk.app/en/guides/dashboards.md): Dashboard in the menu — the ready-made Sales pipeline dashboard opens first; Performance, the sales analysis dashboards and your own on one strip. Build your ow - [Quick Entry](https://docs.solk.app/en/guides/quick-entry.md): Log a conversation on one screen — a fixed core, blocks bound to the data model, templates and sector presets, suggestions from the note, natural-language dates - [Quotes](https://docs.solk.app/en/guides/offers.md): Multi-line quote builder, quick add from contracted and previous prices, optional lines, discount approval, the quote workspace (next step, summary, history) an - [Industry package](https://docs.solk.app/en/guides/sector-package.md): Presets for chemicals / manufacturing, product trading, logistics and services — units of measure, how quote and deal value is calculated (monthly × 12 or one-o - [Price lists and margin](https://docs.solk.app/en/guides/price-lists.md): Customer group (dealer, wholesale, retail) and campaign price lists, quantity tiers, purchase cost and minimum order quantity on products, margin in quotes and - [Order-to-invoice process](https://docs.solk.app/en/guides/order-process.md): Set up the path from order to invoice with flows — which order follows which flow (rules), where and by whom despatch notes and invoices are issued, your own st - [Shipment planning](https://docs.solk.app/en/guides/shipping.md): Regional delivery runs, capacity and orders carried over to the next run — fixed weekdays, province / district / per-company regions, cut-off, route, loading sh - [Visits and location](https://docs.solk.app/en/guides/visits.md): The visit list, detail page, map and the team's day; arriving with "I'm here", the exit location on save, distance to the company, visit duration — modes, priva - [Deal and ticket forms](https://docs.solk.app/en/guides/forms.md): New opportunity and new support ticket work like Quick Entry — a fixed core, blocks opened by the template, a quick panel from any page, sector presets and assi - [Digital business card and QR](https://docs.solk.app/en/guides/digital-card.md): A QR digital business card for every user — public page, link or offline vCard QR, printable card, e-mail signature, Apple Wallet and Google Wallet, a prospect - [Templates](https://docs.solk.app/en/guides/record-templates.md): Settings › Templates — task, company, opportunity form, note and email templates in one place; a library of ready-made examples, categories, descriptions, archi - [Custom objects and the data model](https://docs.solk.app/en/guides/custom-objects.md): Your own record types linked to companies, contacts, opportunities and conversations — production lines, branches, equipment, projects. The data model map, fiel - [Table views and lists](https://docs.solk.app/en/guides/views-and-lists.md): Filter, sort and bulk-update companies, people and opportunities in a table or kanban; track records in staged lists. - [List templates](https://docs.solk.app/en/guides/list-templates.md): 24 ready-made list templates and approval workflows — recruiting, onboarding, leave, expenses, purchasing, discount approval, samples, collections… Template gal - [Approvals and leave](https://docs.solk.app/en/guides/approvals.md): Approval rules on list stages, manager approval, the Approvals page, notifications and leave requests — working-day calculation (public holidays, half-day eves) - [Pipeline and sales forecast](https://docs.solk.app/en/guides/pipeline-forecast.md): The Pipeline page's summary strip, live waterfall, open projects and records behind every number; search, filter and sort; on the Forecast page pick a month, qu - [Fair dashboard](https://docs.solk.app/en/guides/fair-dashboard.md): A live dashboard for every trade fair and a comparison of all fairs — lead → sales funnel, interest and follow-up status, product / sector / city charts, reps, - [Module dashboards](https://docs.solk.app/en/guides/module-dashboards.md): Live dashboards on the Support tickets, Quotes, Orders and Contracts pages — tiles, flow funnel, charts, highlights; records behind every number, Play and video - [Notes](https://docs.solk.app/en/guides/notes.md): Notes on companies, projects, support tickets and contracts — card and list views, favorites, titled and formatted notes, the floating note window, the / menu, - [Comments](https://docs.solk.app/en/guides/comments.md): Team-internal comment threads on companies, opportunities, people, email threads and list entries — @mentions, replies, resolving, and the Comments page. - [Canvases](https://docs.solk.app/en/guides/canvas.md): A whiteboard — 67 ready-made templates, sticky notes, 21 shapes, fonts and styles, smart tables (table · board · timeline views), AI blocks and flows, pen, imag - [Workflows](https://docs.solk.app/en/guides/workflows.md): Automate repetitive work with triggers, conditions and actions — periodic and date-based triggers, workflows that start each other, a canvas editor, suggestions - [Plans and subscription](https://docs.solk.app/en/guides/plans.md): Solk plans, the 14-day trial, choosing a plan and seats, paying with iyzico, upgrades and cancellation. - [Call recording](https://docs.solk.app/en/guides/calls.md): The notetaker joins Zoom, Google Meet and Teams meetings; in-person and phone calls are recorded in the browser. Transcript, speakers, summary, insights and act - [Conversation intelligence](https://docs.solk.app/en/guides/conversation-intelligence.md): Call recordings and visit notes are evaluated automatically — a BANT / MEDDIC scorecard, coaching tips, keyword trackers and alerts, competitor, price, objectio - [Refer and earn](https://docs.solk.app/en/guides/referral.md): Invite companies you know to Solk; they get a first-year discount and you earn invoice credit. - [AI models and your own key](https://docs.solk.app/en/guides/ai-models.md): Choose between Claude, GPT and Gemini models in Ask Solk; connect through Solk or with your company's own API key; usage, data and agreements. - [Prompt templates](https://docs.solk.app/en/guides/prompts.md): Ready-made questions in the Ask Solk box — 27 built-in templates, team and personal templates, the '/' menu, [placeholders], dictation. - [Chats](https://docs.solk.app/en/guides/chats.md): Your Ask Solk conversations are kept — in the menu under Lists, picked up where you left off; earlier questions were moved into chats too. - [Agents](https://docs.solk.app/en/guides/agents.md): Ready-made agents run on schedule and bring the report to you — weekly at-risk deals, 1:1 prep brief, slip pattern, loss reason summary and competitor price log - [Importing from CSV and Excel](https://docs.solk.app/en/guides/import.md): Import companies, people and opportunities from HubSpot, Pipedrive, Zoho or your own spreadsheet by mapping columns; preview, apply, and undo if needed. - [Merging duplicate records](https://docs.solk.app/en/guides/merge.md): Compare duplicate companies, people or opportunities field by field and merge them into a single record. - [Workspace export](https://docs.solk.app/en/guides/export.md): Download all CRM data as one ZIP with a CSV file per table — for backups, analysis, or moving to another system. - [Migrating from Salesforce](https://docs.solk.app/en/guides/salesforce-migration.md): Move your Salesforce data to Solk — with an export file or a direct connection, a sample migration first, then the full migration, and undo if needed. ## 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 - [Profile](https://docs.solk.app/en/rest-api/auth/profile.md): The signed-in user (user — the same full shape as /me: photo, color, phone, ui) and the colour palettes (palettes: key, label, light, dark, on_light, on_dark — - [Update the profile](https://docs.solk.app/en/rest-api/auth/profile-save.md): Only the fields you send change; all are validated first (nothing is written if one is invalid). Palette and theme are the same as Settings › Appearance on the - [Upload a profile photo](https://docs.solk.app/en/rest-api/auth/profile-photo.md): multipart/form-data field photo (or a raw body with Content-Type: image/*): JPG, PNG or WEBP, up to 8 MB and 40 megapixels. The server fixes the EXIF orientatio - [Remove the profile photo](https://docs.solk.app/en/rest-api/auth/profile-photo-delete.md): Deletes the photo from the server; the avatar falls back to initials. Response: user. - [User photo](https://docs.solk.app/en/rest-api/auth/user-photo.md): The user's photo (image/jpeg). Cacheable for 30 days with the ?v= version in the path; ETag + If-None-Match → 304. 404 when there is no photo. The path comes wi - [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 notifications (newest first) and the unread count. Each row: kind (type — mention, comment, task, assign, approval, deal, ticket, email, call, - [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. - [Register a phone for notifications](https://docs.solk.app/en/rest-api/workspace/push-register.md): Registers the mobile app's Firebase Cloud Messaging token for this user and session (a token registered to another user moves to this one). The device is deacti - [Unregister a phone](https://docs.solk.app/en/rest-api/workspace/push-unregister.md): Deactivates this user's device with the given token (when On this phone is turned off in the app). removed: number of devices deactivated. - [Phone notification preferences](https://docs.solk.app/en/rest-api/workspace/push-prefs.md): Types (kinds: k, label, desc, push) — the Phone column of Settings → Notifications on the web; types of disabled modules are not listed. quiet: quiet hours (on, - [Save phone notification preferences](https://docs.solk.app/en/rest-api/workspace/push-prefs-save.md): Only the given types and quiet hours change; in-app and e-mail preferences are kept. The response is the same as GET /push/prefs. - [Send a test notification](https://docs.solk.app/en/rest-api/workspace/push-test.md): Sends a test notification to this user's registered devices right away (quiet hours and the hourly limit do not apply). - [My Solk support tickets](https://docs.solk.app/en/rest-api/workspace/support.md): The Solk support tickets the user wrote (latest activity first): id, subject, category + category_label, status (sending · open · answered — a reply came · solv - [Write to Solk support](https://docs.solk.app/en/rest-api/workspace/support-new.md): A new ticket. JSON or multipart/form-data: subject, category, body, ctx (optional context — app, device, os, lang, viewport, screen, page; JSON or a JSON string - [Support ticket](https://docs.solk.app/en/rest-api/workspace/support-get.md): The ticket and its thread: msgs[] (id, side — user | team, author, body, at, sent, files[] — name, mime, size, url), can_close, can_reopen. For the user who ope - [Reply to a support ticket](https://docs.solk.app/en/rest-api/workspace/support-reply.md): The user's reply (body and / or files, same rules as a new ticket). A solved or closed ticket reopens. Response: sent, ticket. - [Close / reopen a ticket](https://docs.solk.app/en/rest-api/workspace/support-state.md): close or reopen; the status is also sent to the Solk panel. Response: ticket. - [Ticket attachment](https://docs.solk.app/en/rest-api/workspace/support-file.md): The i-th attachment of a message (from 0) — images inline, others as a download. The path comes with files[].url; only the ticket's author and admins. - [Caller ID list](https://docs.solk.app/en/rest-api/workspace/callerid.md): Company and contact numbers the user can see (international digits, ascending): entries = [number, label, company_id, contact_id] — label Company · Contact (com - [Parse a business card](https://docs.solk.app/en/rest-api/workspace/card-parse.md): Splits business-card lines read on the phone (OCR) into fields: name, title, department, company, mobile / other phone (fax skipped), e-mail, website, address, - [Save a contact from a business card](https://docs.solk.app/en/rest-api/workspace/card-save.md): multipart/form-data (or JSON): data (JSON) — customer_id (existing company) or new_customer {name, website, phone, address, city} or contact_id (complete an exi - [Suggest a record for a share](https://docs.solk.app/en/rest-api/workspace/share-suggest.md): Suggests up to 5 companies from shared text or an e-mail file (eml, first 64 KB): an existing contact's e-mail → their company, e-mail domain → company, a compa - [Add a share to a record](https://docs.solk.app/en/rest-api/workspace/share.md): multipart/form-data: a note and up to 10 files (15 MB each; allowed types as for web attachments) on the chosen record. Subject, sender, date and body of .eml f - [My business card](https://docs.solk.app/en/rest-api/workspace/my-card.md): The signed-in user's digital business card (card). The card is created on the first call but is not published (enabled: false). Top-level values (name, title, d - [Update my business card](https://docs.solk.app/en/rest-api/workspace/my-card-save.md): Only the fields you send change; the response is the same as GET /card. enabled: true publishes the card, false unpublishes it. Name, e-mail, phone and photo co - [Renew the business card link](https://docs.solk.app/en/rest-api/workspace/my-card-rotate.md): Creates a new link (token, url) and a new QR; the old link, old QR codes and printed cards stop opening. Counters are kept; the Apple Wallet pass updates itself - [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). - [Badges](https://docs.solk.app/en/rest-api/workspace/badges.md): Unread notifications and pending approvals (a light endpoint for app badges). - [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 - [Company location](https://docs.solk.app/en/rest-api/companies/geo.md): v66: sets or clears (clear: true) the company's location. Admins or the company's owner. Distances in visits are measured to this point. The company card (GET / - [Company potential](https://docs.solk.app/en/rest-api/companies/potentials.md): The company's potential rows by product group (potentials), the section setting (pot: on, title) and selectable groups (groups). Row: grp (empty = all products; - [Save company potential](https://docs.solk.app/en/rest-api/companies/potentials-save.md): Writes the full list of rows: rows not sent are deleted, empty rows are skipped, a repeated group keeps the first (max 50 rows). Row: grp (product group; empty - [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. Gates are edited in Se - [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). - [List objects](https://docs.solk.app/en/rest-api/objects/objects-list.md): Custom objects defined in the installation that are open to the API or mobile: key, name, icon, fields (key, type, options, required, in Quick Entry), relations - [List records](https://docs.solk.app/en/rest-api/objects/records-list.md): Records of one object, sorted by name. fields maps field key → value (date YYYY-MM-DD, number, option text, array for multi-select, user id for person fields); - [Create a record](https://docs.solk.app/en/rest-api/objects/records-create.md): Creates a record. Required fields and options are validated on the server (invalid, listed one by one in errors). With customer_id the object's company relation - [Get a record](https://docs.solk.app/en/rest-api/objects/records-get.md): The record plus field_list (label, type, display value, options), relations (linked records per relation type), the web URL and editable. - [Update a record](https://docs.solk.app/en/rest-api/objects/records-update.md): Only the fields you send change; an empty value inside fields clears that field. active: false archives, true restores. POST is accepted too. - [Delete a record](https://docs.solk.app/en/rest-api/objects/records-delete.md): Permanently deletes the record, its field values, relations and comments. To keep it recoverable, archive with active: false instead. Clients without DELETE can - [Delete a record (POST)](https://docs.solk.app/en/rest-api/objects/records-delete-post.md): Same as Delete a record, for clients that can't send DELETE. - [Add / remove a link](https://docs.solk.app/en/rest-api/objects/records-link.md): Links the record to another record through a relation type (act: add) or removes the link (act: remove). On a single (N:1) relation the new target replaces the - [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 - [Visits](https://docs.solk.app/en/rest-api/activities/visits.md): The visit / activity list (by day, then entry time, newest first). Row: the visit fields + geo (location summary — only for the person who logged it and admins; - [Visit](https://docs.solk.app/en/rest-api/activities/visit.md): Visit detail: the list row + contact_phone, contact_title, action_done_at, action_result, nogeo_reason (why no location was handled — phone call, back-dated ent - [Open check-in](https://docs.solk.app/en/rest-api/activities/checkin-state.md): The user's open "I'm here" check-in (checkin or null) and settings (mode — off · optional · required, radius). Check-in: id, customer_id, customer, at, time, mi - [I'm here (check in)](https://docs.solk.app/en/rest-api/activities/checkin.md): Records arrival at a company with a location. If the company's location is known the distance and status (ok · far · low) are calculated. If not, against the ap - [Cancel a check-in](https://docs.solk.app/en/rest-api/activities/checkin-cancel.md): Cancels the user's open check-in (without saving a visit). - [Nearby companies](https://docs.solk.app/en/rest-api/activities/nearby.md): Companies with a known location within 5 km (by distance, up to 8): id, name, city, status, dist, dist_l, here (within the radius). Also recent (the companies t - [Distance reference for a company](https://docs.solk.app/en/rest-api/activities/firm-geo.md): A company's reference point for the live distance on the visit form: geo = the company location (base: firm) or the approximate point found from its address (ba - [Team's day](https://docs.solk.app/en/rest-api/activities/team-day.md): Admins only. Each salesperson's stops for the day (stops — visits and check-ins that didn't become a visit, by time: kind, time, customer, type, geo, pt, durati - [A company's activity feed](https://docs.solk.app/en/rest-api/feed/company-activity.md): Everything on the company in one feed, newest first: e-mail, calls and SMS, WhatsApp, meetings and recordings, quotes and orders, notes, comments, tasks, stage - [An opportunity's activity feed](https://docs.solk.app/en/rest-api/feed/deal-activity.md): Same shape as the company feed; only events linked (or estimated to be linked) to this opportunity. - [Company feed stamp](https://docs.solk.app/en/rest-api/feed/company-activity-stamp.md): v92: returns without building the feed — stamp (16 characters). When it changes, fetch the feed again; the mobile app polls every 25 seconds while the screen is - [Opportunity feed stamp](https://docs.solk.app/en/rest-api/feed/deal-activity-stamp.md): v92: like the company stamp, for an opportunity. - [Add a note to a company](https://docs.solk.app/en/rest-api/feed/company-note.md): v92: the feed's Note bar. Response: id (the note's id). The note appears in the feed at once and the stamp changes. - [Add a note to an opportunity](https://docs.solk.app/en/rest-api/feed/deal-note.md): v92: like a company note; the opportunity's last update becomes today. - [List conversations](https://docs.solk.app/en/rest-api/whatsapp/chats.md): v92 (beta): conversations on the workspace's WhatsApp Business number, latest message first (max 100). Row: id, phone, name, profile_name, company_id, company, - [Get a conversation](https://docs.solk.app/en/rest-api/whatsapp/chat.md): v92 (beta): chat, messages (oldest to newest; id, direction in · out, type, text, has_media, media_name, template, status — pending · sent · delivered · read · - [Send a message](https://docs.solk.app/en/rest-api/whatsapp/send.md): v92 (beta): a real send. Within 24 hours of the customer's last message send text; otherwise only an approved template (template + variables). Marketing templat - [Open a conversation](https://docs.solk.app/en/rest-api/whatsapp/open.md): v92 (beta): finds or opens the number's conversation and links it to the company; sends nothing. Response: chat. - [Form configuration](https://docs.solk.app/en/rest-api/quickentry/qe-config.md): Everything needed to draw Quick Entry: templates (block order, st = open · chip · off, req required, cond condition, def defaults), block definitions for the us - [Company context](https://docs.solk.app/en/rest-api/quickentry/qe-context.md): What fills the form once a company is chosen: contacts, active projects and the default one, the open deal's stage, open actions (closable), the last conversati - [Suggestions from the note](https://docs.solk.app/en/rest-api/quickentry/qe-suggest.md): Rule-based suggestions from the conversation note (no outside calls, works on every plan): product, price and payment terms, quantity (tonnes → kg), trial resul - [Parse a date](https://docs.solk.app/en/rest-api/quickentry/qe-when.md): Parses a Turkish natural-language date: yarın, perşembe, haftaya salı 14:00, ay sonu, 12 kasım, 3 gün sonra. understood: false means it couldn't be parsed. - [Save a conversation](https://docs.solk.app/en/rest-api/quickentry/qe-submit.md): Saves the conversation and open blocks in one request: company (created if missing), contact(s), project / deal, stage, product, trial, quote, order, competitor - [Undo](https://docs.solk.app/en/rest-api/quickentry/qe-undo.md): The user who saved (or an admin) can undo within undo_seconds (600 s by default): created records are deleted, changed company / contact / deal fields revert an - [Form configuration](https://docs.solk.app/en/rest-api/forms/forms-config.md): Everything needed to draw the new-deal (opp) or new-ticket (ticket) form — like Quick Entry: templates (block order, st = open · chip · off, req required, cond - [Company context](https://docs.solk.app/en/rest-api/forms/forms-context.md): What the form loads once a company is chosen: contacts (main contact flagged), active projects, all projects (all_projects, to link a ticket to a project), the - [Save with a template](https://docs.solk.app/en/rest-api/forms/forms-submit.md): Saves a deal or a ticket and its open blocks in one request. Deal: company (created as a prospect if missing; a similar name returns 409 similar — pick the exis - [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). - [Lead entry: company lookup](https://docs.solk.app/en/rest-api/fairs/leads-lookup.md): While entering a lead: registered company suggestions (q — Turkish-folded; exact name → prefix → word start → contains), leads at this fair with the same compan - [Lead entry: company card](https://docs.solk.app/en/rest-api/fairs/leads-lookup-company.md): The chosen registered company's card + contacts (contacts: id, name, title, phone, email, main, ini; main contact first) + open opportunities (opps: id, name, s - [Conversion preview](https://docs.solk.app/en/rest-api/fairs/leads-convert-preview.md): Before converting: the suggested company (match — the registered company chosen at entry or a name match; by_link), the lead's people and their suggested match - [Convert a lead](https://docs.solk.app/en/rest-api/fairs/leads-convert.md): Converts the lead (same core as the web conversion card): to a registered company or as a new prospect; people are linked to the matched contact (blank fields f - [Bulk actions](https://docs.solk.app/en/rest-api/fairs/leads-bulk.md): Selected leads (max 200): convert — converts with the default matching (already converted ones go to skipped), assign — changes the owner (no permission → skipp - [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 - [Set a thread's category](https://docs.solk.app/en/rest-api/email/threads-category.md): Sets the thread's category by hand (v50; category_source: user — it stays when new messages arrive) or returns it to automatic with auto (recalculated from keyw - [Recipient suggestions](https://docs.solk.app/en/rest-api/email/recipients.md): Up to 8 suggestions for the To / Cc field: contacts of visible companies (k: contact, company name c, fm left the company), teammates (k: user) and external add - [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 - [List chats](https://docs.solk.app/en/rest-api/ask/chats-list.md): The user's Ask chats (v50), most recent first: title, n number of questions, star, updated_at, preview (short text of the last answer). Chats are personal — adm - [Get a chat](https://docs.solk.app/en/rest-api/ask/chats-get.md): The chat's questions and answers in order (messages[]: q, text, blocks, refs — with nav for the app screen —, mode, model, at). - [Rename / star / delete a chat](https://docs.solk.app/en/rest-api/ask/chats-action.md): rename (title), star (on; toggles when omitted), delete (the chat is removed permanently with its questions and answers). - [Question history](https://docs.solk.app/en/rest-api/ask/history.md): The user's last 12 questions and suggested questions. - [Prompt templates](https://docs.solk.app/en/rest-api/ask/prompts.md): Templates the user can see (personal, team, built-in) — most used first; n is the user's use count. With AI on, models lists the models selectable in Ask (model - [Count a template use](https://docs.solk.app/en/rest-api/ask/prompt-use.md): Increments the user's use count for the template (moves it up the list). - [List notes](https://docs.solk.app/en/rest-api/notes/notes-list.md): Notes on records you may see, most recently updated first. preview is plain text; rec.nav is the mobile screen mapping. - [Get a note](https://docs.solk.app/en/rest-api/notes/notes-get.md): Title, Markdown body, linked record, author, dates, can_edit (author or admin only), fav and labels (v48: [{id, name, color, hex}]). - [Create or update a note](https://docs.solk.app/en/rest-api/notes/notes-save.md): Creates a note when id is missing (it must be linked to a record), otherwise updates it. Users in mentions are notified when the body contains @Full Name (notif - [Note labels](https://docs.solk.app/en/rest-api/notes/notes-labels.md): The team's shared label list (in order): labels[] = {id, name, color, hex, n} (n = use in notes you can see), colors (9 colours), can_create, can_manage (admins - [Create or edit a label](https://docs.solk.app/en/rest-api/notes/notes-labels-save.md): Without id creates a label (anyone; an existing name — case-insensitive, Turkish rules — is returned with existed: true). Renaming / recolouring with id is admi - [Delete a label](https://docs.solk.app/en/rest-api/notes/notes-labels-delete.md): Admin only. The label is removed from notes, the notes stay; removed = number of notes it was removed from. - [Set a note's labels](https://docs.solk.app/en/rest-api/notes/notes-set-labels.md): Replaces the note's labels with the given list (max 6; deleted ids are dropped). Whoever may edit the note (author or admin) can change them; the note's 'last e - [Archive / unarchive](https://docs.solk.app/en/rest-api/notes/notes-archive.md): Moves the note to the archive or back (v49). An archived note isn't deleted: it's hidden from lists, record cards and starred notes, listed with ?archived=1 and - [Star / unstar](https://docs.solk.app/en/rest-api/notes/notes-fav.md): Adds or removes the note from the user's starred notes; fav is the new state. - [Delete a note](https://docs.solk.app/en/rest-api/notes/notes-delete.md): Only the author or an admin can delete. - [List comments](https://docs.solk.app/en/rest-api/comments/comments-list.md): Threads of one record (kind + obj_id) or filtered threads across records. Each thread: first comment, replies, resolved, record (record.nav). n_mentions_open co - [Add a comment](https://docs.solk.app/en/rest-api/comments/comments-add.md): Starts a thread on the record or replies with reply_to (a resolved thread reopens). Users in mentions are added to the text as @Full Name and notified. - [Resolve / reopen](https://docs.solk.app/en/rest-api/comments/comments-resolve.md): resolved: false reopens. - [List approval requests](https://docs.solk.app/en/rest-api/approvals/approvals-list.md): todo pending requests you can decide, mine requests you opened, done your decisions, all (admin) everything. Each row has fields (info), leave balance and overl - [Get a request](https://docs.solk.app/en/rest-api/approvals/approvals-get.md): Visible to the requester, approver, decider or an admin. - [Approve / reject / withdraw](https://docs.solk.app/en/rest-api/approvals/approvals-decide.md): The approver (or an admin) may approve / reject; the requester may cancel. The entry moves to the rule's stage and the requester is notified. - [Request forms](https://docs.solk.app/en/rest-api/approvals/approvals-forms.md): Lists with an approval rule you can add to (leave, expenses, purchasing …): fields (k, l, t, o) and remaining days for leave lists. On leave lists the Employee - [Submit a request](https://docs.solk.app/en/rest-api/approvals/approvals-submit.md): Adds an entry to the list and sends it for approval (same as Send for approval on the web). Leave working days exclude public holidays; if you are the approver - [List call recordings](https://docs.solk.app/en/rest-api/calls/calls-list.md): Recordings you may see (excluding scheduled and canceled), newest first. - [Get a recording](https://docs.solk.app/en/rest-api/calls/calls-get.md): Summary, sections, action items, chapters, speaker shares and transcript (max 600 segments). v79: intel — the conversation intelligence evaluation: method, meth - [Recording status](https://docs.solk.app/en/rest-api/calls/calls-status.md): For polling while processing: status, active. - [Start a recording upload](https://docs.solk.app/en/rest-api/calls/calls-record.md): Opens a recording for audio captured on the phone and returns a token; send the audio in parts with /calls/{token}/chunk, then /finish starts transcription. - [Upload an audio part](https://docs.solk.app/en/rest-api/calls/calls-chunk.md): The body is raw audio bytes (application/octet-stream, max 8 MB per part). Parts must arrive in i order: a repeated part is ignored (dup), a skipped one returns - [Finish a recording](https://docs.solk.app/en/rest-api/calls/calls-finish.md): Closes the upload and starts transcription and summary; id is the recording id. - [Call through the phone system](https://docs.solk.app/en/rest-api/phone/dial.md): Click-to-call: the user's extension rings first, then the number is dialled (Netgsm, Verimor, AloTech or a phone system with a call-start address). Without numb - [Live calls](https://docs.solk.app/en/rest-api/phone/live.md): Calls ringing, in progress or just ended for the user (max 3) — the same data as the web caller card: status (dialing · ringing · answered · done · missed · noa - [Calls and metrics](https://docs.solk.app/en/rest-api/phone/calls.md): Phone system calls: row direction, status (done answered · missed · noanswer outbound, no answer · ringing · answered · lost result unknown), number, e164, star - [SMS compose data](https://docs.solk.app/en/rest-api/phone/sms-compose.md): To send an SMS from a record: people (contacts and the company phone — kind, id, label, to, cid, optout), templates (id, name, kind, body), kinds (k info · taci - [Send SMS](https://docs.solk.app/en/rest-api/phone/sms-send.md): One SMS. kind: info informational (order, delivery, appointment, payment — no campaign wording) · tacir commercial message to a business's corporate line · bire - [SMS history](https://docs.solk.app/en/rest-api/phone/sms.md): Sent SMS (newest first): to, number, body, parts, kind, status (queued · sent · delivered · failed), error, source (single · bulk · flow · api), customer_id, co - [Add to call list](https://docs.solk.app/en/rest-api/phone/call-list-add.md): Adds the number to the call centre's call list (campaign) — Solveline (Mantis) or another call centre with an add-record address. Without phone the contact's, t - [Call list](https://docs.solk.app/en/rest-api/phone/call-list.md): Numbers added to call lists (newest first, push rows) and links (connected call centres — id, name, provider, campaign, appointments), on. Without a company, sa - [Add to do-not-call list](https://docs.solk.app/en/rest-api/phone/do-not-call.md): Puts the number on the do-not-call list: it's never added to call lists again and is written to the blocklist address of the connected call centres. Without pho - [Commission statement](https://docs.solk.app/en/rest-api/insights/prim.md): v90: your own quarterly commission statement: period, label, plan, base (orders · invoices · paid), credited, target, attainment (%), rate, prim, adjustments, t - [Pipeline summary](https://docs.solk.app/en/rest-api/insights/pipeline.md): Open amount, weighted expected, Commit / Best Case / Pipeline, period flow (start → new, moved in / out, increased / decreased, won, lost → end), stages and opp - [Pipeline records](https://docs.solk.app/en/rest-api/insights/pipeline-drill.md): Records behind one pipeline number — the list has exactly n records, the number shown. Keys: waterfall columns start · new · inc · in · out · dec · won · lost · - [Opportunity board](https://docs.solk.app/en/rest-api/insights/opportunity-board.md): The web Opportunities › Board: open opportunities, stalled (SLA overdue or inactive_days+ days idle), average age, sales velocity; closed in the period (won, wi - [Opportunity board records](https://docs.solk.app/en/rest-api/insights/opportunity-board-drill.md): Records behind one board number (number = list): open · velocity · age · stalled · won · avg_won · win_days · rate · lost · canc · reason:; for the mont - [Dashboards](https://docs.solk.app/en/rest-api/insights/dashboards.md): Dashboards you can see, in the web strip order: the built-in Sales pipeline first (home: true), then the rest. ranges: date ranges selectable for a board. - [Dashboard](https://docs.solk.app/en/rest-api/insights/dashboard.md): The board's reports in order: id, title, w (0 small tile · 1 half · 2 full width), chart, kind. Each report's data comes from its own endpoint. - [Dashboard report data](https://docs.solk.app/en/rest-api/insights/dashboard-widget.md): Runs the report with your permissions: data = {chart, kind, labels, series: [{n, c, v}], colors?, total, total_s, unit, insight, goal_pct?, delta?, cols?, table - [Records from a chart](https://docs.solk.app/en/rest-api/insights/dashboard-drill.md): Records behind a bar / slice — the list has as many records as the chart shows. Empty label = all records of the report. labels / sers are all names in the char - [Module boards](https://docs.solk.app/en/rest-api/insights/module-boards.md): Module boards you can open (rows: k, title): tickets Support tickets · offers Quotes · orders Orders · contracts Contracts · fairs Fair leads — by plan and perm - [Module board](https://docs.solk.app/en/rest-api/insights/module-board.md): The same numbers as the web board: tiles and flow (k, q records query, title, label, value, suffix — percent or unit —, sub, dot, bar), charts (title, q, data = - [Module board records](https://docs.solk.app/en/rest-api/insights/module-board-drill.md): Records behind one board number — for a tile / flow step pass its q, for a chart slice the chart's q + i (label index), label, series. The list has as many reco - [Period forecast](https://docs.solk.app/en/rest-api/insights/forecast.md): Month · quarter · year: won, forecast with Commit and Best Case, target, percentage, status, coverage, win rate; deals by category, a 12-month series in month v - [Performance (Dashboard)](https://docs.solk.app/en/rest-api/insights/performance.md): The web Dashboard figures: period, four indicators (T.rate visit efficiency — within window days after the visit a new opportunity, stage advance, trial, quote - [Rep breakdown](https://docs.solk.app/en/rest-api/insights/performance-rep.md): Companies the rep visited in the period, one by one: visits and their status, opportunity movements (events), open opportunities and amount, the next action wri - [List agent reports](https://docs.solk.app/en/rest-api/agents/runs.md): The latest agent reports you can see, newest first: reports of agents you set up or receive; admins see all. Row: id, agent_id, template (weekly_risk · one_on_o - [Get an agent report](https://docs.solk.app/en/rest-api/agents/run.md): The list fields + kpis (label, value, sub), insights (highlights), actions (suggested steps — the AI summary's when there is one), ai_summary (AI summary or nul - [Company finance](https://docs.solk.app/en/rest-api/finance/customer-finance.md): The company's finance summary read from the ERP and its sales invoices: balance, overdue amount, credit limit, risk (balance ÷ limit), open / overdue invoice co - [Product stock](https://docs.solk.app/en/rest-api/finance/product-stock.md): The product's current quantity in the ERP and its warehouse breakdown. For direct ERP connections it is read live and cached for 10 minutes (cached, at); for So - [Send order to ERP](https://docs.solk.app/en/rest-api/finance/order-send.md): Sends the CRM order to the main order connection as a sales order: the customer's PO number (customer_po), ERP account code, item code, quantity, price, currenc - [Customer PO number](https://docs.solk.app/en/rest-api/finance/order-po.md): Writes the order's customer purchase-order number (customer_po), or clears it when empty; whitespace is collapsed, at most 60 characters. On an order already se - [Ping](https://docs.solk.app/en/rest-api/erp/ping.md): Confirms the key and returns the datasets enabled on the connection (datasets); queued_orders = orders waiting to be written to the ERP. - [Send accounts](https://docs.solk.app/en/rest-api/erp/customers.md): Sends ERP accounts; Solk matches each to a CRM company — tax number first, then name (Turkish letters and legal suffixes ignored). If the connection is set to c - [Send balances](https://docs.solk.app/en/rest-api/erp/balances.md): Updates account balances: balance (debit − credit; positive when the customer owes), overdue, credit_limit, currency. The account is found by ext_id or code. - [Send sales invoices](https://docs.solk.app/en/rest-api/erp/invoices.md): Sends sales and return invoices; the company card's open / paid, overdue and last-12-months revenue come from these. customer is the account's ext_id or code (w - [Send products](https://docs.solk.app/en/rest-api/erp/products.md): Sends ERP items; they are matched to CRM products by code (else by name). If update list price is on, price is written to the product's list price. qty, when gi - [Send stock](https://docs.solk.app/en/rest-api/erp/stock.md): Writes the quantity on hand and the warehouse breakdown by item code (warehouses: [{name, qty}]; without qty the warehouses are summed). Stock on orders and the - [Orders to write](https://docs.solk.app/en/rest-api/erp/orders.md): Sales orders waiting to be written to the ERP (max 100): the order body holds ref, po, date, due, currency, customer (CRM id, ERP ext_id / code — empty when the - [Report order result](https://docs.solk.app/en/rest-api/erp/order-ack.md): Writes the order's state in the ERP. status: sent · open · shipped · invoiced · closed · cancelled · error. ext_no is the ERP document number (shown on the orde - [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, write and permanent-delete 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. - [Menü ve gelen kutusu](https://docs.solk.app/guides/navigation.md): Sade kenar çubuğu — 8 ana sayfa, Kayıtlar (Firmalar · Fırsatlar · Kişiler), Daha fazla; sayfaları sabitleme ve sıralama (Ayarlar › Menü); bildirim, yorum ve ona - [Klavye kısayolları](https://docs.solk.app/guides/shortcuts.md): Ctrl+K ya da / ile arama ve komutlar, G + harf ile sayfalar arası geçiş, tek harfle kayıt oluşturma ve tuval kısayolları. - [Telefonda kullanım](https://docs.solk.app/guides/mobile.md): Telefonda Solk — mobil uygulama (iOS / Android) ve telefon tarayıcısı: alt çubuk ve Yeni menüsü, notlar, onaylar, görüşme kaydı, ana ekrana ekleme; paketinizde - [Bildirimler](https://docs.solk.app/guides/notifications.md): Solk'un sizi nasıl haberdar ettiği — Bildirimler sayfası ve sağ üstten kayan bildirim (web), uygulama içinde üstten kayan kart ve telefon bildirimleri (mobil), - [Solk desteği](https://docs.solk.app/guides/support.md): Uygulamanın içinden Solk ekibine yazmak — soru, hata, özellik isteği ya da paket; ekran görüntüsü, sayfa ve sürüm bilgisi, yanıtın bildirim ve e-postayla gelmes - [Paylaşım, kartvizit ve arayan kimliği](https://docs.solk.app/guides/mobile-pro.md): Mobil uygulamada İleri ve Kurumsal paketlerinin saha özellikleri — telefondan paylaşılan dosya ve e-postayı kayda eklemek, kartvizitten kişi açmak (yazı telefon - [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. - [Google ve Microsoft ile giriş](https://docs.solk.app/guides/sso.md): Kullanıcılar şirket Google Workspace ya da Microsoft 365 hesabıyla, şifre yazmadan giriş yapar; yalnız kayıtlı kullanıcılar. - [E-posta gönderimi](https://docs.solk.app/guides/system-email.md): Davet, şifre belirleme, bildirim ve geciken işler e-postaları nasıl gider — varsayılan Solk üzerinden (ayar gerekmez), isteğe bağlı kendi alan adınızdan (Resend - [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. - [Özel alanlar](https://docs.solk.app/concepts/custom-fields.md): Firma, kişi ve fırsatlara kendi alanlarınızı ekleyin — kartta, tablolarda, listelerde, raporlarda, iş akışlarında, Excel'de, REST API'de ve Claude bağlantısında - [İlişkiler](https://docs.solk.app/concepts/relations.md): Kayıtları birbirine bağlayın — ana firma ve şubeler, birden çok firmada çalışan kişiler, fırsattaki ortak ya da bayi; kendi ilişki türlerinizi tanımlayın. - [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ı — tek tıkla kurulum, ne yaptıkları ve hangi verinin nereye gittiği. - [Telefon santrali ve SMS](https://docs.solk.app/guides/phone.md): Netgsm, Verimor, Bulutfon, AloTech, Tegsoft, Yeastar, 3CX, Karel, KobiKom ve olay gönderebilen diğer santraller; Solveline ve diğer çağrı merkezlerinde arama li - [Muhasebe ve ERP](https://docs.solk.app/guides/erp.md): Paraşüt, BizimHesap, DİA, Logo, Netsis, Mikro, Nebim, Uyumsoft, Canias, ETA, Zirve, Akınsoft, SAP Business One, SAP S/4HANA Cloud, Business Central ve Odoo bağl - [Solk Bağlantı Ajanı](https://docs.solk.app/guides/erp-agent.md): ETA, Zirve, Akınsoft Wolvox ve SQL Server / Firebird kullanan diğer masaüstü programların veritabanını okuyup cari, bakiye, fatura, ürün ve stok bilgisini Solk' - [e-Fatura, e-Arşiv ve e-İrsaliye](https://docs.solk.app/guides/e-documents.md): Sevkiyattan e-İrsaliye, irsaliyeden ya da siparişten e-Fatura / e-Arşiv; senaryolar (kamu, ihracat, ihraç kayıtlı), tevkifat, döviz kuru ve TL karşılığı, kur fa - [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 ya da Dropbox'a kaydedin; buluttaki dosyaları kayıtlara bağlayın; günlük yedeği buluta gönderin. - [Bugün](https://docs.solk.app/guides/today.md): Güne buradan başlayın — yapay zekâ kutusu ve öneriler, gecikmiş · bugünkü iş, toplantı, bahsedilme ve haftalık ziyaret şeridi, gün gün toplantılar ve sağdan açı - [Takvim](https://docs.solk.app/guides/calendar.md): Toplantılar, görevler ve aksiyonlar tek takvimde — sürükleyerek taşıyın, süreyi uzatın, çekmeceden düzenleyin ya da silin. - [Dashboard](https://docs.solk.app/guides/dashboard.md): Satış performansı tek ekranda — ziyaret verimi, hit-rate, kazanılan tutar ve kota, ortalama kapanış süresi, ziyaretten kazanıma akış, satışçı tablosu ve firma f - [Panolar ve rapor oluşturucu](https://docs.solk.app/guides/dashboards.md): Menüde Dashboard — hazır Satış hattı panosu ilk açılır; Performans, satış analizi panoları ve kendi panolarınız bir şeritte. Rapor oluşturucuyla kendi grafiğini - [Hızlı Giriş](https://docs.solk.app/guides/quick-entry.md): Görüşmeyi tek ekranda kaydedin — sabit çekirdek, veri modeline bağlı bloklar, şablonlar ve sektör hazır ayarları, nottan öneriler, doğal dilde tarih, canlı özet - [Teklifler](https://docs.solk.app/guides/offers.md): Çok kalemli teklif oluşturucu, anlaşmalı ve önceki fiyatlardan hızlı ekleme, opsiyonel kalem, iskonto onayı, teklif çalışma alanı (sıradaki adım, özet, geçmiş) - [Sektör paketi](https://docs.solk.app/guides/sector-package.md): Kimya / üretim, ürün al-sat, lojistik ve hizmet firmaları için hazır ayar — ölçü birimleri, teklif ve fırsat değerinin hesabı (aylık × 12 ya da tek seferlik), B - [Fiyat listeleri ve marj](https://docs.solk.app/guides/price-lists.md): Müşteri grubu (bayi, toptan, perakende) ve kampanya fiyat listeleri, miktar kademeleri, ürünlerde alış fiyatı ve asgari sipariş miktarı, tekliflerde marj ve asg - [Sipariş sonrası süreç](https://docs.solk.app/guides/order-process.md): Siparişten faturaya giden yolu akışlarla kurun — hangi sipariş hangi akışa düşer (kurallar), irsaliye ve fatura nerede ve kim tarafından düzenlenir, araya giren - [Sevkiyat planlama](https://docs.solk.app/guides/shipping.md): Bölge seferleri, kapasite ve sonraki sefere kalan siparişler — sabit günler, il / ilçe / firmaya özel bölgeler, kesim saati, rota, yükleme listesi, teslim kaydı - [Ziyaretler ve konum](https://docs.solk.app/guides/visits.md): Ziyaret listesi, ayrıntı sayfası, harita ve ekibin günü; Konumdayım ile varış, kayıtta çıkış konumu, firmaya uzaklık, ziyaret süresi — kipler, gizlilik, firma k - [Fırsat ve destek formları](https://docs.solk.app/guides/forms.md): Yeni fırsat ve yeni destek talebi Hızlı Giriş mantığında — sabit çekirdek, şablona göre açılan bloklar, her sayfadan hızlı panel, sektör hazır ayarları ve atama - [Dijital kartvizit ve QR](https://docs.solk.app/guides/digital-card.md): Her kullanıcıya QR kodlu dijital kartvizit — açık sayfa, bağlantı ya da çevrimdışı vCard QR, yazdırılabilir kart, e-posta imzası, Apple Wallet ve Google Cüzdan, - [Şablonlar](https://docs.solk.app/guides/record-templates.md): Ayarlar › Şablonlar — görev, firma, fırsat formu, not ve e-posta şablonları tek yerde; hazır örnek kütüphanesi, kategori, açıklama, arşiv, ilk görevler, varsayı - [Özel nesneler ve veri modeli](https://docs.solk.app/guides/custom-objects.md): Firmaya, kişiye, fırsata ve görüşmeye bağlanan kendi kayıt türleriniz — üretim hattı, şube, ekipman, proje. Veri modeli haritası, alanlar, bağlantılar, tablo ve - [Tablo görünümleri ve listeler](https://docs.solk.app/guides/views-and-lists.md): Firma, kişi ve fırsatları tabloda ya da kanbanda süzün, sıralayın, toplu güncelleyin; kayıtları aşamalı listelerde takip edin. - [Liste şablonları](https://docs.solk.app/guides/list-templates.md): 24 hazır liste şablonu ve onaylı süreçler — işe alım, oryantasyon, izin, masraf, satın alma, iskonto onayı, numune, tahsilat… Şablon galerisi, önizleme, kendi k - [Onaylar ve izinler](https://docs.solk.app/guides/approvals.md): Liste aşamalarına onay kuralı, yönetici onayı, Onaylar sayfası, bildirimler ve izin talepleri — iş günü hesabı (resmî tatiller, arife yarım gün), yıllık izin ba - [Pipeline ve satış öngörüsü](https://docs.solk.app/guides/pipeline-forecast.md): Pipeline sayfasında özet şeridi, canlı şelale, açık projeler ve her sayıdan kayıtlara; arama, süzgeç ve sıralama; Öngörü sayfasında ay, çeyrek ya da yıl seçimi, - [Fuar panosu](https://docs.solk.app/guides/fair-dashboard.md): Her fuarın canlı panosu ve tüm fuarların karşılaştırması — lead → satış hunisi, ilgi ve takip durumu, ürün / sektör / şehir grafikleri, satışçılar, fuar maliyet - [Modül panoları](https://docs.solk.app/guides/module-dashboards.md): Destek talepleri, Teklifler, Siparişler ve Sözleşmeler sayfalarının canlı panoları — kutular, akış hunisi, grafikler, öne çıkanlar; her sayıdan kayıtlara, Oynat - [Notlar](https://docs.solk.app/guides/notes.md): Firma, proje, destek ve sözleşme kayıtlarına yazılan notlar — kart ve liste görünümü, favoriler, başlıklı ve biçimli notlar, yüzen not penceresi, / menüsü, @bah - [Yorumlar](https://docs.solk.app/guides/comments.md): Firma, fırsat, kişi, e-posta yazışması ve liste kayıtlarında ekip içi yorum konuları — @bahsetme, yanıt, çözüldü işareti ve Yorumlar sayfası. - [Tuvaller](https://docs.solk.app/guides/canvas.md): Beyaz tahta — 67 hazır şablon, yapışkan notlar, 21 şekil, yazı tipi ve stil, akıllı tablo (tablo · pano · zaman çizelgesi görünümü), yapay zekâ blokları ve akış - [İş akışları](https://docs.solk.app/guides/workflows.md): Tetikleyici, koşul ve eylemlerle tekrarlanan işleri otomatikleştirin — periyodik ve tarihe bağlı tetikleyiciler, VE / VEYA koşullar, mesai saati ve hedef, onay, - [Paketler ve abonelik](https://docs.solk.app/guides/plans.md): Solk paketleri, 14 günlük deneme, paket ve koltuk seçimi, iyzico ile ödeme, yükseltme, iptal. - [Görüşme kaydı](https://docs.solk.app/guides/calls.md): Not alıcı Zoom, Google Meet ve Teams toplantılarına katılır; yüz yüze ve telefon görüşmeleri tarayıcıdan kaydedilir. Türkçe döküm, konuşmacılar, özet, içgörüler - [Görüşme zekâsı](https://docs.solk.app/guides/conversation-intelligence.md): Görüşme kayıtları ve ziyaret notları kendiliğinden değerlendirilir — BANT / MEDDIC puan kartı, koçluk önerileri, anahtar kelime izleyicileri ve uyarılar, rakip, - [Davet et ve kazan](https://docs.solk.app/guides/referral.md): Tanıdığınız firmaları Solk'a davet edin; onlar ilk yıl indirim alır, siz fatura kredisi kazanırsınız. - [Yapay zekâ modelleri ve kendi anahtarınız](https://docs.solk.app/guides/ai-models.md): Solk'a sor kutusunda Claude, GPT ve Gemini modelleri arasında seçim; Solk üzerinden ya da firmanın kendi API anahtarıyla bağlantı; kullanım, veri ve sözleşmeler - [Soru şablonları](https://docs.solk.app/guides/prompts.md): Solk'a sor kutusunda hazır sorular — 27 hazır şablon, ekip ve kişisel şablonlar, '/' menüsü, [yer tutucular], sesle yazma. - [Sohbetler](https://docs.solk.app/guides/chats.md): Solk'a sorduklarınız kalıcı — menüde Listeler'in altında, kaldığınız yerden sürdürülür; eski sorular da sohbetlere aktarıldı. - [Ajanlar](https://docs.solk.app/guides/agents.md): Hazır ajanlar zamanında çalışır ve raporu size getirir — haftalık riskli fırsat raporu, 1:1 hazırlık brifi, kayma örüntüsü, kayıp nedeni özeti ve rakip fiyat ka - [CSV ve Excel'den içe aktarma](https://docs.solk.app/guides/import.md): HubSpot, Pipedrive, Zoho ya da kendi tablonuzdaki firma, kişi ve fırsatları sütun eşleyerek içe aktarın; önizleyin, uygulayın, gerekirse geri alın. - [Mükerrer kayıtları birleştirme](https://docs.solk.app/guides/merge.md): Aynı firma, kişi ya da fırsat için açılmış kayıtları alan alan karşılaştırıp tek kayıtta birleştirin. - [Çalışma alanını dışa aktarma](https://docs.solk.app/guides/export.md): Tüm CRM verisini tek ZIP'te, tablo başına bir CSV dosyası olarak indirin — yedek, analiz ya da başka bir sisteme taşıma için. - [Salesforce'tan taşıma](https://docs.solk.app/guides/salesforce-migration.md): Salesforce verinizi Solk'a taşıyın — dışa aktarma dosyası ya da doğrudan bağlantı, önce örnek taşıma, sonra tam taşıma, gerekirse geri alma. ## 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 - [Profil](https://docs.solk.app/rest-api/auth/profile.md): Oturumdaki kullanıcı (user — /me ile aynı tam biçim: photo, color, phone, ui) ve renk paletleri (palettes: key, label, light, dark, on_light, on_dark — ilki fir - [Profili güncelle](https://docs.solk.app/rest-api/auth/profile-save.md): Yalnız gönderilen alanlar değişir; önce hepsi doğrulanır (biri hatalıysa hiçbiri yazılmaz). Palet ve tema web'deki Ayarlar › Görünüm ile aynıdır. PATCH de kabul - [Profil fotoğrafı yükle](https://docs.solk.app/rest-api/auth/profile-photo.md): multipart/form-data alanı photo (ya da Content-Type: image/* ham gövde): JPG, PNG ya da WEBP, en çok 8 MB ve 40 megapiksel. Sunucuda EXIF yönü düzeltilir, ortad - [Profil fotoğrafını kaldır](https://docs.solk.app/rest-api/auth/profile-photo-delete.md): Fotoğrafı sunucudan siler; avatar baş harflere döner. Yanıt: user. - [Kullanıcı fotoğrafı](https://docs.solk.app/rest-api/auth/user-photo.md): Kullanıcının fotoğrafı (image/jpeg). Adresteki ?v= sürümüyle 30 gün önbelleğe alınabilir; ETag + If-None-Match → 304. Fotoğraf yoksa 404. Adres /me, /profile, k - [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 bildirimleri (en yenisi önce) ve okunmamış sayısı. Her satır: kind (tür — mention, comment, task, assign, approval, deal, ticket, email, call, - [Bildirimleri okundu say](https://docs.solk.app/rest-api/workspace/notifications-read.md): Verilen bildirimleri (ya da ids yoksa tümünü) okundu yapar. - [Telefonu bildirimlere kaydet](https://docs.solk.app/rest-api/workspace/push-register.md): Mobil uygulamanın Firebase Cloud Messaging belirtecini bu kullanıcıya ve oturuma kaydeder (aynı belirteç başka kullanıcıdaysa bu kullanıcıya geçer). Oturum kapa - [Telefon kaydını sil](https://docs.solk.app/rest-api/workspace/push-unregister.md): Bu kullanıcının verilen belirteçli cihazını devre dışı bırakır (uygulamada Bu telefonda kapatılınca). removed: kapatılan cihaz sayısı. - [Telefon bildirimi tercihleri](https://docs.solk.app/rest-api/workspace/push-prefs.md): Türler (kinds: k, label, desc, push) — web'deki Ayarlar → Bildirimler'in Telefon sütunu; modülü kapalı türler listelenmez. quiet: sessiz saatler (on, from, to — - [Telefon bildirimi tercihlerini kaydet](https://docs.solk.app/rest-api/workspace/push-prefs-save.md): Yalnız gönderilen türler ve sessiz saatler değişir; zil ve e-posta tercihleri korunur. Yanıt GET /push/prefs ile aynı. - [Bildirimleri dene](https://docs.solk.app/rest-api/workspace/push-test.md): Bu kullanıcının kayıtlı cihazlarına hemen bir deneme bildirimi gönderir (sessiz saat ve saatlik sınır uygulanmaz). - [Solk destek taleplerim](https://docs.solk.app/rest-api/workspace/support.md): Kullanıcının Solk ekibine yazdığı destek talepleri (son hareket önce): id, subject, category + category_label, status (sending gönderiliyor · open açık · answer - [Solk desteğine yaz](https://docs.solk.app/rest-api/workspace/support-new.md): Yeni talep. JSON ya da multipart/form-data: subject, category, body, ctx (isteğe bağlı bağlam — app, device, os, lang, viewport, screen, page; JSON ya da JSON m - [Destek talebi](https://docs.solk.app/rest-api/workspace/support-get.md): Talep ve yazışma: msgs[] (id, side — user | team, author, body, at, sent, files[] — name, mime, size, url), can_close, can_reopen. Talebi açan kullanıcı için ok - [Destek talebine yanıt](https://docs.solk.app/rest-api/workspace/support-reply.md): Kullanıcının yanıtı (body ve / veya files, yeni taleptekiyle aynı kurallar). Çözülmüş ya da kapalı talep yeniden açılır. Yanıt: sent, ticket. - [Talebi kapat / yeniden aç](https://docs.solk.app/rest-api/workspace/support-state.md): close ya da reopen; durum Solk paneline de iletilir. Yanıt: ticket. - [Talep eki](https://docs.solk.app/rest-api/workspace/support-file.md): İletideki i. ek (0'dan) — resimler satır içi, diğerleri indirme olarak. Adres files[].url ile gelir; yalnız talebi açan ve yöneticiler. - [Arayan kimliği listesi](https://docs.solk.app/rest-api/workspace/callerid.md): Kullanıcının görebildiği firma ve kişi numaraları (uluslararası rakamlar, artan sırada): entries = [numara, etiket, firma_id, kişi_id] — etiket Firma · Kişi (sa - [Kartviziti ayrıştır](https://docs.solk.app/rest-api/workspace/card-parse.md): Telefonda okunan (OCR) kartvizit satırlarını alanlara ayırır: ad, unvan, birim, firma, cep / diğer telefon (faks atlanır), e-posta, web, adres, il. Görüntü gönd - [Kartvizitten kişi kaydet](https://docs.solk.app/rest-api/workspace/card-save.md): multipart/form-data (ya da JSON): data (JSON) — customer_id (kayıtlı firma) ya da new_customer {name, website, phone, address, city} ya da contact_id (var olan - [Paylaşım için kayıt öner](https://docs.solk.app/rest-api/workspace/share-suggest.md): Telefondan paylaşılan metin ya da e-posta dosyasından (eml, ilk 64 KB) en çok 5 firma önerir: kayıtlı kişinin e-postası → firması, e-posta alan adı → firma, met - [Paylaşılanı kayda ekle](https://docs.solk.app/rest-api/workspace/share.md): multipart/form-data: seçilen kayda not ve en çok 10 dosya (dosya başına 15 MB; izin verilen türler web'deki dosya ekleriyle aynı). .eml dosyalarının konusu, gön - [Kartvizitim](https://docs.solk.app/rest-api/workspace/my-card.md): Oturumdaki kullanıcının dijital kartviziti (card). Kart ilk çağrıda kendiliğinden oluşur ama yayında değildir (enabled: false). Üst düzey değerler (name, title, - [Kartvizitimi güncelle](https://docs.solk.app/rest-api/workspace/my-card-save.md): Yalnız gönderilen alanlar değişir; yanıt GET /card ile aynıdır. enabled: true kartı yayınlar, false yayından kaldırır. Ad, e-posta, telefon ve fotoğraf profilde - [Kartvizit bağlantısını yenile](https://docs.solk.app/rest-api/workspace/my-card-rotate.md): Yeni bağlantı (token, url) ve yeni QR üretir; eski bağlantı, eski QR kodlar ve basılı kartlar artık açılmaz. Sayaçlar korunur; Apple Wallet'taki kart kendiliğin - [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). - [Rozetler](https://docs.solk.app/rest-api/workspace/badges.md): Okunmamış bildirim ve karar bekleyen onay sayısı (uygulama simgeleri için hafif uç). - [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 - [Firma konumu](https://docs.solk.app/rest-api/companies/geo.md): v66: firma konumunu ayarlar ya da kaldırır (clear: true). Yönetici ya da firmanın sorumlusu. Ziyaretlerde firmaya uzaklık bu noktaya göre hesaplanır. Firma kart - [Firma potansiyeli](https://docs.solk.app/rest-api/companies/potentials.md): Firmanın ürün grubu başına potansiyel satırları (potentials), bölüm ayarı (pot: on, title) ve seçilebilir gruplar (groups). Satır: grp (boş = tüm ürünler; grup - [Firma potansiyelini kaydet](https://docs.solk.app/rest-api/companies/potentials-save.md): Satırların tamamını yazar: gönderilmeyen satır silinir, boş satır atlanır, aynı grup ikinci kez gelirse ilki kalır (en çok 50 satır). Satır: grp (ürün grubu; bo - [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. Kapılar Ayarlar → Aşamalar → Kural - [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). - [Nesneleri listele](https://docs.solk.app/rest-api/objects/objects-list.md): Kurulumda tanımlı ve API'ye ya da mobile açık özel nesneler: anahtar, ad, simge, alanlar (anahtar, tür, seçenekler, zorunlu, Hızlı Giriş'te), bağlantılar (hedef - [Kayıtları listele](https://docs.solk.app/rest-api/objects/records-list.md): Bir nesnenin kayıtları, ada göre sıralı. fields alan anahtarı → değer (tarih YYYY-MM-DD, sayı, seçim metni, çoklu seçim dizi, kişi kullanıcı kimliği); sub kartl - [Kayıt aç](https://docs.solk.app/rest-api/objects/records-create.md): Yeni kayıt açar. Zorunlu alanlar ve seçenekler sunucuda denetlenir (invalid, errors dizisinde tek tek). customer_id verilirse nesnenin firma bağlantısı kurulur; - [Kaydı getir](https://docs.solk.app/rest-api/objects/records-get.md): Kayıt + field_list (etiket, tür, görünen değer, seçenekler), relations (her bağlantı türünde bağlı kayıtlar), web adresi ve editable. - [Kaydı güncelle](https://docs.solk.app/rest-api/objects/records-update.md): Yalnız gönderilen alanlar değişir; fields içinde boş değer alanı temizler. active: false arşive alır, true geri getirir. POST da kabul edilir. - [Kaydı sil](https://docs.solk.app/rest-api/objects/records-delete.md): Kaydı, alan değerlerini, bağlantılarını ve yorumlarını kalıcı siler. Geri getirilebilir bir işlem için active: false ile arşive alın. DELETE desteklemeyen istem - [Kaydı sil (POST)](https://docs.solk.app/rest-api/objects/records-delete-post.md): DELETE gönderemeyen istemciler için Kaydı sil ile aynı işlem. - [Bağlantı ekle / kaldır](https://docs.solk.app/rest-api/objects/records-link.md): Kaydı bir bağlantı türü üzerinden başka bir kayda bağlar (act: add) ya da bağı kaldırır (act: remove). Tekil (N:1) bağlantıda yeni hedef eskisinin yerine geçer. - [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) - [Ziyaretler](https://docs.solk.app/rest-api/activities/visits.md): Ziyaret / görüşme listesi (gün, sonra kayıt anı, yeni önce). Satır: ziyaret alanları + geo (konum özeti — yalnız ziyareti girene ve yöneticiye; diğerlerine null - [Ziyaret](https://docs.solk.app/rest-api/activities/visit.md): Ziyaret ayrıntısı: listedeki satır + contact_phone, contact_title, action_done_at, action_result, nogeo_reason (konum işlenmediyse neden — telefon görüşmesi, ge - [Açık giriş](https://docs.solk.app/rest-api/activities/checkin-state.md): Kullanıcının açık Konumdayım girişi (checkin ya da null) ve ayar (mode — off · optional · required, radius). Giriş: id, customer_id, customer, at, time, minutes - [Konumdayım](https://docs.solk.app/rest-api/activities/checkin.md): Firmaya varışı konumla kaydeder. Firma konumu biliniyorsa uzaklık ve durum (ok · far · low) hesaplanır. Bilinmiyorsa firmanın adresinden bulunan yaklaşık noktay - [Girişi iptal et](https://docs.solk.app/rest-api/activities/checkin-cancel.md): Kullanıcının açık girişini iptal eder (ziyaret kaydedilmeden). - [Yakındaki firmalar](https://docs.solk.app/rest-api/activities/nearby.md): Konuma 5 km içindeki, konumu bilinen firmalar (uzaklığa göre, en çok 8): id, name, city, status, dist, dist_l, here (yarıçap içinde). Ayrıca recent (kullanıcını - [Firmaya uzaklığın dayanağı](https://docs.solk.app/rest-api/activities/firm-geo.md): Ziyaret formunda canlı uzaklık için firmanın dayanak noktası: geo = firma konumu (base: firm) ya da firmanın adresinden bulunan yaklaşık nokta (base: addr, prec - [Ekibin günü](https://docs.solk.app/rest-api/activities/team-day.md): Yalnız yönetici. Satışçı başına günün durakları (stops — ziyaretler ve ziyarete dönüşmeyen girişler, saat sırasıyla: kind, time, customer, type, geo, pt, durati - [Firmanın etkinlik akışı](https://docs.solk.app/rest-api/feed/company-activity.md): Firmadaki her şey tek akışta, yeni önce: e-posta, arama ve SMS, WhatsApp, görüşme ve kayıtlar, teklif ve sipariş, not, yorum, görev, aşama ve değer değişiklikle - [Fırsatın etkinlik akışı](https://docs.solk.app/rest-api/feed/deal-activity.md): Firma akışıyla aynı biçim; yalnız bu fırsata bağlı (ya da bağı tahmin edilen) olaylar. - [Firma akışının damgası](https://docs.solk.app/rest-api/feed/company-activity-stamp.md): v92: akışı kurmadan döner — stamp (16 karakter). Değiştiyse akışı yeniden isteyin; mobil uygulama ekran açıkken 25 saniyede bir sorar. - [Fırsat akışının damgası](https://docs.solk.app/rest-api/feed/deal-activity-stamp.md): v92: firma damgası gibi, fırsat için. - [Firmaya not ekle](https://docs.solk.app/rest-api/feed/company-note.md): v92: akıştaki Not çubuğu. Yanıt: id (notun kimliği). Not akışa hemen düşer; damga değişir. - [Fırsata not ekle](https://docs.solk.app/rest-api/feed/deal-note.md): v92: firma notu gibi; fırsatın son güncelleme tarihi bugün olur. - [Yazışmaları listele](https://docs.solk.app/rest-api/whatsapp/chats.md): v92 (beta): firmanın WhatsApp Business numarasıyla yapılan yazışmalar, son ileti önce (en çok 100). Satır: id, phone, name, profile_name, company_id, company, c - [Yazışmayı getir](https://docs.solk.app/rest-api/whatsapp/chat.md): v92 (beta): chat, messages (eskiden yeniye; id, direction in · out, type, text, has_media, media_name, template, status — pending · sent · delivered · read · fa - [İleti gönder](https://docs.solk.app/rest-api/whatsapp/send.md): v92 (beta): gerçek gönderim. Müşteri son 24 saatte yazdıysa text; değilse yalnız onaylı şablon (template + variables). Pazarlama şablonu yalnız ileti almayı kab - [Yazışma aç](https://docs.solk.app/rest-api/whatsapp/open.md): v92 (beta): numaranın yazışmasını bulur ya da açar ve firmaya bağlar; bir şey göndermez. Yanıt: chat. - [Form yapılandırması](https://docs.solk.app/rest-api/quickentry/qe-config.md): Hızlı Giriş'i çizmek için gereken her şey: şablonlar (blok sırası, st = open açık · chip çip · off gizli, req zorunlu, cond koşul, def varsayılanlar), kullanıcı - [Firma bağlamı](https://docs.solk.app/rest-api/quickentry/qe-context.md): Firma seçilince formu dolduran bilgiler: kişiler, aktif projeler ve varsayılanı, açık fırsatın aşaması, açık aksiyonlar (kapatılabilir), son görüşme, rakip notu - [Nottan öneriler](https://docs.solk.app/rest-api/quickentry/qe-suggest.md): Görüşme notundan kural tabanlı öneriler (dışarıya çağrı yapılmaz, her pakette çalışır): ürün, fiyat ve vade, miktar (ton → kg), deneme sonucu, sonraki adım ve t - [Tarihi çöz](https://docs.solk.app/rest-api/quickentry/qe-when.md): Türkçe doğal dil tarihini çözer: yarın, perşembe, haftaya salı 14:00, ay sonu, 12 kasım, 3 gün sonra. understood: false anlaşılmadı demektir. - [Görüşmeyi kaydet](https://docs.solk.app/rest-api/quickentry/qe-submit.md): Tek istekte görüşme + açık bloklar: firma (yoksa açılır), kişi(ler), proje / fırsat, aşama, ürün, deneme, teklif, sipariş, rakip, pazar payı, fuar leadi ve özel - [Geri al](https://docs.solk.app/rest-api/quickentry/qe-undo.md): Kaydı yapan kullanıcı (ya da yönetici) undo_seconds (varsayılan 600 sn) içinde geri alabilir: açılan kayıtlar silinir, değişen firma / kişi / fırsat alanları ön - [Form yapılandırması](https://docs.solk.app/rest-api/forms/forms-config.md): Yeni fırsat (opp) ya da yeni destek talebi (ticket) formunu çizmek için gereken her şey — Hızlı Giriş'teki gibi: şablonlar (blok sırası, st = open açık · chip ç - [Firma bağlamı](https://docs.solk.app/rest-api/forms/forms-context.md): Formda firma seçilince gelenler: kişiler (ana kişi işaretli), aktif projeler, tüm projeler (all_projects, talepte proje bağlamak için), son 25 sipariş (orders), - [Şablonla kaydet](https://docs.solk.app/rest-api/forms/forms-submit.md): Tek istekte fırsat ya da destek talebi + açık bloklar. Fırsat: firma (yoksa aday olarak açılır; benzer ad → 409 similar, mevcut kaydı seçin ya da confirm_new: t - [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). - [Lead girişi: firma sorgusu](https://docs.solk.app/rest-api/fairs/leads-lookup.md): Lead girerken: kayıtlı firma önerileri (q — Türkçe harf katlamalı; tam ad → başlangıç → kelime başı → içerir), bu fuarda aynı firma / telefon / e-postayla giril - [Lead girişi: firma kartı](https://docs.solk.app/rest-api/fairs/leads-lookup-company.md): Seçilen kayıtlı firmanın kartı + kişileri (contacts: id, name, title, phone, email, main, ini; ana kişi önce) + açık projeleri (opps: id, name, stage, hex, valu - [Aktarma önerisi](https://docs.solk.app/rest-api/fairs/leads-convert-preview.md): CRM'e aktarmadan önce: önerilen firma (match — girişte seçilen kayıtlı firma ya da adı eşleşen; by_link), leadin kişileri ve firmanın kişileriyle önerilen eşlem - [Leadi CRM'e aktar](https://docs.solk.app/rest-api/fairs/leads-convert.md): Leadi firmaya aktarır (web'deki aktarma kartıyla aynı çekirdek): kayıtlı firmaya ya da yeni aday firma olarak; kişiler eşlenen kişiye bağlanır (boş alanları tam - [Toplu işlem](https://docs.solk.app/rest-api/fairs/leads-bulk.md): Seçili leadler (en çok 200): convert — varsayılan eşlemeyle CRM'e aktarır (aktarılmışlar skipped), assign — sorumluyu değiştirir (yetkisizler skipped). Yanıt do - [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 - [Yazışmanın kategorisi](https://docs.solk.app/rest-api/email/threads-category.md): Yazışmanın kategorisini elle seçer (v50; category_source: user — yeni ileti gelse de değişmez) ya da auto ile otomatiğe döndürür (anahtar kelime ve bağlı kayıtt - [Alıcı önerisi](https://docs.solk.app/rest-api/email/recipients.md): Kime / Bilgi alanı için en çok 8 öneri: görünür firmaların kişileri (k: contact, firma adı c, fm firmadan ayrıldı), ekip arkadaşları (k: user) ve açık görünürlü - [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ı - [Sohbetleri listele](https://docs.solk.app/rest-api/ask/chats-list.md): Kullanıcının Solk'a sor sohbetleri (v50), en son konuşulan önce: title, n soru sayısı, star, updated_at, preview son yanıtın kısa metni. Sohbetler kişiseldir — - [Sohbeti getir](https://docs.solk.app/rest-api/ask/chats-get.md): Sohbetin soruları ve yanıtları sırasıyla (messages[]: q, text, blocks, refs — nav ile uygulama ekranı —, mode, model, at). - [Sohbeti adlandır / yıldızla / sil](https://docs.solk.app/rest-api/ask/chats-action.md): rename (title), star (on; gönderilmezse tersine çevirir), delete (sohbet soruları ve yanıtlarıyla kalıcı olarak silinir). - [Son sorular](https://docs.solk.app/rest-api/ask/history.md): Kullanıcının son 12 sorusu ve önerilen sorular. - [Hazır soru şablonları](https://docs.solk.app/rest-api/ask/prompts.md): Kullanıcının görebildiği şablonlar (kişisel, ekibin, hazır) — en çok kullanılan önce; n kullanıcının kullanım sayısı. Yapay zekâ açıksa models Solk'a sor kutusu - [Şablon kullanımını say](https://docs.solk.app/rest-api/ask/prompt-use.md): Şablonun kullanıcıdaki kullanım sayısını bir artırır (listede öne çıkar). - [Notları listele](https://docs.solk.app/rest-api/notes/notes-list.md): Görme yetkiniz olan kayıtların notları, son güncellenen önce. preview biçimsiz düz metin; rec.nav mobil ekran eşlemesi. - [Notu getir](https://docs.solk.app/rest-api/notes/notes-get.md): Başlık, Markdown gövde, bağlı kayıt, yazan, tarih, can_edit (yalnız yazan ya da yönetici), fav ve labels (v48: [{id, name, color, hex}]). - [Not yaz / güncelle](https://docs.solk.app/rest-api/notes/notes-save.md): id yoksa yeni not açar (kayda bağlı olmalı), varsa günceller. mentions içindeki kullanıcılar metinde @Ad Soyad olarak geçiyorsa bildirim alır (notified). Boş no - [Not etiketleri](https://docs.solk.app/rest-api/notes/notes-labels.md): Ekibin ortak etiket listesi (sırasıyla): labels[] = {id, name, color, hex, n} (n görebildiğiniz notlarda kullanım), colors (9 renk), can_create, can_manage (yal - [Etiket aç / düzenle](https://docs.solk.app/rest-api/notes/notes-labels-save.md): id yoksa yeni etiket açar (herkes; aynı ad Türkçe büyük / küçük harf duyarsız var olanı döner — existed: true). id ile ad ve rengi değiştirmek yalnız yöneticini - [Etiketi sil](https://docs.solk.app/rest-api/notes/notes-labels-delete.md): Yalnız yönetici. Etiket notlardan kalkar, notlar silinmez; removed = etiketin kaldırıldığı not sayısı. - [Notun etiketleri](https://docs.solk.app/rest-api/notes/notes-set-labels.md): Notun etiketlerini verilen listeyle değiştirir (en çok 6; silinmiş kimlikler atılır). Notu düzenleyebilen (yazan ya da yönetici) değiştirir; 'Son düzenleme' tar - [Arşivle / arşivden çıkar](https://docs.solk.app/rest-api/notes/notes-archive.md): Notu arşive kaldırır ya da geri getirir (v49). Arşivdeki not silinmez: listelerde, kayıt kartlarında ve yıldızlılarda görünmez, ?archived=1 ile listelenir, teki - [Yıldızla / kaldır](https://docs.solk.app/rest-api/notes/notes-fav.md): Notu kullanıcının yıldızlılarına ekler ya da çıkarır; fav yeni durum. - [Notu sil](https://docs.solk.app/rest-api/notes/notes-delete.md): Yalnız yazan ya da yönetici siler. - [Yorumları listele](https://docs.solk.app/rest-api/comments/comments-list.md): Bir kaydın konuları (kind + obj_id) ya da tüm kayıtlarda süzülmüş konular. Her konu: ilk yorum, yanıtlar, resolved, kayıt (record.nav). n_mentions_open sizden b - [Yorum yaz](https://docs.solk.app/rest-api/comments/comments-add.md): Kayda yeni konu açar ya da reply_to ile yanıtlar (çözülmüş konu yeniden açılır). mentions kullanıcıları metne @Ad Soyad olarak eklenir ve bildirim alır. - [Konuyu çöz / yeniden aç](https://docs.solk.app/rest-api/comments/comments-resolve.md): resolved: false yeniden açar. - [Onay taleplerini listele](https://docs.solk.app/rest-api/approvals/approvals-list.md): todo karar verebileceğiniz bekleyenler, mine açtığınız talepler, done karar verdikleriniz, all (yönetici) hepsi. Her satırda alanlar (info), izin listelerinde b - [Talebi getir](https://docs.solk.app/rest-api/approvals/approvals-get.md): Talep eden, onaylayan ya da karar veren (veya yönetici) görür. - [Onayla / reddet / geri çek](https://docs.solk.app/rest-api/approvals/approvals-decide.md): Onaylayan (ya da yönetici) approve / reject, talebi açan cancel. Kayıt kuraldaki aşamaya taşınır, talep edene bildirim gider. - [Talep formları](https://docs.solk.app/rest-api/approvals/approvals-forms.md): Onay kuralı olan ve kayıt ekleyebildiğiniz listeler (izin, masraf, satın alma …): alanlar (k, l, t, o), izin listesinde kalan gün. İzin listesinde Çalışan (satı - [Talep aç](https://docs.solk.app/rest-api/approvals/approvals-submit.md): Listeye kayıt ekler ve kuraldaki onaya gönderir (web'deki Onaya gönder ile aynı). İzinde iş günü resmî tatiller düşülerek hesaplanır; onaylayan kendisiyse doğru - [Görüşme kayıtlarını listele](https://docs.solk.app/rest-api/calls/calls-list.md): Görebildiğiniz kayıtlar (planlanan ve iptal edilenler hariç), yeni önce. - [Kaydı getir](https://docs.solk.app/rest-api/calls/calls-get.md): Özet, bölümler, aksiyonlar, bölümler zaman çizelgesi, konuşmacı payları ve döküm (en çok 600 parça). v79: intel — görüşme zekâsı değerlendirmesi: method, method - [Kayıt durumu](https://docs.solk.app/rest-api/calls/calls-status.md): İşlenirken yoklama için: status, active. - [Kayıt başlat (yükleme)](https://docs.solk.app/rest-api/calls/calls-record.md): Telefondan alınan ses için kayıt açar ve token döner; ses parça parça /calls/{token}/chunk ile gönderilir, /finish ile döküm başlar. - [Ses parçası gönder](https://docs.solk.app/rest-api/calls/calls-chunk.md): Gövde ham ses baytlarıdır (application/octet-stream, parça başına en çok 8 MB). Parçalar i sırasıyla gelmeli: tekrar gelen parça yok sayılır (dup), atlanan parç - [Kaydı bitir](https://docs.solk.app/rest-api/calls/calls-finish.md): Yüklemeyi kapatır, döküm ve özeti başlatır; id kaydın kimliği. - [Santralden ara](https://docs.solk.app/rest-api/phone/dial.md): Tıkla-ara: önce kullanıcının santraldeki dahilisi çalar, açınca numara aranır (Netgsm, Verimor, AloTech ya da arama başlatma adresi tanımlı santral). number yok - [Süren aramalar](https://docs.solk.app/rest-api/phone/live.md): Kullanıcıya şu an çalan, süren ve az önce biten aramalar (en çok 3) — webdeki arayan kartıyla aynı veri: status (dialing · ringing · answered · done · missed · - [Aramalar ve metrikler](https://docs.solk.app/rest-api/phone/calls.md): Santral aramaları: satır direction, status (done görüşüldü · missed cevapsız · noanswer giden, cevap yok · ringing · answered · lost sonuç bilinmiyor), number, - [SMS penceresi verisi](https://docs.solk.app/rest-api/phone/sms-compose.md): Kayıttan SMS göndermek için: people (kişiler ve firma telefonu — kind, id, label, to, cid, optout), templates (id, name, kind, body), kinds (k info · tacir · bi - [SMS gönder](https://docs.solk.app/rest-api/phone/sms-send.md): Tek SMS. kind: info bilgilendirme (sipariş, sevkiyat, randevu, ödeme — kampanya içermez) · tacir şirketin kurumsal hattına ticari ileti · bireysel İYS onaylı bi - [SMS geçmişi](https://docs.solk.app/rest-api/phone/sms.md): Gönderilen SMS'ler (yeni önce): to, number, body, parts, kind, status (queued · sent · delivered · failed), error, source (single · bulk · flow · api), customer - [Arama listesine ekle](https://docs.solk.app/rest-api/phone/call-list-add.md): Numarayı çağrı merkezinin arama listesine (kampanyasına) ekler — Solveline (Mantis) ya da kayıt ekleme adresi olan diğer çağrı merkezleri. phone yoksa kişinin, - [Arama listesi](https://docs.solk.app/rest-api/phone/call-list.md): Arama listesine eklenenler (yeni önce, push satırları) ve links (bağlı çağrı merkezleri — id, name, provider, campaign, appointments), on. Firma verilmezse satı - [Aranmasın listesine ekle](https://docs.solk.app/rest-api/phone/do-not-call.md): Numarayı Aranmasın listesine alır: arama listelerine bir daha eklenmez ve bağlı çağrı merkezlerinin kara liste adresine yazılır. phone yoksa kişinin, o da yoksa - [Prim dökümü](https://docs.solk.app/rest-api/insights/prim.md): v90: kendi çeyreklik prim dökümünüz: period, label, plan, base (orders · invoices · paid), credited (prime esas tutar), target, attainment (%), rate, prim, adju - [Pipeline özeti](https://docs.solk.app/rest-api/insights/pipeline.md): Açık tutar, ağırlıklı beklenen, Commit / Best Case / Pipeline, dönem akışı (başlangıç → yeni, içeri / dışarı taşınan, artan / azalan, kazanılan, kaybedilen → bi - [Pipeline kayıtları](https://docs.solk.app/rest-api/insights/pipeline-drill.md): Pipeline'daki bir sayının kayıtları — listedeki kayıt sayısı gösterilen sayıyla aynıdır (n). Göstergeler: şelale sütunları start · new · inc · in · out · dec · - [Fırsat panosu](https://docs.solk.app/rest-api/insights/opportunity-board.md): Web'deki Fırsatlar › Pano: açık fırsatlar, duraksayanlar (SLA aşımı ya da inactive_days+ gün hareketsiz), ortalama yaş, satış hızı; dönemde kapanan (kazanılan, - [Fırsat panosu kayıtları](https://docs.solk.app/rest-api/insights/opportunity-board-drill.md): Panodaki bir sayının kayıtları (sayı = liste): open · velocity · age · stalled · won · avg_won · win_days · rate · lost · canc · reason:; aylık grafikler - [Panolar](https://docs.solk.app/rest-api/insights/dashboards.md): Görebildiğiniz panolar, web'deki şerit sırasıyla: önce hazır Satış hattı (home: true), sonra diğerleri. ranges: pano için seçilebilen tarih aralıkları. - [Pano](https://docs.solk.app/rest-api/insights/dashboard.md): Panonun raporları sırayla: id, title, w (0 küçük kutu · 1 yarım · 2 tam genişlik), chart, kind. Verisi her rapor için ayrı uçtan gelir. - [Pano raporunun verisi](https://docs.solk.app/rest-api/insights/dashboard-widget.md): Raporu sizin yetkinizle çalıştırır: data = {chart, kind, labels, series: [{n, c, v}], colors?, total, total_s, unit, insight, goal_pct?, delta?, cols?, table?} - [Grafikten kayıtlar](https://docs.solk.app/rest-api/insights/dashboard-drill.md): Grafikteki bir çubuğun / dilimin kayıtları — listedeki kayıt sayısı grafikteki sayıyla aynıdır. label boşsa raporun tüm kayıtları. labels / sers grafikteki tüm - [Modül panoları](https://docs.solk.app/rest-api/insights/module-boards.md): Açabildiğiniz modül panoları (rows: k, title): tickets Destek talepleri · offers Teklifler · orders Siparişler · contracts Sözleşmeler · fairs Fuar leadleri — p - [Modül panosu](https://docs.solk.app/rest-api/insights/module-board.md): Web panosuyla aynı sayılar: tiles ve flow (k, q kayıtlar sorgusu, title, label, value, suffix — yüzde ya da birim —, sub, dot, bar), charts (title, q, data = R5 - [Modül panosu kayıtları](https://docs.solk.app/rest-api/insights/module-board-drill.md): Panodaki bir sayının kayıtları — kutu / akış adımı için q olduğu gibi, grafik dilimi için grafiğin q'su + i (etiket sırası), label, series. Listedeki kayıt sayı - [Dönem öngörüsü](https://docs.solk.app/rest-api/insights/forecast.md): Ay · çeyrek · yıl: kazanılan, Commit ve Best Case ile tahmin, hedef, yüzde, durum, kapsama, kazanma oranı; kategoriye göre fırsatlar, ay görünümünde 12 ay seris - [Performans (Dashboard)](https://docs.solk.app/rest-api/insights/performance.md): Web Dashboard'unun rakamları: dönem, dört gösterge (T.rate ziyaret verimi — ziyaretten sonraki window gün içinde aynı firmada yeni fırsat, aşama ilerlemesi, den - [Satışçı ayrıntısı](https://docs.solk.app/rest-api/insights/performance-rep.md): Satışçının dönemde ziyaret ettiği firmalar firma firma: ziyaretler ve durumları, fırsat hareketleri (events), açık fırsat sayısı ve tutarı, son ziyaretten yazıl - [Ajan raporlarını listele](https://docs.solk.app/rest-api/agents/runs.md): Görebildiğiniz son ajan raporları, yeni önce: ajanı kurduğunuz, alıcısı olduğunuz raporlar; yönetici hepsini görür. Satır: id, agent_id, template (weekly_risk · - [Ajan raporunu getir](https://docs.solk.app/rest-api/agents/run.md): Listedeki alanlar + kpis (label, value, sub), insights (öne çıkanlar), actions (önerilen adımlar — yapay zekâ özeti varsa onunkiler), ai_summary (yapay zekâ öze - [Firmanın finansı](https://docs.solk.app/rest-api/finance/customer-finance.md): Firmanın ERP'den okunan finans özeti ve satış faturaları: bakiye, vadesi geçen tutar, kredi limiti, risk oranı (bakiye ÷ limit), açık / vadesi geçen fatura sayı - [Ürünün anlık stoğu](https://docs.solk.app/rest-api/finance/product-stock.md): Ürünün ERP'deki o anki miktarı ve depo kırılımı. ERP'ye doğrudan bağlı bağlantılarda canlı okunur ve 10 dakika önbellekte tutulur (cached, at); Solk ERP API ve - [Siparişi ERP'ye gönder](https://docs.solk.app/rest-api/finance/order-send.md): CRM siparişini ana sipariş bağlantısına satış siparişi olarak gönderir: müşterinin PO numarası (customer_po), ERP cari kodu, ürün kodu, miktar, fiyat, döviz, te - [Müşteri PO numarası](https://docs.solk.app/rest-api/finance/order-po.md): Siparişin müşteri satınalma sipariş numarasını (customer_po) yazar ya da boş göndererek siler; boşluklar sadeleşir, en çok 60 karakter. ERP'ye gönderilmiş (sent - [Bağlantıyı dene](https://docs.solk.app/rest-api/erp/ping.md): Anahtarın geçerli olduğunu ve bağlantıda açık veri kümelerini (datasets) döndürür; queued_orders = ERP'ye yazılmayı bekleyen sipariş sayısı. - [Carileri gönder](https://docs.solk.app/rest-api/erp/customers.md): ERP carilerini gönderir; Solk her cariyi CRM firmasıyla eşleştirir — önce vergi numarası, sonra unvan (Türkçe harf ve şirket türü farkı yok). Bağlantıda CRM'de - [Bakiyeleri gönder](https://docs.solk.app/rest-api/erp/balances.md): Cari bakiyelerini günceller: balance (borç − alacak; müşteri borçluysa pozitif), overdue (vadesi geçen), credit_limit, currency. Cari ext_id ya da code ile bulu - [Satış faturalarını gönder](https://docs.solk.app/rest-api/erp/invoices.md): Satış ve iade faturalarını gönderir; firma kartında açık / ödenmiş, vadesi geçen ve son 12 ay ciro bunlardan hesaplanır. customer carinin ext_id'si ya da kodudu - [Ürünleri gönder](https://docs.solk.app/rest-api/erp/products.md): ERP stok kartlarını gönderir; CRM ürünleriyle koddan (yoksa addan) eşleşir. Bağlantıda liste fiyatını güncelle açıksa price ürünün liste fiyatına yazılır. qty v - [Stoğu gönder](https://docs.solk.app/rest-api/erp/stock.md): Ürün koduna göre eldeki miktarı ve depo kırılımını yazar (warehouses: [{name, qty}]; qty yoksa depoların toplamı). Siparişte ve ürün listesinde Stok bu değeri g - [Gönderilecek siparişler](https://docs.solk.app/rest-api/erp/orders.md): ERP'ye yazılmayı bekleyen satış siparişleri (en çok 100): order gövdesinde ref, po, date, due, currency, customer (CRM kimliği, ERP ext_id / code — cari yoksa b - [Sipariş sonucunu bildir](https://docs.solk.app/rest-api/erp/order-ack.md): Siparişin ERP'deki durumunu yazar. status: sent · open · shipped · invoiced · closed · cancelled · error. ext_no ERP'deki belge numarası (sipariş satırında görü - [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, yazma ve kalıcı silme 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)