---
title: "Provision a resource"
method: POST
path: "/api/agentic/provisioning/resources"
tags: ["agentic-provisioning"]
---

# Provision a resource

`POST /api/agentic/provisioning/resources`

## Request body

- union
  - object
    - `service_id` 'platform', required
  - object
    - `service_id` 'bucket', required
    - `configuration` object, required
      - `name` string — The name of the repository (defaults to a random name if not provided)
      - `visibility` 'public' | 'private' — The visibility of the repository (defaults to private)
  - object
    - `service_id` 'free', required
    - `configuration` object
      - `rechargeAmountUsd` number — Optional pay-as-you-go auto top-up ceiling, in USD. If set, usage above the plan's included quota is billed via the shared payment token (minimum $15). If omitted, the plan's included quota is a hard cap.
    - `payment_credentials` object
      - `type` 'stripe_payment_token', required
      - `stripe_payment_token` string, required
  - object
    - `service_id` 'pro', required
    - `configuration` object
      - `rechargeAmountUsd` number — Optional pay-as-you-go auto top-up ceiling, in USD. If set, usage above the plan's included quota is billed via the shared payment token (minimum $15). If omitted, the plan's included quota is a hard cap.
    - `payment_credentials` object
      - `type` 'stripe_payment_token', required
      - `stripe_payment_token` string, required

## Response `200`

Provisioned resource

- union
  - object
    - `status` 'complete', required
    - `id` string, required
    - `complete` object, required
      - `access_configuration` object, required
  - object
    - `status` 'pending', required
    - `id` string, required
  - object — Resource provisioning error
    - `status` 'error', required
    - `id` string, required
    - `error` object, required
      - `code` string, required
      - `message` string, required

## Other responses

- `400` — Resource provisioning error

---

[API](https://skmtc.net/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.net/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/versions/dae0cc3790f0/schema)