Technology

The Technology domain tracks two related entity types: TechnologyAsset (an application, platform, or tool) and AccessEntitlement (a role or permission level within that asset). Together they model who has access to what.

TechnologyAsset Schema

Field	Type	Required	Description
`id`	`string`	auto	Prefixed ID: `tast-{ulid}`
`name`	`string`	yes	Display name (e.g. “GitHub Enterprise”)
`type`	`enum`	yes	`saas` \| `internal` \| `infrastructure` \| `device`
`category`	`string`	no	Grouping label (e.g. “DevTools”, “HR”)
`vendor`	`string`	no	Vendor or provider name
`url`	`string`	no	Primary URL for the service
`ownerId`	`string`	no	`id` of the owning `Person`
`status`	`enum`	auto	`active` \| `deprecated` \| `deleted`
`tags`	`string[]`	no	Free-form tags
`createdAt`	`string`	auto	ISO 8601 UTC
`updatedAt`	`string`	auto	ISO 8601 UTC

AccessEntitlement Schema

Field	Type	Required	Description
`id`	`string`	auto	Prefixed ID: `ent-{ulid}`
`assetId`	`string`	yes	Parent `TechnologyAsset` ID
`name`	`string`	yes	Entitlement name (e.g. “Admin”, “Read-only”)
`description`	`string`	no	What this entitlement grants
`riskLevel`	`enum`	no	`low` \| `medium` \| `high` \| `critical`
`createdAt`	`string`	auto	ISO 8601 UTC

List & Get Assets

import { CpodClient } from '@cpod/sdk'
const sdk = CpodClient.fromEnv()
 
const result = await sdk.technology.list({ type: 'saas', limit: 50 })
for (const asset of result.items) {
  console.log(asset.id, asset.name, asset.vendor)
}
 
const asset = await sdk.technology.get('tast-abc123')
 
// Expand entitlements in one call
const full = await sdk.technology.get('tast-abc123', { expand: ['entitlements'] })
// full.entitlements → AccessEntitlement[]

from cpod import CpodClient
sdk = CpodClient.from_env()
 
result = await sdk.technology.list(type="saas", limit=50)
 
asset = await sdk.technology.get("tast-abc123")
 
full = await sdk.technology.get("tast-abc123", expand=["entitlements"])

import "github.com/cpod-ai/cpod-sdk-go/technology"
 
client := cpod.New(os.Getenv("CPOD_API_KEY"))
 
result, err := client.Technology.List(ctx, technology.ListOptions{Type: "saas", Limit: 50})
 
asset, err := client.Technology.Get(ctx, "tast-abc123", nil)
 
full, err := client.Technology.Get(ctx, "tast-abc123", &technology.GetOptions{
    Expand: []string{"entitlements"},
})

Create & Update an Asset

const asset = await sdk.technology.create({
  name: 'GitHub Enterprise',
  type: 'saas',
  category: 'DevTools',
  vendor: 'GitHub',
  url: 'https://github.com/acme-corp',
  ownerId: 'per-abc123',
})
 
await sdk.technology.update('tast-abc123', { status: 'deprecated' })
await sdk.technology.delete('tast-abc123')

asset = await sdk.technology.create(
    name="GitHub Enterprise",
    type="saas",
    category="DevTools",
    vendor="GitHub",
    url="https://github.com/acme-corp",
    owner_id="per-abc123",
)
 
await sdk.technology.update("tast-abc123", status="deprecated")
await sdk.technology.delete("tast-abc123")

asset, err := client.Technology.Create(ctx, technology.CreateInput{
    Name:     "GitHub Enterprise",
    Type:     "saas",
    Category: "DevTools",
    Vendor:   "GitHub",
    URL:      "https://github.com/acme-corp",
    OwnerID:  "per-abc123",
})
 
_, err = client.Technology.Update(ctx, "tast-abc123", technology.UpdateInput{Status: "deprecated"})
err = client.Technology.Delete(ctx, "tast-abc123")

Manage Access Entitlements

// Create an entitlement on an asset
const entitlement = await sdk.technology.entitlements.create('tast-abc123', {
  name: 'Admin',
  description: 'Full administrative access including billing.',
  riskLevel: 'critical',
})
 
// List entitlements for an asset
const entitlements = await sdk.technology.entitlements.list('tast-abc123')
 
// Get a single entitlement
const ent = await sdk.technology.entitlements.get('ent-xyz789')
 
// Update
await sdk.technology.entitlements.update('ent-xyz789', { riskLevel: 'high' })
 
// Delete
await sdk.technology.entitlements.delete('ent-xyz789')

entitlement = await sdk.technology.entitlements.create(
    "tast-abc123",
    name="Admin",
    description="Full administrative access.",
    risk_level="critical",
)
 
entitlements = await sdk.technology.entitlements.list("tast-abc123")
 
await sdk.technology.entitlements.update("ent-xyz789", risk_level="high")
await sdk.technology.entitlements.delete("ent-xyz789")

ent, err := client.Technology.Entitlements.Create(ctx, "tast-abc123",
    technology.EntitlementInput{
        Name:        "Admin",
        Description: "Full administrative access.",
        RiskLevel:   "critical",
    },
)
 
list, err := client.Technology.Entitlements.List(ctx, "tast-abc123", 50, "")
 
_, err = client.Technology.Entitlements.Update(ctx, "ent-xyz789",
    technology.EntitlementInput{RiskLevel: "high"},
)
 
err = client.Technology.Entitlements.Delete(ctx, "ent-xyz789")

To query which people hold a given entitlement, use the Relationships domain with fromType: 'person' and toId: 'ent-xyz789'.

Groups Licenses