Fields - Mintlify
Use fields to document API parameters and responses. There are two types of fields: parameter fields and response fields.
Parameter field
The <ParamField> component is used to define parameters for your APIs or SDKs. Adding a ParamField automatically adds an API Playground.
An example of a parameter field
<ParamField path="param" type="string" required>
An example of a parameter field
</ParamField>
Properties
query, path, body, or header
Whether the parameter is a query, path, body, or header. Followed by the parameter name.
Expected type of the parameter’s value.Supports number, string, boolean, object.Arrays can be defined using the [] suffix. For example string[].
Indicate whether the parameter is required.
Indicate whether the parameter is deprecated.
Default value populated when the request value is empty
Placeholder text for the input in the playground.
Description of the parameter (Markdown-enabled).
Response field
The <ResponseField> component defines the return values of an API.
An example of a response field
<ResponseField name="response" type="string" required>
A response field example
</ResponseField>
Properties
The name of the response value.
Expected type of the response value. This can be any arbitrary string.
Indicate whether the response is required.
Whether a field is deprecated.
Labels that are shown before the name of the field.
Labels that are shown after the name of the field.