Architecture¶

24 endpoints. Every path below is served by bevm-backend behind the gateway at https://api.trilocore.ai.

GET `/api/v1/arch`¶

List Architectures

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST `/api/v1/arch`¶

Create Architecture

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`201`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`adopt_legacy`	boolean	no	—
`chain`	string	no	—
`document`	one of	no	—
`name`	string	no	`maxLength` 200
`project_id`	one of	no	—
`target_ref`	one of	no	—
`workspace_id`	one of	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/arch \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain": "…", "name": "…", "target_ref": "…"}'

GET `/api/v1/arch/rules`¶

List Architecture Rules

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/rules \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

DELETE `/api/v1/arch/{architecture_id}`¶

Delete Architecture

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X DELETE https://api.trilocore.ai/api/v1/arch/{architecture_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}`¶

Get Architecture

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

PATCH `/api/v1/arch/{architecture_id}`¶

Patch Architecture

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`document`	one of	no	—
`name`	one of	no	—
`project_id`	one of	no	—
`target_ref`	one of	no	—
`workspace_id`	one of	no	—

curl

curl -X PATCH https://api.trilocore.ai/api/v1/arch/{architecture_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document": {}, "name": "…", "target_ref": "…"}'

PUT `/api/v1/arch/{architecture_id}`¶

Put Architecture

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`document`	object	yes	—
`name`	one of	no	—
`target_ref`	one of	no	—

curl

curl -X PUT https://api.trilocore.ai/api/v1/arch/{architecture_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document": {}}'

GET `/api/v1/arch/{architecture_id}/analyses`¶

List Architecture Analyses

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/analyses \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST `/api/v1/arch/{architecture_id}/analyses`¶

Create Architecture Analysis

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`201`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`baseGraph`	one of	no	—
`edges`	one of	no	—
`label`	string	no	`maxLength` 200
`nodes`	one of	no	—
`target`	one of	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/arch/{architecture_id}/analyses \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"baseGraph": {}, "nodes": [], "edges": []}'

GET `/api/v1/arch/{architecture_id}/analyses/{analysis_id}`¶

Get Architecture Analysis

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/analyses/{analysis_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}/audit-events`¶

List Architecture Audit Events

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/audit-events \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}/builds`¶

List Architecture Builds

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/builds \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST `/api/v1/arch/{architecture_id}/builds`¶

Create Architecture Build

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`201`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`apply`	boolean	no	—
`label`	string	no	`maxLength` 200
`target`	object	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/arch/{architecture_id}/builds \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target": {}, "label": "…", "apply": false}'

GET `/api/v1/arch/{architecture_id}/builds/{build_id}`¶

Get Architecture Build

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/builds/{build_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}/diffs`¶

List Architecture Diffs

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/diffs \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST `/api/v1/arch/{architecture_id}/diffs`¶

Create Architecture Diff

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`201`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`after`	one of	no	—
`before`	object	no	—
`label`	string	no	`maxLength` 200

curl

curl -X POST https://api.trilocore.ai/api/v1/arch/{architecture_id}/diffs \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"before": {}, "after": {}, "label": "…"}'

GET `/api/v1/arch/{architecture_id}/diffs/{diff_id}`¶

Get Architecture Diff

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/diffs/{diff_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}/snapshots`¶

List Architecture Snapshots

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/snapshots \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST `/api/v1/arch/{architecture_id}/snapshots`¶

Create Architecture Snapshot

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	required
Success	`201`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`label`	string	no	`maxLength` 200

curl

curl -X POST https://api.trilocore.ai/api/v1/arch/{architecture_id}/snapshots \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"label": "…"}'

GET `/api/v1/arch/{architecture_id}/snapshots/{snapshot_id}`¶

Get Architecture Snapshot

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/snapshots/{snapshot_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}/threats`¶

Get Architecture Threats

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/threats \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/arch/{architecture_id}/traces`¶

List Architecture Traces

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/traces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST `/api/v1/arch/{architecture_id}/traces`¶

Create Architecture Trace

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`201`
Upstream	`bevm-backend`

Request body

Field	Type	Required	Constraints
`label`	string	no	`maxLength` 200
`root_address`	one of	no	—
`trace`	object	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/arch/{architecture_id}/traces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trace": {}, "root_address": "…", "label": "…"}'

GET `/api/v1/arch/{architecture_id}/traces/{trace_id}`¶

Get Architecture Trace

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`bevm-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/arch/{architecture_id}/traces/{trace_id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

Architecture¶

GET /api/v1/arch¶

POST /api/v1/arch¶

GET /api/v1/arch/rules¶

DELETE /api/v1/arch/{architecture_id}¶

GET /api/v1/arch/{architecture_id}¶

PATCH /api/v1/arch/{architecture_id}¶

PUT /api/v1/arch/{architecture_id}¶

GET /api/v1/arch/{architecture_id}/analyses¶

POST /api/v1/arch/{architecture_id}/analyses¶

GET /api/v1/arch/{architecture_id}/analyses/{analysis_id}¶

GET /api/v1/arch/{architecture_id}/audit-events¶

GET /api/v1/arch/{architecture_id}/builds¶

POST /api/v1/arch/{architecture_id}/builds¶

GET /api/v1/arch/{architecture_id}/builds/{build_id}¶

GET /api/v1/arch/{architecture_id}/diffs¶

POST /api/v1/arch/{architecture_id}/diffs¶

GET /api/v1/arch/{architecture_id}/diffs/{diff_id}¶

GET /api/v1/arch/{architecture_id}/snapshots¶

POST /api/v1/arch/{architecture_id}/snapshots¶

GET /api/v1/arch/{architecture_id}/snapshots/{snapshot_id}¶

GET /api/v1/arch/{architecture_id}/threats¶

GET /api/v1/arch/{architecture_id}/traces¶

POST /api/v1/arch/{architecture_id}/traces¶

GET /api/v1/arch/{architecture_id}/traces/{trace_id}¶

GET `/api/v1/arch`¶

POST `/api/v1/arch`¶

GET `/api/v1/arch/rules`¶

DELETE `/api/v1/arch/{architecture_id}`¶

GET `/api/v1/arch/{architecture_id}`¶

PATCH `/api/v1/arch/{architecture_id}`¶

PUT `/api/v1/arch/{architecture_id}`¶

GET `/api/v1/arch/{architecture_id}/analyses`¶

POST `/api/v1/arch/{architecture_id}/analyses`¶

GET `/api/v1/arch/{architecture_id}/analyses/{analysis_id}`¶

GET `/api/v1/arch/{architecture_id}/audit-events`¶

GET `/api/v1/arch/{architecture_id}/builds`¶

POST `/api/v1/arch/{architecture_id}/builds`¶

GET `/api/v1/arch/{architecture_id}/builds/{build_id}`¶

GET `/api/v1/arch/{architecture_id}/diffs`¶

POST `/api/v1/arch/{architecture_id}/diffs`¶

GET `/api/v1/arch/{architecture_id}/diffs/{diff_id}`¶

GET `/api/v1/arch/{architecture_id}/snapshots`¶

POST `/api/v1/arch/{architecture_id}/snapshots`¶

GET `/api/v1/arch/{architecture_id}/snapshots/{snapshot_id}`¶

GET `/api/v1/arch/{architecture_id}/threats`¶

GET `/api/v1/arch/{architecture_id}/traces`¶

POST `/api/v1/arch/{architecture_id}/traces`¶

GET `/api/v1/arch/{architecture_id}/traces/{trace_id}`¶