# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hugging Face Hub Repos API
  version: 1.0.0
extends: openapi/hugging-face-repos-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/repos/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a model, dataset or Space repo
      effect: write
      questions:
      - How do I create a new model or dataset repository on the Hub through the API?
      - Can I create a repo directly under an organization and make it private?
      - Which SDK do I need to specify when the new repo is a Space?
      instructions:
      - text: Create a new {type} repository named {name}.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Create private={private} {type} repo {name} under organization {organization}.
        slots:
          private: requestBody.private
          type: requestBody.type
          name: requestBody.name
          organization: requestBody.organization
      - text: Create a Space called {name} of type {type} using SDK {sdk}.
        slots:
          name: requestBody.name
          type: requestBody.type
          sdk: requestBody.sdk
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repos/delete'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository from the Hub
      effect: destructive
      questions:
      - Can I delete a model, dataset or Space repository from the Hub?
      - What do I need to identify a repo I want removed from an organization?
      instructions:
      - text: Delete the {type} repository {name}.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Remove {type} repo {name} owned by organization {organization}.
        slots:
          type: requestBody.type
          name: requestBody.name
          organization: requestBody.organization
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repos/{repo_type}/{repo_id}/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a repo's visibility or gating
      effect: write
      questions:
      - Can I switch an existing repository from public to private?
      - Is there a way to require users to request access to a model before downloading it?
      instructions:
      - text: Make {repo_type} repo {repo_id} private={private}.
        slots:
          repo_type: path.repo_type
          repo_id: path.repo_id
          private: requestBody.private
      - text: Set access gating on {repo_type} {repo_id} to {gated}.
        slots:
          repo_type: path.repo_type
          repo_id: path.repo_id
          gated: requestBody.gated
      method: generated
      generated: '2026-10-01'