> ## Documentation Index > Fetch the complete documentation index at: https://help.onetsolutions.net/llms.txt > Use this file to discover all available pages before exploring further. # [Tasks] Retry a failed task > Submit a new task with the same type and parameters as a failed or cancelled one. The new task runs immediately if the instance is free, and queues behind the current task otherwise. The original task is left untouched, so the history keeps both attempts. ## OpenAPI ````yaml https://api.onetsolutions.net/schema post /v1/organizations/{organization_id}/projects/{project_id}/compute/instances/{instance_id}/tasks/{id}/retry openapi: 3.0.3 info: title: OnetSolutions API version: v1 (v1) description: > ## Overview The OnetSolutions API provides programmatic access to manage your cloud infrastructure, domains, and web hosting services. ## Authentication All API requests require authentication using one of the following methods: - **JWT Token**: Obtain a token via login endpoints and include it in the `Authorization: Bearer ` header - **API Key**: Generate an API key from your account settings and use it as `Authorization: Bearer sk-onetsolutions-...` ## Rate Limiting API requests are rate-limited to ensure fair usage: - **Standard**: 1000 requests per minute - **Burst**: 100 requests per second ## Pagination List endpoints return paginated results. Use `page` and `page_size` query parameters. ## Error Handling The API uses standard HTTP status codes: - `200` Success - `201` Created - `400` Bad Request - `401` Unauthorized - `403` Forbidden - `404` Not Found - `429` Too Many Requests servers: - url: https://api.onetsolutions.net description: Production security: [] tags: - name: Authentication description: >- Login, passwordless authentication, MFA, OAuth providers, and token management. - name: Organizations description: >- Organization management, members, roles, modules, audit logs, and notification settings. - name: Projects description: Project management, team members, and project-scoped resources. - name: Compute description: >- Cloud instances, volumes, snapshots, backups, VPCs, firewalls, SSH keys, uptime monitors, and instance tasks. - name: Domains description: >- Domain availability, registration, transfers, DNS zones, DNS records, and TLD information. - name: Web Hosting description: >- cPanel-based web hosting, emails, databases, subdomains, FTP accounts, addon domains, and SSL certificates. paths: /v1/organizations/{organization_id}/projects/{project_id}/compute/instances/{instance_id}/tasks/{id}/retry: post: tags: - Compute summary: '[Tasks] Retry a failed task' description: >- Submit a new task with the same type and parameters as a failed or cancelled one. The new task runs immediately if the instance is free, and queues behind the current task otherwise. The original task is left untouched, so the history keeps both attempts. operationId: retry_instance_task parameters: - in: path name: id schema: type: string format: uuid description: A UUID string identifying this Instance Task. required: true - in: path name: instance_id schema: type: string format: uuid required: true - in: path name: organization_id schema: type: string format: uuid required: true - in: path name: project_id schema: type: string format: uuid required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/InstanceTask' description: '' '400': description: Only a failed or cancelled task can be retried '403': description: Instance not active or not attached to a hypervisor '404': description: Task not found security: - BearerAuth: [] components: schemas: InstanceTask: type: object properties: id: type: string format: uuid readOnly: true instance_id: type: string format: uuid readOnly: true instance: allOf: - $ref: '#/components/schemas/TaskInstance' readOnly: true task_type: enum: - create_vps - start_vps - stop_vps - reboot_vps - shutdown_vps - reset_vps - resize_vps - change_hostname - reinstall_os - assign_ip - remove_ip - update_reverse_dns - update_vpc - apply_firewall - create_snapshot - delete_snapshot - restore_snapshot - create_backup - delete_backup - restore_backup - create_image_from_snapshot - delete_image - create_volume - attach_volume - detach_volume - resize_volume - delete_volume - attach_gpu - detach_gpu - install_software - uninstall_software - get_vnc_url - sync_vps_state - apply_config type: string description: |- * `create_vps` - Create Instance * `start_vps` - Start Instance * `stop_vps` - Stop Instance * `reboot_vps` - Reboot Instance * `shutdown_vps` - Shutdown Instance * `reset_vps` - Reset Instance * `resize_vps` - Resize Instance * `change_hostname` - Change Hostname * `reinstall_os` - Reinstall OS * `assign_ip` - Assign IP * `remove_ip` - Remove IP * `update_reverse_dns` - Update Reverse DNS * `update_vpc` - Update VPC * `apply_firewall` - Apply Firewall Rules * `create_snapshot` - Create Snapshot * `delete_snapshot` - Delete Snapshot * `restore_snapshot` - Restore Snapshot * `create_backup` - Create Backup * `delete_backup` - Delete Backup * `restore_backup` - Restore Backup * `create_image_from_snapshot` - Create Image from Snapshot * `delete_image` - Delete Image * `create_volume` - Create Volume * `attach_volume` - Attach Volume * `detach_volume` - Detach Volume * `resize_volume` - Resize Volume * `delete_volume` - Delete Volume * `attach_gpu` - Attach GPU * `detach_gpu` - Detach GPU * `install_software` - Install Software * `uninstall_software` - Uninstall Software * `get_vnc_url` - Get console access * `sync_vps_state` - Sync Instance State * `apply_config` - Apply Proxmox Configuration x-spec-enum-id: e0bab37b509830b6 status: enum: - queued - pending - running - completed - failed - cancelled type: string description: |- * `queued` - Queued * `pending` - Pending * `running` - Running * `completed` - Completed * `failed` - Failed * `cancelled` - Cancelled x-spec-enum-id: 40fa8a34933693d2 readOnly: true parameters: description: Paramètres spécifiques à la tâche result: readOnly: true description: Résultat de l'exécution progress: type: integer readOnly: true started_at: type: string format: date-time readOnly: true nullable: true completed_at: type: string format: date-time readOnly: true nullable: true retry_count: type: integer readOnly: true max_retries: type: integer maximum: 4294967295 minimum: 0 format: int64 created: type: string format: date-time readOnly: true modified: type: string format: date-time readOnly: true created_by: allOf: - $ref: '#/components/schemas/TaskCreatedBy' readOnly: true required: - completed_at - created - created_by - id - instance - instance_id - modified - progress - result - retry_count - started_at - status - task_type TaskInstance: type: object properties: id: type: string format: uuid name: type: string required: - id - name TaskCreatedBy: type: object properties: id: type: string format: uuid email: type: string format: email first_name: type: string last_name: type: string required: - email - first_name - id - last_name securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT or API Key description: >- Use `Authorization: Bearer ` header. Token can be a JWT token or an API key (format: `sk-onetsolutions-...`). ````