API Documentation

List your prompt templates. Supports filtering and pagination.

Query Parameters

page	Page number (default: 1)
per_page	Items per page (default: 25, max: 100)
visibility	Filter: private, shared, public, purchasable
category	Filter: productivity, business, developer, creative, communication, starter-kit
created_via	Filter: web, api

Example

curl -X GET "https://clawy.io/api/v1/prompt_templates?visibility=private" \
  -H "Authorization: Bearer clw_your_api_key"

CLI Equivalent

clawy prompts list -o json
clawy prompts list --visibility private

Create a new prompt template. Prompts created via API default to private visibility.

Request Body

title *	string (max 100 chars)
description *	string (max 500 chars)
content *	string - The actual prompt text (max 10,000 chars). Use {{VARIABLE_NAME}} for fillable template variables (e.g., {{APP_NAME}}). Variables are auto-detected and returned in template_variables.
category *	productivity | business | developer | creative | communication | starter-kit
difficulty	easy | medium | hard (default: easy)
visibility	private | public (default: private for API)
tags	array of strings
estimated_build_time	integer (minutes, default: 2)
screenshots	array of base64 data URLs (max 5, each max 5MB, PNG/JPEG/WebP)

* Required field

Example

curl -X POST "https://clawy.io/api/v1/prompt_templates" \
  -H "Authorization: Bearer clw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "App Builder",
    "description": "Builds a customizable app with your chosen name and theme",
    "content": "Build an app called {{APP_NAME}} using a {{COLOR_THEME}} color theme. Add {{NUM_PAGES}} pages.",
    "category": "developer",
    "difficulty": "medium",
    "tags": ["app", "builder", "customizable"]
  }'

The {{APP_NAME}}, {{COLOR_THEME}}, and {{NUM_PAGES}} variables will be auto-detected. Users deploying this prompt will be asked to fill them in first.

CLI Equivalent

clawy prompts create --title "App Builder" --content "Build an app called ..." --category developer
clawy prompts create --title "App Builder" --file prompt.txt --tags app,builder

Get details of a specific prompt template you own.

curl -X GET "https://clawy.io/api/v1/prompt_templates/abc123" \
  -H "Authorization: Bearer clw_your_api_key"

CLI Equivalent

clawy prompts show abc123

Update an existing prompt template. Only include fields you want to change.

curl -X PUT "https://clawy.io/api/v1/prompt_templates/abc123" \
  -H "Authorization: Bearer clw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Title",
    "visibility": "public"
  }'

CLI Equivalent

clawy prompts update abc123 --title "Updated Title" --visibility public
clawy prompts update abc123 --content-file new-prompt.txt

List your submitted feedback. Supports filtering by status, feedback_type, and priority.

curl -X GET "https://clawy.io/api/v1/ideas?feedback_type=bug_report" \
  -H "Authorization: Bearer clw_your_api_key"

CLI Equivalent

clawy feedback list -o json
clawy feedback list

Submit feedback. Works with any API key permission level (read, manage, or admin).

Request Body

title *	string — Short summary
body *	string — Detailed description
feedback_type	feature_request (default) | bug_report
priority	low | medium (default) | high

* Required field

curl -X POST "https://clawy.io/api/v1/ideas" \
  -H "Authorization: Bearer clw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Add dark mode toggle",
    "body": "It would be great to have a dark mode toggle in the dashboard",
    "feedback_type": "feature_request",
    "priority": "medium"
  }'

CLI Equivalent

clawy feedback submit --title "Add dark mode toggle" --body "It would be great to have a dark mode toggle in the dashboard"