---
descriptions:
  delete_resource:
    resource_id: The ID of the resource to delete.
    cascade_delete: >-
      If true, deletes all descendant resources and role assignments. Defaults
      to false. If not set and the resource has children or assignments, the
      request will fail.
reference:
  curl:
    - key: delete_resource
      id: delete_resource
      url: /reference/fga/resource/delete
      title: '/authorization/resources/:resource_id'
      type: DELETE
      parameters:
        - key: resource_id
          type: string
          description: (delete_resource.resource_id)
        - key: cascade_delete
          type: boolean
          optional: true
          description: (delete_resource.cascade_delete)
      returns:
        - key: empty
          type: empty
          description: Returns an empty response on success.
  js:
    - key: deleteResource
      id: delete_resource
      url: /reference/fga/resource/delete
      title: authorization.deleteResource()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: resourceId
              type: string
              description: (delete_resource.resource_id)
            - key: cascadeDelete
              type: boolean
              optional: true
              description: (delete_resource.cascade_delete)
      returns:
        - key: void
          description: Returns nothing on success.
originalPath: .tmp-workos-clone/packages/docs/content/reference/fga/resource/delete.mdx
---

## Delete a resource

Delete an authorization resource. By default, this will fail if the resource has child resources or role assignments. Set `cascade_delete` to `true` to delete the resource along with all its descendants and role assignments.

<Callout type="warning">
  Deleting a resource also removes all role assignments on that resource. This
  action cannot be undone.
</Callout>

<CodeBlock referenceId="delete_resource">
  <CodeBlockTab title="Request" file="delete-resource-request" />
</CodeBlock>