> ## Documentation Index > Fetch the complete documentation index at: https://docs.e2b.dev/llms.txt > Use this file to discover all available pages before exploring further. # List templates (v2) > List all templates ## OpenAPI ````yaml /openapi-public.yaml get /v2/templates openapi: 3.1.0 info: title: E2B API version: 0.1.0 description: >- Complete E2B developer API. Platform endpoints are served on api.e2b.app. Sandbox endpoints (envd) are served on the shared sandbox host (sandbox.e2b.app); target a specific sandbox with the E2b-Sandbox-Id and E2b-Sandbox-Port headers. servers: - url: https://api.e2b.app description: E2B Platform API security: [] tags: - name: Sandboxes - name: Templates - name: Tags - name: Volumes - name: Envd - name: Filesystem - name: Process - name: Teams - name: Secrets - name: Events - name: Webhooks paths: /v2/templates: servers: - url: https://api.e2b.app description: E2B Platform API get: tags: - Templates summary: List templates (v2) description: List all templates operationId: listTemplatesV2 parameters: - in: query required: false name: teamID schema: type: string description: >- Identifier of the team, as its UUID or its public project ID (prj_) - $ref: '#/components/parameters/paginationNextToken' - $ref: '#/components/parameters/paginationLimit' responses: '200': description: Successfully returned all templates headers: X-Next-Token: $ref: '#/components/headers/XNextToken' content: application/json: schema: type: array items: $ref: '#/components/schemas/Template' '400': description: Bad request content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 400 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: invalidNextToken: summary: The pagination token cannot be decoded value: code: 400 message: Invalid next token '401': description: Authentication error content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 401 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: missingAuthentication: summary: No supported authentication header was supplied value: code: 401 message: authorization header is missing '403': description: Forbidden content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 403 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: teamBanned: summary: The team is banned at authentication value: code: 403 message: team is banned '429': description: Too many requests headers: Retry-After: description: >- When present, the number of seconds to wait before retrying the request. required: false schema: type: integer minimum: 0 example: 30 RateLimit-Limit: description: Configured rate-limit burst size. schema: type: integer RateLimit-Remaining: description: Requests remaining in the rate-limit window. schema: type: integer RateLimit-Reset: description: Seconds until the rate-limit window resets. schema: type: integer content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 429 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: rateLimitExceeded: summary: A configured API rate limit was exceeded value: code: 429 message: Rate limit exceeded '500': description: Server error content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 500 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: operationFailed: summary: The template query fails value: code: 500 message: Error when getting templates security: - ApiKeyAuth: [] components: parameters: paginationNextToken: name: nextToken in: query description: Cursor to start the list from required: false schema: type: string paginationLimit: name: limit in: query description: Maximum number of items to return per page required: false schema: type: integer format: int32 minimum: 1 default: 100 maximum: 100 headers: XNextToken: description: Cursor to fetch the next page of results, if more exist schema: type: string schemas: Template: required: - templateID - buildID - cpuCount - memoryMB - diskSizeMB - public - createdAt - updatedAt - createdBy - lastSpawnedAt - spawnCount - buildCount - envdVersion - aliases - names - buildStatus properties: templateID: type: string description: Identifier of the template buildID: type: string description: Identifier of the last successful build for given template cpuCount: description: >- Resource allocation for the latest build, or 0 when build resources are unavailable. anyOf: - $ref: '#/components/schemas/CPUCount' - type: integer const: 0 memoryMB: description: >- Resource allocation for the latest build, or 0 when build resources are unavailable. anyOf: - $ref: '#/components/schemas/MemoryMB' - type: integer const: 0 diskSizeMB: $ref: '#/components/schemas/DiskSizeMB' public: type: boolean description: Whether the template is public or only accessible by the team aliases: type: array description: Aliases of the template deprecated: true items: type: string names: type: array description: Names of the template (namespace/alias format when namespaced) items: type: string createdAt: type: string format: date-time description: Time when the template was created updatedAt: type: string format: date-time description: Time when the template was last updated createdBy: oneOf: - $ref: '#/components/schemas/TeamUser' - type: 'null' lastSpawnedAt: type: - string - 'null' format: date-time description: Time when the template was last used spawnCount: type: integer format: int64 description: Number of times the template was used buildCount: type: integer format: int32 description: Number of times the template was built envdVersion: $ref: '#/components/schemas/EnvdVersion' buildStatus: $ref: '#/components/schemas/TemplateBuildStatus' type: object CPUCount: type: integer format: int32 minimum: 1 description: CPU cores for the sandbox MemoryMB: type: integer format: int32 minimum: 128 description: Memory for the sandbox in MiB DiskSizeMB: type: integer format: int32 minimum: 0 description: Disk size for the sandbox in MiB TeamUser: required: - id - email properties: id: type: string format: uuid description: Identifier of the user email: type: - string - 'null' deprecated: true default: null description: Email of the user type: object EnvdVersion: type: string description: Version of the envd running in the sandbox TemplateBuildStatus: type: string description: Status of the template build enum: - building - waiting - ready - error - uploaded securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````