merIDK / Diagram types / Sequence diagram
Mermaid sequence diagram: example and syntax
Sequence diagrams show how participants such as users, services and databases exchange messages over time. They are the standard way to document API calls, login flows and service-to-service interactions.
Open this example in the editor
Example code
sequenceDiagram
autonumber
actor U as User
box Backend
participant A as API
participant DB as Database
end
U->>+A: POST /login
A->>+DB: SELECT user
DB-->>-A: row
alt valid password
A-->>U: 200 + token
else invalid
A-->>U: 401
end
loop every 15 min
U->>A: refresh token
end
Note over U,A: Token expires after 1 hour
deactivate A
Result
sequenceDiagram
autonumber
actor U as User
box Backend
participant A as API
participant DB as Database
end
U->>+A: POST /login
A->>+DB: SELECT user
DB-->>-A: row
alt valid password
A-->>U: 200 + token
else invalid
A-->>U: 401
end
loop every 15 min
U->>A: refresh token
end
Note over U,A: Token expires after 1 hour
deactivate ASyntax quick reference
- Messages:
A->>B: textsolid,A-->>Bdashed reply. - Add
+or-after the arrow to activate or deactivate a participant. - Blocks:
alt / else / end,loop,opt,par,critical. autonumbernumbers every message.
How to use it
- Open the example in the editor, or paste your own Mermaid code.
- Edit the code on the left. The preview updates as you type, and errors point to the line.
- Export SVG or PNG, copy a Markdown block for GitHub or Notion, or copy a share link.