---
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

## Changes

- **2026-08-17** `01432a33fdd9` — 1 info
  - the `name` request property default value changed from `toCaTIBD` to `qqAtyUGa`
- **2026-08-16** `5ac4e868623c` — 1 info
  - the `name` request property default value changed from `lfJlYPSh` to `toCaTIBD`
- **2026-08-15** `9ceab730e415` — 1 info
  - the `name` request property default value changed from `nqAzGxZH` to `lfJlYPSh`
- **2026-08-15** `8187a0ec8763` — 1 info
  - the `name` request property default value changed from `bLalyZzf` to `nqAzGxZH`
- **2026-08-14** `2980c6dae34a` — 1 info
  - the `name` request property default value changed from `HxdsCwVY` to `bLalyZzf`

[Full history](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/agentic/provisioning/resources/post.md)

---

[API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.dev/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/revisions/01432a33fdd9/schema)