Skip to main content
GET
List prompts
Returns prompts you can access in your workspace. Use query parameters to paginate, search, or filter by folder and workspace sharing.

Base URL

Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.

Required Scopes

This endpoint requires the PROMPT_API scope.

Parameters

Example

Response Format

Success Response (200 OK)

Example Response

Error Handling

Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.

Authorizations

Authorization
string
header
required

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Query Parameters

limit
integer
default:50

Number of prompts to return.

Required range: 1 <= x <= 250
cursor
string<uuid>

Cursor from the previous response for pagination.

query
string

Search query matched against prompt title and content.

promptFolderId
string<uuid>

Filter by prompt folder UUID.

sharedWithWorkspace
enum<string>

Filter by workspace sharing.

Available options:
true,
false

Response

Prompts returned successfully

prompts
object[]
required
nextCursor
string<uuid>

Cursor for the next page, if more results are available.