Cognite Agentic Access
Cognite exposes 980 API operations that an AI agent could call, of which 708 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.
By consequence: 272 read, 694 write, 10 physical, and 4 safety-critical.
4 operations are classed safety-critical and should require human-in-the-loop approval at runtime.
Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.
By consequence
Highest-consequence actions
The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.
| Method | Path | Consequence | Human-in-loop |
|---|---|---|---|
| POST | /api/v1/orgs/{org}/principals/{principal}/sessions/revoke | safety-critical | required |
| POST | /api/v1/orgs/{org}/principals/{principal}/sessions/revoke | safety-critical | required |
| POST | /sessions/revoke | safety-critical | required |
| POST | /sessions/revoke | safety-critical | required |
| POST | /relationships | physical | conditional |
| POST | /relationships | physical | conditional |
| POST | /relationships/byids | physical | conditional |
| POST | /relationships/byids | physical | conditional |
| POST | /relationships/delete | physical | conditional |
| POST | /relationships/delete | physical | conditional |
| POST | /relationships/list | physical | conditional |
| POST | /relationships/list | physical | conditional |
| POST | /relationships/update | physical | conditional |
| POST | /relationships/update | physical | conditional |
Source
Agentic Access
generated: '2026-07-15'
method: generated
source: openapi/cognite-data-fusion-api.json, openapi/cognite-data-fusion-api.yaml
description: Recommended x-agentic-access execution contracts, classified heuristically from
the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
audience per deployment. See research/curity/agentic-governance/.
summary:
operations: 980
by_action_class:
connected: 272
acting: 708
by_consequence:
read: 272
write: 694
physical: 10
safety-critical: 4
human_in_the_loop_required: 4
operations:
- path: /token/inspect
method: get
operationId: inspectToken
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets
method: get
operationId: getAssets
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets
method: post
operationId: createAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/{id}
method: get
operationId: getAsset
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/list
method: post
operationId: listAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/aggregate
method: post
operationId: aggregateAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/byids
method: post
operationId: byIdsAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/update
method: post
operationId: updateAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/search
method: post
operationId: searchAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /assets/delete
method: post
operationId: deleteAssets
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/spaces
method: post
operationId: ApplySpaces
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/spaces
method: get
operationId: listSpacesV3
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/spaces/byids
method: post
operationId: bySpaceIdsSpaces
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/spaces/delete
method: post
operationId: deleteSpacesV3
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/datamodels
method: post
operationId: createDataModels
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/datamodels
method: get
operationId: listDataModels
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/datamodels/byids
method: post
operationId: byExternalIdsDataModels
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/datamodels/delete
method: post
operationId: deleteDataModels
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/views
method: post
operationId: ApplyViews
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/views
method: get
operationId: listViews
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/views/byids
method: post
operationId: byExternalIdsViews
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/views/delete
method: post
operationId: deleteViews
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers
method: post
operationId: ApplyContainers
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers
method: get
operationId: listContainers
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/byids
method: post
operationId: byExternalIdsContainers
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/delete
method: post
operationId: deleteContainers
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/indexes/delete
method: post
operationId: deleteContainerIndexes
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/indexes/retry
method: post
operationId: retryContainerIndexes
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/constraints/delete
method: post
operationId: deleteContainerConstraints
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/constraints/retry
method: post
operationId: retryContainerConstraints
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/properties/retry
method: post
operationId: retryPropertyConstraints
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/containers/inspect
method: post
operationId: containerInspect
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances
method: post
operationId: applyNodeAndEdges
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/list
method: post
operationId: advancedListInstance
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/byids
method: post
operationId: byExternalIdsInstances
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/search
method: post
operationId: searchInstances
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/aggregate
method: post
operationId: aggregateInstances
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/delete
method: post
operationId: deleteBulk
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/query
method: post
operationId: queryContent
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/sync
method: post
operationId: syncContent
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/instances/inspect
method: post
operationId: instanceInspect
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/statistics
method: get
operationId: getStatistics
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/statistics/spaces
method: get
operationId: getSpaceStatistics
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /models/statistics/spaces/byids
method: post
operationId: getSpaceStatisticsByIds
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams
method: post
operationId: createStream
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams
method: get
operationId: listStreams
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}
method: get
operationId: getStream
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}
method: delete
operationId: deleteStream
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/delete
method: post
operationId: deleteStreams
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}/records
method: post
operationId: ingestRecords
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}/records/upsert
method: post
operationId: upsertRecords
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}/records/delete
method: post
operationId: deleteRecords
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}/records/filter
method: post
operationId: filterRecords
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}/records/aggregate
method: post
operationId: aggregateRecords
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /streams/{streamId}/records/sync
method: post
operationId: syncRecords
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events
method: post
operationId: createEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events
method: get
operationId: listEvents
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/{id}
method: get
operationId: getEventByInternalId
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/list
method: post
operationId: advancedListEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/aggregate
method: post
operationId: aggregateEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/byids
method: post
operationId: byIdsEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/update
method: post
operationId: updateEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/search
method: post
operationId: searchEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /events/delete
method: post
operationId: deleteEvents
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files
method: post
operationId: initFileUpload
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files
method: get
operationId: listFiles
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/initmultipartupload
method: post
operationId: initMultiPartUpload
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/uploadlink
method: post
operationId: getUploadLink
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/multiuploadlink
method: post
operationId: getMultiPartUploadLink
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/{id}
method: get
operationId: getFileByInternalId
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/list
method: post
operationId: advancedListFiles
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/byids
method: post
operationId: byIdsFiles
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/search
method: post
operationId: searchFiles
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/delete
method: post
operationId: deleteFiles
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/downloadlink
method: post
operationId: downloadLinks
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/icon
method: get
operationId: getIcon
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/update
method: post
operationId: updateFiles
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
scope:
- https://api.cognitedata.com/.default
- https://{cluster}.cognitedata.com/.default
- path: /files/aggregate
method: post
operationId: aggregateFiles
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
t
# --- truncated at 32 KB (397 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cognite/refs/heads/main/agentic-access/cognite-agentic-access.yml