# iyedy docs

> iyedy is architecture modelling software: one model of your system, its views, its checks, its reviews, and an Assistant that proposes changes a person applies.

Each link is the Markdown version of a page; the page for a browser is the same address without index.html.md. Français : https://docs.iyedy.com/fr/llms.txt

## Get started

- [What is iyedy](https://docs.iyedy.com/get-started/index.html.md): iyedy keeps one model of your system and draws every architecture view from it. Checks, an Assistant and reviews keep the views right.
- [Your first diagram in 10 minutes](https://docs.iyedy.com/get-started/first-diagram/index.html.md): Build the containers view of a small claims platform, check it, ask the Assistant for one change, then save a version you can share.
- [Read a diagram in 2 minutes](https://docs.iyedy.com/get-started/read-a-diagram/index.html.md): Someone shared a diagram with you. Learn to read its view, its title block, its elements and lines, its status stamp and its findings.
- [Key concepts](https://docs.iyedy.com/get-started/concepts/index.html.md): The words iyedy uses: diagram, model, view, element, check, finding, Assistant, proposal, version, review, stamp, workspace, classification, credits.
- [A tour of the editor](https://docs.iyedy.com/get-started/editor/index.html.md): The five zones of the editor: the top bar, the left panel, the canvas with its sheet, the right panel and the status bar, with their keyboard shortcuts.
- [Home and To do](https://docs.iyedy.com/get-started/home/index.html.md): Home is where you land: a box to ask or describe, the To do basket of what waits for you, your recent diagrams, your workspaces and your credits.
- [Create your account and sign in](https://docs.iyedy.com/get-started/account/index.html.md): Create your iyedy account with your e-mail or Google, verify your address with a 6-digit code, then sign in, stay signed in or use your company's sign-in.
- [Change the language](https://docs.iyedy.com/get-started/language/index.html.md): iyedy speaks English by default and French on request. Change the interface language once: your account keeps it on every device.
- [I’m new to iyedy](https://docs.iyedy.com/get-started/new/index.html.md): From your first diagram to a shared version: draw, check, ask the Assistant, save a version and share it. Free plan, no AI needed to start.
- [I was invited to review](https://docs.iyedy.com/get-started/guest/index.html.md): Someone asked for your opinion on a diagram. Read it, give your opinion or your verdict, and comment. Reviewing and commenting are free.
- [I run an organisation](https://docs.iyedy.com/get-started/admin/index.html.md): Set up iyedy for a company: create the organisation, invite members, verify your domain, connect single sign-on and SCIM, then set the AI rules.
- [I connect Claude or the API](https://docs.iyedy.com/get-started/developer/index.html.md): Connect Claude Code to iyedy, learn the MCP tools and how proposals reach your team, then make your first call to the public API with a token.
- [Help and troubleshooting](https://docs.iyedy.com/help/index.html.md): Find the fix for what went wrong: sign-in, saving, the Assistant, Claude, imports, sharing, organisations and billing. Then, if needed, contact support.
- [Sign-in problems](https://docs.iyedy.com/help/sign-in/index.html.md): Fixes for codes that don't arrive or are refused, wrong passwords, Google sign-ins, your company's single sign-on, sessions that end and passkeys.
- [Changes not saved](https://docs.iyedy.com/help/saving/index.html.md): What the status bar's Not saved, Offline, Unsaved and Read-only mean, why a save fails, and how to get your changes back.
- [Contact support](https://docs.iyedy.com/help/contact/index.html.md): Write to iyedy support from the app, with the technical details that help and without any diagram content, or send an idea or a problem as feedback.

## Guides

- [All guides](https://docs.iyedy.com/guides/index.html.md): Every task you can do in iyedy, by topic. Draw and version diagrams, import and export them, work with the Assistant, review, share and run an organisation.
- [Diagrams](https://docs.iyedy.com/diagrams/index.html.md): Create diagrams, draw their elements and relationships, add views, keep versions and present them. One model per diagram, every view drawn from it.
- [Create a diagram](https://docs.iyedy.com/diagrams/create/index.html.md): Start a new diagram in your library, blank, from the sample, from a template or from a description, then give it a name.
- [Find and organise diagrams](https://docs.iyedy.com/diagrams/library/index.html.md): Search the Library, filter it, star the diagrams you use most, clean up the ones you do not, and restore a diagram from the trash.
- [One model, many views](https://docs.iyedy.com/diagrams/views/index.html.md): A diagram holds one model of your system. Every view is drawn from it, so what you change in one view changes everywhere.
- [View types](https://docs.iyedy.com/diagrams/view-types/index.html.md): The twelve view types of iyedy, what each one shows, what it needs in the model and whether iyedy draws it for you.
- [Add a view](https://docs.iyedy.com/diagrams/add-view/index.html.md): Add a view of a chosen type to your diagram, name it, then rename, duplicate, reorder, hide or delete views from the Views list.
- [Add elements and relationships](https://docs.iyedy.com/diagrams/elements/index.html.md): Place elements on the canvas, describe them in the Inspector, connect them with relationships and say what kind each one is.
- [Shapes and official logos](https://docs.iyedy.com/diagrams/shapes/index.html.md): Find a shape or a cloud service in the shape shelf, set an element's logo, choose how a view shows logos, and upload your own.
- [Layers, annotations and grid](https://docs.iyedy.com/diagrams/layers/index.html.md): Choose what a view draws on top of its content, add notes to a view, and use the grid references and the minimap.
- [The title block](https://docs.iyedy.com/diagrams/title-block/index.html.md): The block in the corner of every sheet says what the drawing is, which revision, who made it, its status and its classification, as on a technical drawing.
- [Draw a process in BPMN](https://docs.iyedy.com/diagrams/bpmn/index.html.md): Add a business process to your diagram with the Assistant, open its BPMN view, and keep it next to the architecture that runs it.
- [Draw a sequence or dynamic view](https://docs.iyedy.com/diagrams/sequence/index.html.md): Add a scenario with the Assistant, read it as a Sequence view and as a Dynamic view, and trace it step by step on your other views.
- [Save and restore versions](https://docs.iyedy.com/diagrams/versions/index.html.md): Save a named version to mark a milestone, compare any version with the current one, and restore an earlier state without losing today's.
- [Baseline, transition and target](https://docs.iyedy.com/diagrams/states/index.html.md): A diagram can hold several states of the same architecture, today's, the steps on the way and the target, and iyedy works out what changes between them.
- [Compare states and plan a roadmap](https://docs.iyedy.com/diagrams/roadmap/index.html.md): Show a view in one state compared with another, read the gap between two states and the work that delivers it, and draw the roadmap on a time axis.
- [Present a diagram](https://docs.iyedy.com/diagrams/present/index.html.md): Show your views full screen, one after the other, revealing each view step by step, with a laser pointer, a blank screen and speaker notes.
- [Diagram troubleshooting](https://docs.iyedy.com/diagrams/troubleshooting/index.html.md): What to do when you cannot create, edit, save, draw, version or present a diagram, symptom by symptom, with the app's own messages.
- [Import and export](https://docs.iyedy.com/import-export/index.html.md): Import draw.io, Visio, Mermaid, SVG or PNG. Export SVG, PNG, draw.io, Mermaid, PlantUML or a review pack (PDF).
- [Import a diagram](https://docs.iyedy.com/import-export/import/index.html.md): Turn a draw.io, Visio or Mermaid file, or an SVG or PNG exported from iyedy, into a new diagram, then read what the import kept.
- [What each import keeps](https://docs.iyedy.com/import-export/import-formats/index.html.md): For each file iyedy imports, what becomes part of the model, what is approximated and what is left out.
- [Export a view](https://docs.iyedy.com/import-export/export/index.html.md): Save the view on screen as SVG or PNG, as a draw.io, Mermaid, PlantUML or C4-PlantUML file, or copy it to paste elsewhere.
- [Export formats](https://docs.iyedy.com/import-export/export-formats/index.html.md): Each export format of iyedy, the views it takes, what it keeps and what it loses.
- [Create a review pack (PDF)](https://docs.iyedy.com/import-export/review-pack/index.html.md): Put several views, the open findings, interfaces, decisions, risks and the revision history in one PDF for a review or a sign-off.
- [Import and export troubleshooting](https://docs.iyedy.com/import-export/troubleshooting/index.html.md): What to do when a file does not import, an import misses part of the drawing, or an export, a copy or a PDF pack does not come out.
- [Assistant](https://docs.iyedy.com/assistant/index.html.md): Ask about a diagram, describe a system, review it or model its threats. The Assistant prepares changes; nothing changes until you apply them.
- [What the Assistant does](https://docs.iyedy.com/assistant/overview/index.html.md): One box for every request. The Assistant works out the job from your words, cites your model and shows changes as ghosts you apply yourself.
- [Ask, review, apply](https://docs.iyedy.com/assistant/apply/index.html.md): Ask the Assistant for a change, check the ghosts and the list of changes, then apply them in one step you can undo.
- [Describe a system to get a first draft](https://docs.iyedy.com/assistant/design/index.html.md): Describe your system in a few sentences and get a first model to check and apply, instead of drawing every box by hand.
- [Ask questions about a diagram](https://docs.iyedy.com/assistant/analyse/index.html.md): Ask what depends on what, what a view shows or what changed. Answers cite the elements they rely on and say what the diagram does not state.
- [Find threats with STRIDE](https://docs.iyedy.com/assistant/threats/index.html.md): Threat-model a data-flow view with STRIDE. Every flow that crosses a trust boundary is covered, and the threats join the diagram's review.
- [Bring images and PDFs](https://docs.iyedy.com/assistant/files/index.html.md): Turn a whiteboard photo, a sketch or a written brief into a first model you check and apply. Files are checked for secrets and never kept.
- [Background tasks](https://docs.iyedy.com/assistant/background-tasks/index.html.md): Let a long review, threat model, design or research run on the server while you keep working, or close the page, and open the result when it is ready.
- [Instant answers, free and without AI](https://docs.iyedy.com/assistant/instant/index.html.md): Some answers are computed in your browser. They cost no credits, send nothing, and keep working when the AI is off or you are offline.
- [What the Assistant reads](https://docs.iyedy.com/assistant/what-it-reads/index.html.md): What leaves iyedy with a request, the classification ceiling, what is never sent, and how to see the exact text of your last question.
- [How the Assistant uses credits](https://docs.iyedy.com/assistant/credits/index.html.md): Each AI request uses credits, shown as an estimate before it runs. Instant answers and the checks are free. Only the credits you have left limit the Assistant.
- [Conversations and retention](https://docs.iyedy.com/assistant/conversations/index.html.md): Each diagram keeps your conversation with the Assistant for a set time. Pin notes, start over, clear or delete it whenever you want.
- [Assistant troubleshooting](https://docs.iyedy.com/assistant/troubleshooting/index.html.md): Fixes for the Assistant being off, credits running out, diagrams it does not read, proposals that do not apply and files it refuses.
- [Checks and standards](https://docs.iyedy.com/checks/index.html.md): Checks find reliability, security, data and network gaps on every change, for free. Standards record what your team adopts, decides and accepts.
- [Run checks and handle findings](https://docs.iyedy.com/checks/run/index.html.md): Open the findings of a diagram, see them on the canvas, then fix each one, accept the risk with a reason, request an exception or dismiss it.
- [Check rules](https://docs.iyedy.com/checks/rules/index.html.md): The 36 check rules of iyedy: what each one flags, why it matters and how to fix it, with its default severity.
- [Standards: radar, patterns, decisions, exceptions](https://docs.iyedy.com/checks/standards/index.html.md): One register for what your workspace stands by. The radar says what to use, patterns what to reuse, decisions what was agreed, exceptions what is allowed.
- [Use the technology radar](https://docs.iyedy.com/checks/radar/index.html.md): Rate the technologies your workspace uses (Adopt, Trial, Assess, Hold) with their end-of-life dates, and let the checks flag them in every diagram.
- [Apply a pattern](https://docs.iyedy.com/checks/patterns/index.html.md): Save a proven piece of architecture as a versioned pattern, insert it in other diagrams, and update every copy when a new version is published.
- [Record a decision](https://docs.iyedy.com/checks/decisions/index.html.md): Record an architecture decision with its outcome, conditions and reasons, pinned to the exact version of the diagram it was taken on.
- [Accept an exception](https://docs.iyedy.com/checks/exceptions/index.html.md): Accept a known gap to a standard for a limited time, with its scope, reasons and compensating controls. The checks remind you before it lapses.
- [Review and sharing](https://docs.iyedy.com/review/index.html.md): Sign off a version, ask for an opinion or a review, comment on a view, and share a diagram with the people who need to read it.
- [How review works](https://docs.iyedy.com/review/overview/index.html.md): On your own you sign off your versions; in an organisation colleagues review them. What a verdict covers, the HIGH finding rule, and where the result shows.
- [Sign off your own version](https://docs.iyedy.com/review/author-sign-off/index.html.md): Read the checks, then sign off the current version of a diagram in My diagrams. It becomes Approved, signed off by you.
- [Ask a guest for an opinion](https://docs.iyedy.com/review/ask-for-an-opinion/index.html.md): Before you sign off, ask a person who has access to read the version and give an opinion. Their opinion is recorded; the sign-off stays yours.
- [Request a review](https://docs.iyedy.com/review/request/index.html.md): In an organisation, ask approvers to review a version: who reviews, how many approvals, by when, and what is decided in one sentence.
- [Review and sign off a version](https://docs.iyedy.com/review/sign-off/index.html.md): You were asked to approve a version. Read it on one page, comment where needed, then approve, approve with a condition or request changes.
- [Give your opinion as a guest](https://docs.iyedy.com/review/as-a-guest/index.html.md): Someone invited you to read a diagram and give your opinion. Accept the invitation, sign in for free, read, comment, and say what you think.
- [Comment on a view](https://docs.iyedy.com/review/comments/index.html.md): Comment on an element, a relationship or a view, mention someone with @, reply, then resolve the thread once it is settled.
- [Status stamps](https://docs.iyedy.com/review/stamps/index.html.md): The six stamps a version of a diagram can carry: Draft, In review, Changes requested, Approved, Withdrawn and Superseded, and what sets each one.
- [Share a diagram](https://docs.iyedy.com/review/share/index.html.md): Invite a person to view, comment on or edit one diagram, by e-mail, with an end date if you want one. What each plan allows, and how to take access back.
- [Read-only public links](https://docs.iyedy.com/review/public-links/index.html.md): Show a Public diagram to anyone, without an account, for 90 days at most. Create the link, copy it once, see when it was opened, remove it.
- [Review troubleshooting](https://docs.iyedy.com/review/troubleshooting/index.html.md): An invitation or a link that does not open, a right you do not have, a verdict or a sign-off refused. Each message, what it means and what to do.
- [Organisations](https://docs.iyedy.com/organisations/index.html.md): Create a team, invite members, give roles, decide what the Assistant and Claude may read, and keep a log of who did what.
- [Create an organisation](https://docs.iyedy.com/organisations/create/index.html.md): Create a team in three steps: its name and seats, the people you invite, the diagrams you bring. You finish on the secure payment page.
- [Invite and manage members](https://docs.iyedy.com/organisations/members/index.html.md): Invite people into your organisation as members or guests, change their role, suspend or remove them, decide access requests and export the list.
- [Roles and permissions](https://docs.iyedy.com/organisations/roles/index.html.md): Three layers of roles: the organisation's (Owner to Guest), the account's (billing, security), and each workspace's (Viewer to Owner). Which take a seat.
- [Workspaces](https://docs.iyedy.com/organisations/workspaces/index.html.md): Group diagrams and the people who work on them. Create a workspace, set its default role and its people, rename it, archive it or restore it.
- [Verify your domain](https://docs.iyedy.com/organisations/domain/index.html.md): Prove with a DNS record that your organisation owns its e-mail domain, before single sign-on. There is no screen for it in iyedy yet.
- [Set up single sign-on](https://docs.iyedy.com/organisations/sso/index.html.md): Let your members sign in with your company account, through SAML or OIDC. There is no screen for it in iyedy yet; support helps you meanwhile.
- [Provision users with SCIM](https://docs.iyedy.com/organisations/scim/index.html.md): Create, update and deactivate members from your identity provider with SCIM 2.0. There is no screen for it in iyedy yet.
- [Classification and AI ceiling](https://docs.iyedy.com/organisations/classification/index.html.md): Four levels say what a diagram holds: Public, Internal, Confidential, Restricted. They decide links, guests, and what the Assistant and Claude may read.
- [Turn on the Assistant for your organisation](https://docs.iyedy.com/organisations/ai/index.html.md): In Team and Enterprise, the Assistant is off until an owner accepts the AI addendum. Turn it on, set what it may read, and follow every call.
- [Claude and MCP for your organisation](https://docs.iyedy.com/organisations/mcp/index.html.md): In Team and Enterprise, connected assistants cannot reach your diagrams until support turns MCP on. How to ask, what they may read, what members do next.
- [Dual approval for sensitive changes](https://docs.iyedy.com/organisations/dual-approval/index.html.md): On Enterprise, turning on the Assistant, raising what it may read or turning on web research asks a second owner or security administrator to approve.
- [Audit log](https://docs.iyedy.com/organisations/audit-log/index.html.md): See who did what in your organisation, and when. Filter by members, workspaces, invitations, rules, diagrams or sign-ins. It never holds diagram content.
- [Organisation troubleshooting](https://docs.iyedy.com/organisations/troubleshooting/index.html.md): A member who cannot sign in, an invitation refused, a role or a seat that blocks, a rule that will not save. Each message, what it means and what to do.
- [Plans compared](https://docs.iyedy.com/plans/index.html.md): Free, Pro, Pro+, Team and Enterprise side by side: prices before VAT, editors, active diagrams, AI credits, packs, public links and sign-in.
- [Credits and credit packs](https://docs.iyedy.com/plans/credits/index.html.md): What a credit is, how many each plan gets and when, how the Assistant spends them, the Team pool, and the 500-credit pack.
- [Limits by plan](https://docs.iyedy.com/plans/limits/index.html.md): Every limit that depends on your plan: active diagrams, invited editors, public links, version history, seats, export mention and requests per minute.
- [Free trials](https://docs.iyedy.com/plans/trials/index.html.md): Team has a 14-day trial without a card. Pro has a 15-day trial, offered from our ads, with a card and nothing charged before it ends.
- [Upgrade, change or cancel](https://docs.iyedy.com/plans/change/index.html.md): Move from Free to Pro or Pro+, switch between Pro and Pro+ or monthly and yearly, cancel in one click, or withdraw within 14 days.
- [Manage seats](https://docs.iyedy.com/plans/seats/index.html.md): Add or remove seats on a Team or Enterprise plan, see what an added seat costs today, and know which roles take a seat.
- [Invoices and VAT](https://docs.iyedy.com/plans/invoices/index.html.md): Find and download your invoices, understand why prices are before VAT and what VAT you pay, buy as a business with a VAT number, and update your card.
- [Enterprise](https://docs.iyedy.com/plans/enterprise/index.html.md): What Enterprise adds to Team: SCIM, policies, stricter defaults, two-person approval, audit export, invoices with a purchase order, from 25 seats.
- [Billing troubleshooting](https://docs.iyedy.com/plans/troubleshooting/index.html.md): Fixes for refused payments, credits that did not arrive, packs you cannot buy, a plan that lapsed or paused, and billing screens that do not load.
- [All reference pages](https://docs.iyedy.com/reference/index.html.md): Every reference page of the docs in one place: shortcuts, notation and glossary, then the tables kept next to the guides they serve.
- [Keyboard shortcuts](https://docs.iyedy.com/reference/shortcuts/index.html.md): Every keyboard shortcut of the iyedy editor, by group, as the app's own shortcut sheet lists them. Mod is Ctrl, or ⌘ on a Mac.
- [Notation guide](https://docs.iyedy.com/reference/notation/index.html.md): What each element, deployment node and line style means in an iyedy diagram, with the names the app gives them in English and French.
- [Glossary](https://docs.iyedy.com/reference/glossary/index.html.md): The words of iyedy, one term per object, with its French name. Use it to read the app, the docs and a review in either language.

## Developers

- [Developers](https://docs.iyedy.com/developers/index.html.md): Connect Claude, ChatGPT and other MCP clients to iyedy, call the public API, and link iyedy to Jira, Confluence, Microsoft Teams and your own pages.
- [Connect iyedy to Claude](https://docs.iyedy.com/claude/index.html.md): Work with your architecture diagrams in a Claude conversation. Claude reads your models, runs the checks and prepares changes that a person applies.
- [Use iyedy in Claude Code](https://docs.iyedy.com/claude/code/index.html.md): Add iyedy to Claude Code with one command, sign in once, then ask Claude about your diagrams from your terminal or your editor.
- [What Claude can do with iyedy](https://docs.iyedy.com/claude/what-claude-can-do/index.html.md): Once connected, Claude reads your diagrams, follows dependencies, runs the checks and prepares changes. What it can do, task by task, and what it never does.
- [Claude Team and Enterprise](https://docs.iyedy.com/claude/organisations/index.html.md): Let the members of an iyedy organisation use Claude with their diagrams: turn MCP on, choose the Claude apps you allow, know what each member reaches.
- [Claude troubleshooting](https://docs.iyedy.com/claude/troubleshooting/index.html.md): What to do when Claude cannot connect to iyedy, cannot see a diagram, refuses a call or cuts an answer short.
- [Connect iyedy to ChatGPT](https://docs.iyedy.com/chatgpt/index.html.md): Work with your architecture diagrams in ChatGPT. ChatGPT reads your models, runs the checks and prepares changes that a person applies in iyedy.
- [ChatGPT troubleshooting](https://docs.iyedy.com/chatgpt/troubleshooting/index.html.md): What to do when ChatGPT cannot add or sign in to iyedy, keeps asking you to sign in, cannot see a diagram or cannot submit a proposal.
- [Connect a coding assistant](https://docs.iyedy.com/mcp-clients/index.html.md): Connect Codex, VS Code with GitHub Copilot, Zed, Cursor or Gemini CLI to iyedy's MCP server, sign in once, and work with your diagrams next to your code.
- [Connect iyedy to Codex](https://docs.iyedy.com/mcp-clients/codex/index.html.md): Add iyedy to Codex with one command, sign in once, and let Codex read your architecture diagrams and prepare changes that a person applies.
- [Connect iyedy to VS Code and GitHub Copilot](https://docs.iyedy.com/mcp-clients/vscode/index.html.md): Add iyedy to VS Code with its address, sign in once, and let GitHub Copilot read your architecture diagrams and prepare changes that a person applies.
- [Connect iyedy to Zed](https://docs.iyedy.com/mcp-clients/zed/index.html.md): Add iyedy to Zed with its address, sign in once, and let Zed's agent read your architecture diagrams and prepare changes that a person applies.
- [Connect iyedy to Cursor](https://docs.iyedy.com/mcp-clients/cursor/index.html.md): Add iyedy to Cursor's mcp.json with iyedy's client ID, sign in once, and let Cursor's agent read your architecture diagrams and prepare changes.
- [Connect iyedy to Gemini CLI](https://docs.iyedy.com/mcp-clients/gemini-cli/index.html.md): Add iyedy to Gemini CLI's settings with iyedy's client ID, sign in once, and let Gemini CLI read your architecture diagrams and prepare changes.
- [Coding assistant troubleshooting](https://docs.iyedy.com/mcp-clients/troubleshooting/index.html.md): What to do when Codex, VS Code, Zed, Cursor or Gemini CLI cannot sign in to iyedy, keeps asking you to sign in, or cannot see a diagram.
- [Connect another MCP client](https://docs.iyedy.com/mcp/index.html.md): Connect an MCP client that iyedy's sign-in does not know, such as a CI job or your own agent, to iyedy's MCP server with a personal access token.
- [MCP tools reference](https://docs.iyedy.com/mcp/tools/index.html.md): The 24 tools iyedy offers to Claude and other MCP clients. 22 only read; 2 store a proposal or take one back. Parameters, permissions and answers.
- [Sign-in, permissions and disconnecting](https://docs.iyedy.com/mcp/sign-in/index.html.md): How an MCP client signs in to iyedy, the three permissions you approve, what the client can then reach, and how to take the access back.
- [How proposals reach your team](https://docs.iyedy.com/mcp/proposals/index.html.md): A change from Claude or another MCP client is stored as a proposal. It waits in iyedy until a person who can edit the diagram applies or rejects it.
- [API overview](https://docs.iyedy.com/api/index.html.md): iyedy's public REST API serves your diagrams, views, checks, dependency graph and proposals to scripts and CI jobs, with a token and its scopes.
- [Your first API call](https://docs.iyedy.com/api/quickstart/index.html.md): With a personal access token, find your workspace, list your diagrams and download one view as SVG. Four requests.
- [Create and manage API tokens](https://docs.iyedy.com/api/tokens/index.html.md): Personal access tokens let a script or an MCP client act as you through the API. Their format, lifetime, scopes and rules, and how to revoke one.
- [Service accounts](https://docs.iyedy.com/api/service-accounts/index.html.md): A service account gives a CI job its own identity in one workspace, with tokens that survive the person who made them and an optional list of allowed addresses.
- [Scopes](https://docs.iyedy.com/api/scopes/index.html.md): The four scopes of iyedy tokens, the routes and MCP tools each one opens, and how scopes and roles combine on every request.
- [Endpoints](https://docs.iyedy.com/api/endpoints/index.html.md): The full reference of the API's routes is coming. Until then, the OpenAPI document of the API describes every route and its schemas.
- [Rate limits and errors](https://docs.iyedy.com/api/limits/index.html.md): How many requests iyedy's API and MCP server accept per minute, the headers that tell you where you stand, and every error code with what to do.
- [Propose a change through the API](https://docs.iyedy.com/api/proposals/index.html.md): From a script or a CI job, preview a change to a diagram without storing anything, then submit it as a proposal that a person reviews and applies in iyedy.
- [Command-line tool](https://docs.iyedy.com/api/cli/index.html.md): iyedy's command-line tool is not available to install yet. Meanwhile, call the public API from your scripts and CI jobs, or connect an MCP client.
- [Integrations](https://docs.iyedy.com/integrations/index.html.md): What iyedy connects to today (Jira issues with their status, views embedded in Confluence, Microsoft Teams or any page) and what it does not do.
- [Link Jira issues](https://docs.iyedy.com/integrations/jira/index.html.md): Link a Jira issue, or any tracker's link, to an element, a view, a finding or the whole diagram, and see its live status next to the design.
- [Show a diagram in Confluence](https://docs.iyedy.com/integrations/confluence/index.html.md): Put a live, read-only view of a diagram on a Confluence page with an embed link and the Iframe macro, and revoke it when the page no longer needs it.
- [Show a diagram in Microsoft Teams](https://docs.iyedy.com/integrations/teams/index.html.md): Pin a live, read-only view of a diagram as a tab of a Teams channel, with the iyedy app for Teams and an embed link.
- [Embed a view on a website](https://docs.iyedy.com/integrations/embed/index.html.md): Show a live, read-only view of a diagram on your own site, intranet or documentation, with an iframe or through oEmbed, only on the sites you allow.

## Security and privacy

- [Security and privacy](https://docs.iyedy.com/security/index.html.md): How iyedy protects your diagrams and your account, what the AI reads, how measurement works, and how to leave with your data.
- [Your data](https://docs.iyedy.com/security/your-data/index.html.md): What iyedy stores about you and your diagrams, where it is stored, how it is protected, and who can read it.
- [AI and your diagrams](https://docs.iyedy.com/security/ai/index.html.md): When the Assistant sends something to our AI model provider, what it sends, what never leaves, and how to turn AI off.
- [Assistants connected through MCP](https://docs.iyedy.com/security/ai-clients/index.html.md): What Claude, ChatGPT or another assistant you connect to iyedy can read and change, what iyedy keeps, and how to remove the access.
- [Export your data or delete your account](https://docs.iyedy.com/security/export-and-delete/index.html.md): Download a copy of your account and your diagrams, then, if you want to leave, delete your account and know what happens to your data.
- [Secure your account](https://docs.iyedy.com/security/account/index.html.md): Choose how you sign in, how long iyedy keeps you signed in, and end the sessions you do not recognise.
- [How we test security](https://docs.iyedy.com/security/practices/index.html.md): The standard iyedy checks itself against, the tests that run on every change, and the certifications we do not have yet.
- [Measurement and cookies](https://docs.iyedy.com/security/measurement/index.html.md): How these docs, iyedy.com and the iyedy app measure their audience without cookies, what they never collect, and how to change your choice.
- [Report a vulnerability](https://docs.iyedy.com/security/report/index.html.md): Found a security flaw in iyedy, its sign-in, its API or these docs? Tell us privately, with what we need to reproduce it.
- [Legal](https://docs.iyedy.com/legal/index.html.md): The legal texts of iyedy live on iyedy.com. These docs keep only the trademarks and licences and their own accessibility statement.
- [Trademarks and licences](https://docs.iyedy.com/legal/trademarks/index.html.md): The trademarks these docs and the app cite, the sources and licences of the logos in your diagrams, and the typefaces, icons and tools behind them.
- [Accessibility of these docs](https://docs.iyedy.com/legal/accessibility/index.html.md): The accessibility level these docs aim for, what they are built to support, how they are tested, and how to tell us about a barrier.

## Changelog

- [Changelog](https://docs.iyedy.com/changelog/index.html.md): What changed in iyedy, release by release. Each release says what you will notice, in plain words, with a link to the guide that changed.
- [Coding assistants connect to iyedy](https://docs.iyedy.com/changelog/2026.10.30-3/index.html.md): Codex, VS Code with GitHub Copilot, Zed, Cursor and Gemini CLI connect to iyedy at the same address as Claude and ChatGPT, and sign in with your iyedy account.
- [ChatGPT connects to iyedy](https://docs.iyedy.com/changelog/2026.10.30/index.html.md): Add iyedy to ChatGPT on the web as a custom MCP server with its address, sign in to iyedy and allow. ChatGPT reads your diagrams, runs the checks and prepares proposals.
- [claude.ai, Claude Desktop and the mobile apps connect to iyedy](https://docs.iyedy.com/changelog/2026.10.29/index.html.md): Add iyedy as a custom connector in claude.ai or Claude Desktop with its address, sign in and allow. The Claude mobile apps use the same connector.
- [English by default, and clearer proposals](https://docs.iyedy.com/changelog/2026.10.27/index.html.md): iyedy speaks English unless you choose French, and a proposal from the Assistant never applies or leaves out a change without showing it.