# Midsummer

> Midsummer is the whole vertical for a Project: repositories, CI, Deploy, Database, Storage, Email and Domains, each a product of its own, run from one CLI (`midsummer`), one API and one MCP server.

Every page below is Markdown. `/llms-full.txt` holds all of them in one file.

## Get started

- [Sign in and make a repository](/get-started/sign-in.md): Sign the Midsummer CLI in, make a Team, and make the repository everything else builds on.
- [Ship a Site](/get-started/ship-a-site.md): Push your first version with Sol and ship it as a live Site, then ship a preview and promote it.
- [Add a Database](/get-started/add-a-database.md): Write a Database's schema and functions in db/, deploy them, and call them.
- [Run CI](/get-started/run-ci.md): Add a workflow to .ci/, push it, and watch its run.

## Guides

- [Work in Views](/guides/orbit/work-in-views.md): Make repositories, work in Views, track issues, cut releases and give people access.
- [Run workflows](/guides/ci/run-workflows.md): Write workflows as scripts in .ci/, run them on push and by hand, run them on your own Machines, and set who approves.
- [Ship and promote](/guides/deploy/ship-and-promote.md): Ship a Project, choose where its code comes from, promote and roll back, give it values and attach a domain.
- [Domains](/guides/domains/domains.md): Register a Domain or connect one you have, keep its DNS records, and attach its names to a Site.
- [Build a Database](/guides/database/build-a-database.md): Write a Database in db/, deploy it, branch it with masked data, give outside code a key and keep restore points.
- [Store files](/guides/storage/store-files.md): Make Buckets, give tools a Storage Key, and read and write Objects with any S3 tool or the SDK.
- [Store and query Vectors](/guides/vector-db/store-and-query-vectors.md): Make a Vector namespace, store Vectors with metadata, and find the closest ones.
- [Send and schedule](/guides/queues/send-and-schedule.md): Send Messages to a Queue, deliver them to a path of your Site, and send them on a Schedule.
- [Send email](/guides/email/send-email.md): Verify a Sending domain, send Messages, give your code an Email key, and receive mail in Inboxes.
- [Build an Agent](/guides/agent-os/build-an-agent.md): Make an Agent, put a version in an Environment, run it by hand, on a Schedule or from a webhook, and see what its runs did.
- [Invite your Team](/guides/teams/invite-your-team.md): Make a Team, invite Members, give them roles, add Team agents and see who changed what.
- [Tokens and sign-ins](/guides/identity/tokens-and-sign-ins.md): See where you are signed in, sign one place out, and make personal tokens for scripts.
- [Budgets](/guides/usage/budgets.md): See what a Team spends, and set what a cycle may spend and what happens when it gets there.
- [Notifications](/guides/notifications/notifications.md): Read how your runs and Deployments ended and what waits on you, and choose what reaches your email.
- [Use Git](/guides/git/use-git.md): Clone, fetch and push a repository with Git, and open a merge request from a branch you pushed.
- [Link GitHub](/guides/github/link-github.md): Link a repository to a GitHub repository both ways, so each side's changes reach the other.
- [Scan a repository](/guides/security/scan-a-repository.md): Scan the default branch for leaked secrets, risky dependencies and files, and resolve what it finds.
- [Call Models](/guides/ai-gateway/call-models.md): Ask a Model for your Team, give your code an AI key, and see what calls cost.

## Reference

- [Orbit reference](/reference/products/orbit.md): Every Orbit Action: its command, its HTTP request and its MCP call.
- [issue close](/reference/issue.close.md): Close an issue or discussion
- [issue comment](/reference/issue.comment.md): Comment on an issue; who it @mentions, its author and its assignees are notified
- [issue create](/reference/issue.create.md): Open an issue or a discussion; the Members and Team agents it @mentions are notified
- [issue edit](/reference/issue.edit.md): Change an issue's title or body, or add and remove its labels and assignees
- [issue link](/reference/issue.link.md): Link an issue to a merge request or a View, which closes it on merge unless you say --closes false
- [issue list](/reference/issue.list.md): List a repository's issues and discussions, newest first: open ones unless you say
- [issue reopen](/reference/issue.reopen.md): Reopen a closed issue or discussion
- [issue show](/reference/issue.show.md): Show an issue with its comments, what happened to it and the merge requests and Views linked to it
- [issue start](/reference/issue.start.md): Start a View to work on an issue: it is linked to close the issue, which you take when nobody has it
- [issue unlink](/reference/issue.unlink.md): Take a merge request or View off an issue
- [mr change list](/reference/mr.change.list.md): Show what a merge request changes; --since-review, what changed since your last review
- [mr close](/reference/mr.close.md): Close a merge request without merging it
- [mr comment apply](/reference/mr.comment.apply.md): Apply the changes comments suggest to the merge request's View
- [mr comment create](/reference/mr.comment.create.md): Comment on a merge request, or on one line of a file it changes
- [mr comment resolve](/reference/mr.comment.resolve.md): Mark a merge request's comment resolved
- [mr conflict list](/reference/mr.conflict.list.md): Show the files a merge request conflicts on, with the base, the View and the target
- [mr conflict resolve](/reference/mr.conflict.resolve.md): Resolve a merge request's conflicts: each file's text, or the View's or the target's side
- [mr merge](/reference/mr.merge.md): Merge a merge request: merged, squashed, or only chosen paths, with a release when named
- [mr open](/reference/mr.open.md): Open a merge request from a View; the host reviews its change
- [mr reopen](/reference/mr.reopen.md): Reopen a closed merge request
- [mr review comment create](/reference/mr.review.comment.create.md): Add a comment to your pending review, sent when you review
- [mr review comment delete](/reference/mr.review.comment.delete.md): Take a comment out of your pending review
- [mr review create](/reference/mr.review.create.md): Review a merge request: approve, request changes or comment, sending your pending review's comments with it
- [mr review delete](/reference/mr.review.delete.md): Discard your pending review and its comments
- [mr reviewer add](/reference/mr.reviewer.add.md): Ask people or Team agents to review a merge request
- [mr show](/reference/mr.show.md): Show a merge request, its checks and reviews
- [release create](/reference/release.create.md): Cut a signed release from a branch's head or one of its checkpoints, with notes, to an audience first if asked
- [release delete](/reference/release.delete.md): Delete a release; it can be restored for seven days and its name stays taken
- [release edit](/reference/release.edit.md): Change a release's notes, or who sees it before its reveal time
- [release list](/reference/release.list.md): List a repository's releases
- [release restore](/reference/release.restore.md): Bring back a release deleted in the last seven days
- [release show](/reference/release.show.md): Show a release, its notes and the merge requests it brought in
- [repo activity list](/reference/repo.activity.list.md): What happened in a repository, newest first; --after waits for what happens after a cursor
- [repo audit list](/reference/repo.audit.list.md): Who forked a repository, proposed to it or synced it, and when
- [repo blame](/reference/repo.blame.md): Show who last changed each line of a file
- [repo branch delete](/reference/repo.branch.delete.md): Delete a branch other than the default one
- [repo branch list](/reference/repo.branch.list.md): List the branches, each with how far it is ahead of and behind the base; --deleted lists deleted ones, each at the head it had
- [repo branch restore](/reference/repo.branch.restore.md): Bring back a deleted branch at the head it had
- [repo checkpoint create](/reference/repo.checkpoint.create.md): Save files, edits, deletions and renames to a View as one checkpoint
- [repo checkpoint list](/reference/repo.checkpoint.list.md): List a branch's Checkpoints
- [repo checkpoint show](/reference/repo.checkpoint.show.md): Show what one Checkpoint changed
- [repo collaborator list](/reference/repo.collaborator.list.md): List the people given a role on this repository
- [repo collaborator set](/reference/repo.collaborator.set.md): Give someone a role on this repository, or take it away with null
- [repo compare](/reference/repo.compare.md): Show what changed between two branches, checkpoints or releases
- [repo contributor list](/reference/repo.contributor.list.md): List who made a branch's checkpoints, with each one's share
- [repo create](/reference/repo.create.md): Create a repository
- [repo delete](/reference/repo.delete.md): Delete a repository: its code, history, Views and merge requests become inaccessible at once and can be restored for seven days
- [repo detach](/reference/repo.detach.md): Make a fork of a public repository a repository of its own
- [repo edit](/reference/repo.edit.md): Rename a repository, describe it, set its topics, change who can see it, or archive it
- [repo embargo list](/reference/repo.embargo.list.md): List the embargoes in force that you are in
- [repo embargo reveal](/reference/repo.embargo.reveal.md): End an embargo now: once merged everyone reads it, and before, the merge request is no longer embargoed
- [repo embargo set](/reference/repo.embargo.set.md): Embargo a merge request for chosen Members until its reveal, or change who or when before it merges
- [repo file change list](/reference/repo.file.change.list.md): List the checkpoints that changed a file, each with its diff
- [repo file list](/reference/repo.file.list.md): List the files on a branch, or as they were at one of its checkpoints
- [repo file show](/reference/repo.file.show.md): Read one file on a branch, or as it was at one of its checkpoints
- [repo fork](/reference/repo.fork.md): Fork a repository into a Team you may create repositories in, with every branch you can read and its history
- [repo fork list](/reference/repo.fork.list.md): List a repository's forks
- [repo fork set](/reference/repo.fork.set.md): Keep a fork's default branch up with its original's while it has nothing of its own, or stop
- [repo insights show](/reference/repo.insights.show.md): Show a branch's checkpoints and merged requests by day, and its contributors' shares
- [repo list](/reference/repo.list.md): List a Team's repositories; --deleted lists those deleted in the last seven days, while they can be restored
- [repo network show](/reference/repo.network.show.md): A repository's fork family: its topmost original and every fork below it, each with how far it is ahead and behind
- [repo propose](/reference/repo.propose.md): Propose a fork's branch to the repository it was forked from, or bring its open request up to the branch
- [repo read](/reference/repo.read.md): Read several files on a branch at once, at its head or at a snapshot
- [repo restore](/reference/repo.restore.md): Bring back a deleted repository as it was: its content, settings, collaborators and stars
- [repo restrict](/reference/repo.restrict.md): Keep a View, or a merge request and its View, to chosen Members, or change who
- [repo restriction list](/reference/repo.restriction.list.md): List the Views and merge requests only some people may read
- [repo search](/reference/repo.search.md): Search a branch's code for text
- [repo settings set](/reference/repo.settings.set.md): Set a repository's merge rules
- [repo show](/reference/repo.show.md): Show a repository: its branches, merge requests and clone URL
- [repo star](/reference/repo.star.md): Star a repository, or take the star back
- [repo sync](/reference/repo.sync.md): Bring a fork's branch up to its original: it moves forward, or the original's changes arrive as a merge request in the fork
- [repo transfer](/reference/repo.transfer.md): Move a repository to another Team you manage
- [repo unrestrict](/reference/repo.unrestrict.md): Open a restricted View to everyone with access
- [repo watch](/reference/repo.watch.md): Watch a repository, or stop watching it
- [view change list](/reference/view.change.list.md): Show what a View changes
- [view create](/reference/view.create.md): Start a View from a branch, with nothing changed yet
- [view list](/reference/view.list.md): List the Views pushed to a repository
- [CI reference](/reference/products/ci.md): Every CI Action: its command, its HTTP request and its MCP call.
- [ci artifact download](/reference/ci.artifact.download.md): Download a file a Run kept
- [ci artifact expire](/reference/ci.artifact.expire.md): Remove the files a Run kept, before they expire
- [ci artifact list](/reference/ci.artifact.list.md): List the files a Run kept
- [ci audit list](/reference/ci.audit.list.md): Who changed CI settings, and when
- [ci connection add](/reference/ci.connection.add.md): Connect an outside CI provider; answers its token and signing secret once
- [ci connection artifact list](/reference/ci.connection.artifact.list.md): List the files a connected provider's run kept
- [ci connection edit](/reference/ci.connection.edit.md): Change a connection's organization, project, pipeline, address or provider API token
- [ci connection list](/reference/ci.connection.list.md): List a repository's connections to outside CI providers
- [ci connection remove](/reference/ci.connection.remove.md): Disconnect an outside CI provider
- [ci connection replay](/reference/ci.connection.replay.md): Send a connection's last event again
- [ci connection run approve](/reference/ci.connection.run.approve.md): Approve what a connected provider's run waits on, such as a gated environment or a block step
- [ci connection run cancel](/reference/ci.connection.run.cancel.md): Cancel a connected provider's run
- [ci connection run list](/reference/ci.connection.run.list.md): List a connected provider's recent runs through its API
- [ci connection run logs](/reference/ci.connection.run.logs.md): Read a connected provider's run output
- [ci connection run retry](/reference/ci.connection.run.retry.md): Retry a connected provider's run
- [ci connection run start](/reference/ci.connection.run.start.md): Start a connected provider's run for a merge request's candidate
- [ci connection test](/reference/ci.connection.test.md): Send a signed ping to a connection
- [ci migration show](/reference/ci.migration.show.md): The repository's GitHub Actions workflows turned into Midsummer CI workflows, with what does not carry over
- [ci notification settings set](/reference/ci.notification.settings.set.md): Choose what you hear about from a repository's CI
- [ci notification settings show](/reference/ci.notification.settings.show.md): What you hear about from a repository's CI
- [ci policy set](/reference/ci.policy.set.md): Set who approves runs, the monthly budget and how long artifacts stay
- [ci policy show](/reference/ci.policy.show.md): How a repository's runs are governed
- [ci run approve](/reference/ci.run.approve.md): Approve a Run waiting for approval
- [ci run cancel](/reference/ci.run.cancel.md): Cancel a Run
- [ci run filter delete](/reference/ci.run.filter.delete.md): Remove a Run filter you saved
- [ci run filter list](/reference/ci.run.filter.list.md): List the Run filters you saved
- [ci run filter set](/reference/ci.run.filter.set.md): Save a Run filter by name, replacing one of that name; use it with ci run list --filter <name>
- [ci run list](/reference/ci.run.list.md): List Runs, newest first; --filter <name> applies a Run filter you saved, --before <number> lists older ones
- [ci run reject](/reference/ci.run.reject.md): Reject a Run waiting for approval
- [ci run show](/reference/ci.run.show.md): Show a Run and its output; --follow prints its output live until it ends
- [ci run start](/reference/ci.run.start.md): Start a Workflow; --follow prints its output live until it ends
- [ci usage show](/reference/ci.usage.show.md): How much CI a repository used
- [ci workflow list](/reference/ci.workflow.list.md): List a branch's Workflows
- [ci workflow set](/reference/ci.workflow.set.md): Pause a workflow or resume it
- [machine add](/reference/machine.add.md): Register a machine for the Team's jobs, or with --repository for one repository's; answers its token once (`midsummer runner` does this)
- [machine edit](/reference/machine.edit.md): Change how many jobs a machine takes at once, or drain it
- [machine list](/reference/machine.list.md): List the Team's own machines and where its jobs go; --repository, the hosted machines and the repository's own
- [machine remove](/reference/machine.remove.md): Remove one of the Team's machines, or with --repository one of the repository's
- [machine route set](/reference/machine.route.set.md): Choose where the Team's CI Runs execute: hosted, its Machines first, or its Machines only
- [Deploy reference](/reference/products/deploy.md): Every Deploy Action: its command, its HTTP request and its MCP call.
- [deploy analytics](/reference/deploy.analytics.md): A Site's requests, server errors and latency by the hour, in total and by Deployment, over the last --hours (up to 168)
- [deploy approve](/reference/deploy.approve.md): Approve a build waiting on its Environment, which then builds
- [deploy cancel](/reference/deploy.cancel.md): Stop a Deployment's build, before or while it runs
- [deploy create](/reference/deploy.create.md): Ship a Deployment: a branch's head or the Checkpoint named, files uploaded by SHA-256, or a prebuilt archive; promoted to an Environment once Ready when asked
- [deploy domain add](/reference/deploy.domain.add.md): Attach a name of the Team's Domain to the Site, serving an Environment (production by default) once its DNS points at the Site and its certificate is issued; answers the DNS records it needs
- [deploy domain check](/reference/deploy.domain.check.md): Check an attached name's DNS and certificate now; it serves as soon as both hold
- [deploy domain list](/reference/deploy.domain.list.md): List the names of the Team's Domains attached to the Site, with what each waits on
- [deploy domain remove](/reference/deploy.domain.remove.md): Detach a name from the Site: it stops serving at once, and its certificate and the DNS attaching pointed are let go
- [deploy environment list](/reference/deploy.environment.list.md): What each Environment serves, and where
- [deploy file list](/reference/deploy.file.list.md): Which of these files, by SHA-256, the Project does not have yet: what an upload still has to send
- [deploy list](/reference/deploy.list.md): List Deployments, newest first
- [deploy logs](/reference/deploy.logs.md): A Deployment's build log; --follow prints it live until it ends
- [deploy project create](/reference/deploy.project.create.md): Make a Project: named like a repository, that repository's own; otherwise one of its own, with no repository, shipped from a folder. Takes your default source setting unless given one
- [deploy project list](/reference/deploy.project.list.md): List a Team's Projects: those made with deploy project create, and repositories' that have shipped
- [deploy project show](/reference/deploy.project.show.md): Show a Project: its id, its source setting and its repository, when it has one
- [deploy promote](/reference/deploy.promote.md): Point an Environment at a Ready Deployment; one built with another Environment's values is built again with this one's and promoted once Ready
- [deploy reject](/reference/deploy.reject.md): Reject a build waiting on its Environment, which cancels it
- [deploy rollback](/reference/deploy.rollback.md): Promote the Deployment an Environment served before
- [deploy schedule list](/reference/deploy.schedule.list.md): List the Schedules production's Deployment declares, with when each runs next and how it last ran
- [deploy schedule runs](/reference/deploy.schedule.runs.md): List a Project's Schedule runs, newest first, kept seven days
- [deploy settings set](/reference/deploy.settings.set.md): Choose how the Project's code reaches Deploy: sol pushes the View, git and folder upload it
- [deploy settings show](/reference/deploy.settings.show.md): How the Project's code reaches Deploy: sol, git or folder
- [deploy show](/reference/deploy.show.md): Show a Deployment, by id or number
- [deploy site remove](/reference/deploy.site.remove.md): Take the Project's Site down: its addresses stop answering, and its Deployments are kept seven days, restorable
- [deploy site rename](/reference/deploy.site.rename.md): Rename the Project's address on the app domain; every address moves, and the old ones stop
- [deploy site restore](/reference/deploy.site.restore.md): Bring back a Site taken down in the last seven days, serving what it served
- [deploy site show](/reference/deploy.site.show.md): The Project's address on the app domain
- [deploy source-setting set](/reference/deploy.source-setting.set.md): Choose your default source setting for the Projects you make: sol, git or folder
- [deploy source-setting show](/reference/deploy.source-setting.show.md): Your default source setting, which each Project you make takes
- [env apply](/reference/env.apply.md): Make the values midsummer.json declares and nothing has set yet, and say what still needs you
- [env audit list](/reference/env.audit.list.md): Who changed a Project's Environments and values, and when
- [env delete](/reference/env.delete.md): Delete a value; name its Environment when it has more than one, * for every Environment's
- [env dev end](/reference/env.dev.end.md): End a midsummer dev before its command does
- [env dev start](/reference/env.dev.start.md): Run code on your computer in an Environment: its values, placeholders for secrets bound to hosts, and an identity token
- [env environment delete](/reference/env.environment.delete.md): Remove an Environment's rules; its values stay
- [env environment list](/reference/env.environment.list.md): List a Project's Environments and their rules
- [env environment set](/reference/env.environment.set.md): Set an Environment's rules: the branches that deploy to it, and who approves
- [env identity set](/reference/env.identity.set.md): Set the audience workloads' identity tokens carry, or confirm a cloud trusts them
- [env identity show](/reference/env.identity.show.md): The issuer, audience and subjects clouds trust a Project's workloads by
- [env integration add](/reference/env.integration.add.md): Connect a service with a key that may make keys; it is checked, kept, and never shown again
- [env integration list](/reference/env.integration.list.md): List the services a Team has connected
- [env integration remove](/reference/env.integration.remove.md): Forget a connected service, once no secret made through it remains
- [env key create](/reference/env.key.create.md): Have a connected service make a key and keep it as an Environment's secret, bound to the service's hosts
- [env list](/reference/env.list.md): List the values a Project's Environments give, never a secret's; --deleted lists those deleted in the last seven days
- [env move](/reference/env.move.md): Move a value to one Environment, or to every one; name the one it is in when it has more than one
- [env restore](/reference/env.restore.md): Bring back a deleted value as it was; name its Environment to pick one, * for every Environment's
- [env rotate](/reference/env.rotate.md): Rotate a generated secret, or one an Integration made: its next value now, the one before kept for the overlap, what uses it rebuilt
- [env set](/reference/env.set.md): Set a value for one Environment, or every one: a variable, a secret, one Midsummer generates, or one kept in an outside store (--integration vault --path …)
- [env token create](/reference/env.token.create.md): Make a token that may only write this secret's next value, for something outside Midsummer that rotates it; answered once
- [env token list](/reference/env.token.list.md): List the drop tokens that may write a Project's secrets
- [env token revoke](/reference/env.token.revoke.md): End a drop token at once
- [Domains reference](/reference/products/domains.md): Every Domains Action: its command, its HTTP request and its MCP call.
- [domain add](/reference/domain.add.md): Connect a Domain registered elsewhere, whose DNS stays where it is, so its names can be attached
- [domain edit](/reference/domain.edit.md): Turn a Domain's auto-renew on or off, or set its DNSSEC DS records (none turns DNSSEC off)
- [domain list](/reference/domain.list.md): List the Team's Domains, or with --show deleted those removed in the last seven days, while they can be restored
- [domain quote](/reference/domain.quote.md): Hold a price for five minutes, to register, renew or transfer a Domain
- [domain record add](/reference/domain.record.add.md): Add a DNS record to a Domain registered here; name it @ for the Domain itself
- [domain record list](/reference/domain.record.list.md): List a Domain's DNS records, or with --show deleted those removed in the last seven days, while they can be restored
- [domain record remove](/reference/domain.record.remove.md): Remove a DNS record from a Domain registered here, restorable for seven days
- [domain record restore](/reference/domain.record.restore.md): Add back a DNS record removed in the last seven days, as it was
- [domain register](/reference/domain.register.md): Register a Domain for the Team at its quoted price
- [domain remove](/reference/domain.remove.md): Remove a connected Domain, restorable for seven days; a registered one stays the Team's until it expires
- [domain renew](/reference/domain.renew.md): Renew a Domain registered here at its quoted price
- [domain restore](/reference/domain.restore.md): Bring back a Domain removed in the last seven days, as it was
- [domain search](/reference/domain.search.md): Find names like this one to register, with their prices in US cents for the shortest term each is sold for
- [domain show](/reference/domain.show.md): Show one of the Team's Domains
- [domain transfer](/reference/domain.transfer.md): Move a Domain registered elsewhere here at its quoted price, with the code its registrar gives
- [Database reference](/reference/products/database.md): Every Database Action: its command, its HTTP request and its MCP call.
- [db branch create](/reference/db.branch.create.md): Make a Database from this one, with its rows as they are now or were at a time in the last 7 days; --masked rewrites the columns its mask names, and an agent's branch is always masked
- [db create](/reference/db.create.md): Make an empty Database
- [db data-use list](/reference/db.data-use.list.md): Who read production rows or ran functions by hand, and when
- [db delete](/reference/db.delete.md): Delete a Database, restorable for 7 days, or at once with --now
- [db deploy](/reference/db.deploy.md): Deploy the db/ folder to this Database: at the head of --branch for a Project that ships from Sol, or as a folder or git Project last shipped it (from --branch, when given)
- [db deploy list](/reference/db.deploy.list.md): List a Database's deploys, newest first
- [db key create](/reference/db.key.create.md): Make a key to this Database for code outside Midsummer; answers its secret once
- [db key list](/reference/db.key.list.md): List this Database's keys, newest first, without their secrets
- [db key revoke](/reference/db.key.revoke.md): Revoke a key: it gives no token again, so its access ends within 10 minutes
- [db list](/reference/db.list.md): List the Project's Databases and branches
- [db logs](/reference/db.logs.md): A Database's function logs, oldest first, from --since (the last hour) or --after a page's next
- [db mask list](/reference/db.mask.list.md): List the columns this Database's mask rewrites in a masked branch, and how
- [db mask remove](/reference/db.mask.remove.md): Stop masking a column in new masked branches; never an agent's to do
- [db mask set](/reference/db.mask.set.md): Mask a column (table.field) in masked branches: redact, hash (joins still match) or fake; an agent may add a rule, never change one
- [db metrics show](/reference/db.metrics.show.md): A Database's health over time: calls, errors, slowed and refused calls, and their times
- [db restore](/reference/db.restore.md): Bring back a deleted Database before its rows are purged
- [db restore-point create](/reference/db.restore-point.create.md): Keep this Database's rows as they are now, to restore later; sent again with a name, answers the first
- [db restore-point list](/reference/db.restore-point.list.md): List this Database's restore points, newest first; one a replace took first names what it restored
- [db restore-point restore](/reference/db.restore-point.restore.md): Restore a point into a new branch (--into, restore-<point> by default), or with --replace over this Database's rows after keeping a point of them; --tag makes a retry replace once
- [db rollback](/reference/db.rollback.md): Serve the live deploy before the one this Database serves; rows stay as they are
- [db row list](/reference/db.row.list.md): A page of a table's rows, by id or by an index; --after takes the last page's next
- [db run](/reference/db.run.md): Run one of a Database's functions by hand, internal ones too, as the server or as a user
- [db show](/reference/db.show.md): Show a Database: its address, what it was branched from and the deploy it serves
- [db signing-key rotate](/reference/db.signing-key.rotate.md): Give this Database a new signing key; tokens of the old one work 11 minutes more
- [db table list](/reference/db.table.list.md): List a Database's tables and their rows; production data needs production data access
- [db token create](/reference/db.token.create.md): Exchange a Database Key for a 10-minute token and the Database's address
- [Storage reference](/reference/products/storage.md): Every Storage Action: its command, its HTTP request and its MCP call.
- [storage bucket create](/reference/storage.bucket.create.md): Make a Bucket in an Environment
- [storage bucket delete](/reference/storage.bucket.delete.md): Delete a Bucket that holds no Objects
- [storage bucket list](/reference/storage.bucket.list.md): List an Environment's Buckets
- [storage key create](/reference/storage.key.create.md): Make a Storage Key for S3-protocol tools; answers its secret once
- [storage key list](/reference/storage.key.list.md): List Storage Keys, newest first, without their secrets
- [storage key revoke](/reference/storage.key.revoke.md): Revoke a Storage Key; its next request is refused
- [Vector DB reference](/reference/products/vector-db.md): Every Vector DB Action: its command, its HTTP request and its MCP call.
- [vector delete](/reference/vector.delete.md): Remove Vectors by id; ids not there are not an error
- [vector fetch](/reference/vector.fetch.md): Read Vectors by id, with their values and metadata
- [vector namespace create](/reference/vector.namespace.create.md): Make a Vector namespace in an Environment, its dimension and metric fixed; made again the same way, answers the first
- [vector namespace delete](/reference/vector.namespace.delete.md): Delete a Vector namespace, restorable for 7 days; its name is free at once
- [vector namespace list](/reference/vector.namespace.list.md): List an Environment's Vector namespaces, or with deleted, those still restorable
- [vector namespace restore](/reference/vector.namespace.restore.md): Bring back the Vector namespace by this name deleted last, with its Vectors
- [vector namespace show](/reference/vector.namespace.show.md): Show a Vector namespace: its dimension, metric and how many Vectors it holds
- [vector query](/reference/vector.query.md): Find the Vectors closest to a vector that match a metadata filter, closest first
- [vector upsert](/reference/vector.upsert.md): Store Vectors in a namespace, replacing those with the same ids
- [Queues reference](/reference/products/queues.md): Every Queues Action: its command, its HTTP request and its MCP call.
- [queue consumer remove](/reference/queue.consumer.remove.md): Stop delivering a Queue's Messages; they wait to be received
- [queue consumer set](/reference/queue.consumer.set.md): Deliver a Queue's Messages to a path of the Site, retrying failures, dead-lettering after maxAttempts
- [queue list](/reference/queue.list.md): List an Environment's Queues with their depth, dead-letter count and oldest Message's age
- [queue message create](/reference/queue.message.create.md): Send a Message to a Queue, made on first send; its key sent again within a day answers the first Message
- [queue message list](/reference/queue.message.list.md): List a Queue's Messages, or with --dead its dead-letter Queue's, oldest first, without receiving them
- [queue show](/reference/queue.show.md): Show a Queue: what it holds, how long the oldest Message has waited, and its Consumer
- [schedule create](/reference/schedule.create.md): Make a Schedule that sends a Message to a Queue at the times its cron names, in UTC; its key sent again answers the first
- [schedule delete](/reference/schedule.delete.md): Delete a Schedule; it sends nothing more, and can be restored for seven days
- [schedule list](/reference/schedule.list.md): List an Environment's Schedules and when each sends next; --deleted, those deleted that can be restored
- [schedule restore](/reference/schedule.restore.md): Bring back a Schedule deleted in the last seven days
- [Email reference](/reference/products/email.md): Every Email Action: its command, its HTTP request and its MCP call.
- [email domain add](/reference/email.domain.add.md): Make a Domain the Team holds, or a name under one, a Sending domain of the Project; answers its DNS records, added here when Domains keeps its DNS. Safe to run again
- [email domain check](/reference/email.domain.check.md): Check whether a Sending domain's DNS records answer, and verify it when they do
- [email domain list](/reference/email.domain.list.md): List the Project's Sending domains and whether each is verified, with those removed in the last seven days
- [email domain remove](/reference/email.domain.remove.md): Stop sending from a Sending domain and remove the DNS records added for it, restorable for seven days. Safe to run again
- [email domain restore](/reference/email.domain.restore.md): Bring back a Sending domain removed in the last seven days, as it was, its DNS records added again
- [email domain show](/reference/email.domain.show.md): Show a Sending domain with the DNS records it needs
- [email draft create](/reference/email.draft.create.md): Start a Draft in an Inbox, or in reply in a Thread (--thread), which gives its recipients and subject; with --key, asking again answers that Draft, sent or deleted since
- [email draft delete](/reference/email.draft.delete.md): Delete a Draft, restorable for seven days
- [email draft edit](/reference/email.draft.edit.md): Change a Draft's recipients, subject or words
- [email draft list](/reference/email.draft.list.md): List an Inbox's Drafts, newest first, or with --show deleted those deleted in the last seven days
- [email draft restore](/reference/email.draft.restore.md): Bring back a Draft deleted in the last seven days
- [email draft send](/reference/email.draft.send.md): Send a Draft from its Inbox: it joins its Thread; sending it again answers the message sent
- [email draft show](/reference/email.draft.show.md): Show a Draft
- [email inbox check](/reference/email.inbox.check.md): Look for an Inbox's DNS records; once both are set it is active and receives
- [email inbox create](/reference/email.inbox.create.md): Make an Inbox at an address on a Domain the Team holds, pending until its DNS records are set and checked; --agent makes it an Agent inbox
- [email inbox delete](/reference/email.inbox.delete.md): Delete an Inbox: it receives nothing more, and is restorable for seven days
- [email inbox edit](/reference/email.inbox.edit.md): Rename an Inbox, or give it to an Agent (--agent), or to none (null)
- [email inbox list](/reference/email.inbox.list.md): List the Project's Inboxes, or with --show deleted those deleted in the last seven days
- [email inbox restore](/reference/email.inbox.restore.md): Bring back an Inbox deleted in the last seven days, with its Threads, Drafts and Rules
- [email inbox rule add](/reference/email.inbox.rule.add.md): Add a Rule: mail whose sender, recipients and subject contain what it says is labelled, posted to a webhook or handed to an Agent; answers the webhook's signing secret once
- [email inbox rule list](/reference/email.inbox.rule.list.md): List an Inbox's Rules, in the order they run on what arrives, or with --show deleted those removed in the last seven days
- [email inbox rule remove](/reference/email.inbox.rule.remove.md): Remove a Rule, restorable for seven days; webhooks it still owes are not posted
- [email inbox rule restore](/reference/email.inbox.rule.restore.md): Bring back a Rule removed in the last seven days
- [email inbox show](/reference/email.inbox.show.md): Show an Inbox, by id or address
- [email key create](/reference/email.key.create.md): Make an Email key for the Project's code to send with, through the SDK or as an SMTP password; answers its secret, and with --key the same key however often it is asked
- [email key list](/reference/email.key.list.md): List the Project's Email keys, newest first, without their secrets
- [email key revoke](/reference/email.key.revoke.md): Revoke an Email key; its next send is refused
- [email message list](/reference/email.message.list.md): List the Project's Messages of the last thirty days, newest first
- [email message send](/reference/email.message.send.md): Send a Message from a verified Sending domain; suppressed recipients are left out, and the same key sends once
- [email message show](/reference/email.message.show.md): Show a Message with each recipient's delivery and its delivery events
- [email suppression add](/reference/email.suppression.add.md): Stop sending to an address
- [email suppression list](/reference/email.suppression.list.md): List the addresses the Project no longer sends to: hard bounces, complaints, repeated soft bounces and those added by hand
- [email suppression remove](/reference/email.suppression.remove.md): Send to a suppressed address again, its soft bounces counted from none
- [email thread edit](/reference/email.thread.edit.md): Set a Thread's labels
- [email thread list](/reference/email.thread.list.md): List an Inbox's Threads, last active first; --before <lastAt>:<id> of a page's last Thread for the page after
- [email thread reply](/reference/email.thread.reply.md): Reply in a Thread at once, to whoever last wrote unless --to says; with --key, asking again answers the message sent
- [email thread show](/reference/email.thread.show.md): Show a Thread with its messages, in order
- [email webhook create](/reference/email.webhook.create.md): Post the Project's delivery events to a URL, signed; answers its signing secret, and with --key the same webhook however often it is asked
- [email webhook list](/reference/email.webhook.list.md): List the Project's email webhooks
- [email webhook remove](/reference/email.webhook.remove.md): Stop posting delivery events to a webhook
- [Agent OS reference](/reference/products/agent-os.md): Every Agent OS Action: its command, its HTTP request and its MCP call.
- [agent artifact list](/reference/agent.artifact.list.md): List the files a run kept
- [agent artifact show](/reference/agent.artifact.show.md): Download a file a run kept
- [agent create](/reference/agent.create.md): Make an Agent with its first version from a template, one file, and its Agent inbox; the same --key answers the same Agent
- [agent delete](/reference/agent.delete.md): Delete an Agent: nothing starts its runs; restorable for seven days
- [agent deployment list](/reference/agent.deployment.list.md): Which version each Environment runs, its Schedule and webhook
- [agent deployment rollback](/reference/agent.deployment.rollback.md): Have an Environment run the version it ran before
- [agent deployment set](/reference/agent.deployment.set.md): Have an Environment run a version
- [agent evaluation create](/reference/agent.evaluation.create.md): Run a version on cases ([{input, expected}]) and score it; the same --key answers the same Evaluation
- [agent evaluation list](/reference/agent.evaluation.list.md): An Agent's Evaluations, newest first, with each version's score
- [agent evaluation show](/reference/agent.evaluation.show.md): Show an Evaluation: each case's run, whether it passed, and the score
- [agent event list](/reference/agent.event.list.md): A run's events in order; --after takes the last sequence seen
- [agent list](/reference/agent.list.md): List the Project's Agents, or with --deleted those still restorable
- [agent memory delete](/reference/agent.memory.delete.md): Remove a key from an Agent's memory
- [agent memory list](/reference/agent.memory.list.md): What an Agent keeps in an Environment's memory (production unless named)
- [agent memory set](/reference/agent.memory.set.md): Set a key of an Agent's memory to a JSON value
- [agent restore](/reference/agent.restore.md): Bring back an Agent deleted in the last seven days
- [agent run cancel](/reference/agent.run.cancel.md): End a run: its code's next call is refused
- [agent run list](/reference/agent.run.list.md): List an Agent's runs, newest first
- [agent run show](/reference/agent.run.show.md): Show a run: its status, input, output and what it spent
- [agent run start](/reference/agent.run.start.md): Start a run on an Environment's version (production unless named) or --version; the same --key answers the same run
- [agent schedule remove](/reference/agent.schedule.remove.md): Stop an Environment's Schedule
- [agent schedule set](/reference/agent.schedule.set.md): Start a run at each time a cron names (UTC), such as "0 9 * * 1-5"
- [agent show](/reference/agent.show.md): Show an Agent: its newest version and what each Environment runs
- [agent version create](/reference/agent.version.create.md): Make a version from a file (--source-file agent.ts) or a template; settings left out are the newest version's
- [agent version list](/reference/agent.version.list.md): List an Agent's versions, newest first
- [agent version show](/reference/agent.version.show.md): Show a version with its code; --json and .source give the file
- [agent webhook create](/reference/agent.webhook.create.md): Give an Environment a webhook, ending any before; answers its URL and its secret once
- [agent webhook remove](/reference/agent.webhook.remove.md): Remove an Environment's webhook: its posts are refused
- [Teams reference](/reference/products/teams.md): Every Teams Action: its command, its HTTP request and its MCP call.
- [team agent add](/reference/team.agent.add.md): Add an agent to a Team; answers its token once
- [team agent edit](/reference/team.agent.edit.md): Change what sets an agent to work, its Schedule and instructions, or pause it
- [team agent list](/reference/team.agent.list.md): List a Team's agents
- [team agent run list](/reference/team.agent.run.list.md): List a Team agent's runs, the latest first: what set it to work, where, and what it answered
- [team agent token create](/reference/team.agent.token.create.md): Make a new token for an agent; answered once
- [team audit list](/reference/team.audit.list.md): List who changed what in a Team, from which sign-in, the latest first: --since 7d or a date, --actor a handle, --action a key or its group
- [team create](/reference/team.create.md): Create a Team
- [team delete](/reference/team.delete.md): Delete a Team: it and everything it owns are out of reach at once, and its owners can restore it for seven days
- [team forget](/reference/team.forget.md): End a deleted Team's seven days now: it and everything it owns are forgotten for good
- [team fork-policy set](/reference/team.fork-policy.set.md): Set where a Team's private repositories may be forked: anywhere their settings allow, only within the Team, or nowhere
- [team fork-policy show](/reference/team.fork-policy.show.md): Where a Team's private repositories may be forked
- [team invitation accept](/reference/team.invitation.accept.md): Accept an invitation to a Team
- [team invite](/reference/team.invite.md): Invite someone to a Team by email
- [team member remove](/reference/team.member.remove.md): Remove a Member from a Team
- [team member role set](/reference/team.member.role.set.md): Change a Member's role
- [team restore](/reference/team.restore.md): Bring back a Team deleted in the last seven days, with everything it owns
- [team role delete](/reference/team.role.delete.md): Delete a role the Team made
- [team role list](/reference/team.role.list.md): List a Team's roles and every permission a role can hold
- [team role set](/reference/team.role.set.md): Create a role, or change one the Team made
- [team show](/reference/team.show.md): Show a Team and its Members
- [team token revoke-all](/reference/team.token.revoke-all.md): End every sign-in and personal token of the Team's Members, yours and agents' too, for the Team's resources; Members sign in again and make new tokens (owners)
- [Identity reference](/reference/products/identity.md): Every Identity Action: its command, its HTTP request and its MCP call.
- [me edit](/reference/me.edit.md): Change your name, bio, colour or photo
- [me show](/reference/me.show.md): Show who you are signed in as, and your Teams
- [signin activity list](/reference/signin.activity.list.md): What was changed from one sign-in, the latest first
- [signin list](/reference/signin.list.md): List where you are signed in, the latest first
- [signin revoke](/reference/signin.revoke.md): Sign out one place: its tokens stop working at once, and the others go on
- [token create](/reference/token.create.md): Create a personal token for scripts and CI
- [token list](/reference/token.list.md): List your personal tokens
- [token revoke](/reference/token.revoke.md): Revoke a personal token
- [Usage reference](/reference/products/usage.md): Every Usage Action: its command, its HTTP request and its MCP call.
- [usage budget set](/reference/usage.budget.set.md): Set what a cycle may spend and what happens at it: throttle, pause writes, or keep to a ceiling
- [usage ceiling set](/reference/usage.ceiling.set.md): Set what one resource may spend in a cycle, or null for its default
- [usage lift](/reference/usage.lift.md): Lift a resource's slow-down for unusual usage
- [usage show](/reference/usage.show.md): Show a Team's credits, budget, this cycle's spend by resource, and why anything slowed
- [usage webhook set](/reference/usage.webhook.set.md): Post the Team's usage alerts to a URL as well, or stop; answers the signing secret once
- [Notifications reference](/reference/products/notifications.md): Every Notifications Action: its command, its HTTP request and its MCP call.
- [notification list](/reference/notification.list.md): List your notifications, the newest first: how your runs and deployments ended; --waiting lists what waits on you instead
- [notification read](/reference/notification.read.md): Mark notifications read: those named, or every one; with --repository and --snapshot, a default-branch head as handled, for agents set to work on its changes
- [notification settings set](/reference/notification.settings.set.md): Choose when you are emailed; every notification is in your inbox either way
- [notification settings show](/reference/notification.settings.show.md): Show when you are emailed: important (failures and what waits on you), everything, or nothing
- [Git reference](/reference/products/git.md): Every Git Action: its command, its HTTP request and its MCP call.
- [git merge-request open](/reference/git.merge-request.open.md): Open a merge request from a branch pushed with Git
- [git show](/reference/git.show.md): The repository's Git mirror: its address, and the Git commit each version became
- [GitHub reference](/reference/products/github.md): Every GitHub Action: its command, its HTTP request and its MCP call.
- [github link](/reference/github.link.md): Link a GitHub repository with a token that can push to it, both ways
- [github show](/reference/github.show.md): The GitHub repository this one is linked to, its last sync and the pull requests it took
- [github sync](/reference/github.sync.md): Sync with GitHub now, both ways
- [github unlink](/reference/github.unlink.md): Unlink GitHub; its Views and merge requests stay
- [Security reference](/reference/products/security.md): Every Security Action: its command, its HTTP request and its MCP call.
- [security resolve](/reference/security.resolve.md): Mark a finding resolved, or reopen it
- [security scan](/reference/security.scan.md): Scan the default branch; repeat while files remain
- [security settings set](/reference/security.settings.set.md): Turn security checks on or off
- [security show](/reference/security.show.md): A repository's security checks, last scan and findings
- [AI Gateway reference](/reference/products/ai-gateway.md): Every AI Gateway Action: its command, its HTTP request and its MCP call.
- [ai ask](/reference/ai.ask.md): Ask a Model with an AI key, as a Project's code does through the SDK; answered as ai call create answers
- [ai call create](/reference/ai.call.create.md): Ask a Model for the Team: one prompt or a conversation, answered whole or streamed, with the tokens and credits it spent
- [ai key create](/reference/ai.key.create.md): Make an AI key that reaches every Model for the Team's code; answers its secret once
- [ai key list](/reference/ai.key.list.md): List the Team's AI keys, newest first, without their secrets
- [ai key revoke](/reference/ai.key.revoke.md): Revoke an AI key, by name or id; its next call is refused
- [ai model list](/reference/ai.model.list.md): List the Models a call can name, the default first, with their prices in credits per million tokens
- [ai usage show](/reference/ai.usage.show.md): Show the Team's Model calls since a time (this month unless given): calls, tokens and credits by Model
- [@midsummer/sdk](/reference/sdk/sdk.md): The SDK: the one package a Project's code imports to reach its Capabilities. This entry holds Storage, a Project's Objects in Buckets.
- [@midsummer/sdk/stand-in](/reference/sdk/stand-in.md): Storage's Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It holds no engine code and passes the contract (`@midsummer/sdk/contract`) except durability and scale.
- [@midsummer/sdk/contract](/reference/sdk/contract.md): Storage's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the real Capability runs the same cases against its own engine, through the wire. A behaviour that is not a case here is not promised.
- [@midsummer/sdk/s3](/reference/sdk/s3.md): Storage over the S3 protocol, so the tools and SDKs that speak it reach a Project's Buckets unchanged. `s3(engine, options)` answers one HTTP request from any engine: the Stand-in under `midsummer dev`, or the real Capability's engine on its server. S3 here is the protocol, not a provider.
- [@midsummer/sdk/socket](/reference/sdk/socket.md): Storage's wire over a WebSocket: one connection carries every call, so a client pays for one HTTP request when it connects, not one a call. The frames are the wire's own (`@midsummer/sdk/wire`), each sent with a request id, answered in any order; `remote` batches over it as over HTTP.
- [@midsummer/sdk/ai](/reference/sdk/ai.md): AI: Model calls from a Project's code, through one AI key, streamed or whole, each with the tokens and credits it spent.
- [@midsummer/sdk/ai/stand-in](/reference/sdk/ai-stand-in.md): AI's Stand-in: Model calls answered on this computer, for `midsummer dev` and tests, with no Model behind them. It passes the contract (`@midsummer/sdk/ai/contract`); its answers are only an echo of the question, so code can be run end to end without spending credits.
- [@midsummer/sdk/ai/contract](/reference/sdk/ai-contract.md): AI's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the platform runs the same cases through the wire, against a provider of its own. A behaviour that is not a case here is not promised.
- [@midsummer/sdk/client](/reference/sdk/client.md): Storage from code holding a Storage Key, as an app reaches it: calls are written as usual and travel over one WebSocket, so a client pays for one request when it connects, not one a call. Where a connection cannot open, they travel as batched HTTP, signed with the same key.
- [@midsummer/sdk/server](/reference/sdk/server.md): `@midsummer/sdk/server`: what a Project's `db/` functions are written with. Each file of `db/` is a module of functions, each export a function named `<file>.<export>`, referred to by the client as `api.<file>.<export>`:
- [@midsummer/sdk/database/stand-in](/reference/sdk/database-stand-in.md): The Database's Stand-in, for `midsummer dev`: a Project's own `db/` functions run in memory, with the Database's meaning. Mutations run one at a time, each writing all of what it wrote or none of it; a mutation sent again under the same tag applies once; arguments, answers and writes are checked against their shapes; a watched query is given its value again after every change; the scheduler runs what it is given. It passes the Database's contract (`@midsummer/sdk/database/contract`) except durability and scale, and holds no engine code.
- [@midsummer/sdk/database/contract](/reference/sdk/database-contract.md): What every Database promises its client, as cases any test runner can run. The Database runs them through its own client and wire, and the Stand-in passes the same cases; a behaviour that is not a case here is not promised.
- [@midsummer/sdk/database/errors](/reference/sdk/database-errors.md): Why a Database refused a call, as the client throws it: the same codes from the Stand-in and the Database.
- [@midsummer/sdk/database](/reference/sdk/database.md): `@midsummer/sdk/database`: a Project's Database, from its app or its server.
- [@midsummer/sdk/database/dev-server](/reference/sdk/database-dev-server.md): The Stand-in over the Database's own wire, for `midsummer dev`: the client connects to it as it connects to a Database, so an app runs against it unchanged. One unit, on one WebSocket a client:
- [@midsummer/sdk/agents](/reference/sdk/agents.md): Agents: what an Agent's one file is, and the runtime that runs it. An Agent's file exports its Agent as default:
- [@midsummer/sdk/agents/stand-in](/reference/sdk/agents-stand-in.md): Agents' Stand-in: runs in memory, for running an Agent's file on this computer and in tests. It keeps a run's calls as the platform does, so a run executed again resumes, and it refuses tools the run is not allowed. Its memory is kept between the runs one Stand-in starts.
- [@midsummer/sdk/agents/contract](/reference/sdk/agents-contract.md): Agents' contract: what every place that keeps Agent runs promises, as cases any test runner can run. The Stand-in runs them in this package; the platform runs the same cases through its wire.
- [@midsummer/sdk/queues](/reference/sdk/queues.md): Queues: a Project's Queues of Messages, one set per Environment, reached through the SDK.
- [@midsummer/sdk/queues/stand-in](/reference/sdk/queues-stand-in.md): Queues' Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It holds no engine code and passes the contract (`@midsummer/sdk/queues/contract`) except durability and scale.
- [@midsummer/sdk/queues/contract](/reference/sdk/queues-contract.md): Queues' contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the platform runs the same cases against its own engine, through the wire. A behaviour that is not a case here is not promised.
- [@midsummer/sdk/email](/reference/sdk/email.md): Email from a Project's code: Messages sent from its verified Sending domains.
- [@midsummer/sdk/email/stand-in](/reference/sdk/email-stand-in.md): Email's Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It sends nothing anywhere; what it would send is kept in `sent`. It passes the contract (`@midsummer/sdk/email/contract`) except durability and delivery.
- [@midsummer/sdk/email/contract](/reference/sdk/email-contract.md): Email's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the real Capability runs the same cases against a Project set up with the fixture: `mail.acme.dev` a verified Sending domain, and `suppressed@example.com` suppressed.
- [@midsummer/sdk/email/client](/reference/sdk/email-client.md): Email's wire: code holding an Email key sends through `client`, and the platform answers with `serveMessages`. One Message is one POST of JSON to `<origin>/email/messages` with `authorization: Bearer <the key's secret>`; the answer is the `SentMessage`, or `{ "error": { "code", "message" } }` with the code's status.
- [@midsummer/sdk/email/smtp](/reference/sdk/email-smtp.md): Email for clients that speak only SMTP: a relay that takes mail by SMTP, signed in with an Email key as the password (username `midsummer`), and sends each message through Email's wire, as the SDK's client does. It keeps nothing, so any number of them can run anywhere that can reach the API.
- [@midsummer/sdk/vector](/reference/sdk/vector.md): Vector DB: a Project's Vectors in Vector namespaces, searched by closeness and filtered by their metadata.
- [@midsummer/sdk/vector/stand-in](/reference/sdk/vector-stand-in.md): Vector DB's Stand-in: the Capability's behaviour in memory, for `midsummer dev` and tests. It holds no engine code and passes the contract (`@midsummer/sdk/vector/contract`) except durability and scale. A query is an exact search: every Vector of the namespace is scored, so it answers what an approximate engine aims for.
- [@midsummer/sdk/vector/contract](/reference/sdk/vector-contract.md): Vector DB's contract: what every engine promises, as cases any test runner can run. The Stand-in runs them in this package; the real Capability runs the same cases against its own engine, through the wire. A behaviour that is not a case here is not promised.
- [assistant ask](/reference/assistant.ask.md): Replaced by team agent add. The old name answers until 2026-12-31.
- [branch delete](/reference/branch.delete.md): Replaced by repo branch delete. The old name answers until 2026-12-31.
- [branch deleted](/reference/branch.deleted.md): Replaced by repo branch list. The old name answers until 2026-12-31.
- [branch list](/reference/branch.list.md): Replaced by repo branch list. The old name answers until 2026-12-31.
- [branch restore](/reference/branch.restore.md): Replaced by repo branch restore. The old name answers until 2026-12-31.
- [ci audit](/reference/ci.audit.md): Replaced by ci audit list. The old name answers until 2026-12-31.
- [ci connection run log](/reference/ci.connection.run.log.md): Replaced by ci connection run logs. The old name answers until 2026-12-31.
- [ci connection runs](/reference/ci.connection.runs.md): Replaced by ci connection run list. The old name answers until 2026-12-31.
- [ci connection update](/reference/ci.connection.update.md): Replaced by ci connection edit. The old name answers until 2026-12-31.
- [ci machine list](/reference/ci.machine.list.md): Replaced by machine list. The old name answers until 2026-12-31.
- [ci machine remove](/reference/ci.machine.remove.md): Replaced by machine remove. The old name answers until 2026-12-31.
- [ci machine update](/reference/ci.machine.update.md): Replaced by machine edit. The old name answers until 2026-12-31.
- [ci migration](/reference/ci.migration.md): Replaced by ci migration show. The old name answers until 2026-12-31.
- [ci notifications](/reference/ci.notifications.md): Replaced by ci notification settings show. The old name answers until 2026-12-31.
- [ci notifications set](/reference/ci.notifications.set.md): Replaced by ci notification settings set. The old name answers until 2026-12-31.
- [ci policy](/reference/ci.policy.md): Replaced by ci policy show. The old name answers until 2026-12-31.
- [ci route set](/reference/ci.route.set.md): Replaced by machine route set. The old name answers until 2026-12-31.
- [ci runner add](/reference/ci.runner.add.md): Replaced by machine add. The old name answers until 2026-12-31.
- [ci runner list](/reference/ci.runner.list.md): Replaced by machine list. The old name answers until 2026-12-31.
- [ci runner remove](/reference/ci.runner.remove.md): Replaced by machine remove. The old name answers until 2026-12-31.
- [ci runner update](/reference/ci.runner.update.md): Replaced by machine edit. The old name answers until 2026-12-31.
- [ci usage](/reference/ci.usage.md): Replaced by ci usage show. The old name answers until 2026-12-31.
- [ci workflow enable](/reference/ci.workflow.enable.md): Replaced by ci workflow set. The old name answers until 2026-12-31.
- [db branch](/reference/db.branch.md): Replaced by db branch create. The old name answers until 2026-12-31.
- [db data-uses](/reference/db.data-uses.md): Replaced by db data-use list. The old name answers until 2026-12-31.
- [db deploys](/reference/db.deploys.md): Replaced by db deploy list. The old name answers until 2026-12-31.
- [db metrics](/reference/db.metrics.md): Replaced by db metrics show. The old name answers until 2026-12-31.
- [db rows](/reference/db.rows.md): Replaced by db row list. The old name answers until 2026-12-31.
- [db tables](/reference/db.tables.md): Replaced by db table list. The old name answers until 2026-12-31.
- [db token](/reference/db.token.md): Replaced by db token create. The old name answers until 2026-12-31.
- [deployment approve](/reference/deployment.approve.md): Replaced by deploy approve. The old name answers until 2026-12-31.
- [deployment cancel](/reference/deployment.cancel.md): Replaced by deploy cancel. The old name answers until 2026-12-31.
- [deployment create](/reference/deployment.create.md): Replaced by deploy create. The old name answers until 2026-12-31.
- [deployment files missing](/reference/deployment.files.missing.md): Replaced by deploy file list. The old name answers until 2026-12-31.
- [deployment list](/reference/deployment.list.md): Replaced by deploy list. The old name answers until 2026-12-31.
- [deployment logs](/reference/deployment.logs.md): Replaced by deploy logs. The old name answers until 2026-12-31.
- [deployment promote](/reference/deployment.promote.md): Replaced by deploy promote. The old name answers until 2026-12-31.
- [deployment reject](/reference/deployment.reject.md): Replaced by deploy reject. The old name answers until 2026-12-31.
- [deployment rollback](/reference/deployment.rollback.md): Replaced by deploy rollback. The old name answers until 2026-12-31.
- [deployment serving](/reference/deployment.serving.md): Replaced by deploy environment list. The old name answers until 2026-12-31.
- [deployment show](/reference/deployment.show.md): Replaced by deploy show. The old name answers until 2026-12-31.
- [env audit](/reference/env.audit.md): Replaced by env audit list. The old name answers until 2026-12-31.
- [env deleted](/reference/env.deleted.md): Replaced by env list. The old name answers until 2026-12-31.
- [environment delete](/reference/environment.delete.md): Replaced by env environment delete. The old name answers until 2026-12-31.
- [environment identity](/reference/environment.identity.md): Replaced by env identity show. The old name answers until 2026-12-31.
- [environment identity set](/reference/environment.identity.set.md): Replaced by env identity set. The old name answers until 2026-12-31.
- [environment list](/reference/environment.list.md): Replaced by env environment list. The old name answers until 2026-12-31.
- [environment set](/reference/environment.set.md): Replaced by env environment set. The old name answers until 2026-12-31.
- [git request](/reference/git.request.md): Replaced by git merge-request open. The old name answers until 2026-12-31.
- [integration add](/reference/integration.add.md): Replaced by env key create. The old name answers until 2026-12-31.
- [integration catalog](/reference/integration.catalog.md): Replaced by env integration list. The old name answers until 2026-12-31.
- [integration connect](/reference/integration.connect.md): Replaced by env integration add. The old name answers until 2026-12-31.
- [integration disconnect](/reference/integration.disconnect.md): Replaced by env integration remove. The old name answers until 2026-12-31.
- [integration list](/reference/integration.list.md): Replaced by env integration list. The old name answers until 2026-12-31.
- [invitation accept](/reference/invitation.accept.md): Replaced by team invitation accept. The old name answers until 2026-12-31.
- [machine update](/reference/machine.update.md): Replaced by machine edit. The old name answers until 2026-12-31.
- [mr act](/reference/mr.act.md): Replaced by mr merge. The old name answers until 2026-12-31.
- [mr changes](/reference/mr.changes.md): Replaced by mr change list. The old name answers until 2026-12-31.
- [mr conflicts](/reference/mr.conflicts.md): Replaced by mr conflict list. The old name answers until 2026-12-31.
- [mr since-review](/reference/mr.since-review.md): Replaced by mr change list. The old name answers until 2026-12-31.
- [needs-you](/reference/needs-you.md): Replaced by notification list. The old name answers until 2026-12-31.
- [needs-you seen](/reference/needs-you.seen.md): Replaced by notification read. The old name answers until 2026-12-31.
- [notification settings](/reference/notification.settings.md): Replaced by notification settings show. The old name answers until 2026-12-31.
- [project settings](/reference/project.settings.md): Replaced by deploy settings show. The old name answers until 2026-12-31.
- [project settings set](/reference/project.settings.set.md): Replaced by deploy settings set. The old name answers until 2026-12-31.
- [repo activity](/reference/repo.activity.md): Replaced by repo activity list. The old name answers until 2026-12-31.
- [repo activity after](/reference/repo.activity.after.md): Replaced by repo activity list. The old name answers until 2026-12-31.
- [repo audit](/reference/repo.audit.md): Replaced by repo audit list. The old name answers until 2026-12-31.
- [repo checkpoint](/reference/repo.checkpoint.md): Replaced by repo checkpoint show. The old name answers until 2026-12-31.
- [repo deleted](/reference/repo.deleted.md): Replaced by repo list. The old name answers until 2026-12-31.
- [repo file](/reference/repo.file.md): Replaced by repo file show. The old name answers until 2026-12-31.
- [repo file-history](/reference/repo.file-history.md): Replaced by repo file change list. The old name answers until 2026-12-31.
- [repo files](/reference/repo.files.md): Replaced by repo file list. The old name answers until 2026-12-31.
- [repo forks](/reference/repo.forks.md): Replaced by repo fork list. The old name answers until 2026-12-31.
- [repo git](/reference/repo.git.md): Replaced by git show. The old name answers until 2026-12-31.
- [repo history](/reference/repo.history.md): Replaced by repo checkpoint list. The old name answers until 2026-12-31.
- [repo keep-in-sync](/reference/repo.keep-in-sync.md): Replaced by repo fork set. The old name answers until 2026-12-31.
- [repo network](/reference/repo.network.md): Replaced by repo network show. The old name answers until 2026-12-31.
- [repo restrictions](/reference/repo.restrictions.md): Replaced by repo restriction list. The old name answers until 2026-12-31.
- [repo save](/reference/repo.save.md): Replaced by repo checkpoint create. The old name answers until 2026-12-31.
- [repo settings](/reference/repo.settings.md): Replaced by repo settings set. The old name answers until 2026-12-31.
- [security](/reference/security.md): Replaced by security show. The old name answers until 2026-12-31.
- [security checks set](/reference/security.checks.set.md): Replaced by security settings set. The old name answers until 2026-12-31.
- [signin activity](/reference/signin.activity.md): Replaced by signin activity list. The old name answers until 2026-12-31.
- [site](/reference/site.md): Replaced by deploy site show. The old name answers until 2026-12-31.
- [site rename](/reference/site.rename.md): Replaced by deploy site rename. The old name answers until 2026-12-31.
- [team agent token](/reference/team.agent.token.md): Replaced by team agent token create. The old name answers until 2026-12-31.
- [team agent update](/reference/team.agent.update.md): Replaced by team agent edit. The old name answers until 2026-12-31.
- [team forks](/reference/team.forks.md): Replaced by team fork-policy show. The old name answers until 2026-12-31.
- [team forks set](/reference/team.forks.set.md): Replaced by team fork-policy set. The old name answers until 2026-12-31.
- [team member role](/reference/team.member.role.md): Replaced by team member role set. The old name answers until 2026-12-31.
- [team role save](/reference/team.role.save.md): Replaced by team role set. The old name answers until 2026-12-31.
- [view changes](/reference/view.changes.md): Replaced by view change list. The old name answers until 2026-12-31.

## Concepts

- [Teams and access](/concepts/teams-and-access.md): Who owns what, who may do what, and how agents act for people.
- [Views](/concepts/views.md): A View is the unit of change: one branch of code, of data and a Preview, merged as one.
- [Environments and sealing](/concepts/environments-and-sealing.md): Where values live, why a secret is never read back, and how sealed files stay readable only to their audience.