Skip to main content

​
Apply

Create or update resources from YAML (starts provisioning immediately by default): 
pragma resources apply myresource.yaml
Apply multiple files: 
pragma resources apply file1.yaml file2.yaml
Create in draft state (skip provisioning): 
pragma resources apply --draft myresource.yaml
Resources are deployed by default when you apply them. Use --draft to save a resource configuration without triggering provisioning.

​
File References

For pragma/secret resources, use @path syntax to inline file contents: 
provider: pragma
resource: secret
name: gcp-credentials
config:
  data:
    service_account_key: "@./service-account.json"
For pragma/file resources, use @path in the content field to upload a file: 
provider: pragma
resource: file
name: training-data
config:
  content: "@./data/training-set.jsonl"
  content_type: "application/jsonl"
The file is uploaded to pragma-os storage, and the resource outputs include a URL for downloading it.

​
List

pragma resources list
Output as JSON for scripting: 
pragma resources list --output json
Filter by provider: 
pragma resources list --provider gcp
Filter by resource type: 
pragma resources list --resource warehouse
Filter by tags: 
pragma resources list --tag env:production

​
Types

List available resource types from deployed providers: 
pragma resources types
Filter by provider: 
pragma resources types --provider gcp

​
Get

Get resources by type: 
pragma resources get gcp/storage
Get a specific resource: 
pragma resources get gcp/storage my-bucket

​
Describe

Get detailed information about a resource, including full configuration, resolved config, and outputs: 
pragma resources describe gcp/storage my-bucket
Output as JSON to inspect resolved_config for dependency debugging: 
pragma resources describe agno/agent my-agent -o json

​
Tags

Manage tags on existing resources: 
# List tags
pragma resources tags list gcp/storage my-bucket

# Add tags
pragma resources tags add gcp/storage my-bucket --tag env:prod --tag cost-center:123

# Remove tags
pragma resources tags remove gcp/storage my-bucket --tag env:prod

​
Delete

Delete a resource by type and name: 
pragma resources delete gcp/storage my-bucket
Delete all resources defined in a YAML file: 
pragma resources delete -f myresources.yaml
This reads the provider, resource, and name from each document in the YAML file and deletes the matching resources.

​
Next Steps

Resource Concepts

Learn about resource lifecycle, deletion behavior, and dependency resolution.