Skip to content
Responses
/
/
List prompts
Last updated

List prompt templates

🔨 In Development — This section is still being developed and may change.
Retrieves a list of prompt templates for the specified organization. Supports pagination and filtering to manage large collections of templates.
GEThttps://api.freddy.aitronos.com/v1/prompts

Use this endpoint to discover available prompt templates, search by name or tags, and manage your template library.

Query Parameters

organizationId string required

The unique identifier of the organization whose prompt templates to list. All API requests must be scoped to an organization for access control and resource management.

limit integer optional · Defaults to 20

The maximum number of prompt templates to return in the response. Must be between 1 and 100.

offset integer optional · Defaults to 0

The number of prompt templates to skip before starting to return results. Used for pagination.

name string optional

Filter templates by exact name match.

tags array optional

Filter templates that contain all of the specified tags. Each tag must be present in the template's tags array.

isPublic boolean optional

Filter templates by public status. When true, returns only public templates. When false, returns only private templates. When omitted, returns both.

search string optional

Free-text search across template names and descriptions. Performs fuzzy matching to find relevant templates.

sort string optional · Defaults to createdAt

Sort the results by the specified field. Available options: name (alphabetical), createdAt (creation date), updatedAt (last modified), usageCount (most used first).

order string optional · Defaults to desc

Sort order direction. Available options: asc (ascending), desc (descending). Only applicable when sort is specified.

Response

object string

Always set to "list".

data array

Array of prompt template objects.

hasMore boolean

Whether there are additional prompt templates to retrieve (for pagination).

limit integer

The limit that was applied to this request.

offset integer

The offset that was applied to this request.

total integer

The total number of prompt templates matching the query (may be approximate for large collections).

Each prompt template in the data array includes:

  • id string - The unique identifier
  • name string - The template name
  • description string - The template description
  • tags array - The assigned tags
  • isPublic boolean - Public status
  • createdAt integer - Creation timestamp
  • updatedAt integer - Last modified timestamp
  • version string - Current version
  • usageCount integer - Number of times used (approximate)

Returns

A PromptsResponse object containing the API response data.

Bash
curl "https://api.freddy.aitronos.com/v1/prompts?organizationId=org_abc123&limit=10" \
-H "Authorization: Bearer $FREDDY_API_KEY"

Example Response

{
  "object": "list",
  "data": [
    {
      "id": "prompt_abc123",
      "object": "prompt",
      "name": "Code Review Assistant",
      "description": "Reviews code pull requests and provides improvement suggestions",
      "tags": ["code-review", "development", "quality"],
      "isPublic": false,
      "createdAt": 1735689600,
      "updatedAt": 1735689600,
      "version": "1.0.0",
      "usageCount": 45
    },
    {
      "id": "prompt_def456",
      "object": "prompt",
      "name": "Customer Support Bot",
      "description": "Standard customer support responses with escalation options",
      "tags": ["support", "customer-service"],
      "isPublic": true,
      "createdAt": 1735603200,
      "updatedAt": 1735689600,
      "version": "2.1.0",
      "usageCount": 127
    }
  ],
  "hasMore": true,
  "limit": 10,
  "offset": 0,
  "total": 23
}
Previous page
Next page