{ "name": "CreateEnvironmentInsight", "fully_qualified_name": "PosthogApi.CreateEnvironmentInsight@0.1.0", "description": "Create a new insight for an environment.\n\nUse this tool to add a new insight for a specified environment within a project. It logs a new view each time it is called and is useful for tracking file system views in your projects.", "toolkit": { "name": "ArcadePosthogApi", "description": null, "version": "0.1.0" }, "input": { "parameters": [ { "name": "project_id", "required": true, "description": "Project ID to access the specific project. Retrieve using /api/projects/.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/." }, "inferrable": true, "http_endpoint_parameter_name": "project_id" }, { "name": "output_format", "required": false, "description": "Specify the format of the output data. Accepted values are 'csv' or 'json'.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": [ "csv", "json" ], "properties": null, "inner_properties": null, "description": "" }, "inferrable": true, "http_endpoint_parameter_name": "format" }, { "name": "environment_insight_params", "required": false, "description": "A JSON object containing detailed parameters for creating an environment insight, such as id, short_id, name, query, and more.", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "id": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "short_id": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "derived_name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "query": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "order": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "deleted": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "dashboards": { "val_type": "array", "inner_val_type": "integer", "enum": null, "properties": null, "inner_properties": null, "description": "\n DEPRECATED. Will be removed in a future release. Use dashboard_tiles instead.\n A dashboard ID for each of the dashboards that this insight is displayed on.\n " }, "dashboard_tiles": { "val_type": "array", "inner_val_type": "json", "enum": null, "properties": null, "inner_properties": { "id": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "dashboard_id": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "deleted": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "description": "\n A dashboard tile ID and dashboard_id for each of the dashboards that this insight is displayed on.\n " }, "last_refresh": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "\n The datetime this insight's results were generated.\n If added to one or more dashboards the insight can be refreshed separately on each.\n Returns the appropriate last_refresh datetime for the context the insight is viewed in\n (see from_dashboard query parameter).\n " }, "cache_target_age": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The target age of the cached results for this insight." }, "next_allowed_client_refresh": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "\n The earliest possible datetime at which we'll allow the cached results for this insight to be refreshed\n by querying the database.\n " }, "result": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "hasMore": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "columns": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "created_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "created_by": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "description": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "updated_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tags": { "val_type": "array", "inner_val_type": "string", "enum": null, "properties": null, "inner_properties": null, "description": null }, "favorited": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "last_modified_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "last_modified_by": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "is_sample": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "effective_restriction_level": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "effective_privilege_level": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "user_access_level": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The effective access level the user has for this object" }, "timezone": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timezone this chart is displayed in." }, "is_cached": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "query_status": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "hogql": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "types": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "_create_in_folder": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "alerts": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "last_viewed_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "inner_properties": null, "description": "" }, "inferrable": true, "http_endpoint_parameter_name": "requestBody" } ] }, "output": { "description": "Response from the API endpoint 'environments_insights_create'.", "available_modes": [ "value", "error", "null" ], "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "requirements": { "authorization": null, "secrets": [ { "key": "POSTHOG_SERVER_URL" }, { "key": "POSTHOG_PERSONAL_API_KEY" } ], "metadata": null }, "deprecation_message": null, "metadata": { "object_type": "api_wrapper_tool", "version": "1.1.0", "description": "Tools that enable LLMs to interact directly with the Datadog API." }, "http_endpoint": { "metadata": { "object_type": "http_endpoint", "version": "1.2.0", "description": "" }, "url": "{posthog_server_url}/api/environments/{project_id}/insights/", "http_method": "POST", "headers": {}, "parameters": [ { "name": "format", "tool_parameter_name": "output_format", "description": "", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": [ "csv", "json" ], "properties": null, "inner_properties": null, "description": "" }, "accepted_as": "query", "required": false, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "project_id", "tool_parameter_name": "project_id", "description": "Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/." }, "accepted_as": "path", "required": true, "deprecated": false, "default": null, "documentation_urls": [] }, { "name": "requestBody", "tool_parameter_name": "environment_insight_params", "description": "", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "id": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "short_id": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "derived_name": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "query": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "order": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "deleted": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "dashboards": { "val_type": "array", "inner_val_type": "integer", "enum": null, "properties": null, "inner_properties": null, "description": "\n DEPRECATED. Will be removed in a future release. Use dashboard_tiles instead.\n A dashboard ID for each of the dashboards that this insight is displayed on.\n " }, "dashboard_tiles": { "val_type": "array", "inner_val_type": "json", "enum": null, "properties": null, "inner_properties": { "id": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "dashboard_id": { "val_type": "integer", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "deleted": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "description": "\n A dashboard tile ID and dashboard_id for each of the dashboards that this insight is displayed on.\n " }, "last_refresh": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "\n The datetime this insight's results were generated.\n If added to one or more dashboards the insight can be refreshed separately on each.\n Returns the appropriate last_refresh datetime for the context the insight is viewed in\n (see from_dashboard query parameter).\n " }, "cache_target_age": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The target age of the cached results for this insight." }, "next_allowed_client_refresh": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "\n The earliest possible datetime at which we'll allow the cached results for this insight to be refreshed\n by querying the database.\n " }, "result": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "hasMore": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "columns": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "created_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "created_by": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "description": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "updated_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "tags": { "val_type": "array", "inner_val_type": "string", "enum": null, "properties": null, "inner_properties": null, "description": null }, "favorited": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "last_modified_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "last_modified_by": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "is_sample": { "val_type": "boolean", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "effective_restriction_level": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "effective_privilege_level": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "user_access_level": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The effective access level the user has for this object" }, "timezone": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The timezone this chart is displayed in." }, "is_cached": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "query_status": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "hogql": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "types": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "_create_in_folder": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "alerts": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null }, "last_viewed_at": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "inner_properties": null, "description": "" }, "accepted_as": "body", "required": false, "deprecated": false, "default": null, "documentation_urls": [] } ], "documentation_urls": [], "secrets": [ { "arcade_key": "POSTHOG_SERVER_URL", "parameter_name": "posthog_server_url", "accepted_as": "path", "formatted_value": null, "description": "", "is_auth_token": false }, { "arcade_key": "POSTHOG_PERSONAL_API_KEY", "parameter_name": "Authorization", "accepted_as": "header", "formatted_value": "Bearer {authorization}", "description": "", "is_auth_token": false } ], "request_body_spec": "{\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\",\n \"description\": \"Simplified serializer to speed response times when loading large amounts of objects.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\",\n \"readOnly\": true\n },\n \"short_id\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"name\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"maxLength\": 400\n },\n \"derived_name\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"maxLength\": 400\n },\n \"query\": {\n \"type\": \"object\",\n \"example\": {\n \"kind\": \"InsightVizNode\",\n \"source\": {\n \"kind\": \"TrendsQuery\",\n \"series\": [\n {\n \"kind\": \"EventsNode\",\n \"math\": \"total\",\n \"name\": \"$pageview\",\n \"event\": \"$pageview\",\n \"version\": 1\n }\n ],\n \"version\": 1\n },\n \"version\": 1\n },\n \"nullable\": true\n },\n \"order\": {\n \"type\": \"integer\",\n \"maximum\": 2147483647,\n \"minimum\": -2147483648,\n \"nullable\": true\n },\n \"deleted\": {\n \"type\": \"boolean\"\n },\n \"dashboards\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"integer\"\n },\n \"description\": \"\\n DEPRECATED. Will be removed in a future release. Use dashboard_tiles instead.\\n A dashboard ID for each of the dashboards that this insight is displayed on.\\n \"\n },\n \"dashboard_tiles\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\",\n \"readOnly\": true\n },\n \"dashboard_id\": {\n \"type\": \"integer\",\n \"readOnly\": true\n },\n \"deleted\": {\n \"type\": \"boolean\",\n \"nullable\": true\n }\n },\n \"required\": [\n \"dashboard_id\",\n \"id\"\n ]\n },\n \"readOnly\": true,\n \"description\": \"\\n A dashboard tile ID and dashboard_id for each of the dashboards that this insight is displayed on.\\n \"\n },\n \"last_refresh\": {\n \"type\": \"string\",\n \"readOnly\": true,\n \"description\": \"\\n The datetime this insight's results were generated.\\n If added to one or more dashboards the insight can be refreshed separately on each.\\n Returns the appropriate last_refresh datetime for the context the insight is viewed in\\n (see from_dashboard query parameter).\\n \"\n },\n \"cache_target_age\": {\n \"type\": \"string\",\n \"readOnly\": true,\n \"description\": \"The target age of the cached results for this insight.\"\n },\n \"next_allowed_client_refresh\": {\n \"type\": \"string\",\n \"readOnly\": true,\n \"description\": \"\\n The earliest possible datetime at which we'll allow the cached results for this insight to be refreshed\\n by querying the database.\\n \"\n },\n \"result\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"hasMore\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"columns\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"created_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"readOnly\": true,\n \"nullable\": true\n },\n \"created_by\": {\n \"allOf\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\",\n \"readOnly\": true\n },\n \"uuid\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"readOnly\": true\n },\n \"distinct_id\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"maxLength\": 200\n },\n \"first_name\": {\n \"type\": \"string\",\n \"maxLength\": 150\n },\n \"last_name\": {\n \"type\": \"string\",\n \"maxLength\": 150\n },\n \"email\": {\n \"type\": \"string\",\n \"format\": \"email\",\n \"title\": \"Email address\",\n \"maxLength\": 254\n },\n \"is_email_verified\": {\n \"type\": \"boolean\",\n \"nullable\": true\n },\n \"hedgehog_config\": {\n \"type\": \"object\",\n \"additionalProperties\": {},\n \"nullable\": true,\n \"readOnly\": true\n },\n \"role_at_organization\": {\n \"nullable\": true,\n \"oneOf\": [\n {\n \"enum\": [\n \"engineering\",\n \"data\",\n \"product\",\n \"founder\",\n \"leadership\",\n \"marketing\",\n \"sales\",\n \"other\"\n ],\n \"type\": \"string\",\n \"description\": \"* `engineering` - Engineering\\n* `data` - Data\\n* `product` - Product Management\\n* `founder` - Founder\\n* `leadership` - Leadership\\n* `marketing` - Marketing\\n* `sales` - Sales / Success\\n* `other` - Other\"\n },\n {\n \"enum\": [\n \"\"\n ]\n },\n {\n \"enum\": [\n null\n ]\n }\n ]\n }\n },\n \"required\": [\n \"email\",\n \"hedgehog_config\",\n \"id\",\n \"uuid\"\n ]\n }\n ],\n \"readOnly\": true\n },\n \"description\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"maxLength\": 400\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"readOnly\": true\n },\n \"tags\": {\n \"type\": \"array\",\n \"items\": {}\n },\n \"favorited\": {\n \"type\": \"boolean\"\n },\n \"last_modified_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"readOnly\": true\n },\n \"last_modified_by\": {\n \"allOf\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\",\n \"readOnly\": true\n },\n \"uuid\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"readOnly\": true\n },\n \"distinct_id\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"maxLength\": 200\n },\n \"first_name\": {\n \"type\": \"string\",\n \"maxLength\": 150\n },\n \"last_name\": {\n \"type\": \"string\",\n \"maxLength\": 150\n },\n \"email\": {\n \"type\": \"string\",\n \"format\": \"email\",\n \"title\": \"Email address\",\n \"maxLength\": 254\n },\n \"is_email_verified\": {\n \"type\": \"boolean\",\n \"nullable\": true\n },\n \"hedgehog_config\": {\n \"type\": \"object\",\n \"additionalProperties\": {},\n \"nullable\": true,\n \"readOnly\": true\n },\n \"role_at_organization\": {\n \"nullable\": true,\n \"oneOf\": [\n {\n \"enum\": [\n \"engineering\",\n \"data\",\n \"product\",\n \"founder\",\n \"leadership\",\n \"marketing\",\n \"sales\",\n \"other\"\n ],\n \"type\": \"string\",\n \"description\": \"* `engineering` - Engineering\\n* `data` - Data\\n* `product` - Product Management\\n* `founder` - Founder\\n* `leadership` - Leadership\\n* `marketing` - Marketing\\n* `sales` - Sales / Success\\n* `other` - Other\"\n },\n {\n \"enum\": [\n \"\"\n ]\n },\n {\n \"enum\": [\n null\n ]\n }\n ]\n }\n },\n \"required\": [\n \"email\",\n \"hedgehog_config\",\n \"id\",\n \"uuid\"\n ]\n }\n ],\n \"readOnly\": true\n },\n \"is_sample\": {\n \"type\": \"boolean\",\n \"readOnly\": true\n },\n \"effective_restriction_level\": {\n \"allOf\": [\n {\n \"enum\": [\n 21,\n 37\n ],\n \"type\": \"integer\"\n }\n ],\n \"readOnly\": true\n },\n \"effective_privilege_level\": {\n \"allOf\": [\n {\n \"enum\": [\n 21,\n 37\n ],\n \"type\": \"integer\"\n }\n ],\n \"readOnly\": true\n },\n \"user_access_level\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"description\": \"The effective access level the user has for this object\"\n },\n \"timezone\": {\n \"type\": \"string\",\n \"readOnly\": true,\n \"description\": \"The timezone this chart is displayed in.\"\n },\n \"is_cached\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"query_status\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"hogql\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"types\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"_create_in_folder\": {\n \"type\": \"string\",\n \"writeOnly\": true,\n \"title\": \" create in folder\"\n },\n \"alerts\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"last_viewed_at\": {\n \"type\": \"string\",\n \"readOnly\": true\n }\n },\n \"required\": [\n \"alerts\",\n \"cache_target_age\",\n \"columns\",\n \"created_at\",\n \"created_by\",\n \"dashboard_tiles\",\n \"effective_privilege_level\",\n \"effective_restriction_level\",\n \"hasMore\",\n \"hogql\",\n \"id\",\n \"is_cached\",\n \"is_sample\",\n \"last_modified_at\",\n \"last_modified_by\",\n \"last_refresh\",\n \"last_viewed_at\",\n \"next_allowed_client_refresh\",\n \"query_status\",\n \"result\",\n \"short_id\",\n \"timezone\",\n \"types\",\n \"updated_at\",\n \"user_access_level\"\n ]\n }\n }\n }\n}", "use_request_body_schema_mode": true, "validate_request_body_schema": true } }