Read configuration

GET

/api/v1/settings/item

const url = 'https://api.inside.chat/api/v1/settings/item?website_id=example&path=example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.inside.chat/api/v1/settings/item?website_id=example&path=example' \
  --header 'Authorization: Bearer <token>'

Required scopes: config_read
Data access: –
MCP tool: config_get

Read bounded current active-version metadata at /ai/features or an owned stable feature path. Unrestricted installation policy required. Credentials, instructions, settings, models, functions and history are excluded.

Authorizations

installation_token
oauth_client_credentials
config_read

Parameters

Query Parameters

website_id

required

string

/^web_[0-9]{1,20}_[1-9][0-9]{0,18}$/

An explicitly granted website.

path

required

string

<= 200 characters /^/ai/features(?:/aif_[0-9]{1,20}_[1-9][0-9]{0,18}_[1-9][0-9]{0,18})?$/

limit

integer

>= 1 <= 100

cursor

string

/^aif_[0-9]{1,20}_[1-9][0-9]{0,18}_[1-9][0-9]{0,18}$/

Responses

200

Authorized result. Projection depends on current scopes and data policy.

application/json

A page of AI feature metadata for path=/ai/features, or one item for path=/ai/features/{feature_id}.

object

data

required

One of:

object
object

object

path

required

Allowed value: /ai/features

items

required

Array<object>

<= 100 items

object

required

string

/^aif_[0-9]{1,20}_[1-9][0-9]{0,18}_[1-9][0-9]{0,18}$/

name

required

string

<= 200 characters

type

required

string

Allowed values: autopilot ask_ai copilot translation language_detection spam_checker spelling_grammar_check rephrase chat_summary metrics scoring product_recommendation email_autopilot voice_autopilot citation_summary unsupported

enabled

required

boolean

version

required

Latest active version. Send it as expected_version.

integer

>= 1

truncated

required

More rows exist after next_cursor.

boolean

next_cursor

required

Any of:

string
null

string

/^aif_[0-9]{1,20}_[1-9][0-9]{0,18}_[1-9][0-9]{0,18}$/

Example

{
  "data": {
    "path": "/ai/features",
    "items": [
      {
        "type": "autopilot"
      }
    ]
  }
}

400

Invalid, duplicate or unsupported request parameters.

401

Missing, expired or revoked installation credential.

404

Resource not found or not permitted by current authority.

422

The requested capability is not available for application installations.

429

Per-app quota exceeded.

Headers

Retry-After

integer

>= 1

503

Enrollment, native service or required authority is unavailable.