List templates

List all reusable Runpod templates owned by the authenticated user, including Pod and Serverless container configuration details.

GET /v2/templates

List templates

cURL

curl --request GET \
  --url https://api.runpod.io/v2/templates \
  --header 'Authorization: Bearer <token>'

200

{
  "templates": [
    {
      "id": "9x4m2p7v",
      "name": "PyTorch GPU Template",
      "image": "runpod/pytorch:1.0.2-cu1281-torch280-ubuntu2404",
      "args": "",
      "disk": 50,
      "mounts": {
        "persistent": {
          "size": 20,
          "path": "/workspace"
        }
      },
      "ports": [
        "8888/http"
      ],
      "env": {
        "JUPYTER_ENABLE_LAB": "yes"
      },
      "registry": null,
      "serverless": false,
      "public": false,
      "category": "NVIDIA",
      "startSsh": true,
      "startJupyter": false,
      "allowedCudaVersions": []
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasNextPage": false
  }
}

Authorizations

Authorization · string · header · required

Runpod API key authentication. Generate an API key in the Runpod console and send it in the Authorization header as Bearer <api_key>. Keys are scoped to the permissions granted when created; requests may return 403 when a valid key lacks access to the requested resource or action.

Query Parameters

cursor · string

Opaque resume cursor — pass the previous response's pagination.nextCursor through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected with 422.

Minimum string length: 1

limit · integer

Page size, 1–1000. Defaults to 1000 when omitted.

Required range: 1 <= x <= 1000

Response

200

application/json

OK

Mixin for cursor-paginated list responses. Compose it with allOf next to the resource's bare list schema so that a list shape shared with a non-paginated endpoint (e.g. a cluster's member pods) does not inherit a pagination block it cannot honour.

templates · object[] · required

Show child attributes

pagination · object · required

Cursor-pagination metadata, uniform across list endpoints. Every response carries it: follow nextCursor while hasNextPage is true to walk the full result set.

Show child attributes