# Ara Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ara.so/docs/_mcp/server

## Docs

- [Overview](https://ara.so/docs/guides/overview.md): The autonomous code factory.
- [Quickstart](https://ara.so/docs/guides/quickstart.md): From zero to a change request in five minutes.
- [Concepts](https://ara.so/docs/guides/concepts.md): Five objects. That is the whole model.
- [Sessions](https://ara.so/docs/guides/sessions.md): One agent run, from prompt to change request.
- [Repositories](https://ara.so/docs/guides/repositories.md): Connect code, index it, then run agents against it.
- [Code review](https://ara.so/docs/guides/code-review.md): Review pull requests and merge requests safely.
- [Agent context and tools](https://ara.so/docs/guides/agent-context-and-tools.md): Give agents native memory, instructions, credentials, and external tools.
- [Automations](https://ara.so/docs/guides/automations.md): Scheduled work, security checks, and factory loops.
- [Software factory](https://ara.so/docs/guides/automations/software-factory.md): Compose audit and fix automations into one loop.
- [Security automation](https://ara.so/docs/guides/automations/security-automation.md): File concrete security findings on a schedule.
- [API keys and access](https://ara.so/docs/guides/api-keys-and-access.md): Keys, service users, scopes, and roles.
- [Environment](https://ara.so/docs/guides/environment.md): Prepare a repository once, then let every session start from the right place.
- [Operating at scale](https://ara.so/docs/guides/operating-at-scale.md): Watch usage, work, cost, and team activity.

## API Docs

- API Reference > Organizations [List organizations](https://ara.so/docs/api-reference/api-reference/organizations/list-organizations.md)
- API Reference > Organizations [Create an organization](https://ara.so/docs/api-reference/api-reference/organizations/create-organization.md)
- API Reference > Organizations [Retrieve an organization](https://ara.so/docs/api-reference/api-reference/organizations/get-organization.md)
- API Reference > Organizations [Delete an organization](https://ara.so/docs/api-reference/api-reference/organizations/delete-organization.md)
- API Reference > Organizations [Update an organization](https://ara.so/docs/api-reference/api-reference/organizations/update-organization.md)
- API Reference > Attachments [List attachments](https://ara.so/docs/api-reference/api-reference/attachments/list-attachments.md)
- API Reference > Attachments [Upload an attachment](https://ara.so/docs/api-reference/api-reference/attachments/create-attachment.md)
- API Reference > Attachments [Download an attachment](https://ara.so/docs/api-reference/api-reference/attachments/download-attachment.md)
- API Reference > Attachments [Download an attachment (named)](https://ara.so/docs/api-reference/api-reference/attachments/download-attachment-with-filename.md)
- API Reference > Audit Logs [List audit log entries](https://ara.so/docs/api-reference/api-reference/audit-logs/list-audit-logs.md)
- API Reference > Automations [List automations](https://ara.so/docs/api-reference/api-reference/automations/list-automations.md)
- API Reference > Automations [Create an automation](https://ara.so/docs/api-reference/api-reference/automations/create-automation.md)
- API Reference > Automations [Retrieve an automation](https://ara.so/docs/api-reference/api-reference/automations/get-automation.md)
- API Reference > Automations [Delete an automation](https://ara.so/docs/api-reference/api-reference/automations/delete-automation.md)
- API Reference > Automations [Update an automation](https://ara.so/docs/api-reference/api-reference/automations/update-automation.md)
- API Reference > Automations [List an automation's triggers](https://ara.so/docs/api-reference/api-reference/automations/list-automation-triggers.md)
- API Reference > Automations [Add a trigger to an automation](https://ara.so/docs/api-reference/api-reference/automations/create-automation-trigger.md)
- API Reference > Automations [Remove a trigger from an automation](https://ara.so/docs/api-reference/api-reference/automations/delete-automation-trigger.md)
- API Reference > Consumption [Get daily consumption](https://ara.so/docs/api-reference/api-reference/consumption/get-daily-consumption.md)
- API Reference > Environment [List environment builds](https://ara.so/docs/api-reference/api-reference/environment/list-environment-builds.md)
- API Reference > Environment [Trigger an environment image build](https://ara.so/docs/api-reference/api-reference/environment/create-environment-build.md)
- API Reference > Environment [Get an environment build](https://ara.so/docs/api-reference/api-reference/environment/get-environment-build.md)
- API Reference > Environment [Cancel an environment build](https://ara.so/docs/api-reference/api-reference/environment/cancel-environment-build.md)
- API Reference > Environment [Pin an environment build](https://ara.so/docs/api-reference/api-reference/environment/pin-environment-build.md)
- API Reference > Environment [Unpin the build's repo](https://ara.so/docs/api-reference/api-reference/environment/unpin-environment-build.md)
- API Reference > Environment [Get the environment recipe](https://ara.so/docs/api-reference/api-reference/environment/get-environment-recipe.md)
- API Reference > Environment [Create or update the environment recipe](https://ara.so/docs/api-reference/api-reference/environment/put-environment-recipe.md)
- API Reference > Environment [Get the repo runbook](https://ara.so/docs/api-reference/api-reference/environment/get-environment-runbook.md)
- API Reference > Environment [Create or update the repo runbook](https://ara.so/docs/api-reference/api-reference/environment/put-environment-runbook.md)
- API Reference > Environment [Get the session-start script](https://ara.so/docs/api-reference/api-reference/environment/get-environment-session-start-script.md)
- API Reference > Git Connections [List git connections (deprecated)](https://ara.so/docs/api-reference/api-reference/git-connections/list-git-connections.md)
- API Reference > Git Connections [List repositories for a git connection (deprecated)](https://ara.so/docs/api-reference/api-reference/git-connections/list-git-connection-repositories.md)
- API Reference > Git Plugins [List git plugins](https://ara.so/docs/api-reference/api-reference/git-plugins/list-git-plugins.md)
- API Reference > Git Plugins [List repositories for a git plugin](https://ara.so/docs/api-reference/api-reference/git-plugins/list-git-plugin-repositories.md)
- API Reference > Repositories [List indexed repositories](https://ara.so/docs/api-reference/api-reference/repositories/list-indexed-repositories.md)
- API Reference > Repositories [List repositories](https://ara.so/docs/api-reference/api-reference/repositories/list-repositories.md)
- API Reference > Repositories [Bulk index repositories](https://ara.so/docs/api-reference/api-reference/repositories/bulk-index-repositories.md)
- API Reference > Repositories [Bulk remove repositories](https://ara.so/docs/api-reference/api-reference/repositories/bulk-remove-repositories.md)
- API Reference > Repositories [Disconnect a repository](https://ara.so/docs/api-reference/api-reference/repositories/delete-repository.md)
- API Reference > Repositories [Delete a repository branch](https://ara.so/docs/api-reference/api-reference/repositories/delete-repository-branch.md)
- API Reference > Repositories [Get repository guardrails](https://ara.so/docs/api-reference/api-reference/repositories/get-repository-guardrails.md)
- API Reference > Repositories [Update repository guardrails](https://ara.so/docs/api-reference/api-reference/repositories/update-repository-guardrails.md)
- API Reference > Repositories [Index a repository](https://ara.so/docs/api-reference/api-reference/repositories/index-repository.md)
- API Reference > Repositories [Get indexing status](https://ara.so/docs/api-reference/api-reference/repositories/get-indexing-status.md)
- API Reference > Repositories [Get repository wiki](https://ara.so/docs/api-reference/api-reference/repositories/get-repository-wiki.md)
- API Reference > Repositories [Export repository wiki](https://ara.so/docs/api-reference/api-reference/repositories/export-repository-wiki.md)
- API Reference > Knowledge [List knowledge folders](https://ara.so/docs/api-reference/api-reference/knowledge/list-knowledge-folders.md)
- API Reference > Knowledge [List notes](https://ara.so/docs/api-reference/api-reference/knowledge/list-notes.md)
- API Reference > Knowledge [Create a note](https://ara.so/docs/api-reference/api-reference/knowledge/create-note.md)
- API Reference > Knowledge [Retrieve a note](https://ara.so/docs/api-reference/api-reference/knowledge/get-note.md)
- API Reference > Knowledge [Update a note](https://ara.so/docs/api-reference/api-reference/knowledge/update-note.md)
- API Reference > Knowledge [Delete a note](https://ara.so/docs/api-reference/api-reference/knowledge/delete-note.md)
- API Reference > Mcp Servers [List MCP servers](https://ara.so/docs/api-reference/api-reference/mcp-servers/list-mcp-servers.md)
- API Reference > Mcp Servers [Create an MCP server](https://ara.so/docs/api-reference/api-reference/mcp-servers/create-mcp-server.md)
- API Reference > Mcp Servers [Retrieve an MCP server](https://ara.so/docs/api-reference/api-reference/mcp-servers/get-mcp-server.md)
- API Reference > Mcp Servers [Delete an MCP server](https://ara.so/docs/api-reference/api-reference/mcp-servers/delete-mcp-server.md)
- API Reference > Mcp Servers [Update an MCP server](https://ara.so/docs/api-reference/api-reference/mcp-servers/update-mcp-server.md)
- API Reference > Members [List members](https://ara.so/docs/api-reference/api-reference/members/list-members.md)
- API Reference > Members [Invite a member](https://ara.so/docs/api-reference/api-reference/members/invite-member.md)
- API Reference > Members [Get a member](https://ara.so/docs/api-reference/api-reference/members/get-member.md)
- API Reference > Members [Remove a member](https://ara.so/docs/api-reference/api-reference/members/remove-member.md)
- API Reference > Members [Set a member's role](https://ara.so/docs/api-reference/api-reference/members/set-member-role.md)
- API Reference > Memory [List repository memory notes](https://ara.so/docs/api-reference/api-reference/memory/list-memory-notes.md)
- API Reference > Memory [Create a repository memory note](https://ara.so/docs/api-reference/api-reference/memory/create-memory-note.md)
- API Reference > Memory [Retrieve a repository memory note](https://ara.so/docs/api-reference/api-reference/memory/get-memory-note.md)
- API Reference > Memory [Forget a repository memory note](https://ara.so/docs/api-reference/api-reference/memory/forget-memory-note.md)
- API Reference > Memory [Update a repository memory note](https://ara.so/docs/api-reference/api-reference/memory/update-memory-note.md)
- API Reference > Metrics [Get usage metrics](https://ara.so/docs/api-reference/api-reference/metrics/get-usage-metrics.md)
- API Reference > Metrics [Get queue status](https://ara.so/docs/api-reference/api-reference/metrics/get-queue-status.md)
- API Reference > Change Request Reviews [List change request reviews](https://ara.so/docs/api-reference/api-reference/change-request-reviews/list-pr-reviews.md)
- API Reference > Change Request Reviews [Trigger a change request review](https://ara.so/docs/api-reference/api-reference/change-request-reviews/trigger-pr-review.md)
- API Reference > Roles [List role assignments](https://ara.so/docs/api-reference/api-reference/roles/list-role-assignments.md)
- API Reference > Roles [Set a role assignment](https://ara.so/docs/api-reference/api-reference/roles/set-role-assignment.md)
- API Reference > Roles [Get the caller's role](https://ara.so/docs/api-reference/api-reference/roles/get-own-role.md)
- API Reference > Roles [Get a member's role](https://ara.so/docs/api-reference/api-reference/roles/get-role-assignment.md)
- API Reference > Secrets [List secret names](https://ara.so/docs/api-reference/api-reference/secrets/list-secrets.md)
- API Reference > Secrets [Create or update a secret](https://ara.so/docs/api-reference/api-reference/secrets/set-secret.md)
- API Reference > Secrets [Delete a secret](https://ara.so/docs/api-reference/api-reference/secrets/delete-secret.md)
- API Reference > Sessions [List sessions](https://ara.so/docs/api-reference/api-reference/sessions/list-sessions.md)
- API Reference > Sessions [Create a session](https://ara.so/docs/api-reference/api-reference/sessions/create-session.md)
- API Reference > Sessions [List sessions with insights](https://ara.so/docs/api-reference/api-reference/sessions/list-sessions-with-insights.md)
- API Reference > Sessions [Retrieve a session](https://ara.so/docs/api-reference/api-reference/sessions/get-session.md)
- API Reference > Sessions [Delete a session](https://ara.so/docs/api-reference/api-reference/sessions/delete-session.md)
- API Reference > Sessions [Archive a session](https://ara.so/docs/api-reference/api-reference/sessions/archive-session.md)
- API Reference > Sessions [List attachments](https://ara.so/docs/api-reference/api-reference/sessions/list-session-attachments.md)
- API Reference > Sessions [Download an attachment](https://ara.so/docs/api-reference/api-reference/sessions/get-session-attachment.md)
- API Reference > Sessions [Cancel a session](https://ara.so/docs/api-reference/api-reference/sessions/cancel-session.md)
- API Reference > Sessions [Get session insights](https://ara.so/docs/api-reference/api-reference/sessions/get-session-insight.md)
- API Reference > Sessions [Generate session insights](https://ara.so/docs/api-reference/api-reference/sessions/generate-session-insight.md)
- API Reference > Sessions [List messages](https://ara.so/docs/api-reference/api-reference/sessions/list-session-messages.md)
- API Reference > Sessions [Send a message](https://ara.so/docs/api-reference/api-reference/sessions/send-session-message.md)
- API Reference > Sessions [List session tags](https://ara.so/docs/api-reference/api-reference/sessions/list-session-tags.md)
- API Reference > Sessions [Append session tags](https://ara.so/docs/api-reference/api-reference/sessions/append-session-tags.md)
- API Reference > Sessions [Replace session tags](https://ara.so/docs/api-reference/api-reference/sessions/replace-session-tags.md)
- API Reference > Settings [List organization settings](https://ara.so/docs/api-reference/api-reference/settings/list-settings.md)
- API Reference > Settings [Get a settings namespace](https://ara.so/docs/api-reference/api-reference/settings/get-setting.md)
- API Reference > Settings [Update a settings namespace](https://ara.so/docs/api-reference/api-reference/settings/update-setting.md)
- API Reference > Setup [Ranked repo setup suggestions](https://ara.so/docs/api-reference/api-reference/setup/get-setup-helper.md)
- API Reference > Skills [List skills](https://ara.so/docs/api-reference/api-reference/skills/list-skills.md)
- API Reference > Skills [Create a skill](https://ara.so/docs/api-reference/api-reference/skills/create-skill.md)
- API Reference > Skills [Retrieve a skill](https://ara.so/docs/api-reference/api-reference/skills/get-skill.md)
- API Reference > Skills [Update a skill](https://ara.so/docs/api-reference/api-reference/skills/update-skill.md)
- API Reference > Skills [Delete a skill](https://ara.so/docs/api-reference/api-reference/skills/delete-skill.md)
- API Reference > Account [Verify credentials](https://ara.so/docs/api-reference/api-reference/account/get-self.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://ara.so/openapi.json)
- [OpenAPI YAML](https://ara.so/openapi.yaml)