# Search API Reference

OpenAPI source: https://api.are.na/v3/openapi.json

## GET /v3/search

- Label: Search across Are.na
- Docs: https://www.are.na/developers/explore/search
- Markdown: https://www.are.na/developers/explore/search.md
- Requires resource id: no
- Response content type: application/json

Search across blocks, channels, users, and groups.

**⚠️ Premium Only**: This endpoint requires a Premium subscription.

**Examples:**
- Simple: `/v3/search?query=brutalism`
- Images only: `/v3/search?query=architecture&type=Image`
- My content: `/v3/search?query=*&scope=my`
- In a channel: `/v3/search?query=design&channel_id=12345`
- By a user: `/v3/search?query=*&user_id=456`
- PDFs sorted by date: `/v3/search?query=*&ext=pdf&sort=created_at_desc`

Parameters:
- query: string (optional) — The search query string. Supports full-text search across titles,
descriptions, and content. Use `*` as a wildcard to match everything
(useful when filtering by type, scope, or extension).

- type: select[] (optional) options=All|Text|Image|Link|Attachment|Embed|Channel|Block|User|Group — Filter results by content type. Accepts comma-separated values.
- Block subtypes: `Text`, `Image`, `Link`, `Attachment`, `Embed`
- Aggregate types: `Block` (all block types), `Channel`, `User`, `Group`
- `All` returns everything (default behavior)

- scope: select (optional) options=all|my|following — Limit search to a specific context.
- user_id: number (optional) — Limit search to a specific user's content.
- group_id: number (optional) — Limit search to a specific group's content.
- channel_id: number (optional) — Limit search to a specific channel's content.
- ext: select[] (optional) options=aac|ai|aiff|avi|avif|bmp|csv|doc|docx|eps|epub|fla|gif|h264|heic|heif|ind|indd|jpeg|jpg|key|kml|kmz|latex|m4a|ma|mb|mid|midi|mov|mp3|mp4|mp4v|mpeg|mpg|mpg4|numbers|oga|ogg|ogv|otf|pages|pdf|pgp|png|ppt|pptx|psd|svg|swa|swf|tex|texi|texinfo|tfm|tif|tiff|torrent|ttc|ttf|txt|wav|webm|webp|wma|xls|xlsx|xlt — Filter results by file extension. Accepts comma-separated values.
Only applies to Attachment and Image block types. Common extensions
include: pdf, jpg, png, gif, mp4, mp3, doc, xls, etc.

- sort: select (optional) options=score_desc|created_at_desc|created_at_asc|updated_at_desc|updated_at_asc|name_asc|name_desc|connections_count_desc|random — Sort by relevance, date, name, or popularity. Defaults to `score_desc`.
Use `random` with `seed` for reproducible random ordering.

- after: string (optional) — Filter to only return results updated after this timestamp.
Useful for incremental syncing or finding recently modified content.
Format: ISO 8601 datetime string.

- seed: number (optional) — Random seed for reproducible random ordering. Only used when
`sort=random`. Providing the same seed will return results in
the same order, useful for pagination through random results.

- page: number (optional) — Page number for pagination
- per: number (optional) — Number of items per page (max 100)

Response schema:
```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "Array of results (blocks, channels, users, or groups)",
      "items": {
        "type": "oneOf",
        "variants": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the block",
                "example": 12345
              },
              "base_type": {
                "type": "string",
                "nullable": false,
                "description": "Base type of the block (always \"Block\")",
                "enum": [
                  "Block"
                ],
                "example": "Block"
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Block title",
                "example": "Interesting Article"
              },
              "description": {
                "type": "oneOf",
                "description": "Block description with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "state": {
                "type": "string",
                "nullable": false,
                "description": "Processing state of a block.\n- `processing`: Being processed (e.g., image resizing)\n- `available`: Ready for display\n- `failed`: Processing failed\n",
                "enum": [
                  "processing",
                  "available",
                  "failed"
                ],
                "refName": "BlockState"
              },
              "visibility": {
                "type": "string",
                "nullable": false,
                "description": "Visibility of a block.\n- `public`: Visible to everyone\n- `private`: Only visible to owner\n- `orphan`: Not connected to any channel\n",
                "enum": [
                  "public",
                  "private",
                  "orphan"
                ],
                "refName": "BlockVisibility"
              },
              "comment_count": {
                "type": "integer",
                "nullable": false,
                "description": "Number of comments on the block",
                "example": 5
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was last updated",
                "format": "date-time",
                "example": "2023-01-15T14:45:00Z"
              },
              "user": {
                "type": "object",
                "description": "Embedded user representation (used when user is nested in other resources)",
                "…": "see OpenAPI spec for full schema"
              },
              "metadata": {
                "type": "oneOf",
                "description": "Custom key-value metadata",
                "…": "see OpenAPI spec for full schema"
              },
              "source": {
                "type": "oneOf",
                "description": "Source URL and metadata (if block was created from a URL)",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              },
              "connection": {
                "type": "oneOf",
                "description": "Connection context (only present when block is returned as part of channel contents).\nContains position, pinned status, and information about who connected the block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "can": {
                "type": "oneOf",
                "description": "Abilities object (only present for full block responses, not in channel contents).\nIndicates what actions the current user can perform on this block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Block type (always \"Text\" for TextBlock)",
                "enum": [
                  "Text"
                ]
              },
              "content": {
                "type": "object",
                "description": "Markdown content with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "base_type",
              "state",
              "visibility",
              "comment_count",
              "created_at",
              "updated_at",
              "user",
              "_links",
              "type",
              "content"
            ],
            "description": "A text block containing markdown content",
            "refName": "TextBlock"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the block",
                "example": 12345
              },
              "base_type": {
                "type": "string",
                "nullable": false,
                "description": "Base type of the block (always \"Block\")",
                "enum": [
                  "Block"
                ],
                "example": "Block"
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Block title",
                "example": "Interesting Article"
              },
              "description": {
                "type": "oneOf",
                "description": "Block description with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "state": {
                "type": "string",
                "nullable": false,
                "description": "Processing state of a block.\n- `processing`: Being processed (e.g., image resizing)\n- `available`: Ready for display\n- `failed`: Processing failed\n",
                "enum": [
                  "processing",
                  "available",
                  "failed"
                ],
                "refName": "BlockState"
              },
              "visibility": {
                "type": "string",
                "nullable": false,
                "description": "Visibility of a block.\n- `public`: Visible to everyone\n- `private`: Only visible to owner\n- `orphan`: Not connected to any channel\n",
                "enum": [
                  "public",
                  "private",
                  "orphan"
                ],
                "refName": "BlockVisibility"
              },
              "comment_count": {
                "type": "integer",
                "nullable": false,
                "description": "Number of comments on the block",
                "example": 5
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was last updated",
                "format": "date-time",
                "example": "2023-01-15T14:45:00Z"
              },
              "user": {
                "type": "object",
                "description": "Embedded user representation (used when user is nested in other resources)",
                "…": "see OpenAPI spec for full schema"
              },
              "metadata": {
                "type": "oneOf",
                "description": "Custom key-value metadata",
                "…": "see OpenAPI spec for full schema"
              },
              "source": {
                "type": "oneOf",
                "description": "Source URL and metadata (if block was created from a URL)",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              },
              "connection": {
                "type": "oneOf",
                "description": "Connection context (only present when block is returned as part of channel contents).\nContains position, pinned status, and information about who connected the block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "can": {
                "type": "oneOf",
                "description": "Abilities object (only present for full block responses, not in channel contents).\nIndicates what actions the current user can perform on this block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Block type (always \"Image\" for ImageBlock)",
                "enum": [
                  "Image"
                ]
              },
              "image": {
                "type": "object",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "base_type",
              "state",
              "visibility",
              "comment_count",
              "created_at",
              "updated_at",
              "user",
              "_links",
              "type",
              "image"
            ],
            "description": "An image block containing an uploaded or scraped image",
            "refName": "ImageBlock"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the block",
                "example": 12345
              },
              "base_type": {
                "type": "string",
                "nullable": false,
                "description": "Base type of the block (always \"Block\")",
                "enum": [
                  "Block"
                ],
                "example": "Block"
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Block title",
                "example": "Interesting Article"
              },
              "description": {
                "type": "oneOf",
                "description": "Block description with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "state": {
                "type": "string",
                "nullable": false,
                "description": "Processing state of a block.\n- `processing`: Being processed (e.g., image resizing)\n- `available`: Ready for display\n- `failed`: Processing failed\n",
                "enum": [
                  "processing",
                  "available",
                  "failed"
                ],
                "refName": "BlockState"
              },
              "visibility": {
                "type": "string",
                "nullable": false,
                "description": "Visibility of a block.\n- `public`: Visible to everyone\n- `private`: Only visible to owner\n- `orphan`: Not connected to any channel\n",
                "enum": [
                  "public",
                  "private",
                  "orphan"
                ],
                "refName": "BlockVisibility"
              },
              "comment_count": {
                "type": "integer",
                "nullable": false,
                "description": "Number of comments on the block",
                "example": 5
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was last updated",
                "format": "date-time",
                "example": "2023-01-15T14:45:00Z"
              },
              "user": {
                "type": "object",
                "description": "Embedded user representation (used when user is nested in other resources)",
                "…": "see OpenAPI spec for full schema"
              },
              "metadata": {
                "type": "oneOf",
                "description": "Custom key-value metadata",
                "…": "see OpenAPI spec for full schema"
              },
              "source": {
                "type": "oneOf",
                "description": "Source URL and metadata (if block was created from a URL)",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              },
              "connection": {
                "type": "oneOf",
                "description": "Connection context (only present when block is returned as part of channel contents).\nContains position, pinned status, and information about who connected the block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "can": {
                "type": "oneOf",
                "description": "Abilities object (only present for full block responses, not in channel contents).\nIndicates what actions the current user can perform on this block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Block type (always \"Link\" for LinkBlock)",
                "enum": [
                  "Link"
                ]
              },
              "image": {
                "type": "oneOf",
                "description": "Preview image (if available)",
                "…": "see OpenAPI spec for full schema"
              },
              "content": {
                "type": "oneOf",
                "description": "Extracted text content from the link",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "base_type",
              "state",
              "visibility",
              "comment_count",
              "created_at",
              "updated_at",
              "user",
              "_links",
              "type"
            ],
            "description": "A link block representing a URL with optional preview",
            "refName": "LinkBlock"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the block",
                "example": 12345
              },
              "base_type": {
                "type": "string",
                "nullable": false,
                "description": "Base type of the block (always \"Block\")",
                "enum": [
                  "Block"
                ],
                "example": "Block"
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Block title",
                "example": "Interesting Article"
              },
              "description": {
                "type": "oneOf",
                "description": "Block description with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "state": {
                "type": "string",
                "nullable": false,
                "description": "Processing state of a block.\n- `processing`: Being processed (e.g., image resizing)\n- `available`: Ready for display\n- `failed`: Processing failed\n",
                "enum": [
                  "processing",
                  "available",
                  "failed"
                ],
                "refName": "BlockState"
              },
              "visibility": {
                "type": "string",
                "nullable": false,
                "description": "Visibility of a block.\n- `public`: Visible to everyone\n- `private`: Only visible to owner\n- `orphan`: Not connected to any channel\n",
                "enum": [
                  "public",
                  "private",
                  "orphan"
                ],
                "refName": "BlockVisibility"
              },
              "comment_count": {
                "type": "integer",
                "nullable": false,
                "description": "Number of comments on the block",
                "example": 5
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was last updated",
                "format": "date-time",
                "example": "2023-01-15T14:45:00Z"
              },
              "user": {
                "type": "object",
                "description": "Embedded user representation (used when user is nested in other resources)",
                "…": "see OpenAPI spec for full schema"
              },
              "metadata": {
                "type": "oneOf",
                "description": "Custom key-value metadata",
                "…": "see OpenAPI spec for full schema"
              },
              "source": {
                "type": "oneOf",
                "description": "Source URL and metadata (if block was created from a URL)",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              },
              "connection": {
                "type": "oneOf",
                "description": "Connection context (only present when block is returned as part of channel contents).\nContains position, pinned status, and information about who connected the block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "can": {
                "type": "oneOf",
                "description": "Abilities object (only present for full block responses, not in channel contents).\nIndicates what actions the current user can perform on this block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Block type (always \"Attachment\" for AttachmentBlock)",
                "enum": [
                  "Attachment"
                ]
              },
              "attachment": {
                "type": "object",
                "…": "see OpenAPI spec for full schema"
              },
              "image": {
                "type": "oneOf",
                "description": "Preview image (for PDFs and other previewable files)",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "base_type",
              "state",
              "visibility",
              "comment_count",
              "created_at",
              "updated_at",
              "user",
              "_links",
              "type",
              "attachment"
            ],
            "description": "An attachment block containing an uploaded file",
            "refName": "AttachmentBlock"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the block",
                "example": 12345
              },
              "base_type": {
                "type": "string",
                "nullable": false,
                "description": "Base type of the block (always \"Block\")",
                "enum": [
                  "Block"
                ],
                "example": "Block"
              },
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Block title",
                "example": "Interesting Article"
              },
              "description": {
                "type": "oneOf",
                "description": "Block description with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "state": {
                "type": "string",
                "nullable": false,
                "description": "Processing state of a block.\n- `processing`: Being processed (e.g., image resizing)\n- `available`: Ready for display\n- `failed`: Processing failed\n",
                "enum": [
                  "processing",
                  "available",
                  "failed"
                ],
                "refName": "BlockState"
              },
              "visibility": {
                "type": "string",
                "nullable": false,
                "description": "Visibility of a block.\n- `public`: Visible to everyone\n- `private`: Only visible to owner\n- `orphan`: Not connected to any channel\n",
                "enum": [
                  "public",
                  "private",
                  "orphan"
                ],
                "refName": "BlockVisibility"
              },
              "comment_count": {
                "type": "integer",
                "nullable": false,
                "description": "Number of comments on the block",
                "example": 5
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the block was last updated",
                "format": "date-time",
                "example": "2023-01-15T14:45:00Z"
              },
              "user": {
                "type": "object",
                "description": "Embedded user representation (used when user is nested in other resources)",
                "…": "see OpenAPI spec for full schema"
              },
              "metadata": {
                "type": "oneOf",
                "description": "Custom key-value metadata",
                "…": "see OpenAPI spec for full schema"
              },
              "source": {
                "type": "oneOf",
                "description": "Source URL and metadata (if block was created from a URL)",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              },
              "connection": {
                "type": "oneOf",
                "description": "Connection context (only present when block is returned as part of channel contents).\nContains position, pinned status, and information about who connected the block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "can": {
                "type": "oneOf",
                "description": "Abilities object (only present for full block responses, not in channel contents).\nIndicates what actions the current user can perform on this block.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Block type (always \"Embed\" for EmbedBlock)",
                "enum": [
                  "Embed"
                ]
              },
              "embed": {
                "type": "object",
                "…": "see OpenAPI spec for full schema"
              },
              "image": {
                "type": "oneOf",
                "description": "Thumbnail image (if available)",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "base_type",
              "state",
              "visibility",
              "comment_count",
              "created_at",
              "updated_at",
              "user",
              "_links",
              "type",
              "embed"
            ],
            "description": "An embed block containing embedded media (video, audio, etc.)",
            "refName": "EmbedBlock"
          },
          {
            "type": "object",
            "required": [
              "id",
              "type",
              "slug",
              "title",
              "state",
              "visibility",
              "created_at",
              "updated_at",
              "owner",
              "counts",
              "_links"
            ],
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the channel",
                "example": 12345
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Channel type",
                "enum": [
                  "Channel"
                ],
                "example": "Channel"
              },
              "slug": {
                "type": "string",
                "nullable": false,
                "description": "Channel URL slug",
                "example": "my-collection-abc123"
              },
              "title": {
                "type": "string",
                "nullable": false,
                "description": "Channel title",
                "example": "My Collection"
              },
              "description": {
                "type": "oneOf",
                "description": "Channel description with multiple renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "state": {
                "type": "string",
                "nullable": false,
                "description": "Lifecycle state of a channel.\n- `available`: Active and accessible\n- `deleted`: Soft deleted\n",
                "enum": [
                  "available",
                  "deleted"
                ],
                "refName": "ChannelState"
              },
              "visibility": {
                "type": "string",
                "nullable": false,
                "description": "Visibility level of a channel:\n- `public`: Anyone can view and connect to the channel\n- `private`: Only the owner and collaborators can view\n- `closed`: Anyone can view, but only collaborators can add content\n",
                "enum": [
                  "public",
                  "private",
                  "closed"
                ],
                "refName": "ChannelVisibility"
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the channel was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the channel was last updated",
                "format": "date-time",
                "example": "2023-01-15T14:45:00Z"
              },
              "metadata": {
                "type": "oneOf",
                "description": "Custom key-value metadata",
                "…": "see OpenAPI spec for full schema"
              },
              "owner": {
                "type": "oneOf",
                "description": "Channel owner (User or Group)",
                "…": "see OpenAPI spec for full schema"
              },
              "counts": {
                "type": "object",
                "description": "Counts of various items in the channel",
                "…": "see OpenAPI spec for full schema"
              },
              "collaborators": {
                "type": "array",
                "description": "Collaborators on this channel (users and groups).\nOnly present when channel is returned as a full resource, not when embedded.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              },
              "connection": {
                "type": "oneOf",
                "description": "Connection context (only present when channel is returned as part of another channel's contents).\nContains position, pinned status, and information about who connected the channel.\n",
                "…": "see OpenAPI spec for full schema"
              },
              "can": {
                "type": "oneOf",
                "description": "Actions the current user can perform on this channel.\nOnly present when channel is returned as a full resource, not when embedded.\n",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "refName": "Channel"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the user",
                "example": 12345
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "User type",
                "enum": [
                  "User"
                ],
                "example": "User"
              },
              "name": {
                "type": "string",
                "nullable": false,
                "description": "User's display name",
                "example": "John Doe"
              },
              "slug": {
                "type": "string",
                "nullable": false,
                "description": "URL-safe identifier (use this in API paths)",
                "example": "john-doe"
              },
              "avatar": {
                "type": "string",
                "nullable": true,
                "description": "URL to user's avatar image",
                "format": "uri",
                "example": "https://d2w9rnfcy7mm78.cloudfront.net/12345/avatar.jpg"
              },
              "initials": {
                "type": "string",
                "nullable": false,
                "description": "User's initials",
                "example": "JD"
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the user was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the user was last updated",
                "format": "date-time",
                "example": "2023-06-20T14:45:00Z"
              },
              "bio": {
                "type": "oneOf",
                "description": "User biography with markdown, HTML, and plain text renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "badge": {
                "type": "oneOf",
                "description": "Denotes plan or other distinction",
                "…": "see OpenAPI spec for full schema"
              },
              "tier": {
                "type": "string",
                "nullable": false,
                "description": "User subscription tier:\n- `guest`: Unauthenticated user\n- `free`: Free account\n- `premium`: Premium subscriber\n- `supporter`: Supporter tier\n",
                "enum": [
                  "guest",
                  "free",
                  "premium",
                  "supporter"
                ],
                "refName": "UserTier"
              },
              "counts": {
                "type": "object",
                "description": "Counts of various items for the user",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "type",
              "name",
              "slug",
              "avatar",
              "initials",
              "created_at",
              "updated_at",
              "badge",
              "tier",
              "counts",
              "_links"
            ],
            "description": "Full user representation",
            "refName": "User"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "nullable": false,
                "description": "Unique identifier for the group",
                "example": 67890
              },
              "type": {
                "type": "string",
                "nullable": false,
                "description": "Group type",
                "enum": [
                  "Group"
                ],
                "example": "Group"
              },
              "name": {
                "type": "string",
                "nullable": false,
                "description": "Group's name",
                "example": "Design Team"
              },
              "slug": {
                "type": "string",
                "nullable": false,
                "description": "Group's URL slug",
                "example": "design-team-abc123"
              },
              "avatar": {
                "type": "string",
                "nullable": true,
                "description": "URL to group's avatar image",
                "format": "uri",
                "example": "https://d2w9rnfcy7mm78.cloudfront.net/groups/67890/avatar.jpg"
              },
              "initials": {
                "type": "string",
                "nullable": false,
                "description": "Group's initials",
                "example": "DT"
              },
              "bio": {
                "type": "oneOf",
                "description": "Group biography with markdown, HTML, and plain text renderings",
                "…": "see OpenAPI spec for full schema"
              },
              "created_at": {
                "type": "string",
                "nullable": false,
                "description": "When the group was created",
                "format": "date-time",
                "example": "2023-01-15T10:30:00Z"
              },
              "updated_at": {
                "type": "string",
                "nullable": false,
                "description": "When the group was last updated",
                "format": "date-time",
                "example": "2023-06-20T14:45:00Z"
              },
              "user": {
                "type": "object",
                "description": "Embedded user representation (used when user is nested in other resources)",
                "…": "see OpenAPI spec for full schema"
              },
              "counts": {
                "type": "object",
                "description": "Counts of various items for the group",
                "…": "see OpenAPI spec for full schema"
              },
              "_links": {
                "type": "object",
                "description": "HATEOAS links for navigation and discovery.\nFollows HAL (Hypertext Application Language) format where link relationships \nare expressed as object keys (e.g., \"self\", \"user\", \"channels\").\n",
                "…": "see OpenAPI spec for full schema"
              }
            },
            "required": [
              "id",
              "type",
              "name",
              "slug",
              "avatar",
              "initials",
              "created_at",
              "updated_at",
              "user",
              "counts",
              "_links"
            ],
            "description": "Full group representation",
            "refName": "Group"
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "description": "Pagination metadata",
      "required": [
        "current_page",
        "per_page",
        "total_pages",
        "total_count",
        "has_more_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "nullable": false,
          "description": "Current page number",
          "example": 1
        },
        "next_page": {
          "type": "integer",
          "nullable": true,
          "description": "Next page number (null if last page)",
          "example": 2
        },
        "prev_page": {
          "type": "integer",
          "nullable": true,
          "description": "Previous page number (null if first page)"
        },
        "per_page": {
          "type": "integer",
          "nullable": false,
          "description": "Number of items per page",
          "example": 25
        },
        "total_pages": {
          "type": "integer",
          "nullable": false,
          "description": "Total number of pages available",
          "example": 5
        },
        "total_count": {
          "type": "integer",
          "nullable": false,
          "description": "Total number of items available",
          "example": 120
        },
        "has_more_pages": {
          "type": "boolean",
          "nullable": false,
          "description": "Whether there are more pages available",
          "example": true
        }
      },
      "refName": "PaginationMeta"
    }
  },
  "required": [
    "data",
    "data",
    "meta"
  ],
  "description": "Paginated list of all content types with total count",
  "refName": "EverythingListResponse"
}
```