> ## Documentation Index > Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt > Use this file to discover all available pages before exploring further. # Create pod (legacy) > Legacy provider-shaped launch. New integrations should use `POST /v1/gpu/instances`, which performs placement and pricing internally. This route requires a quote and explicit disk/public-port acknowledgements. Requires compute `manage` access. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/gpu/pods openapi: 3.0.3 info: title: AI Reserve Gateway API description: >- The AI Reserve API surface — OpenAI-compatible chat completions, Anthropic-compatible messages, Bedrock Converse, images, video, files, text-to-speech, realtime voice sessions, and provider-hidden GPU infrastructure — all behind one endpoint and one API key. version: 1.0.0 servers: - url: https://api.aireserve.com security: - bearerAuth: [] tags: - name: Customers description: >- Per-end-customer usage, cost, and billable amounts for organizations that tag requests with their own customers. - name: GPU Infrastructure description: >- Provision and manage provider-hidden GPU instances. The recommended Instances API accepts workload requirements and an hourly price ceiling; AI Reserve handles provider placement internally. Every mutation is asynchronous and returns an operation to poll. - name: Customer keys description: >- Mint, list, and revoke API keys pinned to your own end customers (and their organizations), so spend splits per customer without per-request tagging. paths: /v1/gpu/pods: post: tags: - GPU Infrastructure summary: Create pod (legacy) description: >- Legacy provider-shaped launch. New integrations should use `POST /v1/gpu/instances`, which performs placement and pricing internally. This route requires a quote and explicit disk/public-port acknowledgements. Requires compute `manage` access. operationId: createPod parameters: - name: Idempotency-Key in: header required: true description: >- Client-chosen key of 8–180 characters `[A-Za-z0-9:_-]`. Replaying the same key with the same body returns the original operation; a different body with the same key fails with `409 operation_conflict`. schema: type: string minLength: 8 maxLength: 180 pattern: ^[A-Za-z0-9:_-]+$ requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 120 computeType: default: GPU type: string enum: - GPU - CPU gpuTypeId: type: string minLength: 1 maxLength: 160 gpuCount: type: integer minimum: 1 maximum: 16 cpuTypeId: type: string minLength: 1 maxLength: 160 vcpuCount: type: integer minimum: 2 maximum: 256 cloud: default: SECURE type: string enum: - SECURE - COMMUNITY containerDiskGb: type: integer minimum: 1 maximum: 1024 dataCenterId: type: string maxLength: 80 imageName: type: string minLength: 1 maxLength: 500 pattern: >- ^(?![A-Za-z][A-Za-z0-9+.-]*:\/\/)[A-Za-z0-9][A-Za-z0-9./_:@-]*$ templateId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ runpodTemplateId: type: string minLength: 1 maxLength: 128 templateStorageAcknowledged: default: false type: boolean networkVolumeId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ volumeMountPath: default: /workspace type: string maxLength: 120 pattern: ^\/[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*\/?$ registryCredentialId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ sshKeyIds: default: [] maxItems: 20 type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ env: default: {} type: object additionalProperties: type: string maxLength: 16384 ports: anyOf: - type: array items: type: object properties: port: type: integer minimum: 1 maximum: 65535 protocol: type: string enum: - http - tcp - udp required: - port - protocol additionalProperties: false - type: string dockerStartCmd: default: [] maxItems: 32 type: array items: type: string maxLength: 4096 publicPortsAcknowledged: default: false type: boolean ephemeralDiskAcknowledged: type: boolean enum: - true quoteId: type: string description: Signed quote token from `POST /v1/gpu/quotes`. required: - name - containerDiskGb - dataCenterId - ephemeralDiskAcknowledged - quoteId additionalProperties: false responses: '202': description: Accepted. Poll `operationId` for completion. headers: Location: description: Path of the created resource. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ComputeAccepted' '400': description: Invalid request, missing Idempotency-Key, or schema violation. content: application/json: schema: $ref: '#/components/schemas/ComputeError' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ComputeError' '402': description: Insufficient wallet funds (`insufficient_funds`). content: application/json: schema: $ref: '#/components/schemas/ComputeError' '403': description: Key lacks the required compute access (`read` or `manage`). content: application/json: schema: $ref: '#/components/schemas/ComputeError' '404': description: Resource not found or owned by another organization. content: application/json: schema: $ref: '#/components/schemas/ComputeError' '409': description: >- Conflict: `quote_expired`, `price_changed`, `operation_conflict`, `volume_in_use`, or `storage_delinquent`. content: application/json: schema: $ref: '#/components/schemas/ComputeError' '503': description: Compute disabled or provider unavailable. content: application/json: schema: $ref: '#/components/schemas/ComputeError' deprecated: true security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: ComputeAccepted: type: object properties: accepted: type: boolean enum: - true resourceId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: ID of the resource created or mutated. resourceType: type: string enum: - pod - volume - cluster - template - registry - ssh_key operationId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: >- Durable operation record. Poll `GET /v1/gpu/operations/{id}` until a terminal status. status: type: string enum: - accepted required: - accepted - resourceId - resourceType - operationId - status additionalProperties: false description: Body of every `202 Accepted` Compute mutation. ComputeError: type: object properties: error: type: object properties: message: type: string type: type: string enum: - invalid_request_error - authentication_error - permission_error - server_error param: nullable: true type: string code: type: string description: >- Machine-readable Compute error code, e.g. `quote_expired`, `price_changed`, `operation_conflict`, `no_capacity`, `volume_in_use`, `insufficient_funds`, `compute_access_required`, `not_found`. details: description: >- Machine-readable context for some codes. For `no_capacity` see `ComputeNoCapacityDetails`. type: object additionalProperties: {} required: - message - type - param - code additionalProperties: false required: - error additionalProperties: false description: OpenAI-shaped error envelope returned on every 4xx/5xx. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys). apiKeyAuth: type: apiKey in: header name: x-api-key description: The same API key sent as an `x-api-key` header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.