# PromptBookmark

## Retrieves prompt bookmarks for the current user.

> Returns all bookmarks owned by the authenticated user, optionally filtered by prompt feature.

```json
{"openapi":"3.0.1","info":{"title":"WebApi | v1","version":"1.0.0"},"tags":[{"name":"PromptBookmark"}],"servers":[{"url":"https://api.safegpt.nl/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT bearer token. Example: 'Bearer {token}'.","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/PromptBookmark/Get/{promptFeature}":{"get":{"tags":["PromptBookmark"],"summary":"Retrieves prompt bookmarks for the current user.","description":"Returns all bookmarks owned by the authenticated user, optionally filtered by prompt feature.","parameters":[{"name":"promptFeature","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Authentication is required."},"403":{"description":"The user is not authorized to access this endpoint."}}}}}}
```

## Creates a new prompt bookmark for the current user.

> Stores bookmark metadata and prompt content under the authenticated user's profile.

```json
{"openapi":"3.0.1","info":{"title":"WebApi | v1","version":"1.0.0"},"tags":[{"name":"PromptBookmark"}],"servers":[{"url":"https://api.safegpt.nl/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT bearer token. Example: 'Bearer {token}'.","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CreatePromptBookmarkViewModel":{"required":["name","prompt","promptFeature"],"type":"object","properties":{"name":{"type":"string","description":"Display name of the bookmark."},"description":{"type":"string","description":"Optional explanatory description.","nullable":true},"prompt":{"type":"string","description":"Prompt text template to store."},"promptFeature":{"$ref":"#/components/schemas/PromptFeature"}},"description":"Represents the payload for creating a prompt bookmark."},"PromptFeature":{"type":"integer","description":"Target feature context for this bookmark."}}},"paths":{"/v1/PromptBookmark/Create":{"post":{"tags":["PromptBookmark"],"summary":"Creates a new prompt bookmark for the current user.","description":"Stores bookmark metadata and prompt content under the authenticated user's profile.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePromptBookmarkViewModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/CreatePromptBookmarkViewModel"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/CreatePromptBookmarkViewModel"}}},"required":true},"responses":{"200":{"description":"OK"},"401":{"description":"Authentication is required."},"403":{"description":"The user is not authorized to access this endpoint."}}}}}}
```

## Updates an existing prompt bookmark.

> Applies partial updates to bookmark fields after ownership validation.

```json
{"openapi":"3.0.1","info":{"title":"WebApi | v1","version":"1.0.0"},"tags":[{"name":"PromptBookmark"}],"servers":[{"url":"https://api.safegpt.nl/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT bearer token. Example: 'Bearer {token}'.","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UpdatePromptBookmarkViewModel":{"required":["name","prompt"],"type":"object","properties":{"name":{"type":"string","description":"Updated bookmark name."},"description":{"type":"string","description":"Updated bookmark description.","nullable":true},"prompt":{"type":"string","description":"Updated prompt template content."}},"description":"Represents the payload for updating an existing prompt bookmark."}}},"paths":{"/v1/PromptBookmark/Update/{promptBookMarkId}":{"patch":{"tags":["PromptBookmark"],"summary":"Updates an existing prompt bookmark.","description":"Applies partial updates to bookmark fields after ownership validation.","parameters":[{"name":"promptBookMarkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePromptBookmarkViewModel"}},"text/json":{"schema":{"$ref":"#/components/schemas/UpdatePromptBookmarkViewModel"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/UpdatePromptBookmarkViewModel"}}},"required":true},"responses":{"200":{"description":"OK"},"401":{"description":"Authentication is required."},"403":{"description":"The user is not authorized to access this endpoint."}}}}}}
```

## Deletes an existing prompt bookmark.

> Removes the bookmark after validating ownership.

```json
{"openapi":"3.0.1","info":{"title":"WebApi | v1","version":"1.0.0"},"tags":[{"name":"PromptBookmark"}],"servers":[{"url":"https://api.safegpt.nl/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT bearer token. Example: 'Bearer {token}'.","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v1/PromptBookmark/Delete/{promptBookMarkId}":{"delete":{"tags":["PromptBookmark"],"summary":"Deletes an existing prompt bookmark.","description":"Removes the bookmark after validating ownership.","parameters":[{"name":"promptBookMarkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Authentication is required."},"403":{"description":"The user is not authorized to access this endpoint."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.safegpt.nl/api-en/endpoints/promptbookmark.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.