List prompts | Hume API

1 curl https://api.hume.ai \ 2 -H "X-Hume-Api-Key: <apiKey>"

1 { 2 "page_number": 0, 3 "page_size": 2, 4 "total_pages": 1, 5 "prompts_page": [ 6 { 7 "id": "af699d45-2985-42cc-91b9-af9e5da3bac5", 8 "version": 0, 9 "version_type": "FIXED", 10 "name": "Weather Assistant Prompt", 11 "created_on": 1715267200693, 12 "modified_on": 1715267200693, 13 "text": "<role>You are an AI weather assistant providing users with accurate and up-to-date weather information. Respond to user queries concisely and clearly. Use simple language and avoid technical jargon. Provide temperature, precipitation, wind conditions, and any weather alerts. Include helpful tips if severe weather is expected.</role>", 14 "version_description": "" 15 }, 16 { 17 "id": "616b2b4c-a096-4445-9c23-64058b564fc2", 18 "version": 0, 19 "version_type": "FIXED", 20 "name": "Web Search Assistant Prompt", 21 "created_on": 1715267200693, 22 "modified_on": 1715267200693, 23 "text": "<role>You are an AI web search assistant designed to help users find accurate and relevant information on the web. Respond to user queries promptly, using the built-in web search tool to retrieve up-to-date results. Present information clearly and concisely, summarizing key points where necessary. Use simple language and avoid technical jargon. If needed, provide helpful tips for refining search queries to obtain better results.</role>", 24 "version_description": "" 25 } 26 ] 27 }

Fetches a paginated list of Prompts.

See our prompting guide for tips on crafting your system prompt.

Query parameters

page_numberintegerOptionalDefaults to 0

Specifies the page number to retrieve, enabling pagination.

This parameter uses zero-based indexing. For example, setting page_number to 0 retrieves the first page of results (items 0-9 if page_size is 10), setting page_number to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.

page_sizeintegerOptional

Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive.

For example, if page_size is set to 10, each page will include up to 10 items. Defaults to 10.

restrict_to_most_recentbooleanOptional

Only include the most recent version of each prompt in the list.

namestringOptional

Filter to only include prompts with name.

Response

Success

page_numberinteger

The page number of the returned list.

This value corresponds to the page_number parameter specified in the request. Pagination uses zero-based indexing.

page_sizeinteger

The maximum number of items returned per page.

This value corresponds to the page_size parameter specified in the request.

total_pagesinteger

The total number of pages in the collection.

prompts_pagelist of objects

List of prompts returned for the specified page_number and page_size.

Headers

Query parameters

Response