> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macstadium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 2.4.x to 3.0.0: API Mapping

> Map Orka 2.4.x REST API endpoints to Orka 3.0.0: auth, tokens, VMs, VM configs, images, nodes, and removed endpoints with their Orka3 API replacements.

<Warning>
  **You're reading Orka 2.x migration documentation.** Orka 2.x is no longer actively maintained. If you haven't upgraded yet, see the [Orka 3.x documentation](/orka/orka-overview/orka-overview) to get started. Questions? Contact [support@macstadium.com](mailto:support@macstadium.com).
</Warning>

How do Orka 2.4.x API endpoints map to Orka 3.0.0?

Use the following mapping to figure out how to migrate your API-based custom automation to Orka 3.0.0.

| Orka 2.4.x API                                     | Orka3 API                                                                                                                                                                                              |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `GET/POST/DELETE/PUT /users`                       | Removed. See [Cluster Access Management: Overview](/orka/orka-cluster-access/cluster-access-management-overview).                                                                                      |
| `POST /users/password`                             | Removed. See [Cluster Access Management: Overview](/orka/orka-cluster-access/cluster-access-management-overview).                                                                                      |
| `POST /users/groups/myUserGroup`                   | Removed. Grouping is now handled via namespaces and role bindings. See [Orka Cluster: Manage Access to Resources](/orka/orka-cluster-access/orka-cluster-manage-access-to-resources).                  |
| `POST /users/groups/$ungrouped`                    | Removed. Grouping is now handled via namespaces and role bindings. See [Orka Cluster: Manage Access to Resources](/orka/orka-cluster-access/orka-cluster-manage-access-to-resources).                  |
| `POST /token`                                      | For a user: `orka3 user get-token`<br />For a service account: `POST /api/v1/namespaces/{namespace}/serviceaccounts/{serviceaccount}/token`                                                            |
| `DELETE /token`                                    | Removed. Tokens are invalidated at the end of their duration (1 hour for users, or 1 year or custom for service accounts), or when the respective user or service account is removed from the cluster. |
| `GET /resources/vm/list`                           | `GET /api/v1/namespaces/{namespace}/vms`<br />`GET /api/v1/namespaces/{namespace}/vmconfigs`                                                                                                           |
| `GET /resources/vm/list/all`                       | Removed. `GET /api/v1/namespaces/{namespace}/vms` and `GET /api/v1/namespaces/{namespace}/vmconfigs` now list all VMs and VM configurations for all users in the namespace.                            |
| `GET /resources/vm/list/{user}`                    | Removed. `GET /api/v1/namespaces/{namespace}/vms` and `GET /api/v1/namespaces/{namespace}/vmconfigs` now list all VMs and VM configurations for all users in the namespace.                            |
| `GET /resources/vm/status/{vm}`                    | `GET /api/v1/namespaces/{namespace}/vms/{vm}`                                                                                                                                                          |
| `GET /resources/vm/configs`                        | `GET /api/v1/namespaces/{namespace}/vmconfigs`                                                                                                                                                         |
| `GET /resources/vm/configs/myorkavm`               | `GET /api/v1/namespaces/{namespace}/vmconfigs/{vmconfig}`                                                                                                                                              |
| `POST /resources/vm/create`                        | `POST /api/v1/namespaces/{namespace}/vmconfigs`                                                                                                                                                        |
| `POST /resources/vm/deploy`                        | `POST /api/v1/namespaces/{namespace}/vms`                                                                                                                                                              |
| `DELETE /resources/vm/delete`                      | `DELETE /api/v1/namespaces/{namespace}/vms/{vm}`                                                                                                                                                       |
| `DELETE /resources/vm/purge`                       | `DELETE /api/v1/namespaces/{namespace}/vms/{vm}`<br />`DELETE /api/v1/namespaces/{namespace}/vmconfigs/{vmconfig}`                                                                                     |
| `POST /resources/vm/exec/start`                    | `POST /api/v1/namespaces/{namespace}/vms/{vm}/exec`                                                                                                                                                    |
| `POST /resources/vm/exec/stop`                     | `POST /api/v1/namespaces/{namespace}/vms/{vm}/exec`                                                                                                                                                    |
| `POST /resources/vm/exec/resume`                   | `POST /api/v1/namespaces/{namespace}/vms/{vm}/exec`                                                                                                                                                    |
| `POST /resources/vm/exec/suspend`                  | `POST /api/v1/namespaces/{namespace}/vms/{vm}/exec`                                                                                                                                                    |
| `POST /resources/vm/exec/revert`                   | `POST /api/v1/namespaces/{namespace}/vms/{vm}/exec`                                                                                                                                                    |
| `POST /resources/vm/list-disks`                    | Removed. Attached disks are no longer available.                                                                                                                                                       |
| `POST /resources/vm/attach-disk`                   | Removed. Attached disks are no longer available.                                                                                                                                                       |
| `POST /resources/vm/configs/save-state`            | Removed. VM states are no longer available.                                                                                                                                                            |
| `POST /resources/vm/configs/myorkavm/delete-state` | Removed. VM states are no longer available.                                                                                                                                                            |
| `GET /resources/node/list`                         | `GET /api/v1/namespaces/{namespace}/nodes`                                                                                                                                                             |
| `GET /resources/node/list/all`                     | Removed.                                                                                                                                                                                               |
| `GET /resources/node/status/{node}`                | Removed. Use `GET /api/v1/namespaces/{namespace}/nodes` instead.                                                                                                                                       |
| `GET /resources/ports`                             | Removed.                                                                                                                                                                                               |
| `POST /resources/node/sandbox`                     | Removed. Sandboxing is now handled via namespaces.                                                                                                                                                     |
| `DELETE /resources/node/sandbox`                   | Removed. Sandboxing is now handled via namespaces.                                                                                                                                                     |
| `POST /resources/node/groups/myUserGroup`          | Removed. Grouping is now handled via namespaces and role bindings. See [Orka Cluster: Manage Access to Resources](/orka/orka-cluster-access/orka-cluster-manage-access-to-resources).                  |
| `POST /resources/node/groups/$ungrouped`           | Removed. Grouping is now handled via namespaces and role bindings. See [Orka Cluster: Manage Access to Resources](/orka/orka-cluster-access/orka-cluster-manage-access-to-resources).                  |
| `POST /resources/node/tag/{tag}`                   | `POST /api/v1/namespaces/{namespace}/nodes/{name}/tag`                                                                                                                                                 |
| `DELETE /resources/node/tag/{tag}`                 | `POST /api/v1/namespaces/{namespace}/nodes/{name}/untag`                                                                                                                                               |
| `GET /resources/image/list`                        | `GET /api/v1/namespaces/{namespace}/images`                                                                                                                                                            |
| `POST /resources/image/rename`                     | Removed. Use `POST /api/v1/namespaces/{namespace}/images/{image}/description` to set a user-friendly custom description instead.                                                                       |
| `POST /resources/image/copy`                       | `POST /api/v1/namespaces/{namespace}/images/{image}/copy`                                                                                                                                              |
| `GET /resources/image/list-remote`                 | `GET /api/v1/namespaces/{namespace}/remoteimages`                                                                                                                                                      |
| `POST /resources/image/pull`                       | `POST /api/v1/namespaces/{namespace}/remoteimages/{remoteimage}/pull`                                                                                                                                  |
| `POST /resources/image/delete`                     | `DELETE /api/v1/namespaces/{namespace}/images/{image}`                                                                                                                                                 |
| `POST /resources/image/commit`                     | `POST /api/v1/namespaces/{namespace}/vms/{vm}/commit`                                                                                                                                                  |
| `POST /resources/image/save`                       | `POST /api/v1/namespaces/{namespace}/vms/{vm}/save`                                                                                                                                                    |
| `POST /resources/image/resize`                     | No API endpoint is available. Use `orka3 vm resize` instead.                                                                                                                                           |
| `POST /resources/image/generate`                   | `POST /api/v1/namespaces/{namespace}/images`                                                                                                                                                           |
| `POST /resources/image/upload`                     | `POST /api/v1/namespaces/{namespace}/upload/image`                                                                                                                                                     |
| `GET /resources/image/download/{image}`            | `GET /api/v1/namespaces/{namespace}/images/{image}/download`                                                                                                                                           |
| `GET /resources/image/checksum/{image}`            | No API endpoint is available.                                                                                                                                                                          |
| `GET /resources/iso/list`                          | `GET /api/v1/namespaces/{namespace}/isos`                                                                                                                                                              |
| `GET /resources/iso/list-remote`                   | `GET /api/v1/namespaces/{namespace}/remoteimages`                                                                                                                                                      |
| `POST /resources/iso/pull`                         | `POST /api/v1/namespaces/{namespace}/remoteisos/{remoteiso}/pull`                                                                                                                                      |
| `POST /resources/iso/rename`                       | Removed. Use `POST /api/v1/namespaces/{namespace}/isos/{iso}/description` to set a user-friendly custom description instead                                                                            |
| `POST /resources/iso/copy`                         | `POST /api/v1/namespaces/{namespace}/isos/{iso}/copy`                                                                                                                                                  |
| `POST /resources/iso/delete`                       | `DELETE /api/v1/namespaces/{namespace}/isos/{iso}`                                                                                                                                                     |
| `POST /resources/iso/upload`                       | `POST /api/v1/namespaces/{namespace}/upload/iso`                                                                                                                                                       |
| `GET/POST/DELETE /resources/kube-account`          | Removed.                                                                                                                                                                                               |
| `POST /resources/kube-account/regenerate`          | Removed.                                                                                                                                                                                               |
| `GET /resources/kube-account/download`             | Removed.                                                                                                                                                                                               |
| `POST /logs/query?limit=10`                        | Removed.                                                                                                                                                                                               |
| `DELETE /logs`                                     | Removed.                                                                                                                                                                                               |
| `POST /logs/query?logs20=true`                     | Removed.                                                                                                                                                                                               |
| `GET /token`                                       | Removed.                                                                                                                                                                                               |
| `GET /health-check`                                | Removed.                                                                                                                                                                                               |
| `GET /version`                                     | Removed.                                                                                                                                                                                               |
| `GET /version/?all=true`                           | Removed.                                                                                                                                                                                               |
| `GET /validation-requirements`                     | Removed. User credentials are handled via the MacStadium Customer Portal.                                                                                                                              |
| `GET /validate-license-key`                        | Removed. License keys are obsolete.                                                                                                                                                                    |
| `GET /default-base-image`                          | Removed.                                                                                                                                                                                               |
| `POST /resources/cert/set`                         | `POST /api/v1/upload/cert`                                                                                                                                                                             |