> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/release-notes/cloudeka-api/ai-dekaclaw/create-an-instance.md).

# Create an instance

Create a new instance in the specified project.

```json
{"openapi":"3.1.1","info":{"title":"Cloudeka AI - API Documentation","version":"1.0.0"},"tags":[{"name":"AI Dekaclaw","description":"API endpoints for AI Dekaclaw (base: /core/dekaclaw)"}],"servers":[{"url":"https://ai.cloudeka.id/"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"description":"Type 'Bearer ' followed by your JWT token. Example: \"Bearer eyJhbGciOi...\"","type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ai_dekaclaw__response.Result":{"type":"object","properties":{"data":{},"message":{"type":"string"},"status":{"type":"boolean"}}},"ai_dekaclaw__response.ResError":{"type":"object","properties":{"errors":{},"message":{"type":"string"},"status":{"type":"boolean"}}},"ai_dekaclaw__request.CreateInstanceRequest":{"type":"object","required":["item_id","name","project_id","provider_api_key"],"properties":{"channel_token":{"type":"string"},"channel_type":{"type":"string"},"created_at":{"type":"string"},"deleted_at":{"type":"string"},"image_id":{"type":"string"},"image_os_id":{"type":"string"},"instance_amount":{"type":"integer"},"item_id":{"type":"string"},"name":{"type":"string","maxLength":100,"minLength":5},"package_instance_id":{"type":"string"},"package_storage_type_name":{"type":"string"},"password_manual":{"type":"string","minLength":8},"project_id":{"type":"string"},"provider_api_key":{"type":"string"},"server_group_id":{"type":"string"},"ssh_key_id":{"type":"array","items":{"type":"string"}},"storages":{"type":"array","items":{"$ref":"#/components/schemas/ai_dekaclaw__request.CreateInstanceStorageRequest"}},"tags":{"description":"VpcID                     string                         `json:\"vpc_id\" validate:\"required,xss_clean\" conform:\"trim\"`","type":"string"},"updated_at":{"type":"string"},"vm_root_disk_custom_service_id":{"type":"string"},"vm_root_disk_custom_size":{"type":"integer"},"vm_root_disk_id":{"type":"string"},"vm_root_disk_type_id":{"type":"string"},"voucher_id":{"type":"string"}}},"ai_dekaclaw__request.CreateInstanceStorageRequest":{"type":"object","properties":{"custom_size":{"type":"integer"},"package_storage_id":{"type":"string"},"package_storage_type_id":{"type":"string"}}}}},"paths":{"/core/dekaclaw/instances":{"post":{"description":"Create a new instance in the specified project.","tags":["AI Dekaclaw","Instance"],"summary":"Create an instance","responses":{"200":{"description":"Instance created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ai_dekaclaw__response.Result"}}}},"400":{"description":"Invalid request or failed to create instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ai_dekaclaw__response.ResError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ai_dekaclaw__request.CreateInstanceRequest"}}},"description":"Instance details","required":true}}}}}
```