curl --request POST \
--url https://api.aireserve.com/v1/gpu/pods \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"name": "<string>",
"containerDiskGb": 512,
"dataCenterId": "<string>",
"ephemeralDiskAcknowledged": true,
"quoteId": "<string>",
"computeType": "GPU",
"gpuTypeId": "<string>",
"gpuCount": 8,
"cpuTypeId": "<string>",
"vcpuCount": 129,
"cloud": "SECURE",
"imageName": "<string>",
"templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runpodTemplateId": "<string>",
"templateStorageAcknowledged": false,
"networkVolumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volumeMountPath": "/workspace",
"registryCredentialId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sshKeyIds": [],
"env": {},
"ports": [
{
"port": 32768
}
],
"dockerStartCmd": [],
"publicPortsAcknowledged": false
}
'import requests
url = "https://api.aireserve.com/v1/gpu/pods"
payload = {
"name": "<string>",
"containerDiskGb": 512,
"dataCenterId": "<string>",
"ephemeralDiskAcknowledged": True,
"quoteId": "<string>",
"computeType": "GPU",
"gpuTypeId": "<string>",
"gpuCount": 8,
"cpuTypeId": "<string>",
"vcpuCount": 129,
"cloud": "SECURE",
"imageName": "<string>",
"templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runpodTemplateId": "<string>",
"templateStorageAcknowledged": False,
"networkVolumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volumeMountPath": "/workspace",
"registryCredentialId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sshKeyIds": [],
"env": {},
"ports": [{ "port": 32768 }],
"dockerStartCmd": [],
"publicPortsAcknowledged": False
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
containerDiskGb: 512,
dataCenterId: '<string>',
ephemeralDiskAcknowledged: true,
quoteId: '<string>',
computeType: 'GPU',
gpuTypeId: '<string>',
gpuCount: 8,
cpuTypeId: '<string>',
vcpuCount: 129,
cloud: 'SECURE',
imageName: '<string>',
templateId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
runpodTemplateId: '<string>',
templateStorageAcknowledged: false,
networkVolumeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
volumeMountPath: '/workspace',
registryCredentialId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sshKeyIds: [],
env: {},
ports: [{port: 32768}],
dockerStartCmd: [],
publicPortsAcknowledged: false
})
};
fetch('https://api.aireserve.com/v1/gpu/pods', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"accepted": true,
"resourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"resourceType": "pod",
"operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "accepted"
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}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.
curl --request POST \
--url https://api.aireserve.com/v1/gpu/pods \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"name": "<string>",
"containerDiskGb": 512,
"dataCenterId": "<string>",
"ephemeralDiskAcknowledged": true,
"quoteId": "<string>",
"computeType": "GPU",
"gpuTypeId": "<string>",
"gpuCount": 8,
"cpuTypeId": "<string>",
"vcpuCount": 129,
"cloud": "SECURE",
"imageName": "<string>",
"templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runpodTemplateId": "<string>",
"templateStorageAcknowledged": false,
"networkVolumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volumeMountPath": "/workspace",
"registryCredentialId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sshKeyIds": [],
"env": {},
"ports": [
{
"port": 32768
}
],
"dockerStartCmd": [],
"publicPortsAcknowledged": false
}
'import requests
url = "https://api.aireserve.com/v1/gpu/pods"
payload = {
"name": "<string>",
"containerDiskGb": 512,
"dataCenterId": "<string>",
"ephemeralDiskAcknowledged": True,
"quoteId": "<string>",
"computeType": "GPU",
"gpuTypeId": "<string>",
"gpuCount": 8,
"cpuTypeId": "<string>",
"vcpuCount": 129,
"cloud": "SECURE",
"imageName": "<string>",
"templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runpodTemplateId": "<string>",
"templateStorageAcknowledged": False,
"networkVolumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volumeMountPath": "/workspace",
"registryCredentialId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sshKeyIds": [],
"env": {},
"ports": [{ "port": 32768 }],
"dockerStartCmd": [],
"publicPortsAcknowledged": False
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '<string>',
containerDiskGb: 512,
dataCenterId: '<string>',
ephemeralDiskAcknowledged: true,
quoteId: '<string>',
computeType: 'GPU',
gpuTypeId: '<string>',
gpuCount: 8,
cpuTypeId: '<string>',
vcpuCount: 129,
cloud: 'SECURE',
imageName: '<string>',
templateId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
runpodTemplateId: '<string>',
templateStorageAcknowledged: false,
networkVolumeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
volumeMountPath: '/workspace',
registryCredentialId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sshKeyIds: [],
env: {},
ports: [{port: 32768}],
dockerStartCmd: [],
publicPortsAcknowledged: false
})
};
fetch('https://api.aireserve.com/v1/gpu/pods', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"accepted": true,
"resourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"resourceType": "pod",
"operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "accepted"
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}Authorizations
Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).
Headers
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.
8 - 180^[A-Za-z0-9:_-]+$Body
1 - 1201 <= x <= 102480true Signed quote token from POST /v1/gpu/quotes.
GPU, CPU 1 - 1601 <= x <= 161 - 1602 <= x <= 256SECURE, COMMUNITY 1 - 500^(?![A-Za-z][A-Za-z0-9+.-]*:\/\/)[A-Za-z0-9][A-Za-z0-9./_:@-]*$^([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)$1 - 128^([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)$120^\/[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*\/?$^([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)$20^([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)$Show child attributes
Show child attributes
Show child attributes
Show child attributes
324096Response
Accepted. Poll operationId for completion.
Body of every 202 Accepted Compute mutation.
true ID of the resource created or mutated.
^([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)$pod, volume, cluster, template, registry, ssh_key Durable operation record. Poll GET /v1/gpu/operations/{id} until a terminal status.
^([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)$accepted