Get installation context

GET

/api/v1/context

const url = 'https://api.inside.chat/api/v1/context';
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/context \
  --header 'Authorization: Bearer <token>'

Required scopes: –
Data access: –
MCP tool: gateway_context

Read current installation context and available guide names. No native/customer read; website inventory requires website_read. No query parameters.

Authorizations

installation_token
oauth_client_credentials

Responses

200

Current grant metadata or permitted guidance; every subsequent action rechecks authority.

application/json

object

principal

required

string

Allowed value: app_installation

environment

required

string

organization_id

required

string

app_id

required

string

installation_id

required

string

scopes

required

Array<string>

website_ids

required

Array<string>

data_access

required

object

message_content

required

boolean

pii

required

boolean

internal_notes

required

boolean

restrictions

required

object

channel_ids

Array<string>

team_ids

Array<string>

subsite_ids

Array<string>

authority_expires_at

required

integer

>= 1

guides

required

Array<string>

Allowed values: overview investigation contacts reporting configuration agent_tasks event_recovery

Example

{
  "principal": "app_installation",
  "guides": [
    "overview"
  ]
}

400

Unsupported input.

401

Missing, expired or changed installation authority.

404

Guide unavailable under current grants.

429

Shared application quota exceeded.

Headers

Retry-After

integer

>= 1