{
"title": "Unsupported Type Error: DECIMAL",
"status": 422,
"detail": "Column 'decimal_value' has type DECIMAL, which is not supported as an output column of a materialized view. CAST the column to a supported type such as DOUBLE, BIGINT, VARCHAR, BOOLEAN, or TIMESTAMP.",
"instance": "/v2/accessrules/create",
"log_id": "c904b703-d41e-4372-9276-9f4bdc8ad031",
"debug": {
"column": "decimal_value",
"type_name": "DECIMAL"
}
}
Access Rules
Create a new Access Rule
Creates a new access rule based on the provided NQL query.
{
"title": "Unsupported Type Error: DECIMAL",
"status": 422,
"detail": "Column 'decimal_value' has type DECIMAL, which is not supported as an output column of a materialized view. CAST the column to a supported type such as DOUBLE, BIGINT, VARCHAR, BOOLEAN, or TIMESTAMP.",
"instance": "/v2/accessrules/create",
"log_id": "c904b703-d41e-4372-9276-9f4bdc8ad031",
"debug": {
"column": "decimal_value",
"type_name": "DECIMAL"
}
}
It should be unique.
Also should not intersect with Dataset names.
Must be <= 256 characters and consist of only alphanumeric characters and underscores.
How much to charge for a row which matches this access rule.
Cost per mille (CPM), more commonly called “cost per thousand,” is how much a buyer pays for 1,000 records.
Limits how a querying company may use the attributes and fields this access rule selects. An attribute is a
Rosetta Stone attribute that the access rule selects from _rosetta_stone. A field is any other column of the
access rule, such as a dataset column it selects directly. A query that breaks the policy reads no rows from the
access rule.
Show child attributes
Response
OK. The created rule, which the caller always owns.
Status of the access rule. Archived rules are never returned by the read endpoints, so this is
active everywhere except the response to the update that archives the rule.
How much to charge for a row which matches this access rule.
Cost per mille (CPM), more commonly called “cost per thousand,” is how much a buyer pays for 1,000 records.
Attributes that are mapped to columns referenced by this access rule. For each mapped
attribute, properties lists the attribute property paths that are exposed by the rule.
Limits how a querying company may use the attributes and fields this access rule selects. An attribute is a
Rosetta Stone attribute that the access rule selects from _rosetta_stone. A field is any other column of the
access rule, such as a dataset column it selects directly. A query that breaks the policy reads no rows from the
access rule.
It should be unique.
Also should not intersect with Dataset names.
Must be <= 256 characters and consist of only alphanumeric characters and underscores.
Schema describing a structure of View (Access Rule). When the rule exposes mapped attributes, they are
described under properties._rosetta_stone.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Narrative I/O Knowledge Base","colors":{"primary":"#1438F5","light":"#F4F7FB","dark":"#010A28"},"logo":{"light":"https://mintcdn.com/narrative-07c7a1f7/ia6SQX79O4nc7uYf/logo/banner.png?fit=max\u0026auto=format\u0026n=ia6SQX79O4nc7uYf\u0026q=85\u0026s=99860b25011c79366624a87d1f648861","dark":"https://mintcdn.com/narrative-07c7a1f7/ia6SQX79O4nc7uYf/logo/banner-dark.png?fit=max\u0026auto=format\u0026n=ia6SQX79O4nc7uYf\u0026q=85\u0026s=604f9688855cf1123b9eddfc8a5bf0e5"},"favicon":"https://mintcdn.com/narrative-07c7a1f7/DaYE2y2_p0IkASZU/favicon.svg?fit=max\u0026auto=format\u0026n=DaYE2y2_p0IkASZU\u0026q=85\u0026s=9961047bdb2aaf9298577e1c3e624c24","navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Open Narrative","href":"https://app.narrative.io"}},"footer":{"socials":{"github":"https://github.com/narrative-io","linkedin":"https://linkedin.com/company/narrative-io"}},"seo":{"indexing":"navigable"},"integrations":{"fathom":{"siteId":"WELVPSSZ"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Release Notes","icon":"clock-rotate-left","href":"/release-notes"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"narrative-07c7a1f7","hasAudioNarration":false,"actualSubdomain":"narrative-07c7a1f7","customDomains":["docs.narrative.io"],"gitSource":{"type":"github","owner":"narrative-io","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae05e4bd115be216cdab17b","collectionId":"a2a4edcc-65dd-42cc-838f-f6f5675cafe8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae05e4bd115be216cdab17b"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae066346c1a15a18d9d1d3c","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":234},{"language":"default","tag":"Reference","count":111},{"language":"default","tag":"Connectors","count":103},{"language":"default","tag":"All connectors","count":101},{"language":"default","tag":"Architecture Reference","count":76},{"language":"default","tag":"Agent Conversations","count":63},{"language":"default","tag":"Concepts","count":62},{"language":"default","tag":"Guides","count":58},{"language":"default","tag":"Errors","count":54},{"language":"default","tag":"NQL","count":36}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/access-rules/create-a-new-access-rule","slug":"/api-reference/access-rules/create-a-new-access-rule","pageMetadata":{"title":"Create a new Access Rule","description":"Creates a new access rule based on the provided NQL query.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/access-rules","href":"/api-reference/access-rules/create-a-new-access-rule","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a new access rule based on the provided NQL query.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a new Access Rule","description":"Creates a new access rule based on the provided NQL query.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/access-rules","href":"/api-reference/access-rules/create-a-new-access-rule","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a new Access Rule","operationId":"createAccessRule","description":"Creates a new access rule based on the provided NQL query.","tags":["Access Rules"],"security":["6334af69-8800-4d9f-81b9-7cb93dca84d0"],"responses":{"200":"7bac2273-7876-476f-9c98-ca41545be828","400":"3fe05670-b7f7-46c0-80e5-c52f1aff7e60","409":"951668fe-9fb8-4ba9-b40e-2fd4286e3a75","422":"93813012-f79b-409f-9208-417a1641caba"},"requestBody":"5821d177-cf8e-4ad3-97b0-c47b61f73b78","method":"post","type":"path","servers":["190e6995-21fb-418b-bbfe-8c27e30d5b55","1dc6c444-4c87-47b0-b19f-59c81fc72525"],"path":"/v2/access-rules","baseUrlOptions":["https://api-dev.narrative.io","https://api.narrative.io"],"title":"Create a new Access Rule","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"It should be unique.\nAlso should not intersect with Dataset names.\nMust be \u003c= 256 characters and consist of only alphanumeric characters and underscores.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"nql":{"type":"string","description":"NQL query of access rule.","isRequired":true,"uniqueKey":"nql","typeLabel":"string"},"collaborators":{"type":"object","description":"Describes who can view or query a resource","properties":{"view":{"oneOf":[{"type":"object","description":"Describes who can view a resource","required":["type"],"properties":{"type":{"type":"string","enum":["all"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.0","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type"],"properties":{"type":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.1","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type"],"properties":{"type":{"type":"string","enum":["anonymous"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.2","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["inclusion"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.3.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.view.oneOf.3.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.3.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.3","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["exclusion"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.4.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.view.oneOf.4.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.4.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"collaborators.view","typeLabel":"object"},"query":{"oneOf":[{"type":"object","description":"Describes who can query a resource","required":["type"],"properties":{"type":{"type":"string","enum":["all"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.0","typeLabel":"object"},{"type":"object","description":"Describes who can query a resource","required":["type"],"properties":{"type":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.1","typeLabel":"object"},{"type":"object","description":"Describes who can query a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["inclusion"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.2.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.query.oneOf.2.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.2.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.2","typeLabel":"object"},{"type":"object","description":"Describes who can query a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["exclusion"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.3.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.query.oneOf.3.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.3.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"collaborators.query","typeLabel":"object"}},"required":["view","query"],"isRequired":true,"uniqueKey":"collaborators","typeLabel":"object"},"price_cpm_usd":{"type":"number","format":"double","minimum":0,"description":"How much to charge for a row which matches this access rule.\nCost per mille (CPM), more commonly called “cost per thousand,” is how much a buyer pays for 1,000 records.","isRequired":true,"uniqueKey":"price_cpm_usd","typeLabel":"number\u003cdouble>"},"display_name":{"type":"string","description":"Optional. Display Name must be non-empty and less than 1000 chars.","uniqueKey":"display_name","typeLabel":"string"},"description":{"type":"string","description":"A human-friendly description of the access rule.","uniqueKey":"description","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"Optional. `_nio_access_rule` will be added even if not presented. Access Rule tag must be non-empty and less than 256 chars.","uniqueKey":"tags","typeLabel":"string[]"},"image":{"type":"string","description":"Optional. Image url must be \u003c 1000 characters, start from https://, ends with one of: jpg, apng, jpeg, jfif, pjpeg, webp, pjp, svg, avif, png, gif, bmp, tiff","uniqueKey":"image","typeLabel":"string"},"query_policy":{"oneOf":[{"type":"object","description":"Limits how a querying company may use the attributes and fields this access rule selects. An attribute is a\nRosetta Stone attribute that the access rule selects from `_rosetta_stone`. A field is any other column of the\naccess rule, such as a dataset column it selects directly. A query that breaks the policy reads no rows from the\naccess rule.","properties":{"default":{"oneOf":[{"type":"object","description":"Rules for every attribute and field that no `usage_rules` entry names. A usage left out is denied.","properties":{"projection":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators","typeLabel":"string[] | null"},"aggregate_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators","typeLabel":"string[] | null"},"external_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection","typeLabel":"object | null"},"group_by":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by","typeLabel":"object | null"},"join":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0","typeLabel":"object"},{"type":"null","description":"Rules for every attribute and field that no `usage_rules` entry names. A usage left out is denied.","uniqueKey":"query_policy.oneOf.0.default.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default","typeLabel":"object | null"},"usage_rules":{"oneOf":[{"type":"array","items":{"type":"object","description":"Rules for one attribute or field. Set exactly one of `attribute` and `field`. The access rule must select the\nattribute or field. A field that renames an attribute refers to that attribute. For example, when the access rule\nselects `_rosetta_stone.email as email`, `{\"field\": \"email\"}` and `{\"attribute\": \"email\"}` name the same column,\nso a policy can have a rule for only one of them.","additionalProperties":false,"properties":{"attribute":{"type":"string","description":"Rosetta Stone attribute path, such as `email` or `id.value`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].attribute","typeLabel":"string"},"field":{"type":"string","description":"Access rule column path, such as `hashed_email`. Use a dot for a nested property of a column, such as\n`address.zip`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].field","typeLabel":"string"},"projection":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators","typeLabel":"string[] | null"},"aggregate_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators","typeLabel":"string[] | null"},"external_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators","typeLabel":"string[] | null"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection","typeLabel":"object"},"group_by":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators","typeLabel":"string[] | null"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by","typeLabel":"object"},"join":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators","typeLabel":"string[] | null"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join","typeLabel":"object"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules","typeLabel":"object[] | null"},"join_required_rule":{"oneOf":[{"type":"object","description":"Requires every query to inner join this access rule to a dataset the querying company owns, matching on the keys\nof one `match` entry.","required":["match"],"properties":{"match":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["keys"],"properties":{"keys":{"type":"array","minItems":1,"items":{"type":"object","description":"One key of a match. Set exactly one of `attribute` and `field`. The access rule must select the attribute or\nfield. As in `UsageRule`, a field that renames an attribute refers to that attribute.","additionalProperties":false,"required":["form"],"properties":{"form":{"oneOf":[{"type":"string","enum":["raw"],"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form.oneOf.1.operator","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form","typeLabel":"enum\u003cstring> | object"},"attribute":{"type":"string","description":"Rosetta Stone attribute path, such as `email` or `id.value`.","uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].attribute","typeLabel":"string"},"field":{"type":"string","description":"Access rule column path, such as `hashed_email`. Use a dot for a nested property of a column, such as\n`address.zip`.","uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys","typeLabel":"object[]"}},"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.join_required_rule","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy","typeLabel":"object | null"}},"required":["name","nql","collaborators","price_cpm_usd"],"example":{"name":"example_access_rule","display_name":"Example Access Rule","description":"This is an example access rule.","image":"https://example.com/image.png","tags":["tag1","tag2"],"nql":"SELECT tar.\"maid\" FROM company_data.\"11370\" tar","collaborators":{"query":{"type":"inclusion","company_ids":[789]},"view":{"type":"all"}},"price_cpm_usd":10},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"example_access_rule","display_name":"Example Access Rule","description":"This is an example access rule.","image":"https://example.com/image.png","tags":["tag1","tag2"],"nql":"SELECT tar.\"maid\" FROM company_data.\"11370\" tar","collaborators":{"query":{"type":"inclusion","company_ids":[789]},"view":{"type":"all"}},"price_cpm_usd":10}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7bac2273-7876-476f-9c98-ca41545be828":{"description":"OK. The created rule, which the caller always owns.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier for the access rule.","isRequired":true,"uniqueKey":"id","typeLabel":"integer"},"company_id":{"type":"integer","format":"int64","description":"The id of an existing company","example":345,"isRequired":true,"uniqueKey":"company_id","typeLabel":"integer\u003cint64>"},"company_name":{"type":"string","description":"Name of the company that owns this rule.","isRequired":true,"uniqueKey":"company_name","typeLabel":"string"},"data_plane_id":{"type":"string","format":"uuid","description":"The data plane the access rule belongs to. A rule can only be queried from this data plane.","isRequired":true,"uniqueKey":"data_plane_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","description":"Status of the access rule. Archived rules are never returned by the read endpoints, so this is\n`active` everywhere except the response to the update that archives the rule.","enum":["archived","active"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"Optional. `_nio_access_rule` will be added even if not presented. Access Rule tag must be non-empty and less than 256 chars.","isRequired":true,"uniqueKey":"tags","typeLabel":"string[]"},"collaborators":{"type":"object","description":"Describes who can view or query a resource","properties":{"view":{"oneOf":[{"type":"object","description":"Describes who can view a resource","required":["type"],"properties":{"type":{"type":"string","enum":["all"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.0","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type"],"properties":{"type":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.1","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type"],"properties":{"type":{"type":"string","enum":["anonymous"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.2","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["inclusion"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.3.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.view.oneOf.3.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.3.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.3","typeLabel":"object"},{"type":"object","description":"Describes who can view a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["exclusion"],"isRequired":true,"uniqueKey":"collaborators.view.oneOf.4.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.view.oneOf.4.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.4.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.view.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"collaborators.view","typeLabel":"object"},"query":{"oneOf":[{"type":"object","description":"Describes who can query a resource","required":["type"],"properties":{"type":{"type":"string","enum":["all"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.0","typeLabel":"object"},{"type":"object","description":"Describes who can query a resource","required":["type"],"properties":{"type":{"type":"string","enum":["none"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.1","typeLabel":"object"},{"type":"object","description":"Describes who can query a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["inclusion"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.2.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.query.oneOf.2.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.2.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.2","typeLabel":"object"},{"type":"object","description":"Describes who can query a resource","required":["type","company_ids"],"properties":{"type":{"type":"string","enum":["exclusion"],"isRequired":true,"uniqueKey":"collaborators.query.oneOf.3.type","typeLabel":"enum\u003cstring>"},"company_ids":{"type":"array","description":"The companies to which the constraint applies.","items":{"type":"integer","uniqueKey":"collaborators.query.oneOf.3.company_ids.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.3.company_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"collaborators.query.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"collaborators.query","typeLabel":"object"}},"required":["view","query"],"isRequired":true,"uniqueKey":"collaborators","typeLabel":"object"},"price_cpm_usd":{"type":"number","format":"double","minimum":0,"description":"How much to charge for a row which matches this access rule.\nCost per mille (CPM), more commonly called “cost per thousand,” is how much a buyer pays for 1,000 records.","isRequired":true,"uniqueKey":"price_cpm_usd","typeLabel":"number\u003cdouble>"},"dataset_ids":{"type":"array","items":{"type":"integer","format":"int64","uniqueKey":"dataset_ids.items.[INDEX]","typeLabel":"integer\u003cint64>"},"description":"All datasets that were used to form the data.","isRequired":true,"uniqueKey":"dataset_ids","typeLabel":"integer\u003cint64>[]"},"metadata":{"type":"object","description":"When the access rule was created and last updated, and by whom. Only the owning company sees the user ids.","properties":{"created_at":{"description":"When the access rule was created. An ISO-8601 local date-time in UTC, without an offset.","type":"string","example":"2023-12-14T21:36:51.847901","isRequired":true,"uniqueKey":"metadata.created_at","typeLabel":"string"},"updated_at":{"description":"When the access rule was last updated. An ISO-8601 local date-time in UTC, without an offset.","type":"string","example":"2023-12-14T21:36:51.847901","isRequired":true,"uniqueKey":"metadata.updated_at","typeLabel":"string"},"created_by":{"oneOf":[{"description":"Id of the user who created the access rule, or null when that was not recorded.","type":"integer","format":"int64","uniqueKey":"metadata.created_by.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Id of the user who created the access rule, or null when that was not recorded.","type":"null","format":"int64","uniqueKey":"metadata.created_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata.created_by","typeLabel":"integer\u003cint64> | null"},"updated_by":{"oneOf":[{"description":"Id of the user who last updated the access rule, or null when that was not recorded.","type":"integer","format":"int64","uniqueKey":"metadata.updated_by.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Id of the user who last updated the access rule, or null when that was not recorded.","type":"null","format":"int64","uniqueKey":"metadata.updated_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata.updated_by","typeLabel":"integer\u003cint64> | null"}},"required":["created_at","updated_at"],"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"type":{"type":"string","description":"Indicates the ownership of the access rule.","enum":["owned"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"is_owned":{"type":"boolean","enum":[true],"description":"Always `true` for an owned rule.","isRequired":true,"uniqueKey":"is_owned","typeLabel":"enum\u003cboolean>"},"mappings":{"type":"array","description":"Attributes that are mapped to columns referenced by this access rule. For each mapped\nattribute, `properties` lists the attribute property paths that are exposed by the rule.","items":{"type":"object","properties":{"attribute_id":{"type":"integer","format":"int64","description":"The id of the mapped attribute.","isRequired":true,"uniqueKey":"mappings.items.[INDEX].attribute_id","typeLabel":"integer\u003cint64>"},"attribute_name":{"type":"string","description":"The name of the mapped attribute.","isRequired":true,"uniqueKey":"mappings.items.[INDEX].attribute_name","typeLabel":"string"},"properties":{"type":"array","items":{"type":"string","uniqueKey":"mappings.items.[INDEX].properties.items.[INDEX]","typeLabel":"string"},"description":"Dot-separated paths of attribute properties exposed by the access rule.\nEmpty for scalar attributes.","isRequired":true,"uniqueKey":"mappings.items.[INDEX].properties","typeLabel":"string[]"}},"required":["attribute_id","attribute_name","properties"],"uniqueKey":"mappings.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"mappings","typeLabel":"object[]"},"query_policy":{"oneOf":[{"type":"object","description":"Limits how a querying company may use the attributes and fields this access rule selects. An attribute is a\nRosetta Stone attribute that the access rule selects from `_rosetta_stone`. A field is any other column of the\naccess rule, such as a dataset column it selects directly. A query that breaks the policy reads no rows from the\naccess rule.","properties":{"default":{"oneOf":[{"type":"object","description":"Rules for every attribute and field that no `usage_rules` entry names. A usage left out is denied.","properties":{"projection":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.scalar_operators","typeLabel":"string[] | null"},"aggregate_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.aggregate_operators","typeLabel":"string[] | null"},"external_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0.external_operators","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.projection","typeLabel":"object | null"},"group_by":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0.scalar_operators","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.group_by","typeLabel":"object | null"},"join":{"oneOf":[{"type":"object","required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0.scalar_operators","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default.oneOf.0.join","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.default.oneOf.0","typeLabel":"object"},{"type":"null","description":"Rules for every attribute and field that no `usage_rules` entry names. A usage left out is denied.","uniqueKey":"query_policy.oneOf.0.default.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.default","typeLabel":"object | null"},"usage_rules":{"oneOf":[{"type":"array","items":{"type":"object","description":"Rules for one attribute or field. Set exactly one of `attribute` and `field`. The access rule must select the\nattribute or field. A field that renames an attribute refers to that attribute. For example, when the access rule\nselects `_rosetta_stone.email as email`, `{\"field\": \"email\"}` and `{\"attribute\": \"email\"}` name the same column,\nso a policy can have a rule for only one of them.","additionalProperties":false,"properties":{"attribute":{"type":"string","description":"Rosetta Stone attribute path, such as `email` or `id.value`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].attribute","typeLabel":"string"},"field":{"type":"string","description":"Access rule column path, such as `hashed_email`. Use a dot for a nested property of a column, such as\n`address.zip`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].field","typeLabel":"string"},"projection":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Scalar functions, such as `SHA2` or `UPPER`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.scalar_operators","typeLabel":"string[] | null"},"aggregate_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Aggregate functions, such as `COUNT` or `SUM`. Add `_DISTINCT` to a name for its distinct form, such as\n`COUNT_DISTINCT`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.aggregate_operators","typeLabel":"string[] | null"},"external_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Functions that send values outside the query: `AI_COMPLETE`, `AI_CONVERSATION`, `AI_EMBED`,\n`CALL_MODEL_FUNCTION`.","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection.external_operators","typeLabel":"string[] | null"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].projection","typeLabel":"object"},"group_by":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by.scalar_operators","typeLabel":"string[] | null"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].group_by","typeLabel":"object"},"join":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["allow","deny","restrict"],"description":"`allow` permits every use. `deny` permits none. `restrict` permits only the functions the rule's lists name, and\nnever the raw value.","isRequired":true,"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.mode","typeLabel":"enum\u003cstring>"},"scalar_operators":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators.oneOf.0","typeLabel":"string[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join.scalar_operators","typeLabel":"string[] | null"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX].join","typeLabel":"object"}},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"query_policy.oneOf.0.usage_rules.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.usage_rules","typeLabel":"object[] | null"},"join_required_rule":{"oneOf":[{"type":"object","description":"Requires every query to inner join this access rule to a dataset the querying company owns, matching on the keys\nof one `match` entry.","required":["match"],"properties":{"match":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["keys"],"properties":{"keys":{"type":"array","minItems":1,"items":{"type":"object","description":"One key of a match. Set exactly one of `attribute` and `field`. The access rule must select the attribute or\nfield. As in `UsageRule`, a field that renames an attribute refers to that attribute.","additionalProperties":false,"required":["form"],"properties":{"form":{"oneOf":[{"type":"string","enum":["raw"],"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form.oneOf.1.operator","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].form","typeLabel":"enum\u003cstring> | object"},"attribute":{"type":"string","description":"Rosetta Stone attribute path, such as `email` or `id.value`.","uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].attribute","typeLabel":"string"},"field":{"type":"string","description":"Access rule column path, such as `hashed_email`. Use a dot for a nested property of a column, such as\n`address.zip`.","uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX].keys","typeLabel":"object[]"}},"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0.match","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"query_policy.oneOf.0.join_required_rule.oneOf.1","typeLabel":"null"}],"uniqueKey":"query_policy.oneOf.0.join_required_rule","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"query_policy.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"query_policy.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"query_policy","typeLabel":"object | null"},"name":{"oneOf":[{"type":"string","description":"It should be unique.\nAlso should not intersect with Dataset names.\nMust be \u003c= 256 characters and consist of only alphanumeric characters and underscores.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"company_slug":{"oneOf":[{"type":"string","description":"Optional. Unique slug assigned to company.","uniqueKey":"company_slug.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"company_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"company_slug","typeLabel":"string | null"},"display_name":{"oneOf":[{"type":"string","description":"Optional. Display Name must be non-empty and less than 1000 chars.","uniqueKey":"display_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"display_name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"A human-friendly description of the access rule.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"image":{"oneOf":[{"type":"string","description":"Optional. Image url must be \u003c 1000 characters, start from https://, ends with one of: jpg, apng, jpeg, jfif, pjpeg, webp, pjp, svg, avif, png, gif, bmp, tiff","uniqueKey":"image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"image.oneOf.1","typeLabel":"null"}],"uniqueKey":"image","typeLabel":"string | null"},"nql":{"oneOf":[{"type":"string","description":"NQL query of access rule.","uniqueKey":"nql.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nql.oneOf.1","typeLabel":"null"}],"uniqueKey":"nql","typeLabel":"string | null"},"schema":{"oneOf":[{"type":"object","description":"Schema describing a structure of View (Access Rule). When the rule exposes mapped attributes, they are\ndescribed under `properties._rosetta_stone`.\n","additionalProperties":true,"uniqueKey":"schema.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"schema","typeLabel":"object | null"}},"required":["id","company_id","company_name","data_plane_id","status","tags","collaborators","price_cpm_usd","dataset_ids","metadata","type","is_owned","mappings","query_policy"],"example":{"name":"access_rule_ebc86610_0907_4374_8fc9_be360f0ff8d0","id":1,"company_id":1,"company_name":"company","company_slug":"company_slug_60a4e678_1d56_48a7_8b8b_4e1d689b11a6","data_plane_id":"f79cbdae-4848-47ca-95e8-69588364d185","display_name":"display name","description":"description","image":"https://narrative.test/1.png","status":"active","tags":["_nio_access_rule"],"nql":"select company_data.\"1\".columnA from company_data.\"1\" WHERE columnA = columnB","schema":{"type":"object","properties":{"columnA":{"display_name":"columnA","type":"string"}},"required":["columnA"]},"collaborators":{"query":{"type":"inclusion","company_ids":[789]},"view":{"type":"all"}},"price_cpm_usd":1000.054,"metadata":{"created_at":"2023-12-14T21:36:51.847901","created_by":42,"updated_at":"2023-12-14T21:36:51.847901","updated_by":null},"dataset_ids":[42],"type":"owned","is_owned":true,"mappings":[{"attribute_id":42,"attribute_name":"id","properties":["id.type","id.value"]}],"query_policy":null},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"access_rule_ebc86610_0907_4374_8fc9_be360f0ff8d0","id":1,"company_id":1,"company_name":"company","company_slug":"company_slug_60a4e678_1d56_48a7_8b8b_4e1d689b11a6","data_plane_id":"f79cbdae-4848-47ca-95e8-69588364d185","display_name":"display name","description":"description","image":"https://narrative.test/1.png","status":"active","tags":["_nio_access_rule"],"nql":"select company_data.\"1\".columnA from company_data.\"1\" WHERE columnA = columnB","schema":{"type":"object","properties":{"columnA":{"display_name":"columnA","type":"string"}},"required":["columnA"]},"collaborators":{"query":{"type":"inclusion","company_ids":[789]},"view":{"type":"all"}},"price_cpm_usd":1000.054,"metadata":{"created_at":"2023-12-14T21:36:51.847901","created_by":42,"updated_at":"2023-12-14T21:36:51.847901","updated_by":null},"dataset_ids":[42],"type":"owned","is_owned":true,"mappings":[{"attribute_id":42,"attribute_name":"id","properties":["id.type","id.value"]}],"query_policy":null}}},"exampleType":"generated"}},"exampleType":"generated"},"3fe05670-b7f7-46c0-80e5-c52f1aff7e60":{"description":"Bad Request. A body that does not decode (missing or invalid field, malformed JSON) and a query that reads\nfrom a view dataset get the plain error shape. An NQL query that fails to parse or validate gets the\nRFC error shape. An invalid `query_policy` is also a 400, and `error_description` lists every problem with it.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error","error_description"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"error_description":{"type":"string","example":"You are not authorized to use this endpoint.","isRequired":true,"uniqueKey":"oneOf.0.error_description","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"An RFC 7807 problem. `title` names the kind of error and `detail` explains this occurrence;\nhttps://docs.narrative.io/guides/nql/troubleshooting walks through the NQL titles.","required":["title","status","detail","instance","log_id"],"example":{"type":null,"title":"Failed to Parse Query","status":400,"detail":"Invalid query format.","instance":"/nql/validate","log_id":"c06fea02-0950-45c6-aaff-07ab07c0d04c","debug":null},"properties":{"title":{"type":"string","description":"a summary of the error","isRequired":true,"uniqueKey":"oneOf.1.title","typeLabel":"string"},"status":{"type":"integer","description":"http status code","isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"integer"},"detail":{"type":"string","description":"a longer description of the error","isRequired":true,"uniqueKey":"oneOf.1.detail","typeLabel":"string"},"instance":{"type":"string","description":"path of the query","isRequired":true,"uniqueKey":"oneOf.1.instance","typeLabel":"string"},"log_id":{"type":"string","format":"uuid","description":"an internal logging id, Narrative can use to help debug a problem.","isRequired":true,"uniqueKey":"oneOf.1.log_id","typeLabel":"string\u003cuuid>"},"type":{"oneOf":[{"description":"A URL naming the class of error.","type":"string","format":"uri","uniqueKey":"oneOf.1.type.oneOf.0","typeLabel":"string\u003curi>"},{"description":"A URL naming the class of error.","type":"null","format":"uri","uniqueKey":"oneOf.1.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.type","typeLabel":"string\u003curi> | null"},"debug":{"oneOf":[{"description":"Extra detail shaped by the error, for example the column and type name of an unsupported-type\nerror. Null when the error has nothing to add. Most errors only include it for admin tokens.","type":"object","additionalProperties":true,"uniqueKey":"oneOf.1.debug.oneOf.0","typeLabel":"object"},{"description":"Extra detail shaped by the error, for example the column and type name of an unsupported-type\nerror. Null when the error has nothing to add. Most errors only include it for admin tokens.","type":"null","additionalProperties":true,"uniqueKey":"oneOf.1.debug.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.debug","typeLabel":"object | null"},"app":{"oneOf":[{"description":"The connector app that raised the error, on errors a connector returned. Otherwise null or absent.","type":"string","uniqueKey":"oneOf.1.app.oneOf.0","typeLabel":"string"},{"description":"The connector app that raised the error, on errors a connector returned. Otherwise null or absent.","type":"null","uniqueKey":"oneOf.1.app.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.app","typeLabel":"string | null"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized","error_description":"You are not authorized to use this endpoint."}}},"exampleType":"generated"}},"exampleType":"generated"},"951668fe-9fb8-4ba9-b40e-2fd4286e3a75":{"description":"Conflict — an access rule, table or view with this name already exists.","content":{"application/json":{"schema":{"type":"object","description":"An RFC 7807 problem. `title` names the kind of error and `detail` explains this occurrence;\nhttps://docs.narrative.io/guides/nql/troubleshooting walks through the NQL titles.","required":["title","status","detail","instance","log_id"],"properties":{"title":{"type":"string","description":"a summary of the error","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"http status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"a longer description of the error","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"path of the query","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"log_id":{"type":"string","format":"uuid","description":"an internal logging id, Narrative can use to help debug a problem.","isRequired":true,"uniqueKey":"log_id","typeLabel":"string\u003cuuid>"},"type":{"oneOf":[{"description":"A URL naming the class of error.","type":"string","format":"uri","uniqueKey":"type.oneOf.0","typeLabel":"string\u003curi>"},{"description":"A URL naming the class of error.","type":"null","format":"uri","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string\u003curi> | null"},"debug":{"oneOf":[{"description":"Extra detail shaped by the error, for example the column and type name of an unsupported-type\nerror. Null when the error has nothing to add. Most errors only include it for admin tokens.","type":"object","additionalProperties":true,"uniqueKey":"debug.oneOf.0","typeLabel":"object"},{"description":"Extra detail shaped by the error, for example the column and type name of an unsupported-type\nerror. Null when the error has nothing to add. Most errors only include it for admin tokens.","type":"null","additionalProperties":true,"uniqueKey":"debug.oneOf.1","typeLabel":"null"}],"uniqueKey":"debug","typeLabel":"object | null"},"app":{"oneOf":[{"description":"The connector app that raised the error, on errors a connector returned. Otherwise null or absent.","type":"string","uniqueKey":"app.oneOf.0","typeLabel":"string"},{"description":"The connector app that raised the error, on errors a connector returned. Otherwise null or absent.","type":"null","uniqueKey":"app.oneOf.1","typeLabel":"null"}],"uniqueKey":"app","typeLabel":"string | null"}},"example":{"type":null,"title":"Failed to Parse Query","status":400,"detail":"Invalid query format.","instance":"/nql/validate","log_id":"c06fea02-0950-45c6-aaff-07ab07c0d04c","debug":null},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":null,"title":"Failed to Parse Query","status":400,"detail":"Invalid query format.","instance":"/nql/validate","log_id":"c06fea02-0950-45c6-aaff-07ab07c0d04c","debug":null}}},"exampleType":"generated"}},"exampleType":"generated"},"93813012-f79b-409f-9208-417a1641caba":{"description":"Unprocessable Entity — the NQL query parsed but is semantically invalid, for example an output\ncolumn whose type is not supported (such as DECIMAL), or a query that produces no output columns.\nvisit https://docs.narrative.io/guides/nql/troubleshooting for more details","content":{"application/json":{"schema":{"type":"object","description":"An RFC 7807 problem. `title` names the kind of error and `detail` explains this occurrence;\nhttps://docs.narrative.io/guides/nql/troubleshooting walks through the NQL titles.","required":["title","status","detail","instance","log_id"],"properties":{"title":{"type":"string","description":"a summary of the error","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"http status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","description":"a longer description of the error","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"path of the query","isRequired":true,"uniqueKey":"instance","typeLabel":"string"},"log_id":{"type":"string","format":"uuid","description":"an internal logging id, Narrative can use to help debug a problem.","isRequired":true,"uniqueKey":"log_id","typeLabel":"string\u003cuuid>"},"type":{"oneOf":[{"description":"A URL naming the class of error.","type":"string","format":"uri","uniqueKey":"type.oneOf.0","typeLabel":"string\u003curi>"},{"description":"A URL naming the class of error.","type":"null","format":"uri","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string\u003curi> | null"},"debug":{"oneOf":[{"description":"Extra detail shaped by the error, for example the column and type name of an unsupported-type\nerror. Null when the error has nothing to add. Most errors only include it for admin tokens.","type":"object","additionalProperties":true,"uniqueKey":"debug.oneOf.0","typeLabel":"object"},{"description":"Extra detail shaped by the error, for example the column and type name of an unsupported-type\nerror. Null when the error has nothing to add. Most errors only include it for admin tokens.","type":"null","additionalProperties":true,"uniqueKey":"debug.oneOf.1","typeLabel":"null"}],"uniqueKey":"debug","typeLabel":"object | null"},"app":{"oneOf":[{"description":"The connector app that raised the error, on errors a connector returned. Otherwise null or absent.","type":"string","uniqueKey":"app.oneOf.0","typeLabel":"string"},{"description":"The connector app that raised the error, on errors a connector returned. Otherwise null or absent.","type":"null","uniqueKey":"app.oneOf.1","typeLabel":"null"}],"uniqueKey":"app","typeLabel":"string | null"}},"example":{"type":null,"title":"Failed to Parse Query","status":400,"detail":"Invalid query format.","instance":"/nql/validate","log_id":"c06fea02-0950-45c6-aaff-07ab07c0d04c","debug":null},"uniqueKey":"","typeLabel":"object"},"examples":{"unsupported_output_type":{"title":"unsupported_output_type","value":{"title":"Unsupported Type Error: DECIMAL","status":422,"detail":"Column 'decimal_value' has type DECIMAL, which is not supported as an output column of a materialized view. CAST the column to a supported type such as DOUBLE, BIGINT, VARCHAR, BOOLEAN, or TIMESTAMP.","instance":"/v2/accessrules/create","log_id":"c904b703-d41e-4372-9276-9f4bdc8ad031","debug":{"column":"decimal_value","type_name":"DECIMAL"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6334af69-8800-4d9f-81b9-7cb93dca84d0":{"BearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"190e6995-21fb-418b-bbfe-8c27e30d5b55":{"url":"https://api-dev.narrative.io"},"1dc6c444-4c87-47b0-b19f-59c81fc72525":{"url":"https://api.narrative.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://docs-cdn.narrative.io/api-reference/main/openapi.json"},"subdomain":"narrative-07c7a1f7","siteName":"Narrative I/O Knowledge Base","title":"Create a new Access Rule - Narrative I/O Knowledge Base","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T20:47:05.958Z","originalFileLocation":"api-reference/access-rules/create-a-new-access-rule.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a new access rule based on the provided NQL query.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Narrative I/O Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new Access Rule - Narrative I/O Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new access rule based on the provided NQL query.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Narrative I/O Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://narrative-07c7a1f7.mintlify.app/_mintlify/api/og/v2?division=Access+Rules\u0026amp;title=Create+a+new+Access+Rule\u0026amp;description=Creates+a+new+access+rule+based+on+the+provided+NQL+query.\u0026amp;theme=ee973f81a9436b7406ccdb45\u0026amp;signature=f99362d4d5669fcb7ac6a9e8cb8e2b4f32acdaad25d4d41e28ef5ee8d8e1d218\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a new Access Rule - Narrative I/O Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new access rule based on the provided NQL query.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://narrative-07c7a1f7.mintlify.app/_mintlify/api/og/v2?division=Access+Rules\u0026amp;title=Create+a+new+Access+Rule\u0026amp;description=Creates+a+new+access+rule+based+on+the+provided+NQL+query.\u0026amp;theme=ee973f81a9436b7406ccdb45\u0026amp;signature=f99362d4d5669fcb7ac6a9e8cb8e2b4f32acdaad25d4d41e28ef5ee8d8e1d218\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/narrative-07c7a1f7/OOk68seBU2ePTAv6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Narrative I/O Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1438F5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/access-rules/create-a-new-access-rule.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.narrative.io/#organization\",\"name\":\"Narrative I/O Knowledge Base\",\"url\":\"https://docs.narrative.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/narrative-07c7a1f7/ia6SQX79O4nc7uYf/logo/banner.png?fit=max\u0026auto=format\u0026n=ia6SQX79O4nc7uYf\u0026q=85\u0026s=99860b25011c79366624a87d1f648861\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.narrative.io#website\",\"name\":\"Narrative I/O Knowledge Base\",\"url\":\"https://docs.narrative.io\",\"publisher\":{\"@id\":\"https://docs.narrative.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule#webpage\",\"url\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule\",\"name\":\"Create a new Access Rule\",\"description\":\"Creates a new access rule based on the provided NQL query.\",\"dateModified\":\"2026-10-26T20:47:05.958Z\",\"isPartOf\":{\"@id\":\"https://docs.narrative.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Access Rules\",\"item\":\"https://docs.narrative.io/api-reference/access-rules/get-an-access-rule-by-id-v2\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a new Access Rule\",\"item\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule#apireference\",\"headline\":\"Create a new Access Rule\",\"name\":\"Create a new Access Rule\",\"description\":\"Creates a new access rule based on the provided NQL query.\",\"url\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule\",\"mainEntityOfPage\":{\"@id\":\"https://docs.narrative.io/api-reference/access-rules/create-a-new-access-rule#webpage\"},\"dateModified\":\"2026-10-26T20:47:05.958Z\",\"publisher\":{\"@id\":\"https://docs.narrative.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.narrative.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Narrative I/O Knowledge Base\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Narrative I/O Knowledge Base","nav":{"global":{"anchors":[{"anchor":"Release Notes","icon":"clock-rotate-left","href":"/release-notes"}]},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/getting-started/create-account"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"Cookbooks","pages":[{"title":"Cookbooks","href":"/cookbooks"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference"}]},{"tab":"Connectors","pages":[{"title":"Connectors","href":"/reference/connectors"}]},{"tab":"NQL","pages":[{"title":"NQL","href":"/nql"}]},{"tab":"API Documentation","groups":[{"group":"Access Rules","pages":[{"title":"Get an Access Rule by id (V2)","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/access-rules/{access_rule_id}","href":"/api-reference/access-rules/get-an-access-rule-by-id-v2"},{"title":"Update an Access Rule by id (V2)","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /v2/access-rules/{access_rule_id}","href":"/api-reference/access-rules/update-an-access-rule-by-id-v2"},{"title":"Delete an access rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /v2/access-rules/{access_rule_id}","href":"/api-reference/access-rules/delete-an-access-rule"},{"title":"Get the query policy of an Access Rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/access-rules/{access_rule_id}/query-policy","href":"/api-reference/access-rules/get-the-query-policy-of-an-access-rule"},{"title":"Set the query policy of an Access Rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /v2/access-rules/{access_rule_id}/query-policy","href":"/api-reference/access-rules/set-the-query-policy-of-an-access-rule"},{"title":"Remove the query policy of an Access Rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /v2/access-rules/{access_rule_id}/query-policy","href":"/api-reference/access-rules/remove-the-query-policy-of-an-access-rule"},{"title":"Get an Access Rule by name (V2)","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/access-rules/{company_slug}/{access_rule_name}","href":"/api-reference/access-rules/get-an-access-rule-by-name-v2"},{"title":"Get all accessible Access Rules (V2)","description":"Get all accessible Access Rules. Authentication is optional: without a token only rules that are visible to\nunauthenticated users are returned, always in their shared form.\n\n'owned_only' and 'shared_only' are flags, they don't require values.\n\n'tag', 'dataset_id', and 'company_id' are multi-params.\n\nQuery like 'tag=tag1\u0026tag=tag2\u0026company_id=1\u0026company_id=2' is interpreted as \"access rules with tags that comprise 'tag1' or 'tag2' AND belonging to companies with id '1' or '2'.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/access-rules","href":"/api-reference/access-rules/get-all-accessible-access-rules-v2"},{"title":"Create a new Access Rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/access-rules","href":"/api-reference/access-rules/create-a-new-access-rule"}]},{"group":"Access Tokens","pages":[{"title":"List System Access Tokens","description":"List every System Access Token belonging to your company, including expired ones. The response never contains\nthe token credentials.\n\nRequires read access to access_tokens.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /access-tokens/tokens","href":"/api-reference/access-tokens/list-system-access-tokens"},{"title":"Create a System Access Token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /access-tokens/tokens","href":"/api-reference/access-tokens/create-a-system-access-token"},{"title":"Get a System Access Token by id","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /access-tokens/tokens/{access_token_id}","href":"/api-reference/access-tokens/get-a-system-access-token-by-id"},{"title":"Update a System Access Token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /access-tokens/tokens/{access_token_id}","href":"/api-reference/access-tokens/update-a-system-access-token"},{"title":"Delete a System Access Token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /access-tokens/tokens/{access_token_id}","href":"/api-reference/access-tokens/delete-a-system-access-token"}]},{"group":"Agent Conversations","pages":[{"title":"List the calling user's agent conversations","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /agents/conversations","href":"/api-reference/agent-conversations/list-the-calling-users-agent-conversations"},{"title":"Create an agent conversation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /agents/conversations","href":"/api-reference/agent-conversations/create-an-agent-conversation"},{"title":"Get an agent conversation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /agents/conversations/{id}","href":"/api-reference/agent-conversations/get-an-agent-conversation"},{"title":"List conversation messages (delta read by version cursor)","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /agents/conversations/{id}/messages","href":"/api-reference/agent-conversations/list-conversation-messages-delta-read-by-version-cursor"},{"title":"Start a new run on the conversation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /agents/conversations/{id}/runs","href":"/api-reference/agent-conversations/start-a-new-run-on-the-conversation"},{"title":"Stop waiting on a handle","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /agents/conversations/{id}/waitables/{handle}/cancel","href":"/api-reference/agent-conversations/stop-waiting-on-a-handle"},{"title":"Get a run's current state","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /agents/runs/{id}","href":"/api-reference/agent-conversations/get-a-runs-current-state"}]},{"group":"App API","pages":[{"title":"Delivery Commands","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v1/app/commands/delivery","href":"/api-reference/app-api/delivery-commands"},{"title":"Delivery Files","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v1/app/commands/delivery/{delivery_id}/files","href":"/api-reference/app-api/delivery-files"},{"title":"Download file","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v1/app/commands/delivery/{delivery_id}/download/{filename}","href":"/api-reference/app-api/download-file"}]},{"group":"App Invites","pages":[{"title":"List App Invites","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /app-invites","href":"/api-reference/app-invites/list-app-invites"},{"title":"Create App Invite","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /app-invites","href":"/api-reference/app-invites/create-app-invite"},{"title":"Get App Invite","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /app-invites/{id}","href":"/api-reference/app-invites/get-app-invite"},{"title":"Archive App Invite","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /app-invites/{id}","href":"/api-reference/app-invites/archive-app-invite"},{"title":"Activate App Invite","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /app-invites/{id}/activate","href":"/api-reference/app-invites/activate-app-invite"},{"title":"Get App Invite By Code","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /app-invites/codes/{code}","href":"/api-reference/app-invites/get-app-invite-by-code"}]},{"group":"Apps","pages":[{"title":"Lists apps","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /apps","href":"/api-reference/apps/lists-apps"},{"title":"Publish app event","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /apps/events","href":"/api-reference/apps/publish-app-event"},{"title":"List installed app interfaces","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /apps/installed/interfaces","href":"/api-reference/apps/list-installed-app-interfaces"},{"title":"List app interfaces","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /apps/{app_id}/interfaces","href":"/api-reference/apps/list-app-interfaces"},{"title":"Get an app interface","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /apps/{app_id}/interfaces/{interface_id}","href":"/api-reference/apps/get-an-app-interface"},{"title":"Lists profiles","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /apps/{app_slug}/profiles","href":"/api-reference/apps/lists-profiles"},{"title":"Get an app's v1 manifest","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /apps/{app_slug}/manifest","href":"/api-reference/apps/get-an-apps-v1-manifest"},{"title":"List Apps","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/apps","href":"/api-reference/apps/list-apps"},{"title":"Create App","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/apps","href":"/api-reference/apps/create-app"},{"title":"Get App","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/apps/{slug}","href":"/api-reference/apps/get-app"},{"title":"Archive App","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /v2/apps/{slug}","href":"/api-reference/apps/archive-app"},{"title":"Replace App Manifest","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /v2/apps/{slug}/manifest","href":"/api-reference/apps/replace-app-manifest"},{"title":"Patch App Manifest","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json patch /v2/apps/{slug}/manifest","href":"/api-reference/apps/patch-app-manifest"},{"title":"Generate App Credentials","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/apps/{slug}/credentials/generate","href":"/api-reference/apps/generate-app-credentials"}]},{"group":"Attributes","pages":[{"title":"Get attributes","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /attributes","href":"/api-reference/attributes/get-attributes"},{"title":"Create an attribute","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /attributes","href":"/api-reference/attributes/create-an-attribute"},{"title":"Get an attribute","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /attributes/{attribute_name_or_id}","href":"/api-reference/attributes/get-an-attribute"},{"title":"Update an attribute","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /attributes/{attribute_name_or_id}","href":"/api-reference/attributes/update-an-attribute"},{"title":"Delete an attribute","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /attributes/{attribute_name_or_id}","href":"/api-reference/attributes/delete-an-attribute"},{"title":"Get attribute references.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /attributes/{attribute_name_or_id}/references","href":"/api-reference/attributes/get-attribute-references"},{"title":"Get the derivation graph around an attribute.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /attributes/{attribute_name_or_id}/derivation-graph","href":"/api-reference/attributes/get-the-derivation-graph-around-an-attribute"}]},{"group":"Auth","pages":[{"title":"Request or refresh an OAuth token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /oauth/token","href":"/api-reference/auth/request-or-refresh-an-oauth-token"}]},{"group":"Authentication","pages":[{"title":"Sign in with a Stytch B2B session token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/b2b/login","href":"/api-reference/authentication/sign-in-with-a-stytch-b2b-session-token"},{"title":"Register with a Stytch B2B session token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/b2b/register","href":"/api-reference/authentication/register-with-a-stytch-b2b-session-token"},{"title":"Check whether a Stytch B2B member is registered on Narrative","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/b2b/registration-status","href":"/api-reference/authentication/check-whether-a-stytch-b2b-member-is-registered-on-narrative"},{"title":"Exchange a user token for one scoped to another company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/exchange-token","href":"/api-reference/authentication/exchange-a-user-token-for-one-scoped-to-another-company"},{"title":"Sign in with a Stytch session token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/login","href":"/api-reference/authentication/sign-in-with-a-stytch-session-token"},{"title":"Register with a Stytch session token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/register","href":"/api-reference/authentication/register-with-a-stytch-session-token"},{"title":"Check whether a Stytch Magic Links or OAuth user is registered on Narrative","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /authentication/registration-status","href":"/api-reference/authentication/check-whether-a-stytch-magic-links-or-oauth-user-is-registered-on-narrative"}]},{"group":"Billings","pages":[{"title":"Get dataset storage billing","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /admin/billings/dataset-storage-billing","href":"/api-reference/billings/get-dataset-storage-billing"},{"title":"Get dataset storage billing for company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /billings/dataset-storage-billing","href":"/api-reference/billings/get-dataset-storage-billing-for-company"}]},{"group":"Companies","pages":[{"title":"Lists Company Domains","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /companies/{company_id}/domains","href":"/api-reference/companies/lists-company-domains"},{"title":"Get a presigned URL to upload company logo","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /admin/companies/logo-upload-url","href":"/api-reference/companies/get-a-presigned-url-to-upload-company-logo"}]},{"group":"Company","pages":[{"title":"Get a company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /companies/{company_id}","href":"/api-reference/company/get-a-company"},{"title":"Get a company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /company/{company_id}","href":"/api-reference/company/get-a-company-1"},{"title":"Update a company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /company/{company_id}","href":"/api-reference/company/update-a-company"},{"title":"Delete (archive) a company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /company/{company_id}","href":"/api-reference/company/delete-archive-a-company"},{"title":"Clear the company's default compute pool for a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /company/{company_id}/data-planes/{data_plane_id}/default-compute-pool","href":"/api-reference/company/clear-the-companys-default-compute-pool-for-a-data-plane"},{"title":"Set the company's default compute pool for a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /company/{company_id}/data-planes/{data_plane_id}/default-compute-pool/{compute_pool_id}","href":"/api-reference/company/set-the-companys-default-compute-pool-for-a-data-plane"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /users/{user_id}","href":"/api-reference/company/update-a-user"}]},{"group":"Company Marketing Information","pages":[{"title":"Returns the company and user associated with the token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /company-info/whoami","href":"/api-reference/company-marketing-information/returns-the-company-and-user-associated-with-the-token"},{"title":"Get marketing details on a company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /company-info/{company_id}","href":"/api-reference/company-marketing-information/get-marketing-details-on-a-company"}]},{"group":"Compute Pools","pages":[{"title":"List compute pools","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /data-planes/{data_plane_id}/compute-pools","href":"/api-reference/compute-pools/list-compute-pools"},{"title":"Create a compute pool","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /data-planes/{data_plane_id}/compute-pools","href":"/api-reference/compute-pools/create-a-compute-pool"},{"title":"Get a compute pool by ID","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /data-planes/{data_plane_id}/compute-pools/{compute_pool_id}","href":"/api-reference/compute-pools/get-a-compute-pool-by-id"},{"title":"Update a compute pool","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /data-planes/{data_plane_id}/compute-pools/{compute_pool_id}","href":"/api-reference/compute-pools/update-a-compute-pool"},{"title":"Archive a compute pool","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /data-planes/{data_plane_id}/compute-pools/{compute_pool_id}","href":"/api-reference/compute-pools/archive-a-compute-pool"}]},{"group":"Connections","pages":[{"title":"List connections","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/connections","href":"/api-reference/connections/list-connections"},{"title":"Create a connection","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/connections","href":"/api-reference/connections/create-a-connection"},{"title":"Get a connection","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/connections/{connection_id}","href":"/api-reference/connections/get-a-connection"},{"title":"Archive a connection","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /v2/connections/{connection_id}","href":"/api-reference/connections/archive-a-connection"}]},{"group":"Data Planes","pages":[{"title":"List data planes","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /data-planes","href":"/api-reference/data-planes/list-data-planes"},{"title":"Create a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /data-planes","href":"/api-reference/data-planes/create-a-data-plane"},{"title":"Get a data plane by ID","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /data-planes/{data_plane_id}","href":"/api-reference/data-planes/get-a-data-plane-by-id"},{"title":"Archive a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /data-planes/{data_plane_id}","href":"/api-reference/data-planes/archive-a-data-plane"},{"title":"Update a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json patch /data-planes/{data_plane_id}","href":"/api-reference/data-planes/update-a-data-plane"},{"title":"Data plane heartbeat","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /data-planes/{data_plane_id}/heartbeat","href":"/api-reference/data-planes/data-plane-heartbeat"},{"title":"Trigger a health check","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /data-planes/{data_plane_id}/health-check","href":"/api-reference/data-planes/trigger-a-health-check"},{"title":"Replace the collaborators on a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /data-planes/{data_plane_id}/collaborators","href":"/api-reference/data-planes/replace-the-collaborators-on-a-data-plane"},{"title":"Add a collaborator to a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /data-planes/{data_plane_id}/collaborators/{collaborator_company_id}","href":"/api-reference/data-planes/add-a-collaborator-to-a-data-plane"},{"title":"Remove a collaborator from a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /data-planes/{data_plane_id}/collaborators/{collaborator_company_id}","href":"/api-reference/data-planes/remove-a-collaborator-from-a-data-plane"},{"title":"Set the default compute pool for a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /data-planes/{data_plane_id}/default-compute-pool/{compute_pool_id}","href":"/api-reference/data-planes/set-the-default-compute-pool-for-a-data-plane"},{"title":"Clear the default compute pool for a data plane","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /data-planes/{data_plane_id}/default-compute-pool","href":"/api-reference/data-planes/clear-the-default-compute-pool-for-a-data-plane"}]},{"group":"Dataset Configuration","pages":[{"title":"Preview snapshot expirations","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/retention-policy/preview","href":"/api-reference/dataset-configuration/preview-snapshot-expirations"},{"title":"Upsert retention policies for a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/retention-policy","href":"/api-reference/dataset-configuration/upsert-retention-policies-for-a-dataset"}]},{"group":"Dataset Files","pages":[{"title":"Files added","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/snapshots/{snapshot_id}/files-added","href":"/api-reference/dataset-files/files-added"},{"title":"Find snapshots","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/find-snapshots","href":"/api-reference/dataset-files/find-snapshots"},{"title":"Find files","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/find-files","href":"/api-reference/dataset-files/find-files"},{"title":"Issue file download url","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/snapshots/{snapshot_id}/files-added/{file_id}/download","href":"/api-reference/dataset-files/issue-file-download-url"}]},{"group":"Dataset Refresh","pages":[{"title":"Update the materialized view refresh configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/refresh-schedule","href":"/api-reference/dataset-refresh/update-the-materialized-view-refresh-configuration"},{"title":"Create a refresh schedule for an existing materialized view","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/refresh-schedule","href":"/api-reference/dataset-refresh/create-a-refresh-schedule-for-an-existing-materialized-view"},{"title":"Archive the materialized view refresh configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /datasets/{dataset_id}/refresh-schedule","href":"/api-reference/dataset-refresh/archive-the-materialized-view-refresh-configuration"},{"title":"Run a materialized view refresh now","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/refresh-materialized-view","href":"/api-reference/dataset-refresh/run-a-materialized-view-refresh-now"}]},{"group":"Dataset Samples","pages":[{"title":"Sample a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/sample","href":"/api-reference/dataset-samples/sample-a-dataset"},{"title":"Upload a sample","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/sample","href":"/api-reference/dataset-samples/upload-a-sample"},{"title":"Delete a sample","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /datasets/{dataset_id}/sample","href":"/api-reference/dataset-samples/delete-a-sample"},{"title":"Sample a dataset (Admin)","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/admin/sample","href":"/api-reference/dataset-samples/sample-a-dataset-admin"},{"title":"Request Dataset Sample","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/request-sample","href":"/api-reference/dataset-samples/request-dataset-sample"},{"title":"Sample a dataset and redact the sample","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/datasets/{dataset_id}/request-sample","href":"/api-reference/dataset-samples/sample-a-dataset-and-redact-the-sample"},{"title":"Get a dataset's sample redaction","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/redaction","href":"/api-reference/dataset-samples/get-a-datasets-sample-redaction"},{"title":"Upload a dataset's sample redaction","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/redaction","href":"/api-reference/dataset-samples/upload-a-datasets-sample-redaction"},{"title":"Delete a dataset's sample redaction","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /datasets/{dataset_id}/redaction","href":"/api-reference/dataset-samples/delete-a-datasets-sample-redaction"},{"title":"Sample a dataset with its redaction applied","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/sample/redacted","href":"/api-reference/dataset-samples/sample-a-dataset-with-its-redaction-applied"},{"title":"Sampled Mappings","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/sample/mappings","href":"/api-reference/dataset-samples/sampled-mappings"}]},{"group":"Dataset Statistics","pages":[{"title":"Get Statistics Configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/statistics-configuration","href":"/api-reference/dataset-statistics/get-statistics-configuration"},{"title":"Put Statistics Configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/statistics-configuration","href":"/api-reference/dataset-statistics/put-statistics-configuration"},{"title":"Disable Statistics Configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /datasets/{dataset_id}/statistics-configuration","href":"/api-reference/dataset-statistics/disable-statistics-configuration"}]},{"group":"Datasets","pages":[{"title":"Get datasets","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets","href":"/api-reference/datasets/get-datasets"},{"title":"Create a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets","href":"/api-reference/datasets/create-a-dataset"},{"title":"Get a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}","href":"/api-reference/datasets/get-a-dataset"},{"title":"Update a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}","href":"/api-reference/datasets/update-a-dataset"},{"title":"Delete a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /datasets/{dataset_id}","href":"/api-reference/datasets/delete-a-dataset"},{"title":"Activate a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/activate","href":"/api-reference/datasets/activate-a-dataset"},{"title":"Activate a dataset","deprecated":true,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/activate","href":"/api-reference/datasets/activate-a-dataset-1"},{"title":"Truncate a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/truncate","href":"/api-reference/datasets/truncate-a-dataset"},{"title":"Get admin info for a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/admin","href":"/api-reference/datasets/get-admin-info-for-a-dataset"},{"title":"Update a dataset's partition spec","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/admin/partition-spec","href":"/api-reference/datasets/update-a-datasets-partition-spec"},{"title":"Get dataset statistics","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/stats","href":"/api-reference/datasets/get-dataset-statistics"},{"title":"Get detailed statistics","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/column-stats","href":"/api-reference/datasets/get-detailed-statistics"},{"title":"Create or Update detailed statistics","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/column-stats","href":"/api-reference/datasets/create-or-update-detailed-statistics"},{"title":"Submit recalculation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/column-stats/recalculate","href":"/api-reference/datasets/submit-recalculation"},{"title":"Get detailed statistics for a snapshot","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/column-stats/{snapshot_id}","href":"/api-reference/datasets/get-detailed-statistics-for-a-snapshot"},{"title":"Combine snapshot metrics","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/combine","href":"/api-reference/datasets/combine-snapshot-metrics"},{"title":"Ingest a file","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/upload","href":"/api-reference/datasets/ingest-a-file"},{"title":"Issue an ingestion token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/upload/token","href":"/api-reference/datasets/issue-an-ingestion-token"},{"title":"Metrics","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/metrics","href":"/api-reference/datasets/metrics"},{"title":"Metrics","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/snapshots/{snapshot_id}/column-stats","href":"/api-reference/datasets/metrics-1"},{"title":"Get Metrics Configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/stats-config","href":"/api-reference/datasets/get-metrics-configuration"},{"title":"Put Metrics Configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/stats-config","href":"/api-reference/datasets/put-metrics-configuration"},{"title":"Disable configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /datasets/{dataset_id}/stats-config","href":"/api-reference/datasets/disable-configuration"},{"title":"Derive the configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /datasets/{dataset_id}/derive-stats-config","href":"/api-reference/datasets/derive-the-configuration"},{"title":"Enable configuration","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /datasets/{dataset_id}/enable-stats-config","href":"/api-reference/datasets/enable-configuration"},{"title":"List connector interfaces compatible with a dataset","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /datasets/{dataset_id}/interfaces","href":"/api-reference/datasets/list-connector-interfaces-compatible-with-a-dataset"}]},{"group":"Derivations","pages":[{"title":"Get derivation rules","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /derivations","href":"/api-reference/derivations/get-derivation-rules"},{"title":"Create a derivation rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /derivations","href":"/api-reference/derivations/create-a-derivation-rule"},{"title":"Get a derivation rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /derivations/{derivation_id}","href":"/api-reference/derivations/get-a-derivation-rule"},{"title":"Delete a derivation rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /derivations/{derivation_id}","href":"/api-reference/derivations/delete-a-derivation-rule"},{"title":"Update a derivation rule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json patch /derivations/{derivation_id}","href":"/api-reference/derivations/update-a-derivation-rule"}]},{"group":"Encryption Materials","pages":[{"title":"List encryption materials","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /encryption-materials","href":"/api-reference/encryption-materials/list-encryption-materials"},{"title":"Create an encryption material","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /encryption-materials","href":"/api-reference/encryption-materials/create-an-encryption-material"},{"title":"List decrypted encryption materials","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /encryption-materials/decrypted","href":"/api-reference/encryption-materials/list-decrypted-encryption-materials"},{"title":"Get an encryption material","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /encryption-materials/{encryption_material_id}","href":"/api-reference/encryption-materials/get-an-encryption-material"},{"title":"Update an encryption material","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /encryption-materials/{encryption_material_id}","href":"/api-reference/encryption-materials/update-an-encryption-material"},{"title":"Archive an encryption material","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /encryption-materials/{encryption_material_id}","href":"/api-reference/encryption-materials/archive-an-encryption-material"}]},{"group":"Installations","pages":[{"title":"List Installations","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /installations","href":"/api-reference/installations/list-installations"},{"title":"Create Installation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /installations","href":"/api-reference/installations/create-installation"},{"title":"Whoami Installation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /installations/whoami","href":"/api-reference/installations/whoami-installation"},{"title":"Get Installation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /installations/{id}","href":"/api-reference/installations/get-installation"},{"title":"Delete Installation","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /installations/{id}","href":"/api-reference/installations/delete-installation"},{"title":"Create Installation Token","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /installations/{id}/token","href":"/api-reference/installations/create-installation-token"}]},{"group":"Jobs","pages":[{"title":"Get jobs","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /jobs","href":"/api-reference/jobs/get-jobs"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /jobs/{job_id}","href":"/api-reference/jobs/get-a-job"},{"title":"Run a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/run","href":"/api-reference/jobs/run-a-job"},{"title":"Schedule a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/schedule","href":"/api-reference/jobs/schedule-a-job"},{"title":"Complete a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/complete","href":"/api-reference/jobs/complete-a-job"},{"title":"Fail a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/fail","href":"/api-reference/jobs/fail-a-job"},{"title":"Request cancellation of a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/request-cancellation","href":"/api-reference/jobs/request-cancellation-of-a-job"},{"title":"Cancel a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/cancel","href":"/api-reference/jobs/cancel-a-job"},{"title":"Reschedule a job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /jobs/{job_id}/reschedule","href":"/api-reference/jobs/reschedule-a-job"}]},{"group":"Mappings","pages":[{"title":"Get mappings","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mappings","href":"/api-reference/mappings/get-mappings"},{"title":"Get mapping","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mappings/{mapping_id}","href":"/api-reference/mappings/get-mapping"},{"title":"Update a mapping","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /mappings/{mapping_id}","href":"/api-reference/mappings/update-a-mapping"},{"title":"Delete a mapping","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /mappings/{mapping_id}","href":"/api-reference/mappings/delete-a-mapping"},{"title":"Accept a mapping","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /mappings/{mapping_id}/accept","href":"/api-reference/mappings/accept-a-mapping"},{"title":"Get mappings for a company","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mappings/companies/{company_id}","href":"/api-reference/mappings/get-mappings-for-a-company"},{"title":"Create a mapping","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /mappings/companies/{company_id}","href":"/api-reference/mappings/create-a-mapping"},{"title":"Get mapping preview","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mappings/{mapping_id}/sample","href":"/api-reference/mappings/get-mapping-preview"},{"title":"Test Mapping","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /mappings/test","href":"/api-reference/mappings/test-mapping"}]},{"group":"MCP Connections","pages":[{"title":"List the calling user's external MCP connections","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mcp-connections","href":"/api-reference/mcp-connections/list-the-calling-users-external-mcp-connections"},{"title":"Begin connecting an external MCP server","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /mcp-connections","href":"/api-reference/mcp-connections/begin-connecting-an-external-mcp-server"},{"title":"OAuth redirect target that receives the authorization code","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mcp-connections/callback","href":"/api-reference/mcp-connections/oauth-redirect-target-that-receives-the-authorization-code"},{"title":"Finish connecting an external MCP server","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /mcp-connections/complete","href":"/api-reference/mcp-connections/finish-connecting-an-external-mcp-server"},{"title":"Get one of the calling user's MCP connections","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /mcp-connections/{id}","href":"/api-reference/mcp-connections/get-one-of-the-calling-users-mcp-connections"},{"title":"Delete one of the calling user's MCP connections","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /mcp-connections/{id}","href":"/api-reference/mcp-connections/delete-one-of-the-calling-users-mcp-connections"}]},{"group":"Model Inference","pages":[{"title":"Run model inference","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /model-inference/run","href":"/api-reference/model-inference/run-model-inference"}]},{"group":"Model Training","pages":[{"title":"Fine-tune a model","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /model-training/run","href":"/api-reference/model-training/fine-tune-a-model"},{"title":"Train a classifier","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v1/model-training/train-classifier","href":"/api-reference/model-training/train-a-classifier"}]},{"group":"Models","pages":[{"title":"Get models","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /models","href":"/api-reference/models/get-models"},{"title":"Get a model","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /models/{model_id}","href":"/api-reference/models/get-a-model"},{"title":"Update a model","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /models/{model_id}","href":"/api-reference/models/update-a-model"},{"title":"Archive a model","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /models/{model_id}","href":"/api-reference/models/archive-a-model"}]},{"group":"NQL","pages":[{"title":"Validate an NQL statement","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /nql/validate","href":"/api-reference/nql/validate-an-nql-statement"},{"title":"Parse an NQL statement","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /nql/parse","href":"/api-reference/nql/parse-an-nql-statement"},{"title":"Execute an NQL statement","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v1/nql/execute","href":"/api-reference/nql/execute-an-nql-statement"},{"title":"Get a forecast job","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /nql/{job_id}","href":"/api-reference/nql/get-a-forecast-job"}]},{"group":"Permissions","pages":[{"title":"Create a permission","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /admin/permissions","href":"/api-reference/permissions/create-a-permission"}]},{"group":"Profiles","pages":[{"title":"Returns app profiles","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /installations/{installation_id}/profiles","href":"/api-reference/profiles/returns-app-profiles"},{"title":"Creates an app profile","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /installations/{installation_id}/profiles","href":"/api-reference/profiles/creates-an-app-profile"},{"title":"Returns profile with {profile_id}","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /installations/{installation_id}/profiles/{app_profile_id}","href":"/api-reference/profiles/returns-profile-with-"},{"title":"Updates an existing app profile","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /installations/{installation_id}/profiles/{app_profile_id}","href":"/api-reference/profiles/updates-an-existing-app-profile"},{"title":"Enables a profile","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /installations/{installation_id}/profiles/{app_profile_id}/enable","href":"/api-reference/profiles/enables-a-profile"},{"title":"Disables a profile","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /installations/{installation_id}/profiles/{app_profile_id}/disable","href":"/api-reference/profiles/disables-a-profile"},{"title":"Archives a profile","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /installations/{installation_id}/profiles/{app_profile_id}/archive","href":"/api-reference/profiles/archives-a-profile"}]},{"group":"Queries","pages":[{"title":"Get a query by id","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/queries/{query_id}","href":"/api-reference/queries/get-a-query-by-id"},{"title":"Deletes a query","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /v2/queries/{query_id}","href":"/api-reference/queries/deletes-a-query"},{"title":"Get accessible queries","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/queries","href":"/api-reference/queries/get-accessible-queries"},{"title":"Create a query","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/queries","href":"/api-reference/queries/create-a-query"}]},{"group":"Resources","pages":[{"title":"Get buckets","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /resources/buckets","href":"/api-reference/resources/get-buckets"},{"title":"Create bucket","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /resources/buckets","href":"/api-reference/resources/create-bucket"},{"title":"Update access type","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /resources/update-access","href":"/api-reference/resources/update-access-type"}]},{"group":"Schema Inference","pages":[{"title":"Infer the dataset schema of a file passed by multipart file.","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/inference","href":"/api-reference/schema-inference/infer-the-dataset-schema-of-a-file-passed-by-multipart-file"}]},{"group":"Uploads","pages":[{"title":"Upload a file","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /uploads/{upload_path}","href":"/api-reference/uploads/upload-a-file"}]},{"group":"Usage","pages":[{"title":"Create a usage event","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /usage","href":"/api-reference/usage/create-a-usage-event"}]},{"group":"Views","pages":[{"title":"Get a view by id","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/views/{view_id}","href":"/api-reference/views/get-a-view-by-id"},{"title":"Updates a view","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json put /v2/views/{view_id}","href":"/api-reference/views/updates-a-view"},{"title":"Archives a view","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /v2/views/{view_id}","href":"/api-reference/views/archives-a-view"},{"title":"Get accessible views","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /v2/views","href":"/api-reference/views/get-accessible-views"},{"title":"Create a view","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /v2/views","href":"/api-reference/views/create-a-view"}]},{"group":"Webhooks","pages":[{"title":"List webhook subscriptions","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhook-subscriptions"},{"title":"Create a webhook subscription","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /webhooks","href":"/api-reference/webhooks/create-a-webhook-subscription"},{"title":"Get a webhook subscription by ID","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /webhooks/{webhook_subscription_id}","href":"/api-reference/webhooks/get-a-webhook-subscription-by-id"},{"title":"Archive a webhook subscription","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /webhooks/{webhook_subscription_id}","href":"/api-reference/webhooks/archive-a-webhook-subscription"},{"title":"Event delivery","version":null,"deprecated":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json webhook webhookDelivery","href":"/api-reference/webhooks/event-delivery"}]},{"group":"Whoami","pages":[{"title":"Get a current user","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /whoami","href":"/api-reference/whoami/get-a-current-user"}]},{"group":"Workflows","pages":[{"title":"List workflows","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /workflows","href":"/api-reference/workflows/list-workflows"},{"title":"Create a workflow","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /workflows","href":"/api-reference/workflows/create-a-workflow"},{"title":"Get a workflow","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /workflows/{workflow_id}","href":"/api-reference/workflows/get-a-workflow"},{"title":"Archive a workflow","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /workflows/{workflow_id}","href":"/api-reference/workflows/archive-a-workflow"},{"title":"Trigger a workflow","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /workflows/{workflow_id}/trigger","href":"/api-reference/workflows/trigger-a-workflow"},{"title":"Schedule a workflow","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /workflows/{workflow_id}/schedule","href":"/api-reference/workflows/schedule-a-workflow"},{"title":"Remove a workflow schedule","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json delete /workflows/{workflow_id}/schedule","href":"/api-reference/workflows/remove-a-workflow-schedule"},{"title":"Cancel a workflow execution","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /workflows/{workflow_id}/cancel","href":"/api-reference/workflows/cancel-a-workflow-execution"},{"title":"List workflow runs","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json get /workflows/{workflow_id}/runs","href":"/api-reference/workflows/list-workflow-runs"},{"title":"Cancel a specific workflow run","deprecated":null,"version":null,"openapi":"https://docs-cdn.narrative.io/api-reference/main/openapi.json post /workflows/{workflow_id}/runs/{run_id}/cancel","href":"/api-reference/workflows/cancel-a-specific-workflow-run"}]}]}]},"title":"Create a new Access Rule - Narrative I/O Knowledge Base","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}