curl --request GET \
--url https://api.example.com/v1/prompts{
"items": [
{
"items[].id": "<string>",
"items[].name": "<string>",
"items[].description": "<string>",
"items[].owner_id": "<string>",
"items[].created_at": "<string>",
"items[].owner_username": "<string>",
"items[].tags": [
"<string>"
]
}
],
"query": "<string>",
"limit": 123,
"offset": 123
}curl --request GET \
--url https://api.example.com/v1/prompts{
"items": [
{
"items[].id": "<string>",
"items[].name": "<string>",
"items[].description": "<string>",
"items[].owner_id": "<string>",
"items[].created_at": "<string>",
"items[].owner_username": "<string>",
"items[].tags": [
"<string>"
]
}
],
"query": "<string>",
"limit": 123,
"offset": 123
}curl "https://api.prompts.dev/v1/prompts?q=code+review&limit=10&offset=0"
{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "code-review-assistant",
"description": "An AI assistant that helps review code for best practices",
"owner_id": "123e4567-e89b-12d3-a456-426614174000",
"owner_username": "alice",
"created_at": "2026-03-10T14:30:00Z",
"tags": ["development", "code-review", "automation"]
},
{
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "pr-review-bot",
"description": "Automated pull request reviewer",
"owner_id": "223e4567-e89b-12d3-a456-426614174001",
"owner_username": "bob",
"created_at": "2026-03-09T10:15:00Z",
"tags": ["automation", "code-review", "github"]
}
],
"query": "code review",
"limit": 10,
"offset": 0
}
offset parameter by the limit value for each subsequent request.
For example: first request uses offset=0, second request uses offset=10, third uses offset=20, etc.{
"error": {
"code": "VALIDATION_ERROR",
"message": "validation failed",
"fields": {
"q": "query is required"
}
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "search failed"
}
}
Search handler at internal/prompts/handler.go:90.