> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke package grant

> Ends a customer Workspace's access to your Package, which an Offer redemption granted. From then on the Workspace can no longer read, resolve or install any version of it, and redeeming the same Offer again grants nothing. Installs already running keep running unchanged and remain the customer's to delete; they can no longer be updated or have their inputs read. Another Offer for the Package that the Workspace redeems later grants access again; archive the Offers it should not redeem. Retry with the same Idempotency-Key to receive the same answer; a Workspace without a grant answers 404.



## OpenAPI

````yaml /openapi-public.json delete /packages/{id}/grants/{workspace_id}
openapi: 3.1.0
info:
  title: Akua API
  version: 1.0.0
  description: >-
    Manage installs and their asynchronous operations. Authenticate with a
    session bearer token and select a Workspace using Akua-Context.
  contact:
    name: Akua API support
    email: support@akua.dev
    url: https://docs.akua.dev/
servers:
  - url: https://api.akua.dev/v1
security: []
tags:
  - name: operations
  - name: installs
  - name: Organizations
  - name: Billing accounts
  - name: workspaces
  - name: regions
  - name: products
  - name: offers
  - name: Order Drafts
  - name: packages
  - name: API Tokens
  - name: Registry
    description: >-
      Connect image registry Upstreams and resolve private images. Guide:
      https://docs.akua.dev/private-images
  - name: Quota adjustments
  - name: Workspace services
  - name: Vault connections
  - name: clusterJoin
  - name: joinBootstrap
  - name: clusters
  - name: Node pools
  - name: Nodes
  - name: machineBootstrap
  - name: machines
  - name: Sandboxes
  - name: OpenCode Servers
  - name: vaults
  - name: vaultSecrets
paths:
  /packages/{id}/grants/{workspace_id}:
    delete:
      tags:
        - packages
      summary: Revoke package grant
      description: >-
        Ends a customer Workspace's access to your Package, which an Offer
        redemption granted. From then on the Workspace can no longer read,
        resolve or install any version of it, and redeeming the same Offer again
        grants nothing. Installs already running keep running unchanged and
        remain the customer's to delete; they can no longer be updated or have
        their inputs read. Another Offer for the Package that the Workspace
        redeems later grants access again; archive the Offers it should not
        redeem. Retry with the same Idempotency-Key to receive the same answer;
        a Workspace without a grant answers 404.
      operationId: packages.revokeGrant
      parameters:
        - name: id
          in: path
          schema:
            type: string
            description: Package ID
            examples:
              - pkg_j572abc123def456
            minLength: 1
            maxLength: 54
          required: true
        - name: workspace_id
          in: path
          schema:
            type: string
            minLength: 2
            maxLength: 53
          required: true
        - name: akua-context
          in: header
          schema:
            type: string
            minLength: 1
            maxLength: 53
            description: >-
              Optional workspace/scope context for the request. Carries a single
              workspace wire id (`ws_…`) today. Only needed for broad tokens - a
              workspace-owned token implies its workspace.
            examples:
              - ws_j572abc123def4
          required: false
        - name: idempotency-key
          in: header
          schema:
            type: string
            minLength: 1
            maxLength: 64
            description: >-
              Optional caller-supplied idempotency key. Any non-empty key up to
              64 characters is accepted. Endpoint-specific documentation
              describes how the key is used.
            examples:
              - create-prod-2026-05-07
          required: false
      responses:
        '204':
          description: Grant revoked
        '400':
          description: The request is malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequest'
        '401':
          description: Missing, invalid or expired credential.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorized'
        '403':
          description: The credential may not act in this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbidden'
        '404':
          description: The resource was not found in this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFound'
      security:
        - BearerAuth: []
components:
  schemas:
    ApiBadRequest:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - Validation
        success:
          type: boolean
          enum:
            - false
        errors:
          type: array
          prefixItems:
            - $ref: '#/components/schemas/ApiErrorEntry'
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiErrorEntry'
        result:
          type: object
          additionalProperties: false
      required:
        - _tag
        - success
        - errors
        - result
      additionalProperties: false
    ApiUnauthorized:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - Unauthorized
        success:
          type: boolean
          enum:
            - false
        errors:
          type: array
          prefixItems:
            - $ref: '#/components/schemas/ApiErrorEntry'
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiErrorEntry'
        result:
          type: object
          additionalProperties: false
      required:
        - _tag
        - success
        - errors
        - result
      additionalProperties: false
    ApiForbidden:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - Forbidden
        success:
          type: boolean
          enum:
            - false
        errors:
          type: array
          prefixItems:
            - $ref: '#/components/schemas/ApiErrorEntry'
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiErrorEntry'
        result:
          type: object
          additionalProperties: false
      required:
        - _tag
        - success
        - errors
        - result
      additionalProperties: false
    ApiNotFound:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - NotFound
        success:
          type: boolean
          enum:
            - false
        errors:
          type: array
          prefixItems:
            - $ref: '#/components/schemas/ApiErrorEntry'
          minItems: 1
          items:
            $ref: '#/components/schemas/ApiErrorEntry'
        result:
          type: object
          additionalProperties: false
      required:
        - _tag
        - success
        - errors
        - result
      additionalProperties: false
    ApiErrorEntry:
      type: object
      properties:
        code:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
          description: Machine-readable error code
          examples:
            - 7002
        message:
          type: string
          description: Human-readable error message
          examples:
            - Resource not found
        path:
          type: array
          items:
            type: string
          description: Field path that caused the error, when applicable
          examples:
            - - body
              - name
        metadata:
          type: object
          additionalProperties:
            type: string
      required:
        - code
        - message
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      description: Bearer token for the authenticated caller.
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.