> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.ollang.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Custom Instruction Suggestions

> Retrieve suggested preset custom instructions you can adopt or adapt

Returns a curated list of suggested custom instructions (templates). Use these as starting points when creating your own via [Create Custom Instruction](/apis/ollang-api-reference/create-custom-instruction).

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api-integration.ollang.com/integration/custom-instructions/suggestions" \
    -H "X-Api-Key: <your-api-key>"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api-integration.ollang.com/integration/custom-instructions/suggestions",
    {
      method: "GET",
      headers: {
        "X-Api-Key": "<your-api-key>",
      },
    }
  );

  const suggestions = await response.json();
  ```

  ```python Python theme={null}
  import requests

  headers = {"X-Api-Key": "<your-api-key>"}

  response = requests.get(
      "https://api-integration.ollang.com/integration/custom-instructions/suggestions",
      headers=headers,
  )

  suggestions = response.json()
  ```
</RequestExample>

## Authorizations

This endpoint requires API key authentication.

* **Header name**: `X-Api-Key`
* **Header value**: Your API key from the [Ollang dashboard](https://lab.ollang.com)

## Response

Each suggestion includes key, value, optional description, and `active` (template default).

<ResponseField name="key" type="string">
  Suggested instruction key.
</ResponseField>

<ResponseField name="value" type="string">
  Suggested instruction body text.
</ResponseField>

<ResponseField name="description" type="string">
  Optional explanation of the suggestion.
</ResponseField>

<ResponseField name="active" type="boolean">
  Whether the template is marked active by default.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "key": "tone_and_register",
      "value": "Match the formality level of the source. Business emails should remain professional.",
      "description": "Instructions for maintaining appropriate tone and register",
      "active": true
    }
  ]
  ```

  ```json 401 theme={null}
  {
    "error": "Unauthorized",
    "message": "Invalid or missing API key"
  }
  ```
</ResponseExample>