Response Field

Overview

The ResponseField component documents the fields returned by your API responses. It shows:

• Field name: The key in the JSON or response object.
• Type: The data type such as string, integer, or object.
• Status: Required and Deprecated badges.
• Rich descriptions: Human-readable explanations of what the field represents.

You can use ResponseField in two ways:

• Editor UI: Add and edit response fields visually with a form-based panel.
• MDX: Use the <ResponseField> component directly in your content.

Using with Web Editor

Add a ResponseField block

1. Place your cursor where you want to describe a response field.
2. Type / to open the command menu and search for Response Field.
3. Select Response Field to insert the component.

A new response field row appears with a default name and type plus a description placeholder.

Edit field metadata

To change the label and status:

1. Click the three-dot menu on the right side of the ResponseField block.
2. In the Response Field settings panel, you can edit:

• Field Name: The name of the field in the response payload (for example, id, status, user).
• Type: The data type of the field (for example, string, integer, boolean, object, array).
• Required: Toggle on to mark the field as required in the response.
• Deprecated: Toggle on to show that the field is deprecated.

Click Save to apply your changes.

Edit the description

• Click in the description area under the badges (for example, Response field description…).

• Add your explanation using any supported content:

  • Text and headings
  • Lists and tables
  • Code blocks showing example responses
  • Callouts and other MDX components

Using with Code Editor

Basic syntax

Use the <ResponseField> component to document API response fields with their type and status.

<ResponseField name="id" field-type="string" required="true">
  Unique identifier for the resource.
</ResponseField>

Examples

Optional field

<ResponseField name="description" field-type="string">
  Optional description text for the resource.
</ResponseField>

Deprecated field

<ResponseField name="legacy_id" field-type="integer" deprecated="true">
  Deprecated legacy identifier. Use `id` instead.
</ResponseField>

Complex type

<ResponseField name="user" field-type="object" required="true">
  User object containing profile information and preferences.
</ResponseField>

Advanced options

Attributes