---
description: The SQL API introspection endpoint now discovers `attributes` keys with the `include_attributes` parameter, and `include_custom_attributes` is deprecated.
title: "SQL API introspection: `include_attributes` parameter"
image: https://developers.cloudflare.com/changelog/post/2026-10-27-introspection-include-attributes/og.png?v=684fcd285f467121
---

[Skip to content](#main-content)

[View RSS feeds](https://developers.cloudflare.com/fundamentals/new-features/available-rss-feeds/) [ Subscribe to RSS](https://developers.cloudflare.com/changelog/rss/index.xml)

[Back to all posts](https://developers.cloudflare.com/changelog)

October 27, 2026

## SQL API introspection: \`include\_attributes\` parameter

[Analytics](https://developers.cloudflare.com/analytics/)

Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/changelog/post/2026-10-27-introspection-include-attributes/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/)

The SQL API introspection endpoint has a new `include_attributes` query parameter. Setting it to `true` discovers the keys of a dataset's `attributes` JSON column, and their types, from the preceding seven days of your account's data. Discovered keys are returned in the dataset's `attributes` response field.

Some datasets store additional key-value data in an `attributes` JSON column, which you query with exact-key lookups such as `attributes['http.method']`. The previous way to discover these keys, `include_custom_attributes`, returned names in a `custom_attributes` field. The new names make it clearer that each returned name is a key you access through the `attributes` column.

`include_custom_attributes` and `custom_attributes` are deprecated but still work. Update integrations to use `include_attributes` and `attributes`.

```bash
curl --get "https://api.cloudflare.com/client/v4/analytics/sql/introspection" \
  --header "Authorization: Bearer <API_TOKEN>" \
  --data-urlencode "account_tag=<ACCOUNT_TAG>" \
  --data-urlencode "dataset_name=events.httpRequests" \
  --data-urlencode "include_attributes=true"
```

For more information, refer to [Attributes](https://developers.cloudflare.com/analytics/sql-api/datasets/#attributes).

```json
{"@context":"https://schema.org","@type":"BlogPosting","@id":"https://developers.cloudflare.com/changelog/post/2026-10-27-introspection-include-attributes/#page","headline":"SQL API introspection: `include_attributes` parameter","description":"The SQL API introspection endpoint now discovers attributes keys with the include_attributes parameter, and include_custom_attributes is deprecated.","url":"https://developers.cloudflare.com/changelog/post/2026-10-27-introspection-include-attributes/","inLanguage":"en","image":"https://developers.cloudflare.com/changelog/post/2026-10-27-introspection-include-attributes/og.png?v=684fcd285f467121","dateModified":"2026-10-27","datePublished":"2026-10-27","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```