CalypsoAI · Schema
GetPublicChatResponse
Artificial IntelligenceSecurityComplianceEnterpriseGenerative AI
Properties
| Name | Type | Description |
|---|---|---|
| chat | object | Requested chat object. |
| prompts | array | Prompts contained in the chat. |
| provider | object | Provider the chat was sent to, if any. |
| user | object | Details of the user who owns the chat. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/calypsoai-com/json-schema/calypsoai-com-get-public-chat-response-schema.json",
"title": "GetPublicChatResponse",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/calypsoai-com-chats-api-openapi.yml#/components/schemas/GetPublicChatResponse",
"properties": {
"chat": {
"$ref": "#/$defs/Chat",
"description": "Requested chat object."
},
"prompts": {
"description": "Prompts contained in the chat.",
"items": {
"$ref": "#/$defs/PublicPrompt"
},
"title": "Prompts",
"type": "array"
},
"provider": {
"anyOf": [
{
"$ref": "#/$defs/PublicProvider"
},
{
"type": "null"
}
],
"description": "Provider the chat was sent to, if any."
},
"user": {
"$ref": "#/$defs/User",
"description": "Details of the user who owns the chat."
}
},
"required": [
"chat",
"prompts",
"user"
],
"type": "object",
"$defs": {
"APIRequestBlock": {
"properties": {
"awsAuth": {
"anyOf": [
{
"$ref": "#/$defs/AWSAuth"
},
{
"type": "null"
}
],
"template": true
},
"body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "Body"
},
"headers": {
"additionalProperties": true,
"default": {},
"template": true,
"title": "Headers",
"type": "object"
},
"json": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "Json"
},
"method": {
"$ref": "#/$defs/HTTPMethod"
},
"ociAuth": {
"anyOf": [
{
"$ref": "#/$defs/OCIAuth"
},
{
"type": "null"
}
],
"template": true
},
"outputs": {
"$ref": "#/$defs/APIScopeOutputs",
"default": {}
},
"queryParams": {
"additionalProperties": {
"type": "string"
},
"default": {},
"template": true,
"title": "Queryparams",
"type": "object"
},
"timeout": {
"default": 20,
"title": "Timeout",
"type": "integer"
},
"type": {
"const": "request",
"default": "request",
"title": "Type",
"type": "string"
},
"url": {
"template": true,
"title": "Url",
"type": "string"
}
},
"required": [
"method",
"url"
],
"title": "APIRequestBlock",
"type": "object"
},
"APIRetryBlock": {
"properties": {
"attempts": {
"title": "Attempts",
"type": "integer"
},
"backoff": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
],
"default": 1,
"template": true,
"title": "Backoff"
},
"block": {
"oneOf": [
{
"$ref": "#/$defs/APIRequestBlock"
},
{
"$ref": "#/$defs/APIWorkflowBlock"
},
{
"$ref": "#/$defs/APIRetryBlock"
}
],
"template": true,
"title": "Block"
},
"type": {
"const": "retry",
"default": "retry",
"title": "Type",
"type": "string"
},
"when": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "When"
}
},
"required": [
"attempts",
"block"
],
"title": "APIRetryBlock",
"type": "object"
},
"APIScopeOutputs": {
"patternProperties": {
"^[a-zA-Z_][a-zA-Z0-9_]*$": {
"type": "string"
}
},
"template": true,
"title": "APIScopeOutputs",
"type": "object"
},
"APIWorkflowBlock": {
"properties": {
"outputs": {
"$ref": "#/$defs/APIScopeOutputs",
"default": {}
},
"stages": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/APIRequestBlock"
},
{
"$ref": "#/$defs/APIRetryBlock"
},
{
"$ref": "#/$defs/APIWorkflowBlock"
}
]
},
"template": true,
"title": "Stages",
"type": "array"
},
"type": {
"const": "workflow",
"default": "workflow",
"title": "Type",
"type": "string"
}
},
"required": [
"stages"
],
"title": "APIWorkflowBlock",
"type": "object"
},
"AWSAuth": {
"properties": {
"accessKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "Accesskey"
},
"region": {
"template": true,
"title": "Region",
"type": "string"
},
"secretKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "Secretkey"
},
"service": {
"template": true,
"title": "Service",
"type": "string"
},
"token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "Token"
}
},
"required": [
"service",
"region"
],
"title": "AWSAuth",
"type": "object"
},
"Chat": {
"properties": {
"access": {
"$ref": "#/$defs/ChatAccess"
},
"createdAt": {
"format": "date-time",
"title": "Createdat",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"maxLength": 100,
"minLength": 1,
"title": "Name",
"type": "string"
},
"projectId": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "ID of the project this chat belongs to",
"title": "Projectid"
},
"promptId": {
"description": "ID of the first prompt in the chat, can be used to retrieve all prompts in the chat",
"format": "uuid",
"title": "Promptid",
"type": "string"
},
"promptTemplateId": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "ID of the prompt template this chat was created from.",
"title": "Prompttemplateid"
},
"starred": {
"description": "Starred means the chat has been bookmarked or 'starred' to find later",
"title": "Starred",
"type": "boolean"
},
"updatedAt": {
"format": "date-time",
"title": "Updatedat",
"type": "string"
},
"userId": {
"description": "User who created the chat",
"title": "Userid",
"type": "string"
}
},
"required": [
"id",
"name",
"promptId",
"userId",
"starred",
"createdAt",
"updatedAt",
"access"
],
"title": "Chat",
"type": "object"
},
"ChatAccess": {
"properties": {
"org": {
"description": "If True, is accessible to anyone in the same org as the user that created the chat",
"title": "Org",
"type": "boolean"
},
"public": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "If is not None, Chat is publicly accessible to anyone with the access ID",
"title": "Public"
},
"users": {
"description": "list of users ID of users with access to the chat",
"items": {
"type": "string"
},
"title": "Users",
"type": "array"
}
},
"required": [
"org",
"users"
],
"title": "ChatAccess",
"type": "object"
},
"ErrorScanResult": {
"properties": {
"msg": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Msg"
},
"type": {
"const": "error",
"default": "error",
"title": "Type",
"type": "string"
}
},
"title": "ErrorScanResult",
"type": "object"
},
"GenAIScannerResult": {
"properties": {
"tokenUsage": {
"default": 0,
"title": "Tokenusage",
"type": "integer"
},
"type": {
"default": "custom",
"enum": [
"genai",
"custom"
],
"title": "Type",
"type": "string"
}
},
"title": "GenAIScannerResult",
"type": "object"
},
"HTTPMethod": {
"enum": [
"GET",
"POST",
"PUT",
"DELETE",
"PATCH",
"HEAD",
"OPTIONS"
],
"title": "HTTPMethod",
"type": "string"
},
"KeywordScannerResult": {
"properties": {
"matches": {
"additionalProperties": {
"items": {
"maxItems": 2,
"minItems": 2,
"prefixItems": [
{
"type": "integer"
},
{
"type": "integer"
}
],
"type": "array"
},
"type": "array"
},
"title": "Matches",
"type": "object"
},
"type": {
"const": "keyword",
"default": "keyword",
"title": "Type",
"type": "string"
}
},
"required": [
"matches"
],
"title": "KeywordScannerResult",
"type": "object"
},
"LegacyScannerResult": {
"additionalProperties": true,
"properties": {},
"title": "LegacyScannerResult",
"type": "object"
},
"MLTextScannerResult": {
"properties": {
"type": {
"const": "ml_text",
"default": "ml_text",
"title": "Type",
"type": "string"
}
},
"title": "MLTextScannerResult",
"type": "object"
},
"OCIAuth": {
"properties": {
"keyId": {
"template": true,
"title": "Keyid",
"type": "string"
},
"passphrase": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"template": true,
"title": "Passphrase"
},
"privateKeyPem": {
"template": true,
"title": "Privatekeypem",
"type": "string"
}
},
"required": [
"keyId",
"privateKeyPem"
],
"title": "OCIAuth",
"type": "object"
},
"PromptOutcome": {
"description": "Outcome of a prompt after it has been processed by all guardrails and providers.\n\nCleared: All guardrails passed, and the prompt was sent to providers\nFlagged: At least one guardrail failed, and the prompt was sent to providers\nBlocked: At least one guardrail failed, and the prompt was not sent to providers.",
"enum": [
"cleared",
"flagged",
"redacted",
"blocked"
],
"title": "PromptOutcome",
"type": "string"
},
"PromptResultFile": {
"properties": {
"contentType": {
"title": "Contenttype",
"type": "string"
},
"data": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "File data, optionally base64 encoded if isBase64 is true",
"title": "Data"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"isBase64": {
"title": "Isbase64",
"type": "boolean"
},
"name": {
"title": "Name",
"type": "string"
}
},
"required": [
"id",
"name",
"contentType",
"isBase64"
],
"title": "PromptResultFile",
"type": "object"
},
"ProviderPromptResult": {
"properties": {
"data": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Response contents from LLM",
"title": "Data"
},
"receivedDate": {
"description": "Time response was received from the LLM",
"format": "date-time",
"title": "Receiveddate",
"type": "string"
},
"sentDate": {
"description": "Time prompt was sent to the LLM",
"format": "date-time",
"title": "Sentdate",
"type": "string"
},
"statusCode": {
"description": "Status code returned from request to provider",
"title": "Statuscode",
"type": "integer"
}
},
"required": [
"statusCode",
"sentDate",
"receivedDate"
],
"title": "ProviderPromptResult",
"type": "object"
},
"ProviderType": {
"enum": [
"ibm",
"openai",
"azure",
"cohere",
"ai21",
"custom",
"anthropic",
"groq",
"openai-compatible",
"huggingface",
"siem",
"google",
"bedrock"
],
"title": "ProviderType",
"type": "string"
},
"PublicPrompt": {
"properties": {
"externalMetadata": {
"anyOf": [
{
"maxProperties": 10,
"patternProperties": {
"^[a-zA-Z0-9_\\-]*$": {
"maxLength": 255,
"type": "string"
}
},
"propertyNames": {
"maxLength": 50
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Externalmetadata"
},
"extraInputs": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Extrainputs"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"input": {
"anyOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"type": "object"
},
{
"items": {},
"type": "array"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "boolean"
}
],
"title": "Input"
},
"memory": {
"anyOf": [
{
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "IDs of prev prompts in the conversation",
"title": "Memory"
},
"parentId": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "ID of the last prompt in the conversation",
"title": "Parentid"
},
"preserve": {
"default": false,
"title": "Preserve",
"type": "boolean"
},
"projectId": {
"format": "uuid",
"title": "Projectid",
"type": "string"
},
"provider": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "ID of LLM provider use for the prompt",
"title": "Provider"
},
"receivedAt": {
"format": "date-time",
"title": "Receivedat",
"type": "string"
},
"result": {
"anyOf": [
{
"$ref": "#/$defs/ScanRequestResult"
},
{
"$ref": "#/$defs/PublicPromptResult"
},
{
"type": "null"
}
],
"title": "Result"
},
"type": {
"anyOf": [
{
"enum": [
"prompt",
"scan"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Type"
},
"userId": {
"title": "Userid",
"type": "string"
}
},
"required": [
"id",
"projectId",
"input",
"receivedAt",
"userId"
],
"title": "PublicPrompt",
"type": "object"
},
"PublicPromptResult": {
"properties": {
"files": {
"default": [],
"items": {
"$ref": "#/$defs/PromptResultFile"
},
"title": "Files",
"type": "array"
},
"outcome": {
"$ref": "#/$defs/PromptOutcome",
"description": "One of 'cleared', 'flagged' or 'blocked'"
},
"providerResult": {
"anyOf": [
{
"$ref": "#/$defs/ProviderPromptResult"
},
{
"type": "null"
}
]
},
"response": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The response to the prompt from the LLM",
"title": "Response"
}
},
"required": [
"outcome"
],
"title": "PublicPromptResult",
"type": "object"
},
"PublicProvider": {
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"description": "The name can be used to identify the provider instead of the id. It is case-sensitive, unique and can only contain letters, numbers and dashes.",
"pattern": "^[a-zA-Z0-9-_]+$",
"title": "Name",
"type": "string"
},
"systemProviderId": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Systemproviderid"
},
"template": {
"oneOf": [
{
"$ref": "#/$defs/APIRequestBlock"
},
{
"$ref": "#/$defs/APIRetryBlock"
},
{
"$ref": "#/$defs/APIWorkflowBlock"
}
],
"title": "Template"
},
"type": {
"$ref": "#/$defs/ProviderType"
}
},
"required": [
"id",
"name",
"type",
"template"
],
"title": "PublicProvider",
"type": "object"
},
"RegexScannerResult": {
"properties": {
"matches": {
"items": {
"maxItems": 2,
"minItems": 2,
"prefixItems": [
{
"type": "integer"
},
{
"type": "integer"
}
],
"type": "array"
},
"title": "Matches",
"type": "array"
},
"type": {
"const": "regex",
"default": "regex",
"title": "Type",
"type": "string"
}
},
"required": [
"matches"
],
"title": "RegexScannerResult",
"type": "object"
},
"Scan": {
"properties": {
"completedDate": {
"format": "date-time",
"title": "Completeddate",
"type": "string"
},
"customConfig": {
"default": false,
"title": "Customconfig",
"type": "boolean"
},
"data": {
"anyOf": [
{
"oneOf": [
{
"$ref": "#/$defs/RegexScannerResult"
},
{
"$ref": "#/$defs/KeywordScannerResult"
},
{
"$ref": "#/$defs/GenAIScannerResult"
},
{
"$ref": "#/$defs/MLTextScannerResult"
},
{
"$ref": "#/$defs/ErrorScanResult"
}
]
},
{
"$ref": "#/$defs/LegacyScannerResult"
}
],
"title": "Data"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message"
},
"outcome": {
"$ref": "#/$defs/ScanOutcome"
},
"scanDirection": {
"$ref": "#/$defs/ScanDirection"
},
"scannerId": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Scannerid"
},
"scannerName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Scannername"
},
"scannerVersionMeta": {
"anyOf": [
{
"$ref": "#/$defs/ScannerVersionMeta"
},
{
"type": "null"
}
]
},
"startedDate": {
"format": "date-time",
"title": "Starteddate",
"type": "string"
}
},
"required": [
"outcome",
"data",
"startedDate",
"completedDate",
"scanDirection"
],
"title": "Scan",
"type": "object"
},
"ScanDirection": {
"enum": [
"request",
"response"
],
"title": "ScanDirection",
"type": "string"
},
"ScanOutcome": {
"description": "The outcome of a single scan on a prompt.",
"enum": [
"failed",
"passed"
],
"title": "ScanOutcome",
"type": "string"
},
"ScanRequestResult": {
"properties": {
"outcome": {
"$ref": "#/$defs/PromptOutcome",
"description": "One of 'cleared' or 'flagged'"
},
"response": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The response of the prompt from the llm after processing by guardrails, in case it is a response scan",
"title": "Response"
},
"scannerResults": {
"description": "Result for each guardrail that ran on the prompt",
"items": {
"$ref": "#/$defs/Scan"
},
"title": "Scannerresults",
"type": "array"
}
},
"required": [
"scannerResults",
"outcome"
],
"title": "ScanRequestResult",
"type": "object"
},
"ScannerDatasetResult": {
"properties": {
"datasetRunId": {
"format": "uuid",
"title": "Datasetrunid",
"type": "string"
},
"f1Score": {
"title": "F1Score",
"type": "number"
}
},
"required": [
"datasetRunId",
"f1Score"
],
"title": "ScannerDatasetResult",
"type": "object"
},
"ScannerDirection": {
"enum": [
"both",
"request",
"response"
],
"title": "ScannerDirection",
"type": "string"
},
"ScannerVersionMeta": {
"properties": {
"createdAt": {
"format": "date-time",
"title": "Createdat",
"type": "string"
},
"createdBy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Createdby"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"direction": {
"anyOf": [
{
"$ref": "#/$defs/ScannerDirection"
},
{
"type": "null"
}
]
},
"f1Score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "F1Score"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"latestDatasetResult": {
"anyOf": [
{
"$ref": "#/$defs/ScannerDatasetResult"
},
{
"type": "null"
}
]
},
"name": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[a-zA-Z0-9-_]+$",
"title": "Name",
"type": "string"
},
"published": {
"title": "Published",
"type": "boolean"
}
},
"required": [
"id",
"createdAt",
"name",
"published"
],
"title": "ScannerVersionMeta",
"type": "object"
},
"User": {
"properties": {
"admin": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Admin"
},
"blocked": {
"default": false,
"title": "Blocked",
"type": "boolean"
},
"createdAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Createdat"
},
"email": {
"format": "password",
"title": "Email",
"type": "string",
"writeOnly": true
},
"id": {
"title": "Id",
"type": "string"
},
"lastInvitationSentAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Lastinvitationsentat"
},
"machine": {
"default": false,
"title": "Machine",
"type": "boolean"
},
"name": {
"format": "password",
"title": "Name",
"type": "string",
"writeOnly": true
},
"org": {
"title": "Org",
"type": "string"
},
"permissions": {
"default": [],
"items": {
"type": "string"
},
"title": "Permissions",
"type": "array",
"uniqueItems": true
},
"roleIds": {
"default": [],
"items": {
"format": "uuid",
"type": "string"
},
"title": "Roleids",
"type": "array"
},
"roles": {
"default": [],
"items": {
"type": "string"
},
"title": "Roles",
"type": "array"
},
"social": {
"default": false,
"title": "Social",
"type": "boolean"
},
"teams": {
"default": [],
"items": {
"type": "string"
},
"title": "Teams",
"type": "array"
},
"verified": {
"default": true,
"title": "Verified",
"type": "boolean"
}
},
"required": [
"id",
"name",
"email",
"org"
],
"title": "User",
"type": "object"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/calypsoai-com-get-public-chat-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.