> ## Documentation Index > Fetch the complete documentation index at: https://docs.pragmatiks.io/llms.txt > Use this file to discover all available pages before exploring further. # Remove Resource > Remove a resource from the graph (hard delete). Only available for DRAFT and WAITING resources. For active resources, use deactivate first. Sensitive fields are masked by default in the response. Returns: The deleted resource. Raises: HTTPException: 404 if resource not found. ## OpenAPI ````yaml https://api.pragmatiks.io/openapi.json delete /projects/{project_id}/resources/by-name openapi: 3.1.0 info: title: Pragma API version: 0.1.0 servers: [] security: [] paths: /projects/{project_id}/resources/by-name: delete: tags: - resources summary: Remove Resource description: |- Remove a resource from the graph (hard delete). Only available for DRAFT and WAITING resources. For active resources, use deactivate first. Sensitive fields are masked by default in the response. Returns: The deleted resource. Raises: HTTPException: 404 if resource not found. operationId: resources-remove_resource parameters: - name: project_id in: path required: true schema: type: string title: Project Id - name: provider in: query required: true schema: type: string description: Provider name title: Provider description: Provider name - name: resource in: query required: true schema: type: string description: Resource type title: Resource description: Resource type - name: name in: query required: true schema: type: string description: Resource name title: Name description: Resource name - name: reveal in: query required: false schema: type: boolean description: Reveal sensitive field values default: false title: Reveal description: Reveal sensitive field values responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Resource-Output' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: Resource-Output: properties: created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At provider: type: string title: Provider resource: type: string title: Resource name: type: string title: Name project_id: type: string title: Project Id config: additionalProperties: true type: object title: Config default: {} resolved_config: anyOf: - additionalProperties: true type: object - type: 'null' title: Resolved Config dependencies: items: $ref: '#/components/schemas/ResourceReference' type: array title: Dependencies default: [] owner_references: items: $ref: '#/components/schemas/OwnerReference' type: array title: Owner References default: [] outputs: additionalProperties: true type: object title: Outputs default: {} error: anyOf: - type: string - type: 'null' title: Error lifecycle_state: $ref: '#/components/schemas/LifecycleState' default: draft health: $ref: '#/components/schemas/HealthStatus' default: healthy health_message: anyOf: - type: string - type: 'null' title: Health Message pending_event_id: anyOf: - type: string - type: 'null' title: Pending Event Id pending_event_type: anyOf: - type: string - type: 'null' title: Pending Event Type provisioned: type: boolean title: Provisioned default: false reconcile_count: type: integer title: Reconcile Count default: 0 version: type: integer title: Version default: 0 tags: anyOf: - items: type: string type: array - type: 'null' title: Tags provider_version: anyOf: - type: string - type: 'null' title: Provider Version managed_by: anyOf: - $ref: '#/components/schemas/ManagedBy' - type: 'null' id: type: string title: Id description: 'External resource ID for API responses: provider/resource/name.' readOnly: true type: object required: - provider - resource - name - project_id - id title: Resource description: >- Domain model for resources with provider/resource identity and 5-state lifecycle. Identity fields (frozen - immutable after creation): provider: Provider that manages this resource type. resource: Resource type name. name: Unique resource instance name. Configuration fields (mutable): config: Original user-submitted resource configuration. Contains raw field references and dependency markers as submitted by the user. resolved_config: Resolved configuration with field references and dependency markers expanded. Contains __field_ref__ markers with resolved_value and dependency markers with ref data. Set when transitioning to PENDING state. None when resource is in DRAFT state or not yet resolved. dependencies: References to resources this resource depends on. owner_references: References to resources that own this resource for lifecycle coordination and cascading deletes. Output fields (provider-managed): outputs: Resource outputs from provider processing. error: Error message when resource is in FAILED state. Lifecycle fields (system-managed): lifecycle_state: Current state (DRAFT/PENDING/PROCESSING/READY/FAILED). pending_event_id: Event ID currently being processed (set on PROCESSING, cleared on READY/FAILED). Used for response idempotency validation. provisioned: Whether the resource was successfully created at least once. Used to distinguish failed creates (retry CREATE) from failed updates (retry UPDATE). Versioning fields (system-managed): provider_version: Semver of the provider version that last processed this resource. Set automatically when the resource transitions to PENDING. None for platform resources or pre-versioning backfill. Ownership fields (system-managed): managed_by: Ownership discriminator. ``user`` for resources the caller owns and controls, ``platform`` for platform-managed resources (platform agents, tier resources, platform-default LLM provider) that reject user writes. ``None`` is the legacy unmanaged default for backfilled records. Categorization fields (mutable): tags: Optional list of tags for categorization and filtering. Inherited from PragmaModel: created_at: Creation timestamp (frozen). updated_at: Last update timestamp (mutable). HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ResourceReference: properties: created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At project_id: type: string title: Project Id provider: type: string title: Provider resource: type: string title: Resource name: type: string title: Name type: object required: - project_id - provider - resource - name title: ResourceReference description: |- Reference to another resource for dependency tracking. Used to express dependencies between resources. At commit time, the API validates that all referenced resources exist and are READY. Attributes: project_id: Project that owns the referenced resource. provider: Provider that manages the referenced resource. resource: Resource type name. name: Resource instance name. OwnerReference: properties: created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At project_id: type: string title: Project Id provider: type: string title: Provider resource: type: string title: Resource name: type: string title: Name type: object required: - project_id - provider - resource - name title: OwnerReference description: >- Reference to a resource that owns this resource for lifecycle coordination. Used for cascading deletes and ownership tracking. When an owner resource is deleted, owned resources can be automatically cleaned up. A resource can have multiple owners (rare but valid for shared resources). Attributes: project_id: Project that owns the referenced resource. provider: Provider that manages the owner resource. resource: Resource type name. name: Resource instance name. LifecycleState: type: string enum: - draft - waiting - pending - processing - ready - failed - deleting title: LifecycleState description: Lifecycle states for resources. HealthStatus: type: string enum: - healthy - degraded ManagedBy: type: string enum: - user - platform ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````