> ## Documentation Index > Fetch the complete documentation index at: https://docs.case.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create agent > Creates a new agent definition with a scoped API key. The agent can then be used to create and execute runs. ## OpenAPI ````yaml /openapi.json post /agent/v1/agents openapi: 3.1.0 info: title: Case.dev API description: >- The AI-native platform for legal technology. Build smarter legal applications with our suite of AI-powered APIs. version: 1.0.0 contact: name: Case.dev Support email: support@casemark.com url: https://case.dev license: name: Proprietary url: https://case.dev/terms servers: - url: https://api.case.dev description: Production security: - bearerAuth: [] tags: - name: Vaults description: Secure document storage with semantic search and GraphRAG - name: Memory description: >- Persistent memory for AI agents with semantic search and 12 generic indexed tag fields - name: OCR description: Extract text from PDFs, images, and scanned documents - name: Voice description: Audio transcription and text-to-speech - name: LLMs description: Access 40+ language models through a unified API - name: Search description: Web search, AI answers, and deep research - name: Mail description: Managed inboxes for agent email workflows - name: Media description: Transcript retrieval and captioned media clip generation - name: Legal description: Legal research tools including citation verification - name: Privilege description: Privilege detection for e-discovery and litigation workflows - name: Compute description: Serverless GPU and CPU infrastructure - name: Format description: Document formatting and template rendering (MD/JSON to PDF/DOCX) - name: SuperDoc description: Document conversion and template automation - name: Webhooks description: Webhook endpoint management - name: System description: Public system metadata and discovery endpoints - name: Usage description: Usage reporting and webhook subscriptions - name: Database description: Serverless PostgreSQL databases with instant branching - name: Translation description: Language detection and translation for multilingual legal workflows - name: Skills description: Search and read legal AI skills for agents - name: Agents description: >- Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows - name: Matters description: Matter-native legal workspaces and orchestration primitives - name: Applications Projects description: Web application project management - name: Applications Deployments description: Web application deployment management - name: Applications Domains description: Custom domain configuration for applications - name: Applications Env Vars description: Environment variable management for applications paths: /agent/v1/agents: post: tags: - Agents summary: Create agent description: >- Creates a new agent definition with a scoped API key. The agent can then be used to create and execute runs. operationId: createAgent requestBody: required: true content: application/json: schema: type: object required: - name - instructions properties: name: type: string description: Display name for the agent description: type: string description: Optional description of the agent instructions: type: string description: System instructions that define agent behavior model: type: string description: >- LLM model identifier (e.g. anthropic/claude-sonnet-4.6). Defaults to anthropic/claude-sonnet-4.6 vaultIds: type: array items: type: string nullable: true description: Restrict agent to specific vault IDs vaultGroups: type: array items: type: string nullable: true description: Restrict agent to vaults within specific vault group IDs enabledTools: type: array items: type: string nullable: true description: >- Allowlist of tools the agent can use. Mutually exclusive with disabledTools — set one or the other, not both. disabledTools: type: array items: type: string nullable: true description: >- Denylist of tools the agent cannot use. Mutually exclusive with enabledTools — set one or the other, not both. sandbox: type: object nullable: true description: Custom sandbox configuration (cpu, memoryMiB) properties: cpu: type: integer description: Number of CPUs memoryMiB: type: integer description: Memory in MiB responses: '200': description: Agent created content: application/json: schema: type: object properties: id: type: string name: type: string description: type: string nullable: true instructions: type: string model: type: string vaultIds: type: array items: type: string nullable: true enabledTools: type: array items: type: string nullable: true disabledTools: type: array items: type: string nullable: true sandbox: type: object nullable: true createdAt: type: string format: date-time updatedAt: type: string format: date-time '400': description: Missing required fields (name, instructions) content: application/json: schema: type: object properties: statusCode: type: integer statusMessage: type: string message: type: string '401': description: Invalid API key content: application/json: schema: type: object properties: statusCode: type: integer statusMessage: type: string message: type: string '403': description: No agent access content: application/json: schema: type: object properties: statusCode: type: integer statusMessage: type: string message: type: string components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: API key starting with `sk_case_` ````