Fascia Platform API (0.1.0)

Download OpenAPI specification:Download

Spec Registry and Platform management API

Audit

Audit log queries

Query audit logs

query Parameters

limit	integer [ 1 .. 100 ] Default: 20
offset	integer >= 0 Default: 0
userId	string
entityType	string
entityId	string
operation	string
from	string <date-time>
to	string <date-time>

Responses

Response Schema: application/json

	Array of objects
total	integer
limit	integer
offset	integer

Response samples

200

Content type

application/json

{"logs": [{"id": "string",
"workspace_id": "string",
"user_id": null,
"user_email": null,
"operation": "string",
"entity_type": "string",
"entity_id": null,
"entity_name": null,
"changes": null,
"ip_address": null,
"user_agent": null,
"created_at": "string"
}
],
"total": 0,
"limit": 0,
"offset": 0
}

Bundle

Spec bundle for executor runtime

Get spec bundle for executor

Responses

Response Schema: application/json

	object
	object
	object
	object

Response samples

200

Content type

application/json

{"entities": { },
"tools": { },
"policies": { },
"manifest": {"version": "string",
"schemaVersion": "string",
"workspaceId": "string"
}
}

Deploy

Deployment management

Create Deploy

Request Body schema: application/json
required

environment

required

string

Enum: "development" "production"

Responses

Request samples

Payload

Content type

application/json

{"environment": "development"
}

Response samples

202

Content type

application/json

{ }

Get Deploy Byid Status

path Parameters

id

required

string <uuid>

Responses

Response Schema: application/json

property name*

additional property

any

Response samples

200

Content type

application/json

{ }

Rollback a deployment

path Parameters

id

required

string <uuid>

Responses

Response Schema: application/json

property name*

additional property

any

Response samples

200

Content type

application/json

{ }

List deployment history

query Parameters

limit	integer [ 1 .. 100 ] Default: 20
offset	integer >= 0 Default: 0

Responses

Response Schema: application/json

property name*

additional property

any

Response samples

200

Content type

application/json

{ }

Health

Health check and readiness endpoints

Health check

Responses

Response Schema: application/json

status	string
version	string

Response samples

200

Content type

application/json

{"status": "string",
"version": "string"
}

Liveness probe

Responses

Response Schema: application/json

status

string

Response samples

200

Content type

application/json

{"status": "string"
}

Readiness probe

Responses

Response Schema: application/json

status	string
	object
property name* additional property	any

Response samples

200
503

Content type

application/json

{"status": "string",
"checks": { }
}

Risk

Risk Engine analysis

Analyze tool risk level

Request Body schema: application/json
required

name required	string
version required	integer
description required	string
required	object
required	object
required	object
required	object
policies	Array of strings
	object
idempotencyKey	string
	object
concurrencyStrategy	string
property name* additional property	any

Responses

Response Schema: application/json

riskLevel	string Enum: "green" "yellow" "red"
	Array of objects
	Array of objects

Request samples

Payload

Content type

application/json

{"name": "string",
"version": 0,
"description": "string",
"trigger": { },
"input": { },
"output": { },
"flow": {"nodes": { },
"edges": [ ],
"startNode": "string"
},
"policies": ["string"
],
"auth": { },
"idempotencyKey": "string",
"compensation": { },
"concurrencyStrategy": "string"
}

Response samples

200

Content type

application/json

{"riskLevel": "green",
"signals": [{"rule": "string",
"level": "string",
"message": "string",
"nodeIds": ["string"
]
}
],
"suggestions": [{"rule": "string",
"description": "string"
}
]
}

Safety

Safety Agent — AI-powered spec analysis

Generate safety test cases

Request Body schema: application/json
required

description required	string [ 1 .. 2000 ] characters
target required	string Enum: "entity" "tool"
	object

Responses

Response Schema: application/json

	object
	object
	null or object
testCases	Array of arrays

Request samples

Payload

Content type

application/json

{"description": "string",
"target": "entity",
"context": {"existingEntities": ["string"
],
"existingTools": ["string"
]
}
}

Response samples

200

Content type

application/json

{"spec": { },
"crossCheck": { },
"riskAnalysis": null,
"testCases": [ ]
}

Review tool spec safety

Request Body schema: application/json
required

specType required	string Enum: "entity" "tool"
required	object
context	string

Responses

Response Schema: application/json

	object
	null or object
testCases	Array of arrays

Request samples

Payload

Content type

application/json

{"specType": "entity",
"spec": { },
"context": "string"
}

Response samples

200

Content type

application/json

{"crossCheck": { },
"riskAnalysis": null,
"testCases": [ ]
}

Full safety analysis

Request Body schema: application/json
required

specType required	string Enum: "entity" "tool"
required	object

Responses

Response Schema: application/json

	null or object
	object
testCases	Array of arrays
overallVerdict	string Enum: "safe" "warnings" "unsafe"

Request samples

Payload

Content type

application/json

{"specType": "entity",
"spec": { }
}

Response samples

200

Content type

application/json

{"riskAnalysis": null,
"crossCheck": { },
"testCases": [ ],
"overallVerdict": "safe"
}

Specs

Spec Registry CRUD — Entity, Tool, Policy specs

Create Specs Bytype

path Parameters

type

required

string

Request Body schema: application/json
required

property name*

additional property

any

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

201

Content type

application/json

{"id": "string",
"workspace_id": "string",
"type": "string",
"name": "string",
"version": 0,
"content": { },
"risk_level": null,
"created_at": "string",
"created_by": null,
"deleted_at": null
}

Get Specs Bytype

path Parameters

type

required

string

query Parameters

limit	integer [ 1 .. 100 ] Default: 20
offset	integer >= 0 Default: 0

Responses

Response Schema: application/json

	Array of objects
total	integer
limit	integer
offset	integer

Response samples

200

Content type

application/json

{"specs": [{"id": "string",
"workspace_id": "string",
"type": "string",
"name": "string",
"version": 0,
"content": { },
"risk_level": null,
"created_at": "string",
"created_by": null,
"deleted_at": null
}
],
"total": 0,
"limit": 0,
"offset": 0
}

Get Specs Bytype Byname

path Parameters

type required	string
name required	string

Responses

Response Schema: application/json

id	string
workspace_id	string
type	string
name	string
version	integer
	object
risk_level	null or string
created_at	string
created_by	null or string
deleted_at	null or string

Response samples

200

Content type

application/json

{"id": "string",
"workspace_id": "string",
"type": "string",
"name": "string",
"version": 0,
"content": { },
"risk_level": null,
"created_at": "string",
"created_by": null,
"deleted_at": null
}

Update Specs Bytype Byname

path Parameters

type required	string
name required	string

Request Body schema: application/json
required

property name*

additional property

any

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

201

Content type

application/json

{"id": "string",
"workspace_id": "string",
"type": "string",
"name": "string",
"version": 0,
"content": { },
"risk_level": null,
"created_at": "string",
"created_by": null,
"deleted_at": null
}

Delete Specs Bytype Byname

path Parameters

type required	string
name required	string

Responses

Response Schema: application/json

message	string
deletedVersions	integer

Response samples

200

Content type

application/json

{"message": "string",
"deletedVersions": 0
}

Get Specs Bytype Byname Versions

path Parameters

type required	string
name required	string

Responses

Response Schema: application/json

Array of objects

Array

id	string
workspace_id	string
type	string
name	string
version	integer
	object
risk_level	null or string
created_at	string
created_by	null or string
deleted_at	null or string

Response samples

200

Content type

application/json

{"versions": [{"id": "string",
"workspace_id": "string",
"type": "string",
"name": "string",
"version": 0,
"content": { },
"risk_level": null,
"created_at": "string",
"created_by": null,
"deleted_at": null
}
]
}

Get Specs Bytype Byname Versions Byversion

path Parameters

type required	string
name required	string
version required	string

Responses

Response Schema: application/json

id	string
workspace_id	string
type	string
name	string
version	integer
	object
risk_level	null or string
created_at	string
created_by	null or string
deleted_at	null or string

Response samples

200

Content type

application/json

{"id": "string",
"workspace_id": "string",
"type": "string",
"name": "string",
"version": 0,
"content": { },
"risk_level": null,
"created_at": "string",
"created_by": null,
"deleted_at": null
}

Workspace

Workspace GCP configuration

Create Workspace Gcp

Request Body schema: application/json
required

gcpProjectId required	string non-empty
region	string Default: "us-central1"
required	object

Responses

Response Schema: application/json

property name*

additional property

any

Request samples

Payload

Content type

application/json

{"gcpProjectId": "string",
"region": "us-central1",
"serviceAccountKey": { }
}

Response samples

200

Content type

application/json

{ }

Delete Workspace Gcp

Responses

Response Schema: application/json

property name*

additional property

any

Response samples

200

Content type

application/json

{ }

Check GCP connection status

Responses

Response Schema: application/json

property name*

additional property

any

Response samples

200
404

Content type

application/json

{ }

Fascia Platform API (0.1.0)

Audit

Query audit logs

query Parameters

Responses

Response Schema: application/json

Response samples

Bundle

Get spec bundle for executor

Responses

Response Schema: application/json

Response samples

Deploy

Create Deploy

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get Deploy Byid Status

path Parameters

Responses

Response Schema: application/json

Response samples

Rollback a deployment

path Parameters

Responses

Response Schema: application/json

Response samples

List deployment history

query Parameters

Responses

Response Schema: application/json

Response samples

Health

Health check

Responses

Response Schema: application/json

Response samples

Liveness probe

Responses

Response Schema: application/json

Response samples

Readiness probe

Responses

Response Schema: application/json

Response samples

Risk

Analyze tool risk level

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Safety

Generate safety test cases

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Review tool spec safety

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Full safety analysis

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Specs

Create Specs Bytype

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get Specs Bytype

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required