Skip to main content
POST
/
v1alpha1
/
inference
/
capacityclaims
Create capacity claim
curl --request POST \
  --url https://api.coreweave.com/v1alpha1/inference/capacityclaims \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resources": {
    "instanceId": "<string>",
    "instanceCount": 123,
    "zones": [
      "<string>"
    ],
    "capacityType": "CAPACITY_TYPE_SERVERLESS"
  },
  "id": "<string>",
  "name": "<string>"
}
'
{
  "capacityClaim": {
    "spec": {
      "id": "<string>",
      "name": "<string>",
      "resources": {
        "instanceId": "<string>",
        "instanceCount": 123,
        "zones": [
          "<string>"
        ],
        "capacityType": "CAPACITY_TYPE_SERVERLESS"
      },
      "organizationId": "<string>"
    },
    "status": {
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "conditions": [
        {
          "type": "<string>",
          "lastUpdateTime": "2023-11-07T05:31:56Z",
          "reason": "<string>",
          "message": "<string>",
          "zone": "<string>",
          "status": "True"
        }
      ],
      "allocatedInstances": 123,
      "pendingInstances": 123,
      "status": "STATUS_CREATING"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt

Use this file to discover all available pages before exploring further.

Reserves the requested number of instanceId-typed instances across the listed zones. The order of zones implies an allocation preference: earlier entries are preferred. The available instanceId values per zone are returned by GET /v1alpha1/inference/capacityclaims/parameters.
Example request
curl -X POST https://api.coreweave.com/v1alpha1/inference/capacityclaims \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer {API_ACCESS_TOKEN}" \
       -d @data.json

Authorizations

​
Authorization
string
header
default:Bearer {API_ACCESS_TOKEN}
required

CoreWeave API access token sent as a bearer token.

Body

application/json

Request to create a CapacityClaim

​
resources
object
required

The specification for the resources to reserve

​
id
string

The unique identifier of the CapacityClaim, UUID format

​
name
string

The human readable name of the CapacityClaim

Response

OK

Response for CreateCapacityClaim

​
capacityClaim
object

The created CapacityClaim

Last modified on May 14, 2026