List prompts

Fetches a paginated list of Prompts.

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

Headers

X-Hume-Api-KeystringRequired

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.