> For the complete documentation index, see [llms.txt](https://docs.aicrisk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aicrisk.com/admin/custom-apis/adding-a-new-api/api-query-parameters.md).

# API Query Parameters

How to Fill Out API Query Parameters

### Parameter Name:

<figure><img src="https://2455207419-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZwCwAN15BUJcXMA5avi%2Fuploads%2FGMfVQ2hnxsSrosW6hZ7m%2Fimage.png?alt=media&amp;token=a47a2970-0209-49e5-904a-5e881b841254" alt=""><figcaption></figcaption></figure>

* *Input Field Type:* Text Field
* *Description:* This field allows the user to name one of the parameters for the Custom API.
* *Usage:* Enter a concise and descriptive name that succinctly identifies the API within the system. This name should facilitate easy recognition and differentiation among multiple APIs.

  <figure><img src="https://2455207419-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZwCwAN15BUJcXMA5avi%2Fuploads%2FxxetoDSymxtFFKFa0Bo6%2Fimage.png?alt=media&amp;token=0f499de1-2499-4b91-a9ff-4f19acfc2a0d" alt=""><figcaption></figcaption></figure>

### Value:&#x20;

* *Input Field Type:* Text Field
* *Description:* This field allows the user to declare the value of the parameter, if it requires a user's input leave it blank, if the value doesn't change input the unchanged value.
  * *Usage:* The input in this value field will query the correct information from the dataset of the API and return desired information.

    <figure><img src="https://2455207419-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZwCwAN15BUJcXMA5avi%2Fuploads%2FghlqLWVfUufNXPKNn4m0%2Fimage.png?alt=media&amp;token=0ba68d9e-0485-4e0e-ade9-5cdfed93f507" alt=""><figcaption></figcaption></figure>

### Description:

* *Input Field Type:* Text Field
* *Description:* This field allows the user to specify the exact format of needed input for parameter (Ex. Ticker for Company or YYYY-MM-DD).
* *Usage:* Enter a concise and descriptive description so that the agent assigned to the Custom API is able to ask the user for the correct further information if needed.

  <figure><img src="https://2455207419-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZwCwAN15BUJcXMA5avi%2Fuploads%2FTYLzOqQmUTlydD1Uc0s5%2Fimage.png?alt=media&amp;token=e345a0e8-d0bb-460a-8b0f-adfce02befb4" alt=""><figcaption></figcaption></figure>

### Required:

* *Input Field Type:* Check Box
* *Description:* This field allows the user to declare the parameter for the API required or not. Usually, will always be required unless it is the token which where a value will already have an input.&#x20;
* *Usage:* Double check with the API implementation of the Custom API so that the agent utilizing the Custom doesn't crash when trying to query for information it cannot find.&#x20;

  <figure><img src="https://2455207419-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZwCwAN15BUJcXMA5avi%2Fuploads%2F1ahKetGhebwZXMbdY8LP%2Fimage.png?alt=media&amp;token=d16877af-4ee0-436a-a266-5f68b4e699cc" alt=""><figcaption></figcaption></figure>
