{ "manifest_version": "1.0", "name": "agined", "display_name": "Agined + Attestor", "description": "Manage Agined audit + compliance and Attestor cryptographic receipts directly from Gemini.", "vendor": "Agined", "version": "0.32.289-agined.1", "contact": { "email": "support@agined.com", "url": "https://agined.com" }, "icons": { "16": "https://cdn.agined.com/static/files/media/images/v1/agined-mark-16.png", "48": "https://cdn.agined.com/static/files/media/images/v1/agined-mark-48.png", "128": "https://cdn.agined.com/static/files/media/images/v1/agined-mark-128.png" }, "auth": { "type": "oauth2", "authorization_endpoint": "https://agined.com/auth/authorize", "token_endpoint": "https://api.agined.com/api/v1/oauth/token", "scopes": [ "organization.rename", "billing.view", "members.view", "members.invite", "members.remove", "members.change_role", "organization.transfer_ownership", "organization.delete", "settings.view_audit_log", "settings.configure_sso", "workspaces.view", "workspaces.create", "settings.view", "workspace.rename", "workspaces.delete", "workspace.schedule_deletion", "workspaces.transfer", "billing.change_plan", "billing.buy_pack", "billing.configure_autotopup", "billing.subscribe_addons", "keys.view", "keys.create", "keys.revoke", "webhooks.view", "webhooks.create", "webhooks.delete", "exports.view", "exports.create", "exports.download", "settings.edit_retention", "settings.edit_integrations", "settings.edit_capabilities", "attestor.attest.agent-call", "attestor.attest.content", "attestor.attest.llm", "attestor.attest.commit", "attestor.deliver.webhook", "attestor.monitors.create", "attestor.monitors.view", "attestor.monitors.delete", "attestor.dns.create", "attestor.dns.view", "attestor.dns.delete", "attestor.tls.create", "attestor.tls.view", "attestor.tls.delete", "attestor.receipts.view", "attestor.usage.view", "attestor.subscription.view", "attestor.abuse.view", "attestor.abuse.appeal", "agents.create", "agents.view", "agents.delete", "records.view", "integrations.view", "integrations.connect", "integrations.disconnect" ], "pkce": "S256", "dpop": true }, "tools": [ { "name": "account_session_list", "description": "List active sessions on this account.", "function_declarations": [ { "name": "account_session_list", "description": "List active sessions on this account.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.session.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sessions": { "type": "array", "items": { "type": "object", "properties": { "sessionId": { "type": "string" }, "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "authMethod": { "type": "string", "enum": [ "session_cookie", "pat", "workspace_api_key", "oauth_access_token", "oauth_access_token_dpop", "mtls_svid", "sidecar_token" ] }, "userAgent": { "type": "string", "maxLength": 500 }, "ipPrefix": { "type": "string", "pattern": "^[0-9a-f.:]+\\/\\d{1,3}$" }, "isCurrent": { "type": "boolean" } }, "required": [ "sessionId", "accountId", "issuedAt", "expiresAt", "authMethod", "isCurrent" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "sessions", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 10 }, "output": { "sessions": [], "nextCursor": null }, "note": "List active sessions." } ] }, { "name": "account_session_revoke", "description": "Revoke an active session by id (cannot be disabled — safety floor).", "function_declarations": [ { "name": "account_session_revoke", "description": "Revoke an active session by id (cannot be disabled — safety floor).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sessionId": { "type": "string" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "sessionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.session.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" }, "propagatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "revoked", "propagatedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "sessionId": "sess_abc" }, "output": { "revoked": true, "propagatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Kill an active session." } ] }, { "name": "account_profile_get", "description": "Get the authenticated account's profile.", "function_declarations": [ { "name": "account_profile_get", "description": "Get the authenticated account's profile.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.profile.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 80 }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "avatarUrl": { "type": "string", "format": "uri" } }, "required": [ "accountId", "email", "locale", "createdAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "accountId": "acct_demo00000000000000000000", "email": "owner@example.com", "displayName": "Ada Lovelace", "locale": "en", "createdAt": "2026-01-01T00:00:00.000Z" }, "note": "Read your profile." } ] }, { "name": "account_profile_update", "description": "Update account profile (display name, avatar URL).", "function_declarations": [ { "name": "account_profile_update", "description": "Update account profile (display name, avatar URL).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "displayName": { "type": "string", "minLength": 1, "maxLength": 80 }, "avatarUrl": { "type": "string", "format": "uri" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.profile.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 80 }, "avatarUrl": { "type": "string", "format": "uri" } }, "required": [ "accountId" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "displayName": "Ada Lovelace" }, "output": { "accountId": "acct_demo00000000000000000000", "displayName": "Ada Lovelace" }, "note": "Update display name." } ] }, { "name": "account_email_change", "description": "Request an email change. A verification email is sent to the new address; the change applies only after click-through.", "function_declarations": [ { "name": "account_email_change", "description": "Request an email change. A verification email is sent to the new address; the change applies only after click-through.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "newEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } }, "required": [ "newEmail" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.email.change" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pending": { "type": "boolean", "const": true }, "verificationSentTo": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } }, "required": [ "pending", "verificationSentTo" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "newEmail": "new@example.com" }, "output": { "pending": true, "verificationSentTo": "new@example.com" }, "note": "Start email change flow." } ] }, { "name": "account_email_change_pending", "description": "The email change currently in flight for this account, if any, and which address still has to confirm it.", "function_declarations": [ { "name": "account_email_change_pending", "description": "The email change currently in flight for this account, if any, and which address still has to confirm it.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.email.change.pending" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pending": { "anyOf": [ { "type": "object", "properties": { "newEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "requestedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "awaitingOldAddress": { "type": "boolean" }, "awaitingNewAddress": { "type": "boolean" } }, "required": [ "newEmail", "requestedAt", "expiresAt", "awaitingOldAddress", "awaitingNewAddress" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "pending" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "pending": { "newEmail": "new@example.com", "requestedAt": "2026-08-26T12:00:00.000Z", "expiresAt": "2026-08-27T12:00:00.000Z", "awaitingOldAddress": true, "awaitingNewAddress": false } }, "note": "The new address confirmed; the old one has not." }, { "input": {}, "output": { "pending": null }, "note": "No change in flight." } ] }, { "name": "account_passkey_list", "description": "List registered passkeys.", "function_declarations": [ { "name": "account_passkey_list", "description": "List registered passkeys.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.passkey.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "passkeys": { "type": "array", "items": { "type": "object", "properties": { "credentialId": { "type": "string" }, "nickname": { "type": "string", "minLength": 1, "maxLength": 80 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "aaguid": { "type": "string" }, "backupEligible": { "type": "boolean" }, "authenticatorAttachment": { "type": "string", "enum": [ "platform", "cross-platform" ] } }, "required": [ "credentialId", "nickname", "createdAt", "lastUsedAt", "backupEligible", "authenticatorAttachment" ], "additionalProperties": false } } }, "required": [ "passkeys" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "passkeys": [] }, "note": "List passkeys." } ] }, { "name": "account_passkey_revoke", "description": "Revoke a registered passkey.", "function_declarations": [ { "name": "account_passkey_revoke", "description": "Revoke a registered passkey.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "credentialId": { "type": "string" } }, "required": [ "credentialId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.passkey.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "credentialId": "cred_abc" }, "output": { "revoked": true }, "note": "Remove a passkey." } ] }, { "name": "account_locale_set", "description": "Set the account-level preferred locale (overrides browser default).", "function_declarations": [ { "name": "account_locale_set", "description": "Set the account-level preferred locale (overrides browser default).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "locale" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.locale.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "locale" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "locale": "de" }, "output": { "locale": "de" }, "note": "Switch UI language to German." } ] }, { "name": "account_display-preferences_set", "description": "Set the account-level theme and timezone.", "function_declarations": [ { "name": "account_display-preferences_set", "description": "Set the account-level theme and timezone.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "theme": { "type": "string", "enum": [ "system", "light", "dark" ] }, "timezone": { "type": "string", "minLength": 1, "maxLength": 64 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.display-preferences.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "theme": { "type": "string", "enum": [ "system", "light", "dark" ] }, "timezone": { "type": [ "string", "null" ] } }, "required": [ "theme", "timezone" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "theme": "dark" }, "output": { "theme": "dark", "timezone": null }, "note": "Switch to the dark theme." } ] }, { "name": "account_notifications_get", "description": "Read notification preferences.", "function_declarations": [ { "name": "account_notifications_get", "description": "Read notification preferences.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.notifications.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "marketingEmails": { "type": "boolean" }, "securityAlerts": { "type": "boolean" }, "billingAlerts": { "type": "boolean" }, "productUpdates": { "type": "boolean" }, "agentSessionStarted": { "type": "boolean" }, "agentSessionAnomaly": { "type": "boolean" }, "shadowSessionStarted": { "type": "boolean" }, "shadowDailyDigest": { "type": "boolean" }, "invitationAlerts": { "type": "boolean" }, "quotaWarnings": { "type": "boolean" }, "privacyRightsAlerts": { "type": "boolean" }, "digestCadence": { "type": "string", "enum": [ "off", "daily", "weekly" ] } }, "required": [ "marketingEmails", "securityAlerts", "billingAlerts", "productUpdates", "agentSessionStarted", "agentSessionAnomaly", "shadowSessionStarted", "shadowDailyDigest", "invitationAlerts", "quotaWarnings", "privacyRightsAlerts", "digestCadence" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "marketingEmails": false, "securityAlerts": true, "billingAlerts": true, "productUpdates": false, "agentSessionStarted": true, "agentSessionAnomaly": true, "shadowSessionStarted": true, "shadowDailyDigest": false, "invitationAlerts": true, "quotaWarnings": true, "privacyRightsAlerts": true, "digestCadence": "weekly" }, "note": "Read prefs." } ] }, { "name": "account_notifications_update", "description": "Update notification preferences.", "function_declarations": [ { "name": "account_notifications_update", "description": "Update notification preferences.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "marketingEmails": { "type": "boolean" }, "securityAlerts": { "type": "boolean" }, "billingAlerts": { "type": "boolean" }, "productUpdates": { "type": "boolean" }, "agentSessionStarted": { "type": "boolean" }, "agentSessionAnomaly": { "type": "boolean" }, "shadowSessionStarted": { "type": "boolean" }, "shadowDailyDigest": { "type": "boolean" }, "invitationAlerts": { "type": "boolean" }, "quotaWarnings": { "type": "boolean" }, "privacyRightsAlerts": { "type": "boolean" }, "digestCadence": { "type": "string", "enum": [ "off", "daily", "weekly" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.notifications.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "marketingEmails": { "type": "boolean" }, "securityAlerts": { "type": "boolean" }, "billingAlerts": { "type": "boolean" }, "productUpdates": { "type": "boolean" }, "agentSessionStarted": { "type": "boolean" }, "agentSessionAnomaly": { "type": "boolean" }, "shadowSessionStarted": { "type": "boolean" }, "shadowDailyDigest": { "type": "boolean" }, "invitationAlerts": { "type": "boolean" }, "quotaWarnings": { "type": "boolean" }, "privacyRightsAlerts": { "type": "boolean" }, "digestCadence": { "type": "string", "enum": [ "off", "daily", "weekly" ] } }, "required": [ "marketingEmails", "securityAlerts", "billingAlerts", "productUpdates", "agentSessionStarted", "agentSessionAnomaly", "shadowSessionStarted", "shadowDailyDigest", "invitationAlerts", "quotaWarnings", "privacyRightsAlerts", "digestCadence" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "agentSessionAnomaly": true }, "output": { "marketingEmails": false, "securityAlerts": true, "billingAlerts": true, "productUpdates": false, "agentSessionStarted": true, "agentSessionAnomaly": true, "shadowSessionStarted": true, "shadowDailyDigest": false, "invitationAlerts": true, "quotaWarnings": true, "privacyRightsAlerts": true, "digestCadence": "weekly" }, "note": "Turn on anomaly alerts." } ] }, { "name": "account_token_list", "description": "List your Personal Access Tokens (PATs).", "function_declarations": [ { "name": "account_token_list", "description": "List your Personal Access Tokens (PATs).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "includeRevoked": { "default": false, "type": "boolean" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.token.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tokens": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:av|tv)_pat_(?:demo_[0-9A-HJKMNP-TV-Z]{26}|[0-9a-f]{10})$" }, "prefix": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "ipCidrBinding": { "type": [ "string", "null" ] }, "last4": { "type": "string" } }, "required": [ "id", "prefix", "label", "scopes", "createdAt", "expiresAt", "lastUsedAt", "revokedAt", "last4" ], "additionalProperties": false } } }, "required": [ "tokens" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "includeRevoked": false }, "output": { "tokens": [] }, "note": "List active PATs." } ] }, { "name": "account_token_revoke", "description": "Revoke a PAT (cannot be disabled — safety floor).", "function_declarations": [ { "name": "account_token_revoke", "description": "Revoke a PAT (cannot be disabled — safety floor).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tokenId": { "type": "string", "pattern": "^(?:av|tv)_pat_(?:demo_[0-9A-HJKMNP-TV-Z]{26}|[0-9a-f]{10})$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "tokenId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.token.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" }, "propagatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "revoked", "propagatedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.revoked", "examples": [ { "input": { "tokenId": "av_pat_a1b2c3d4e5" }, "output": { "revoked": true, "propagatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Revoke a PAT." } ] }, { "name": "account_oauth-grants_list", "description": "List active OAuth grants to third-party agents (Claude, ChatGPT, Gemini, etc.).", "function_declarations": [ { "name": "account_oauth-grants_list", "description": "List active OAuth grants to third-party agents (Claude, ChatGPT, Gemini, etc.).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.oauth-grants.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "grants": { "type": "array", "items": { "type": "object", "properties": { "clientId": { "type": "string", "pattern": "^oauth_[0-9A-Z]{20,}$" }, "clientName": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "grantedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "dpopBound": { "type": "boolean" }, "delegationDepthAllowed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "clientLogoUrl": { "type": [ "string", "null" ] }, "attenuatedSubGrants": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "clientId", "clientName", "scopes", "grantedAt", "lastUsedAt", "expiresAt", "dpopBound", "delegationDepthAllowed", "clientLogoUrl", "attenuatedSubGrants" ], "additionalProperties": false } } }, "required": [ "grants" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "grants": [] }, "note": "List active connected apps." } ] }, { "name": "account_oauth-grants_revoke", "description": "Revoke an OAuth grant. The third-party agent's tokens are immediately invalidated.", "function_declarations": [ { "name": "account_oauth-grants_revoke", "description": "Revoke an OAuth grant. The third-party agent's tokens are immediately invalidated.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "clientId": { "type": "string", "pattern": "^oauth_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "clientId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.oauth-grants.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" }, "propagatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "revoked", "propagatedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.revoked", "examples": [ { "input": { "clientId": "oauth_CLAUDECOWORK0000000000" }, "output": { "revoked": true, "propagatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Kill a connected app session." } ] }, { "name": "account_security-log_list", "description": "Read the account-level security log (logins, MFA, key issuance, anomalies).", "function_declarations": [ { "name": "account_security-log_list", "description": "Read the account-level security log (logins, MFA, key issuance, anomalies).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "kindFilter": { "type": "array", "items": { "type": "string" } }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.security-log.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string", "enum": [ "login_success", "login_failure", "logout", "passkey_registered", "passkey_revoked", "pat_issued", "pat_revoked", "oauth_grant_approved", "oauth_grant_revoked", "anomalous_login_location", "step_up_prompt", "recovery_code_used", "email_changed", "password_changed" ] }, "summary": { "type": "string" }, "ipPrefix": { "type": "string" }, "authMethod": { "type": "string", "enum": [ "session_cookie", "pat", "workspace_api_key", "oauth_access_token", "oauth_access_token_dpop", "mtls_svid", "sidecar_token" ] } }, "required": [ "timestamp", "kind", "summary" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 25 }, "output": { "entries": [], "nextCursor": null }, "note": "Last 25 security events." } ] }, { "name": "account_delete", "description": "Schedule account deletion after a grace window (30 days by default). Organizations you solely own are scheduled with it; ones with other members are reported back instead. Requires WebAuthn step-up.", "function_declarations": [ { "name": "account_delete", "description": "Schedule account deletion after a grace window (30 days by default). Organizations you solely own are scheduled with it; ones with other members are reported back instead. Requires WebAuthn step-up.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "reason": { "type": "string", "minLength": 10, "maxLength": 500 }, "exportFirst": { "default": true, "type": "boolean" } }, "required": [ "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/account.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scheduledDeletionAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "gracePeriodDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "organizationsScheduled": { "type": "array", "items": { "type": "object", "properties": { "organizationId": { "type": "string" }, "name": { "type": "string" } }, "required": [ "organizationId", "name" ], "additionalProperties": false } }, "organizationsBlocked": { "type": "array", "items": { "type": "object", "properties": { "organizationId": { "type": "string" }, "name": { "type": "string" }, "otherMemberCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "organizationId", "name", "otherMemberCount" ], "additionalProperties": false } } }, "required": [ "scheduledDeletionAt", "gracePeriodDays", "organizationsScheduled", "organizationsBlocked" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "reason": "I no longer use this account; please delete in 30 days", "exportFirst": true }, "output": { "scheduledDeletionAt": "2026-06-21T00:00:00.000Z", "gracePeriodDays": 30, "organizationsScheduled": [ { "organizationId": "org_solo", "name": "Jake's Workspace" } ], "organizationsBlocked": [ { "organizationId": "org_team", "name": "Acme Corp", "otherMemberCount": 4 } ] }, "note": "Start account deletion with grace period; the shared org needs an ownership transfer first." } ] }, { "name": "org_get", "description": "Get the current organization's details.", "function_declarations": [ { "name": "org_get", "description": "Get the current organization's details.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "plan": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "scheduledDeletionAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "id", "name", "plan", "createdAt", "scheduledDeletionAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "id": "org_demo00000000000000000000", "name": "Demo Org", "plan": "pro", "createdAt": "2026-01-01T00:00:00.000Z", "scheduledDeletionAt": null }, "note": "Read org metadata." } ] }, { "name": "org_update", "description": "Update organization name + locale.", "function_declarations": [ { "name": "org_update", "description": "Update organization name + locale.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "plan": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "scheduledDeletionAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "id", "name", "plan", "createdAt", "scheduledDeletionAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "name": "New Org Name" }, "output": { "id": "org_demo00000000000000000000", "name": "New Org Name", "plan": "pro", "createdAt": "2026-01-01T00:00:00.000Z", "scheduledDeletionAt": null }, "note": "Rename the organization." } ] }, { "name": "org_locale_set", "description": "Set the organization-default locale (inherited by new workspaces).", "function_declarations": [ { "name": "org_locale_set", "description": "Set the organization-default locale (inherited by new workspaces).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "locale" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.locale.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "locale" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "locale": "de" }, "output": { "locale": "de" }, "note": "Org-default locale → German." } ] }, { "name": "org_billing-state_get", "description": "Get the org's current billing state (plan, subscription status, add-ons).", "function_declarations": [ { "name": "org_billing-state_get", "description": "Get the org's current billing state (plan, subscription status, add-ons).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.billing-state.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "plan": { "type": "string" }, "subscriptionStatus": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "multiWorkspaceAddonActive": { "type": "boolean" }, "extraWorkspacesCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "plan", "subscriptionStatus", "multiWorkspaceAddonActive", "extraWorkspacesCount", "currentPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "plan": "pro", "subscriptionStatus": "active", "multiWorkspaceAddonActive": true, "extraWorkspacesCount": 2, "currentPeriodEnd": "2026-06-22T00:00:00.000Z" }, "note": "Read billing state." } ] }, { "name": "org_member_list", "description": "List organization members.", "function_declarations": [ { "name": "org_member_list", "description": "List organization members.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.member.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "members": { "type": "array", "items": { "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 80 }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ] }, "joinedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "accountId", "email", "role", "joinedAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "members", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 25 }, "output": { "members": [], "nextCursor": null }, "note": "List org members." } ] }, { "name": "org_member_invite", "description": "Invite a new member to the organization. Sends a verification email.", "function_declarations": [ { "name": "org_member_invite", "description": "Invite a new member to the organization. Sends a verification email.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ] } }, "required": [ "email", "role" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.member.invite" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invitationId": { "type": "string" }, "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ] }, "invitedBy": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "invitedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "status": { "type": "string", "enum": [ "pending", "accepted", "expired", "revoked" ] } }, "required": [ "invitationId", "email", "role", "invitedBy", "invitedAt", "expiresAt", "status" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.invited", "examples": [ { "input": { "email": "newmember@example.com", "role": "member" }, "output": { "invitationId": "inv_abc", "email": "newmember@example.com", "role": "member", "invitedBy": "acct_demo00000000000000000000", "invitedAt": "2026-05-22T12:00:00.000Z", "expiresAt": "2026-05-29T12:00:00.000Z", "status": "pending" }, "note": "Invite a new member." } ] }, { "name": "org_member_remove", "description": "Remove a member from the organization. They lose access to all workspaces immediately.", "function_declarations": [ { "name": "org_member_remove", "description": "Remove a member from the organization. They lose access to all workspaces immediately.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "accountId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.member.remove" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "removed": { "type": "boolean" } }, "required": [ "removed" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.removed", "examples": [ { "input": { "accountId": "acct_demo00000000000000000000" }, "output": { "removed": true }, "note": "Remove a member." } ] }, { "name": "org_member_role_change", "description": "Change an org member's role.", "function_declarations": [ { "name": "org_member_role_change", "description": "Change an org member's role.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ] } }, "required": [ "accountId", "role" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.member.role.change" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "displayName": { "type": "string", "minLength": 1, "maxLength": 80 }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ] }, "joinedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "accountId", "email", "role", "joinedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.role_changed", "examples": [ { "input": { "accountId": "acct_demo00000000000000000000", "role": "admin" }, "output": { "accountId": "acct_demo00000000000000000000", "email": "member@example.com", "role": "admin", "joinedAt": "2026-01-01T00:00:00.000Z" }, "note": "Promote to admin." } ] }, { "name": "org_invitations_list", "description": "List pending/expired invitations.", "function_declarations": [ { "name": "org_invitations_list", "description": "List pending/expired invitations.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "accepted", "expired", "revoked" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.invitations.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invitations": { "type": "array", "items": { "type": "object", "properties": { "invitationId": { "type": "string" }, "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ] }, "invitedBy": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "invitedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "status": { "type": "string", "enum": [ "pending", "accepted", "expired", "revoked" ] } }, "required": [ "invitationId", "email", "role", "invitedBy", "invitedAt", "expiresAt", "status" ], "additionalProperties": false } } }, "required": [ "invitations" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "status": "pending" }, "output": { "invitations": [] }, "note": "List pending invites." } ] }, { "name": "org_invitations_resend", "description": "Resend a pending invitation (subject to 5-minute cooldown).", "function_declarations": [ { "name": "org_invitations_resend", "description": "Resend a pending invitation (subject to 5-minute cooldown).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invitationId": { "type": "string" } }, "required": [ "invitationId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.invitations.resend" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "resent": { "type": "boolean" }, "nextResendAvailableAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "resent", "nextResendAvailableAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.invited", "examples": [ { "input": { "invitationId": "inv_abc" }, "output": { "resent": true, "nextResendAvailableAt": "2026-05-22T12:05:00.000Z" }, "note": "Resend invite." } ] }, { "name": "org_invitations_revoke", "description": "Revoke a pending invitation.", "function_declarations": [ { "name": "org_invitations_revoke", "description": "Revoke a pending invitation.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invitationId": { "type": "string" } }, "required": [ "invitationId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.invitations.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.removed", "examples": [ { "input": { "invitationId": "inv_abc" }, "output": { "revoked": true }, "note": "Cancel pending invite." } ] }, { "name": "org_transfer-ownership", "description": "Transfer org ownership to another admin. Requires WebAuthn step-up + reason.", "function_declarations": [ { "name": "org_transfer-ownership", "description": "Transfer org ownership to another admin. Requires WebAuthn step-up + reason.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "newOwnerAccountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "newOwnerAccountId", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.transfer-ownership" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "plan": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "scheduledDeletionAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "id", "name", "plan", "createdAt", "scheduledDeletionAt" ], "additionalProperties": {} }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "newOwnerAccountId": "acct_demo00000000000000000000", "reason": "Stepping down from CEO role; handing over to incoming lead" }, "output": { "id": "org_demo00000000000000000000", "name": "Demo Org", "plan": "pro", "createdAt": "2026-01-01T00:00:00.000Z", "scheduledDeletionAt": null }, "note": "Hand off org ownership." } ] }, { "name": "org_delete_schedule", "description": "Schedule organization deletion in 30 days. Cancellable within the grace window.", "function_declarations": [ { "name": "org_delete_schedule", "description": "Schedule organization deletion in 30 days. Cancellable within the grace window.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "reason": { "type": "string", "minLength": 10, "maxLength": 500 }, "graceDays": { "default": 30, "type": "integer", "minimum": 1, "maximum": 90 } }, "required": [ "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.delete.schedule" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scheduledDeletionAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "scheduledDeletionAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "reason": "Winding down the company; please delete after 30 days of grace" }, "output": { "scheduledDeletionAt": "2026-06-21T00:00:00.000Z" }, "note": "Schedule org deletion." } ] }, { "name": "org_delete_cancel", "description": "Cancel a previously-scheduled org deletion (within grace).", "function_declarations": [ { "name": "org_delete_cancel", "description": "Cancel a previously-scheduled org deletion (within grace).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.delete.cancel" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "plan": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "scheduledDeletionAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "id", "name", "plan", "createdAt", "scheduledDeletionAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": {}, "output": { "id": "org_demo00000000000000000000", "name": "Demo Org", "plan": "pro", "createdAt": "2026-01-01T00:00:00.000Z", "scheduledDeletionAt": null }, "note": "Cancel scheduled deletion." } ] }, { "name": "org_audit_list", "description": "Read org-level audit log entries (admin actions, member changes, billing).", "function_declarations": [ { "name": "org_audit_list", "description": "Read org-level audit log entries (admin actions, member changes, billing).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.audit.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": {} }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 25 }, "output": { "entries": [], "nextCursor": null }, "note": "Read org audit log." } ] }, { "name": "org_sso_connections_list", "description": "List the organization's SSO connections (SAML/OIDC), with sealed secrets redacted to booleans.", "function_declarations": [ { "name": "org_sso_connections_list", "description": "List the organization's SSO connections (SAML/OIDC), with sealed secrets redacted to booleans.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.connections.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "connections": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "type": { "type": "string", "enum": [ "saml", "oidc" ] }, "displayName": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "disabled", "testing" ] }, "samlIdpEntityId": { "type": [ "string", "null" ] }, "samlIdpSsoUrl": { "type": [ "string", "null" ] }, "samlIdpCertificateCount": { "type": "number" }, "samlAllowIdpInitiated": { "type": "boolean" }, "oidcIssuer": { "type": [ "string", "null" ] }, "oidcClientId": { "type": [ "string", "null" ] }, "oidcClientSecretSet": { "type": "boolean" }, "jitEnabled": { "type": "boolean" }, "defaultRole": { "type": "string", "enum": [ "admin", "member" ] }, "groupRoleMappings": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "organizationId", "type", "displayName", "status", "samlIdpEntityId", "samlIdpSsoUrl", "samlIdpCertificateCount", "samlAllowIdpInitiated", "oidcIssuer", "oidcClientId", "oidcClientSecretSet", "jitEnabled", "defaultRole", "groupRoleMappings", "createdAt", "updatedAt" ], "additionalProperties": false } } }, "required": [ "connections" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "connections": [] }, "note": "List SSO connections." } ] }, { "name": "org_sso_connections_upsert", "description": "Create or update a SAML/OIDC SSO connection. A provided OIDC client secret is sealed; SAML certificates are validated.", "function_declarations": [ { "name": "org_sso_connections_upsert", "description": "Create or update a SAML/OIDC SSO connection. A provided OIDC client secret is sealed; SAML certificates are validated.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "saml", "oidc" ] }, "displayName": { "type": "string", "minLength": 1, "maxLength": 120 }, "status": { "type": "string", "enum": [ "active", "disabled", "testing" ] }, "jitEnabled": { "type": "boolean" }, "defaultRole": { "type": "string", "enum": [ "admin", "member" ] }, "groupRoleMappings": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "admin", "member" ] } }, "samlIdpEntityId": { "type": "string" }, "samlIdpSsoUrl": { "type": "string", "format": "uri" }, "samlIdpCertificates": { "type": "string" }, "samlAllowIdpInitiated": { "type": "boolean" }, "oidcIssuer": { "type": "string", "format": "uri" }, "oidcClientId": { "type": "string" }, "oidcClientSecret": { "type": "string" } }, "required": [ "type", "displayName" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.connections.upsert" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "connection": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "type": { "type": "string", "enum": [ "saml", "oidc" ] }, "displayName": { "type": "string" }, "status": { "type": "string", "enum": [ "active", "disabled", "testing" ] }, "samlIdpEntityId": { "type": [ "string", "null" ] }, "samlIdpSsoUrl": { "type": [ "string", "null" ] }, "samlIdpCertificateCount": { "type": "number" }, "samlAllowIdpInitiated": { "type": "boolean" }, "oidcIssuer": { "type": [ "string", "null" ] }, "oidcClientId": { "type": [ "string", "null" ] }, "oidcClientSecretSet": { "type": "boolean" }, "jitEnabled": { "type": "boolean" }, "defaultRole": { "type": "string", "enum": [ "admin", "member" ] }, "groupRoleMappings": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "organizationId", "type", "displayName", "status", "samlIdpEntityId", "samlIdpSsoUrl", "samlIdpCertificateCount", "samlAllowIdpInitiated", "oidcIssuer", "oidcClientId", "oidcClientSecretSet", "jitEnabled", "defaultRole", "groupRoleMappings", "createdAt", "updatedAt" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "connection" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "type": "oidc", "displayName": "Okta", "oidcIssuer": "https://acme.okta.com", "oidcClientId": "0oa1" }, "output": { "connection": null }, "note": "Create an OIDC connection." } ] }, { "name": "org_sso_connections_delete", "description": "Delete an SSO connection by id (org-scoped).", "function_declarations": [ { "name": "org_sso_connections_delete", "description": "Delete an SSO connection by id (org-scoped).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.connections.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "id": "ssoc_abc" }, "output": { "deleted": true }, "note": "Delete a connection." } ] }, { "name": "org_sso_domains_list", "description": "List the organization's captured SSO domains (verified state + the DNS TXT record to publish).", "function_declarations": [ { "name": "org_sso_domains_list", "description": "List the organization's captured SSO domains (verified state + the DNS TXT record to publish).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.domains.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "domains": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "connectionId": { "type": [ "string", "null" ] }, "domain": { "type": "string" }, "verified": { "type": "boolean" }, "verifiedAt": { "type": [ "string", "null" ] }, "enforceSso": { "type": "boolean" }, "dnsRecord": { "type": "object", "properties": { "host": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "host", "type", "value" ], "additionalProperties": false }, "createdAt": { "type": "string" } }, "required": [ "id", "organizationId", "connectionId", "domain", "verified", "verifiedAt", "enforceSso", "dnsRecord", "createdAt" ], "additionalProperties": false } } }, "required": [ "domains" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "domains": [] }, "note": "List SSO domains." } ] }, { "name": "org_sso_domains_create", "description": "Claim an email domain for SSO and mint its DNS TXT verification challenge.", "function_declarations": [ { "name": "org_sso_domains_create", "description": "Claim an email domain for SSO and mint its DNS TXT verification challenge.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "domain": { "type": "string", "minLength": 3, "maxLength": 253 }, "connectionId": { "type": "string" } }, "required": [ "domain" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.domains.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "domain": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "connectionId": { "type": [ "string", "null" ] }, "domain": { "type": "string" }, "verified": { "type": "boolean" }, "verifiedAt": { "type": [ "string", "null" ] }, "enforceSso": { "type": "boolean" }, "dnsRecord": { "type": "object", "properties": { "host": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "host", "type", "value" ], "additionalProperties": false }, "createdAt": { "type": "string" } }, "required": [ "id", "organizationId", "connectionId", "domain", "verified", "verifiedAt", "enforceSso", "dnsRecord", "createdAt" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "domain" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "domain": "acme.com" }, "output": { "domain": null }, "note": "Claim acme.com." } ] }, { "name": "org_sso_domains_verify", "description": "Verify a claimed domain via a DNS-over-HTTPS TXT lookup (proof of control).", "function_declarations": [ { "name": "org_sso_domains_verify", "description": "Verify a claimed domain via a DNS-over-HTTPS TXT lookup (proof of control).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.domains.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "verified": { "type": "boolean" }, "domain": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "connectionId": { "type": [ "string", "null" ] }, "domain": { "type": "string" }, "verified": { "type": "boolean" }, "verifiedAt": { "type": [ "string", "null" ] }, "enforceSso": { "type": "boolean" }, "dnsRecord": { "type": "object", "properties": { "host": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "host", "type", "value" ], "additionalProperties": false }, "createdAt": { "type": "string" } }, "required": [ "id", "organizationId", "connectionId", "domain", "verified", "verifiedAt", "enforceSso", "dnsRecord", "createdAt" ], "additionalProperties": false }, { "type": "null" } ] }, "alreadyVerified": { "type": "boolean" } }, "required": [ "verified" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "id": "ssod_abc" }, "output": { "verified": true }, "note": "Verify domain control." } ] }, { "name": "org_sso_domains_enforcement", "description": "Toggle SSO enforcement for a verified domain (requires a verified domain + an active connection).", "function_declarations": [ { "name": "org_sso_domains_enforcement", "description": "Toggle SSO enforcement for a verified domain (requires a verified domain + an active connection).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "enforceSso": { "type": "boolean" } }, "required": [ "id", "enforceSso" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.domains.enforcement" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "domain": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "organizationId": { "type": "string" }, "connectionId": { "type": [ "string", "null" ] }, "domain": { "type": "string" }, "verified": { "type": "boolean" }, "verifiedAt": { "type": [ "string", "null" ] }, "enforceSso": { "type": "boolean" }, "dnsRecord": { "type": "object", "properties": { "host": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "host", "type", "value" ], "additionalProperties": false }, "createdAt": { "type": "string" } }, "required": [ "id", "organizationId", "connectionId", "domain", "verified", "verifiedAt", "enforceSso", "dnsRecord", "createdAt" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "domain" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "id": "ssod_abc", "enforceSso": true }, "output": { "domain": null }, "note": "Require SSO for the domain." } ] }, { "name": "org_sso_domains_delete", "description": "Remove a captured SSO domain (org-scoped).", "function_declarations": [ { "name": "org_sso_domains_delete", "description": "Remove a captured SSO domain (org-scoped).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.domains.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "id": "ssod_abc" }, "output": { "deleted": true }, "note": "Delete a domain." } ] }, { "name": "org_sso_scim-tokens_list", "description": "List a connection's SCIM bearer tokens (hash-only; the raw token is never returned).", "function_declarations": [ { "name": "org_sso_scim-tokens_list", "description": "List a connection's SCIM bearer tokens (hash-only; the raw token is never returned).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.scim-tokens.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tokens": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "connectionId": { "type": "string" }, "createdAt": { "type": "string" }, "lastUsedAt": { "type": [ "string", "null" ] }, "revoked": { "type": "boolean" }, "revokedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "connectionId", "createdAt", "lastUsedAt", "revoked", "revokedAt" ], "additionalProperties": false } } }, "required": [ "tokens" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "tokens": [] }, "note": "List SCIM tokens." } ] }, { "name": "org_sso_scim-tokens_mint", "description": "Mint a SCIM 2.0 bearer token for a connection. The RAW token is returned exactly once; only its hash is stored.", "function_declarations": [ { "name": "org_sso_scim-tokens_mint", "description": "Mint a SCIM 2.0 bearer token for a connection. The RAW token is returned exactly once; only its hash is stored.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "connectionId": { "type": "string" } }, "required": [ "connectionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.scim-tokens.mint" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "connectionId": { "type": "string" }, "token": { "type": "string" }, "scimBaseUrl": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "connectionId", "token", "scimBaseUrl", "createdAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "connectionId": "ssoc_abc" }, "output": { "id": "scimt_1", "connectionId": "ssoc_abc", "token": "scim_…", "scimBaseUrl": "https://auth.agined.com/scim/v2", "createdAt": "2026-07-21T00:00:00.000Z" }, "note": "Mint a SCIM token (shown once)." } ] }, { "name": "org_sso_scim-tokens_revoke", "description": "Revoke a SCIM bearer token by id.", "function_declarations": [ { "name": "org_sso_scim-tokens_revoke", "description": "Revoke a SCIM bearer token by id.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/org.sso.scim-tokens.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "org.sso_config_changed", "examples": [ { "input": { "id": "scimt_1" }, "output": { "revoked": true }, "note": "Revoke a SCIM token." } ] }, { "name": "workspace_list", "description": "List all workspaces in the current organization.", "function_declarations": [ { "name": "workspace_list", "description": "List all workspaces in the current organization.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "includeDeleted": { "default": false, "type": "boolean" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaces": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "workspaces", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 10 }, "output": { "workspaces": [], "nextCursor": null }, "note": "List up to 10 workspaces in the active organization." } ] }, { "name": "workspace_get", "description": "Get the full state of a single workspace by id.", "function_declarations": [ { "name": "workspace_get", "description": "Get the full state of a single workspace by id.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "id": "ws_demo_default", "name": "Default workspace", "organizationId": "org_demo00000000000000000000", "jurisdiction": "ENAM" }, "note": "Read the active workspace's full state." } ] }, { "name": "workspace_create", "description": "Create a new workspace in the current organization.", "function_declarations": [ { "name": "workspace_create", "description": "Create a new workspace in the current organization.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "regionId": { "type": "string", "pattern": "^(cloudflare-d1|aws-aurora):[a-z0-9-]+$" }, "euJurisdictionBound": { "default": false, "type": "boolean" }, "retentionDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] } }, "required": [ "name", "regionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "workspace.created", "examples": [ { "input": { "name": "EU production", "regionId": "cloudflare-d1:weur", "euJurisdictionBound": true }, "output": { "id": "ws_new0000000000", "name": "EU production", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Create an EU-bound workspace in Western Europe." } ] }, { "name": "workspace_update", "description": "Update workspace settings (name, retention, locale, Tools controls).", "function_declarations": [ { "name": "workspace_update", "description": "Update workspace settings (name, retention, locale, Tools controls).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "retentionDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "locale": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] }, "toolsAutoOverageEnabled": { "type": "boolean" }, "toolsAutoOverageCapMultiplier": { "type": "integer", "minimum": 1, "maximum": 10 }, "toolsBillingMode": { "type": "string", "enum": [ "combined", "separate" ] }, "attestorAutoOverageEnabled": { "type": "boolean" }, "attestorAutoOverageCapMultiplier": { "type": "integer", "minimum": 1, "maximum": 10 }, "attestorBillingMode": { "type": "string", "enum": [ "combined", "separate" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "workspace.renamed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "toolsAutoOverageEnabled": true, "toolsAutoOverageCapMultiplier": 3 }, "output": { "id": "ws_demo_default", "name": "Default", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Enable Tools auto-overage with a 3× cap." } ] }, { "name": "workspace_rename", "description": "Rename a workspace (convenience alias of workspace.update).", "function_declarations": [ { "name": "workspace_rename", "description": "Rename a workspace (convenience alias of workspace.update).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 } }, "required": [ "workspaceId", "name" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.rename" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "workspace.renamed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "name": "EU production v2" }, "output": { "id": "ws_demo_default", "name": "EU production v2", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Rename a workspace." } ] }, { "name": "workspace_delete_schedule", "description": "Schedule a workspace for deletion in 30 days (grace period).", "function_declarations": [ { "name": "workspace_delete_schedule", "description": "Schedule a workspace for deletion in 30 days (grace period).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "graceDays": { "default": 30, "type": "integer", "minimum": 1, "maximum": 90 }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.delete.schedule" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "scheduledDeletionAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId", "scheduledDeletionAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "workspace.scheduled_deletion", "examples": [ { "input": { "workspaceId": "ws_demo_default", "reason": "Migrated to new workspace; cleanup in progress" }, "output": { "workspaceId": "ws_demo_default", "scheduledDeletionAt": "2026-06-21T00:00:00.000Z" }, "note": "Schedule deletion with a 30-day grace." } ] }, { "name": "workspace_delete_cancel", "description": "Cancel a previously-scheduled workspace deletion (within grace).", "function_declarations": [ { "name": "workspace_delete_cancel", "description": "Cancel a previously-scheduled workspace deletion (within grace).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.delete.cancel" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "workspace.deletion_canceled", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "id": "ws_demo_default", "name": "Default", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Cancel deletion within the grace window." } ] }, { "name": "workspace_region_binding-proof", "description": "Download the OpenTimestamps proof of the workspace's region binding.", "function_declarations": [ { "name": "workspace_region_binding-proof", "description": "Download the OpenTimestamps proof of the workspace's region binding.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.region.binding-proof" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "otsProof": { "type": "string", "minLength": 20 }, "anchoredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "blockHeight": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "otsProof", "anchoredAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "otsProof": "base64-encoded-ots-proof-string-here-at-least-20-chars", "anchoredAt": "2026-05-22T12:00:00.000Z", "blockHeight": 854321 }, "note": "Pull the region-binding OTS proof for offline verification." } ] }, { "name": "workspace_member_list", "description": "List members of a workspace with their roles.", "function_declarations": [ { "name": "workspace_member_list", "description": "List members of a workspace with their roles.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.member.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "members": { "type": "array", "items": { "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member", "auditor" ] } }, "required": [ "accountId", "role" ], "additionalProperties": {} } } }, "required": [ "members" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "members": [ { "accountId": "acct_001demo000000000000000000", "role": "owner" } ] }, "note": "List workspace members." } ] }, { "name": "workspace_member_add", "description": "Add an organization member to a workspace with a specific role.", "function_declarations": [ { "name": "workspace_member_add", "description": "Add an organization member to a workspace with a specific role.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "role": { "type": "string", "enum": [ "admin", "member", "auditor" ] } }, "required": [ "workspaceId", "accountId", "role" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.member.add" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member", "auditor" ] } }, "required": [ "accountId", "role" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.joined", "examples": [ { "input": { "workspaceId": "ws_demo_default", "accountId": "acct_002demo000000000000000000", "role": "member" }, "output": { "accountId": "acct_002demo000000000000000000", "role": "member" }, "note": "Add a member." } ] }, { "name": "workspace_member_role_change", "description": "Change a workspace member's role.", "function_declarations": [ { "name": "workspace_member_role_change", "description": "Change a workspace member's role.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member", "auditor" ] } }, "required": [ "workspaceId", "accountId", "role" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.member.role.change" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "role": { "type": "string", "enum": [ "owner", "admin", "member", "auditor" ] } }, "required": [ "accountId", "role" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.role_changed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "accountId": "acct_002demo000000000000000000", "role": "admin" }, "output": { "accountId": "acct_002demo000000000000000000", "role": "admin" }, "note": "Promote a member to admin." } ] }, { "name": "workspace_member_remove", "description": "Remove a member from a workspace.", "function_declarations": [ { "name": "workspace_member_remove", "description": "Remove a member from a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "accountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId", "accountId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.member.remove" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "removed": { "type": "boolean" } }, "required": [ "removed" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "member.removed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "accountId": "acct_002demo000000000000000000" }, "output": { "removed": true }, "note": "Remove a workspace member." } ] }, { "name": "workspace_transfer-ownership", "description": "Transfer workspace ownership to another admin.", "function_declarations": [ { "name": "workspace_transfer-ownership", "description": "Transfer workspace ownership to another admin.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "newOwnerAccountId": { "type": "string", "pattern": "^acct_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "newOwnerAccountId", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.transfer-ownership" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "newOwnerAccountId": "acct_002demo000000000000000000", "reason": "Handing over to new compliance lead per Q3 reorg" }, "output": { "id": "ws_demo_default", "name": "Default", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Transfer ownership — destructive, requires confirmation." } ] }, { "name": "workspace_attestor_enable", "description": "Enable Attestor on a workspace (requires an org-level Attestor subscription).", "function_declarations": [ { "name": "workspace_attestor_enable", "description": "Enable Attestor on a workspace (requires an org-level Attestor subscription).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.attestor.enable" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "workspace.renamed", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "id": "ws_demo_default", "name": "Default", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Enable Attestor on a workspace." } ] }, { "name": "workspace_attestor_disable", "description": "Disable Attestor on a workspace.", "function_declarations": [ { "name": "workspace_attestor_disable", "description": "Disable Attestor on a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.attestor.disable" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "organizationId": { "type": "string" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] } }, "required": [ "id", "name", "organizationId", "jurisdiction" ], "additionalProperties": {} }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "workspace.renamed", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "id": "ws_demo_default", "name": "Default", "organizationId": "org_demo", "jurisdiction": "WEUR" }, "note": "Turn off Attestor on this workspace." } ] }, { "name": "workspace_regions_list", "description": "List the available regions a workspace can be created in.", "function_declarations": [ { "name": "workspace_regions_list", "description": "List the available regions a workspace can be created in.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/workspace.regions.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "regions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(cloudflare-d1|aws-aurora):[a-z0-9-]+$" }, "label": { "type": "string" }, "countryCode": { "type": "string", "pattern": "^[A-Z]{2}$" }, "euJurisdictionBound": { "type": "boolean" } }, "required": [ "id", "label", "countryCode", "euJurisdictionBound" ], "additionalProperties": {} } } }, "required": [ "regions" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "regions": [ { "id": "cloudflare-d1:weur", "label": "Western Europe", "countryCode": "DE", "euJurisdictionBound": true } ] }, "note": "List all 21 supported regions for region picker UIs." } ] }, { "name": "billing_subscription_get", "description": "Get the org's current subscription.", "function_declarations": [ { "name": "billing_subscription_get", "description": "Get the org's current subscription.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.subscription.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "plan": { "type": "string" }, "status": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "currentPeriodStart": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "cancelAtPeriodEnd": { "type": "boolean" } }, "required": [ "organizationId", "plan", "status", "currentPeriodStart", "currentPeriodEnd", "cancelAtPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "subscriptionId": "sub_abc", "organizationId": "org_demo00000000000000000000", "plan": "pro", "status": "active", "currentPeriodStart": "2026-05-01T00:00:00.000Z", "currentPeriodEnd": "2026-06-01T00:00:00.000Z", "cancelAtPeriodEnd": false }, "note": "Read subscription." } ] }, { "name": "billing_subscription_upgrade", "description": "Upgrade to a higher tier. Prorates charges; takes effect immediately.", "function_declarations": [ { "name": "billing_subscription_upgrade", "description": "Upgrade to a higher tier. Prorates charges; takes effect immediately.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "targetPlan": { "type": "string" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "targetPlan" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.subscription.upgrade" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "plan": { "type": "string" }, "status": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "currentPeriodStart": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "cancelAtPeriodEnd": { "type": "boolean" } }, "required": [ "organizationId", "plan", "status", "currentPeriodStart", "currentPeriodEnd", "cancelAtPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "plan.changed", "examples": [ { "input": { "targetPlan": "team" }, "output": { "subscriptionId": "sub_abc", "organizationId": "org_demo00000000000000000000", "plan": "team", "status": "active", "currentPeriodStart": "2026-05-22T12:00:00.000Z", "currentPeriodEnd": "2026-06-22T12:00:00.000Z", "cancelAtPeriodEnd": false }, "note": "Upgrade to Team." } ] }, { "name": "billing_subscription_downgrade", "description": "Downgrade to a lower tier. Effective at next billing period.", "function_declarations": [ { "name": "billing_subscription_downgrade", "description": "Downgrade to a lower tier. Effective at next billing period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "targetPlan": { "type": "string" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "targetPlan", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.subscription.downgrade" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "plan": { "type": "string" }, "status": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "currentPeriodStart": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "cancelAtPeriodEnd": { "type": "boolean" } }, "required": [ "organizationId", "plan", "status", "currentPeriodStart", "currentPeriodEnd", "cancelAtPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "plan.changed", "examples": [ { "input": { "targetPlan": "starter", "reason": "Reducing usage; no longer need Pro" }, "output": { "subscriptionId": "sub_abc", "organizationId": "org_demo00000000000000000000", "plan": "pro", "status": "active", "currentPeriodStart": "2026-05-01T00:00:00.000Z", "currentPeriodEnd": "2026-06-01T00:00:00.000Z", "cancelAtPeriodEnd": false }, "note": "Downgrade scheduled for period end." } ] }, { "name": "billing_subscription_cancel", "description": "Cancel subscription at current period end. Workspace remains accessible until then.", "function_declarations": [ { "name": "billing_subscription_cancel", "description": "Cancel subscription at current period end. Workspace remains accessible until then.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "reason": { "type": "string", "minLength": 10, "maxLength": 500 }, "cancelImmediately": { "default": false, "type": "boolean" } }, "required": [ "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.subscription.cancel" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "plan": { "type": "string" }, "status": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "currentPeriodStart": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "cancelAtPeriodEnd": { "type": "boolean" } }, "required": [ "organizationId", "plan", "status", "currentPeriodStart", "currentPeriodEnd", "cancelAtPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "plan.changed", "examples": [ { "input": { "reason": "Migrating to alternative provider; export complete" }, "output": { "subscriptionId": "sub_abc", "organizationId": "org_demo00000000000000000000", "plan": "pro", "status": "active", "currentPeriodStart": "2026-05-01T00:00:00.000Z", "currentPeriodEnd": "2026-06-01T00:00:00.000Z", "cancelAtPeriodEnd": true }, "note": "Cancel at period end." } ] }, { "name": "billing_subscription_reactivate", "description": "Reactivate a subscription that's been scheduled to cancel.", "function_declarations": [ { "name": "billing_subscription_reactivate", "description": "Reactivate a subscription that's been scheduled to cancel.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.subscription.reactivate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "plan": { "type": "string" }, "status": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "currentPeriodStart": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "cancelAtPeriodEnd": { "type": "boolean" } }, "required": [ "organizationId", "plan", "status", "currentPeriodStart", "currentPeriodEnd", "cancelAtPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "plan.changed", "examples": [ { "input": {}, "output": { "subscriptionId": "sub_abc", "organizationId": "org_demo00000000000000000000", "plan": "pro", "status": "active", "currentPeriodStart": "2026-05-01T00:00:00.000Z", "currentPeriodEnd": "2026-06-01T00:00:00.000Z", "cancelAtPeriodEnd": false }, "note": "Reactivate." } ] }, { "name": "billing_invoices_list", "description": "List invoices.", "function_declarations": [ { "name": "billing_invoices_list", "description": "List invoices.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "status": { "type": "string", "enum": [ "draft", "open", "paid", "void", "uncollectible" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.invoices.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invoices": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^in_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "amount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "status": { "type": "string", "enum": [ "draft", "open", "paid", "void", "uncollectible" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "dueAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "paidAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "hostedInvoiceUrl": { "type": "string", "format": "uri" } }, "required": [ "id", "organizationId", "amount", "currency", "status", "issuedAt", "dueAt", "paidAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "invoices", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "invoices": [], "nextCursor": null }, "note": "List invoices." } ] }, { "name": "billing_invoices_get", "description": "Get a single invoice.", "function_declarations": [ { "name": "billing_invoices_get", "description": "Get a single invoice.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invoiceId": { "type": "string", "pattern": "^in_[A-Za-z0-9]+$" } }, "required": [ "invoiceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.invoices.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^in_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "amount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "status": { "type": "string", "enum": [ "draft", "open", "paid", "void", "uncollectible" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "dueAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "paidAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "hostedInvoiceUrl": { "type": "string", "format": "uri" } }, "required": [ "id", "organizationId", "amount", "currency", "status", "issuedAt", "dueAt", "paidAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "invoiceId": "in_abc" }, "output": { "id": "in_abc", "organizationId": "org_demo00000000000000000000", "amount": 4900, "currency": "USD", "status": "paid", "issuedAt": "2026-05-01T00:00:00.000Z", "dueAt": null, "paidAt": "2026-05-01T00:00:00.000Z" }, "note": "Read invoice." } ] }, { "name": "billing_invoices_download", "description": "Get a signed download URL for the invoice PDF.", "function_declarations": [ { "name": "billing_invoices_download", "description": "Get a signed download URL for the invoice PDF.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "invoiceId": { "type": "string", "pattern": "^in_[A-Za-z0-9]+$" } }, "required": [ "invoiceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.invoices.download" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "url" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "invoiceId": "in_abc" }, "output": { "url": "https://billing.example.com/invoices/abc.pdf", "expiresAt": "2026-05-22T13:00:00.000Z" }, "note": "Download invoice PDF." } ] }, { "name": "billing_payment-method_get", "description": "Get the current default payment method (masked).", "function_declarations": [ { "name": "billing_payment-method_get", "description": "Get the current default payment method (masked).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.payment-method.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "brand": { "type": "string" }, "last4": { "type": "string" }, "expMonth": { "type": "integer", "minimum": 1, "maximum": 12 }, "expYear": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "brand", "last4", "expMonth", "expYear" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "brand": "Visa", "last4": "4242", "expMonth": 12, "expYear": 2027 }, "note": "Read masked payment method." } ] }, { "name": "billing_payment-method_update-url", "description": "Get a signed URL to the hosted payment-method update page. The update happens there, not in Agined.", "function_declarations": [ { "name": "billing_payment-method_update-url", "description": "Get a signed URL to the hosted payment-method update page. The update happens there, not in Agined.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "returnUrl": { "type": "string", "format": "uri" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.payment-method.update-url" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "url" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "url": "https://billing.example.com/p/session/abc", "expiresAt": "2026-05-22T13:00:00.000Z" }, "note": "Get the billing portal URL." } ] }, { "name": "billing_packs_list", "description": "List available top-up packs (runs, Number One queries, Tools calls).", "function_declarations": [ { "name": "billing_packs_list", "description": "List available top-up packs (runs, Number One queries, Tools calls).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kind": { "type": "string", "enum": [ "runs", "number-one", "tools-calls", "attestor-calls" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.packs.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "packs": { "type": "array", "items": { "type": "object", "properties": { "packId": { "type": "string" }, "kind": { "type": "string", "enum": [ "runs", "number-one", "tools-calls", "attestor-calls" ] }, "unitCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "priceUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "packId", "kind", "unitCount", "priceUsdMinor" ], "additionalProperties": {} } } }, "required": [ "packs" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "packs": [ { "packId": "runs_1k", "kind": "runs", "unitCount": 1000, "priceUsdMinor": 2900 } ] }, "note": "Discover packs." } ] }, { "name": "billing_packs_purchase", "description": "Purchase a top-up pack.", "function_declarations": [ { "name": "billing_packs_purchase", "description": "Purchase a top-up pack.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "packId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "packId", "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.packs.purchase" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "checkoutUrl": { "type": "string", "format": "uri" }, "sessionId": { "type": "string" } }, "required": [ "checkoutUrl", "sessionId" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "pack.purchased", "examples": [ { "input": { "packId": "runs_1k", "workspaceId": "ws_demo_default" }, "output": { "checkoutUrl": "https://billing.example.com/c/pay/cs_test_REDACTED", "sessionId": "cs_test_REDACTED" }, "note": "Buy a 1k-run pack — complete payment at checkoutUrl; the credit lands via webhook." } ] }, { "name": "billing_auto-topup_get", "description": "Get auto-topup configuration.", "function_declarations": [ { "name": "billing_auto-topup_get", "description": "Get auto-topup configuration.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.auto-topup.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" }, "packId": { "type": [ "string", "null" ] }, "triggerAtPercent": { "anyOf": [ { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 80 }, { "type": "number", "const": 95 } ] }, { "type": "null" } ] }, "monthlyCapUsdMinor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "enabled", "packId", "triggerAtPercent", "monthlyCapUsdMinor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "enabled": false, "packId": null, "triggerAtPercent": null, "monthlyCapUsdMinor": null }, "note": "Read auto-topup config." } ] }, { "name": "billing_auto-topup_configure", "description": "Configure auto-topup. Fires when balance drops below threshold; capped at monthly USD limit.", "function_declarations": [ { "name": "billing_auto-topup_configure", "description": "Configure auto-topup. Fires when balance drops below threshold; capped at monthly USD limit.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "enabled": { "type": "boolean" }, "packId": { "type": "string" }, "triggerAtPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 80 }, { "type": "number", "const": 95 } ] }, "monthlyCapUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "workspaceId", "enabled" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.auto-topup.configure" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" }, "packId": { "type": [ "string", "null" ] }, "triggerAtPercent": { "anyOf": [ { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 80 }, { "type": "number", "const": 95 } ] }, { "type": "null" } ] }, "monthlyCapUsdMinor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "enabled", "packId", "triggerAtPercent", "monthlyCapUsdMinor" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "auto_topup.configured", "examples": [ { "input": { "workspaceId": "ws_demo_default", "enabled": true, "packId": "runs_1k", "triggerAtPercent": 80, "monthlyCapUsdMinor": 10000 }, "output": { "enabled": true, "packId": "runs_1k", "triggerAtPercent": 80, "monthlyCapUsdMinor": 10000 }, "note": "Enable auto-topup." } ] }, { "name": "billing_cost-centers_list", "description": "List org cost centers (for tagging charges + per-cost-center invoicing).", "function_declarations": [ { "name": "billing_cost-centers_list", "description": "List org cost centers (for tagging charges + per-cost-center invoicing).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.cost-centers.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "costCenters": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^cc_[0-9A-Z]{20,}$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string" }, "taggableProducts": { "type": "array", "items": { "type": "string", "enum": [ "tools", "agined", "attestor", "both" ] } }, "monthlyCapUsdMinor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "notificationThresholdPercents": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 100 } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "organizationId", "name", "taggableProducts", "monthlyCapUsdMinor", "notificationThresholdPercents", "createdAt" ], "additionalProperties": {} } } }, "required": [ "costCenters" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "costCenters": [] }, "note": "List cost centers." } ] }, { "name": "billing_cost-centers_create", "description": "Create a cost center.", "function_declarations": [ { "name": "billing_cost-centers_create", "description": "Create a cost center.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "maxLength": 500 }, "taggableProducts": { "default": [ "tools" ], "type": "array", "items": { "type": "string", "enum": [ "tools" ] } }, "monthlyCapUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "notificationThresholdPercents": { "default": [ 50, 80, 100 ], "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 100 } } }, "required": [ "name" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.cost-centers.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^cc_[0-9A-Z]{20,}$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string" }, "taggableProducts": { "type": "array", "items": { "type": "string", "enum": [ "tools", "agined", "attestor", "both" ] } }, "monthlyCapUsdMinor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "notificationThresholdPercents": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 100 } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "organizationId", "name", "taggableProducts", "monthlyCapUsdMinor", "notificationThresholdPercents", "createdAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "name": "Engineering", "description": "All engineering teams" }, "output": { "id": "cc_DEMO00000000000000000000", "organizationId": "org_demo00000000000000000000", "name": "Engineering", "taggableProducts": [ "tools" ], "monthlyCapUsdMinor": null, "notificationThresholdPercents": [ 50, 80, 100 ], "createdAt": "2026-05-22T12:00:00.000Z" }, "note": "Create cost center." } ] }, { "name": "billing_cost-centers_update", "description": "Update a cost center.", "function_declarations": [ { "name": "billing_cost-centers_update", "description": "Update a cost center.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "costCenterId": { "type": "string", "pattern": "^cc_[0-9A-Z]{20,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "maxLength": 500 }, "monthlyCapUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "notificationThresholdPercents": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 100 } } }, "required": [ "costCenterId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.cost-centers.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^cc_[0-9A-Z]{20,}$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string" }, "taggableProducts": { "type": "array", "items": { "type": "string", "enum": [ "tools", "agined", "attestor", "both" ] } }, "monthlyCapUsdMinor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "notificationThresholdPercents": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 100 } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "organizationId", "name", "taggableProducts", "monthlyCapUsdMinor", "notificationThresholdPercents", "createdAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "costCenterId": "cc_DEMO00000000000000000000", "monthlyCapUsdMinor": 50000 }, "output": { "id": "cc_DEMO00000000000000000000", "organizationId": "org_demo00000000000000000000", "name": "Engineering", "taggableProducts": [ "tools" ], "monthlyCapUsdMinor": 50000, "notificationThresholdPercents": [ 50, 80, 100 ], "createdAt": "2026-05-22T12:00:00.000Z" }, "note": "Set monthly cap." } ] }, { "name": "billing_cost-centers_delete", "description": "Delete a cost center. Tagged charges keep historical tag.", "function_declarations": [ { "name": "billing_cost-centers_delete", "description": "Delete a cost center. Tagged charges keep historical tag.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "costCenterId": { "type": "string", "pattern": "^cc_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "costCenterId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.cost-centers.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "costCenterId": "cc_DEMO00000000000000000000" }, "output": { "deleted": true }, "note": "Delete." } ] }, { "name": "billing_notarian_subscribe", "description": "Subscribe to the Notarian add-on (per-tier subscription pricing).", "function_declarations": [ { "name": "billing_notarian_subscribe", "description": "Subscribe to the Notarian add-on (per-tier subscription pricing).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.notarian.subscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscribed": { "type": "boolean" } }, "required": [ "subscribed" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "notarian.subscribed", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "subscribed": true }, "note": "Subscribe to Notarian." } ] }, { "name": "billing_notarian_unsubscribe", "description": "Unsubscribe from Notarian at next billing period.", "function_declarations": [ { "name": "billing_notarian_unsubscribe", "description": "Unsubscribe from Notarian at next billing period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.notarian.unsubscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "unsubscribed": { "type": "boolean" }, "effectiveAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "unsubscribed", "effectiveAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "notarian.canceled", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "unsubscribed": true, "effectiveAt": "2026-06-22T00:00:00.000Z" }, "note": "Unsubscribe Notarian." } ] }, { "name": "billing_retention-extension_unsubscribe", "description": "Cancel the paid retention extension. Coverage continues until the paid-through date.", "function_declarations": [ { "name": "billing_retention-extension_unsubscribe", "description": "Cancel the paid retention extension. Coverage continues until the paid-through date.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.retention-extension.unsubscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "unsubscribed": { "type": "boolean" }, "effectiveAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "unsubscribed", "effectiveAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "retention.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "unsubscribed": true, "effectiveAt": "2026-09-22T00:00:00.000Z" }, "note": "Cancel the retention extension; coverage runs to the paid-through date." } ] }, { "name": "billing_multi-workspace_subscribe", "description": "Subscribe the organization to the multi-workspace add-on, allowing more than one workspace.", "function_declarations": [ { "name": "billing_multi-workspace_subscribe", "description": "Subscribe the organization to the multi-workspace add-on, allowing more than one workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.multi-workspace.subscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscribed": { "type": "boolean" } }, "required": [ "subscribed" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": null, "examples": [ { "input": {}, "output": { "subscribed": true }, "note": "Buy the multi-workspace add-on." } ] }, { "name": "billing_multi-workspace_unsubscribe", "description": "Cancel the multi-workspace add-on at the end of the current period.", "function_declarations": [ { "name": "billing_multi-workspace_unsubscribe", "description": "Cancel the multi-workspace add-on at the end of the current period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.multi-workspace.unsubscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "unsubscribed": { "type": "boolean" }, "effectiveAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "unsubscribed", "effectiveAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": null, "examples": [ { "input": {}, "output": { "unsubscribed": true, "effectiveAt": "2026-09-22T00:00:00.000Z" }, "note": "Cancel the multi-workspace add-on." } ] }, { "name": "billing_infinite-memory_subscribe", "description": "Subscribe to the Infinite Memory add-on for Number One ($19/mo on paid tiers).", "function_declarations": [ { "name": "billing_infinite-memory_subscribe", "description": "Subscribe to the Infinite Memory add-on for Number One ($19/mo on paid tiers).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.infinite-memory.subscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscribed": { "type": "boolean" } }, "required": [ "subscribed" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "subscribed": true }, "note": "Subscribe Infinite Memory." } ] }, { "name": "billing_infinite-memory_unsubscribe", "description": "Unsubscribe Infinite Memory at next billing period.", "function_declarations": [ { "name": "billing_infinite-memory_unsubscribe", "description": "Unsubscribe Infinite Memory at next billing period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.infinite-memory.unsubscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "unsubscribed": { "type": "boolean" }, "effectiveAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "unsubscribed", "effectiveAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "unsubscribed": true, "effectiveAt": "2026-06-22T00:00:00.000Z" }, "note": "Unsubscribe Infinite Memory." } ] }, { "name": "billing_retention-extension_subscribe", "description": "Subscribe to the universal paid retention extension. Convenience alias of retention.extension.subscribe.", "function_declarations": [ { "name": "billing_retention-extension_subscribe", "description": "Subscribe to the universal paid retention extension. Convenience alias of retention.extension.subscribe.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 } }, "required": [ "workspaceId", "extendedToDays" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.retention-extension.subscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscribed": { "type": "boolean" }, "perGbCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "subscribed", "perGbCostUsdMinor" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "retention.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "extendedToDays": 1095 }, "output": { "subscribed": true, "perGbCostUsdMinor": 1000 }, "note": "Subscribe to 3-year retention extension." } ] }, { "name": "billing_attestor_tier_set", "description": "Set the Attestor subscription tier for the org.", "function_declarations": [ { "name": "billing_attestor_tier_set", "description": "Set the Attestor subscription tier for the org.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tier": { "type": "string" } }, "required": [ "tier" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.attestor.tier.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9]+$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "plan": { "type": "string" }, "status": { "type": "string", "enum": [ "trialing", "active", "past_due", "canceled", "unpaid", "suspended" ] }, "currentPeriodStart": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "currentPeriodEnd": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "cancelAtPeriodEnd": { "type": "boolean" } }, "required": [ "organizationId", "plan", "status", "currentPeriodStart", "currentPeriodEnd", "cancelAtPeriodEnd" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "plan.changed", "examples": [ { "input": { "tier": "scale" }, "output": { "subscriptionId": "sub_atst_abc", "organizationId": "org_demo00000000000000000000", "plan": "scale", "status": "active", "currentPeriodStart": "2026-05-22T12:00:00.000Z", "currentPeriodEnd": "2026-06-22T12:00:00.000Z", "cancelAtPeriodEnd": false }, "note": "Set Attestor tier." } ] }, { "name": "billing_attestor_tier_get", "description": "Get the current Attestor tier.", "function_declarations": [ { "name": "billing_attestor_tier_get", "description": "Get the current Attestor tier.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.attestor.tier.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tier": { "type": "string" }, "monthlyCalls": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "retentionDays": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "tier", "monthlyCalls", "retentionDays" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "tier": "team", "monthlyCalls": 100000, "retentionDays": 365 }, "note": "Read Attestor tier." } ] }, { "name": "billing_attestor_top-up_purchase", "description": "Purchase an Attestor top-up pack (extra call quota for the current month).", "function_declarations": [ { "name": "billing_attestor_top-up_purchase", "description": "Purchase an Attestor top-up pack (extra call quota for the current month).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "packId": { "type": "string" } }, "required": [ "workspaceId", "packId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.attestor.top-up.purchase" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "topUpId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "packKind": { "type": "string" }, "unitCount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "priceUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "purchasedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "unitsRemaining": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "forfeitedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "topUpId", "workspaceId", "packKind", "unitCount", "priceUsdMinor", "purchasedAt", "unitsRemaining", "forfeitedAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "pack.purchased", "examples": [ { "input": { "workspaceId": "ws_demo_default", "packId": "attestor_100k" }, "output": { "topUpId": "tu_atst_abc", "workspaceId": "ws_demo_default", "packKind": "attestor-calls", "unitCount": 100000, "priceUsdMinor": 1900, "purchasedAt": "2026-05-22T12:00:00.000Z", "unitsRemaining": 100000, "forfeitedAt": null }, "note": "Buy 100k Attestor calls." } ] }, { "name": "billing_attestor_auto-overage_set", "description": "Configure auto-overage for an Attestor-enabled workspace.", "function_declarations": [ { "name": "billing_attestor_auto-overage_set", "description": "Configure auto-overage for an Attestor-enabled workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "enabled": { "type": "boolean" }, "capMultiplier": { "type": "integer", "minimum": 1, "maximum": 10 } }, "required": [ "workspaceId", "enabled" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.attestor.auto-overage.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" }, "capMultiplier": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "enabled", "capMultiplier" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "auto_topup.configured", "examples": [ { "input": { "workspaceId": "ws_demo_default", "enabled": true, "capMultiplier": 3 }, "output": { "enabled": true, "capMultiplier": 3 }, "note": "Enable auto-overage at 3× cap." } ] }, { "name": "billing_attestor_billing-mode_set", "description": "Set the Attestor billing mode (combined vs separate subscription).", "function_declarations": [ { "name": "billing_attestor_billing-mode_set", "description": "Set the Attestor billing mode (combined vs separate subscription).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mode": { "type": "string", "enum": [ "combined", "separate" ] } }, "required": [ "mode" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.attestor.billing-mode.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mode": { "type": "string", "enum": [ "combined", "separate" ] } }, "required": [ "mode" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "mode": "separate" }, "output": { "mode": "separate" }, "note": "Separate subscriptions for Agined + Attestor." } ] }, { "name": "billing_attestor_usage_current", "description": "Get current Attestor usage for the org (calls used + remaining quota + auto-overage status).", "function_declarations": [ { "name": "billing_attestor_usage_current", "description": "Get current Attestor usage for the org (calls used + remaining quota + auto-overage status).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.attestor.usage.current" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "callsUsed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "monthlyAllowance": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "remaining": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "autoOverageActive": { "type": "boolean" }, "periodEnd": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "callsUsed", "monthlyAllowance", "remaining", "autoOverageActive", "periodEnd" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "callsUsed": 45000, "monthlyAllowance": 100000, "remaining": 55000, "autoOverageActive": false, "periodEnd": "2026-06-01T00:00:00.000Z" }, "note": "Read current Attestor usage." } ] }, { "name": "billing_ledger-bundles_subscribe", "description": "Subscribe to the LedgerBundles add-on (per-tier subscription pricing).", "function_declarations": [ { "name": "billing_ledger-bundles_subscribe", "description": "Subscribe to the LedgerBundles add-on (per-tier subscription pricing).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.ledger-bundles.subscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscribed": { "type": "boolean" } }, "required": [ "subscribed" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "ledger-bundles.subscribed", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "subscribed": true }, "note": "Subscribe to LedgerBundles." } ] }, { "name": "billing_ledger-bundles_unsubscribe", "description": "Unsubscribe from LedgerBundles at next billing period.", "function_declarations": [ { "name": "billing_ledger-bundles_unsubscribe", "description": "Unsubscribe from LedgerBundles at next billing period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/billing.ledger-bundles.unsubscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "unsubscribed": { "type": "boolean" }, "effectiveAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "unsubscribed", "effectiveAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "ledger-bundles.canceled", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "unsubscribed": true, "effectiveAt": "2026-06-22T00:00:00.000Z" }, "note": "Unsubscribe LedgerBundles." } ] }, { "name": "keys_list", "description": "List workspace API keys (active + revoked filter).", "function_declarations": [ { "name": "keys_list", "description": "List workspace API keys (active + revoked filter).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "includeRevoked": { "default": false, "type": "boolean" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "product", "label", "prefix", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "keys", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "keys": [], "nextCursor": null }, "note": "List active keys." } ] }, { "name": "keys_get", "description": "Get a single workspace API key by id.", "function_declarations": [ { "name": "keys_get", "description": "Get a single workspace API key by id.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "keyId": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "keyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "product", "label", "prefix", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "keyId": "av_workspace_abc20charsforexampleid" }, "output": { "id": "av_workspace_abc20charsforexampleid", "workspaceId": "ws_demo_default", "product": "agined", "label": "Prod key", "prefix": "av_abc", "scopes": [ "ingest:write" ], "createdAt": "2026-05-22T12:00:00.000Z", "lastUsedAt": null, "expiresAt": null, "revokedAt": null }, "note": "Fetch one key." } ] }, { "name": "keys_issue", "description": "Issue a new workspace API key. Cleartext returned ONCE.", "function_declarations": [ { "name": "keys_issue", "description": "Issue a new workspace API key. Cleartext returned ONCE.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "default": "agined", "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "scopes": { "minItems": 1, "type": "array", "items": { "type": "string" } }, "expiry": { "default": "never", "type": "string", "enum": [ "never", "30d", "90d", "1y" ] } }, "required": [ "workspaceId", "label", "scopes" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.issue" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "key": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "product", "label", "prefix", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": {} }, "cleartext": { "type": "string" } }, "required": [ "key", "cleartext" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.issued", "examples": [ { "input": { "workspaceId": "ws_demo_default", "product": "agined", "label": "Prod ingest key", "scopes": [ "ingest:write" ], "expiry": "1y" }, "output": { "key": { "id": "av_workspace_abc20charsforexampleid", "workspaceId": "ws_demo_default", "product": "agined", "label": "Prod ingest key", "prefix": "av_abc", "scopes": [ "ingest:write" ], "createdAt": "2026-05-22T12:00:00.000Z", "lastUsedAt": null, "expiresAt": "2027-05-22T12:00:00.000Z", "revokedAt": null }, "cleartext": "av_abc_REDACTED_EXAMPLE_ONLY" }, "note": "Mint a new key; cleartext shown once." } ] }, { "name": "keys_revoke", "description": "Revoke a workspace API key. Propagates in ≤30s.", "function_declarations": [ { "name": "keys_revoke", "description": "Revoke a workspace API key. Propagates in ≤30s.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "keyId": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "keyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" }, "propagatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "revoked", "propagatedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.revoked", "examples": [ { "input": { "workspaceId": "ws_demo_default", "keyId": "av_workspace_abc20charsforexampleid" }, "output": { "revoked": true, "propagatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Revoke a key." } ] }, { "name": "keys_rotate", "description": "Rotate a key: revoke the current value + issue a replacement with the same label + scopes. Cleartext returned ONCE.", "function_declarations": [ { "name": "keys_rotate", "description": "Rotate a key: revoke the current value + issue a replacement with the same label + scopes. Cleartext returned ONCE.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "keyId": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "gracePeriodMinutes": { "default": 5, "type": "integer", "minimum": 0, "maximum": 60 } }, "required": [ "workspaceId", "keyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.rotate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revokedKeyId": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "newKey": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "product", "label", "prefix", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": {} }, "cleartext": { "type": "string" }, "graceUntil": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "revokedKeyId", "newKey", "cleartext", "graceUntil" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.rotated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "keyId": "av_workspace_abc20charsforexampleid" }, "output": { "revokedKeyId": "av_workspace_abc20charsforexampleid", "newKey": { "id": "av_workspace_def20charsforexampleid", "workspaceId": "ws_demo_default", "product": "agined", "label": "Prod ingest key", "prefix": "av_def", "scopes": [ "ingest:write" ], "createdAt": "2026-05-22T12:00:00.000Z", "lastUsedAt": null, "expiresAt": null, "revokedAt": null }, "cleartext": "av_def_REDACTED_EXAMPLE_ONLY", "graceUntil": "2026-05-22T12:05:00.000Z" }, "note": "Rotate a key with 5-min grace." } ] }, { "name": "keys_scopes_list", "description": "List the available scope grants for workspace API keys.", "function_declarations": [ { "name": "keys_scopes_list", "description": "List the available scope grants for workspace API keys.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "product": { "type": "string", "enum": [ "agined", "attestor" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.scopes.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scopes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string" }, "description": { "type": "string" }, "severity": { "type": "string", "enum": [ "read", "write", "delete" ] } }, "required": [ "id", "product", "label", "description", "severity" ], "additionalProperties": false } } }, "required": [ "scopes" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "scopes": [ { "id": "ingest:write", "product": "agined", "label": "Ingest write", "description": "Send runs / events into the workspace", "severity": "write" } ] }, "note": "Discover scopes." } ] }, { "name": "keys_usage_get", "description": "Get usage statistics (calls + last-used + IP CIDRs) for a key over a time window.", "function_declarations": [ { "name": "keys_usage_get", "description": "Get usage statistics (calls + last-used + IP CIDRs) for a key over a time window.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "keyId": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId", "keyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.usage.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "totalCalls": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "uniqueIpCidrs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "perEndpointBreakdown": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "path", "count" ], "additionalProperties": false } } }, "required": [ "totalCalls", "uniqueIpCidrs", "lastUsedAt", "perEndpointBreakdown" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "keyId": "av_workspace_abc20charsforexampleid" }, "output": { "totalCalls": 12345, "uniqueIpCidrs": 3, "lastUsedAt": "2026-05-22T12:00:00.000Z", "perEndpointBreakdown": [ { "path": "/api/v1/ingest", "count": 12000 } ] }, "note": "Read key usage." } ] }, { "name": "keys_last-used_get", "description": "Quick lookup: when was this key last used?", "function_declarations": [ { "name": "keys_last-used_get", "description": "Quick lookup: when was this key last used?", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "keyId": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "keyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.last-used.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "lastUsedAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "keyId": "av_workspace_abc20charsforexampleid" }, "output": { "lastUsedAt": "2026-05-22T12:00:00.000Z" }, "note": "Lightweight last-used check." } ] }, { "name": "keys_attestor_list", "description": "Convenience: list only the Attestor-product workspace keys.", "function_declarations": [ { "name": "keys_attestor_list", "description": "Convenience: list only the Attestor-product workspace keys.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "includeRevoked": { "default": false, "type": "boolean" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.attestor.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "product", "label", "prefix", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "keys", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "keys": [], "nextCursor": null }, "note": "List Attestor-only keys." } ] }, { "name": "keys_attestor_issue", "description": "Issue an Attestor-product workspace key (atst_*). Cleartext shown ONCE.", "function_declarations": [ { "name": "keys_attestor_issue", "description": "Issue an Attestor-product workspace key (atst_*). Cleartext shown ONCE.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "scopes": { "minItems": 1, "type": "array", "items": { "type": "string" } }, "expiry": { "default": "never", "type": "string", "enum": [ "never", "30d", "90d", "1y" ] } }, "required": [ "workspaceId", "label", "scopes" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.attestor.issue" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "key": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^(av|atst|entp)_[a-z0-9_]{4,}_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "product": { "type": "string", "enum": [ "agined", "attestor" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "product", "label", "prefix", "scopes", "createdAt", "lastUsedAt", "expiresAt", "revokedAt" ], "additionalProperties": {} }, "cleartext": { "type": "string" } }, "required": [ "key", "cleartext" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.issued", "examples": [ { "input": { "workspaceId": "ws_demo_default", "label": "Attestor attestation key", "scopes": [ "attestor:agent-call:write", "attestor:content-attest:write" ], "expiry": "90d" }, "output": { "key": { "id": "atst_workspace_abc20charsforexampleid", "workspaceId": "ws_demo_default", "product": "attestor", "label": "Attestor attestation key", "prefix": "atst_abc", "scopes": [ "attestor:agent-call:write", "attestor:content-attest:write" ], "createdAt": "2026-05-22T12:00:00.000Z", "lastUsedAt": null, "expiresAt": "2026-08-20T12:00:00.000Z", "revokedAt": null }, "cleartext": "atst_abc_REDACTED_EXAMPLE_ONLY" }, "note": "Mint an Attestor key." } ] }, { "name": "keys_ingest-secret_list", "description": "List this workspace's ingest secrets (metadata only — never the secret value).", "function_declarations": [ { "name": "keys_ingest-secret_list", "description": "List this workspace's ingest secrets (metadata only — never the secret value).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "includeRevoked": { "default": false, "type": "boolean" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.ingest-secret.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "secrets": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "platformId": { "type": "string", "pattern": "^(webhook|cloud-event|marketplace):[a-z0-9][a-z0-9-]{0,39}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "platformId", "createdAt", "revokedAt" ], "additionalProperties": false } } }, "required": [ "secrets" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "secrets": [ { "id": "wis_abc123", "workspaceId": "ws_demo_default", "platformId": "webhook:vapi", "createdAt": "2026-09-03T12:00:00.000Z", "revokedAt": null } ] }, "note": "See which platforms can deliver." } ] }, { "name": "keys_ingest-secret_issue", "description": "Issue an ingest secret for a platform. Any active secret for that platform is revoked. Cleartext returned ONCE.", "function_declarations": [ { "name": "keys_ingest-secret_issue", "description": "Issue an ingest secret for a platform. Any active secret for that platform is revoked. Cleartext returned ONCE.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "platformId": { "type": "string", "pattern": "^(webhook|cloud-event|marketplace):[a-z0-9][a-z0-9-]{0,39}$" } }, "required": [ "workspaceId", "platformId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.ingest-secret.issue" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "secret": { "type": "object", "properties": { "id": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "platformId": { "type": "string", "pattern": "^(webhook|cloud-event|marketplace):[a-z0-9][a-z0-9-]{0,39}$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "workspaceId", "platformId", "createdAt", "revokedAt" ], "additionalProperties": false }, "cleartext": { "type": "string" }, "revokedSecretId": { "type": [ "string", "null" ] } }, "required": [ "secret", "cleartext", "revokedSecretId" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.issued", "examples": [ { "input": { "workspaceId": "ws_demo_default", "platformId": "webhook:vapi" }, "output": { "secret": { "id": "wis_def456", "workspaceId": "ws_demo_default", "platformId": "webhook:vapi", "createdAt": "2026-09-03T12:00:00.000Z", "revokedAt": null }, "cleartext": "wis_REDACTED_EXAMPLE_ONLY", "revokedSecretId": null }, "note": "Generate the secret a Vapi webhook signs with." } ] }, { "name": "keys_ingest-secret_revoke", "description": "Revoke an ingest secret without issuing a replacement. Deliveries for that platform then fail closed.", "function_declarations": [ { "name": "keys_ingest-secret_revoke", "description": "Revoke an ingest secret without issuing a replacement. Deliveries for that platform then fail closed.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "secretId": { "type": "string", "minLength": 1 }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "secretId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/keys.ingest-secret.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean", "const": true }, "secretId": { "type": "string" }, "revokedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "revoked", "secretId", "revokedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "key.revoked", "examples": [ { "input": { "workspaceId": "ws_demo_default", "secretId": "wis_def456", "reason": "Rotating after a partner offboarding." }, "output": { "revoked": true, "secretId": "wis_def456", "revokedAt": "2026-09-03T12:00:00.000Z" }, "note": "Stop accepting deliveries for a platform." } ] }, { "name": "webhooks_list", "description": "List webhook endpoints for a workspace.", "function_declarations": [ { "name": "webhooks_list", "description": "List webhook endpoints for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "enabledOnly": { "default": false, "type": "boolean" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "webhooks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } }, "enabled": { "type": "boolean" }, "secretPrefix": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "url", "label", "events", "enabled", "secretPrefix", "createdAt", "updatedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "webhooks", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "webhooks": [], "nextCursor": null }, "note": "List webhooks." } ] }, { "name": "webhooks_get", "description": "Get a single webhook endpoint.", "function_declarations": [ { "name": "webhooks_get", "description": "Get a single webhook endpoint.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "webhookId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } }, "enabled": { "type": "boolean" }, "secretPrefix": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "url", "label", "events", "enabled", "secretPrefix", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000" }, "output": { "id": "wh_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "url": "https://example.com/webhook", "label": "Production hook", "events": [ "alert.fired" ], "enabled": true, "secretPrefix": "whsec_ab", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Read a webhook." } ] }, { "name": "webhooks_create", "description": "Register a new webhook endpoint. Returns the signing secret cleartext ONCE.", "function_declarations": [ { "name": "webhooks_create", "description": "Register a new webhook endpoint. Returns the signing secret cleartext ONCE.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } } }, "required": [ "workspaceId", "url", "label", "events" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "webhook": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } }, "enabled": { "type": "boolean" }, "secretPrefix": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "url", "label", "events", "enabled", "secretPrefix", "createdAt", "updatedAt" ], "additionalProperties": {} }, "signingSecretCleartext": { "type": "string" } }, "required": [ "webhook", "signingSecretCleartext" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "webhook.created", "examples": [ { "input": { "workspaceId": "ws_demo_default", "url": "https://example.com/webhook", "label": "Prod hook", "events": [ "alert.fired", "export.ready" ] }, "output": { "webhook": { "id": "wh_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "url": "https://example.com/webhook", "label": "Prod hook", "events": [ "alert.fired", "export.ready" ], "enabled": true, "secretPrefix": "whsec_ab", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z" }, "signingSecretCleartext": "whsec_REDACTED_EXAMPLE_ONLY" }, "note": "Create + receive signing secret." } ] }, { "name": "webhooks_update", "description": "Update a webhook's URL, label, or event subscriptions.", "function_declarations": [ { "name": "webhooks_update", "description": "Update a webhook's URL, label, or event subscriptions.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } } }, "required": [ "workspaceId", "webhookId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } }, "enabled": { "type": "boolean" }, "secretPrefix": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "url", "label", "events", "enabled", "secretPrefix", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "webhook.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000", "events": [ "alert.fired" ] }, "output": { "id": "wh_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "url": "https://example.com/webhook", "label": "Prod hook", "events": [ "alert.fired" ], "enabled": true, "secretPrefix": "whsec_ab", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:05:00.000Z" }, "note": "Narrow subscription set." } ] }, { "name": "webhooks_delete", "description": "Delete a webhook endpoint. Pending deliveries are abandoned.", "function_declarations": [ { "name": "webhooks_delete", "description": "Delete a webhook endpoint. Pending deliveries are abandoned.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "webhookId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "webhook.deleted", "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000" }, "output": { "deleted": true }, "note": "Remove a webhook." } ] }, { "name": "webhooks_enable", "description": "Enable or disable a webhook without deleting it.", "function_declarations": [ { "name": "webhooks_enable", "description": "Enable or disable a webhook without deleting it.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "enabled": { "type": "boolean" } }, "required": [ "workspaceId", "webhookId", "enabled" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.enable" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "events": { "type": "array", "items": { "type": "string", "enum": [ "record.created", "lens.hit", "notary.anchored", "ledger-bundles.anchored", "pack.purchased", "plan.changed", "member.invited", "member.removed", "key.issued", "key.revoked", "alert.fired", "export.ready", "export.failed" ] } }, "enabled": { "type": "boolean" }, "secretPrefix": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "url", "label", "events", "enabled", "secretPrefix", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "webhook.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000", "enabled": false }, "output": { "id": "wh_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "url": "https://example.com/webhook", "label": "Prod hook", "events": [ "alert.fired" ], "enabled": false, "secretPrefix": "whsec_ab", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:10:00.000Z" }, "note": "Disable temporarily." } ] }, { "name": "webhooks_test-fire", "description": "Fire a synthetic test event to a webhook to verify delivery + signature validation.", "function_declarations": [ { "name": "webhooks_test-fire", "description": "Fire a synthetic test event to a webhook to verify delivery + signature validation.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "eventType": { "default": "webhook.test", "type": "string" } }, "required": [ "workspaceId", "webhookId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.test-fire" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deliveryId": { "type": "string" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "eventType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "success", "failed", "retrying" ] }, "statusCode": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "attemptCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "attemptedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "responseTimeMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "errorMessage": { "type": "string" } }, "required": [ "deliveryId", "webhookId", "eventType", "status", "attemptCount", "attemptedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000" }, "output": { "deliveryId": "del_abc", "webhookId": "wh_DEMO00000000000000000000", "eventType": "webhook.test", "status": "success", "statusCode": 200, "attemptCount": 1, "attemptedAt": "2026-05-22T12:00:00.000Z", "responseTimeMs": 87 }, "note": "Test webhook delivery." } ] }, { "name": "webhooks_events_list", "description": "List the event types this webhook can subscribe to (from the AsyncAPI 3 spec).", "function_declarations": [ { "name": "webhooks_events_list", "description": "List the event types this webhook can subscribe to (from the AsyncAPI 3 spec).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.events.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "description": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ] } }, "required": [ "id", "description", "severity" ], "additionalProperties": false } } }, "required": [ "events" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "events": [ { "id": "alert.fired", "description": "An alert rule fired.", "severity": "warning" } ] }, "note": "Discover event types." } ] }, { "name": "webhooks_events_replay", "description": "Replay missed events from a time window. Useful for recovering after webhook downtime.", "function_declarations": [ { "name": "webhooks_events_replay", "description": "Replay missed events from a time window. Useful for recovering after webhook downtime.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId", "webhookId", "since" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.events.replay" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "replayId": { "type": "string" }, "eventsQueued": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "replayId", "eventsQueued" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000", "since": "2026-05-21T00:00:00.000Z" }, "output": { "replayId": "rep_abc", "eventsQueued": 42 }, "note": "Replay events from yesterday." } ] }, { "name": "webhooks_signing-secret_rotate", "description": "Rotate the HMAC signing secret. Old secret valid for 24h grace.", "function_declarations": [ { "name": "webhooks_signing-secret_rotate", "description": "Rotate the HMAC signing secret. Old secret valid for 24h grace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "webhookId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.signing-secret.rotate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "newSigningSecretCleartext": { "type": "string" }, "oldSecretValidUntil": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "newSigningSecretCleartext", "oldSecretValidUntil" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "webhook.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000" }, "output": { "newSigningSecretCleartext": "whsec_REDACTED_EXAMPLE_ONLY", "oldSecretValidUntil": "2026-05-23T12:00:00.000Z" }, "note": "Rotate webhook signing secret." } ] }, { "name": "webhooks_deliveries_list", "description": "List delivery attempts for a webhook (success + failure history).", "function_declarations": [ { "name": "webhooks_deliveries_list", "description": "List delivery attempts for a webhook (success + failure history).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "statusFilter": { "type": "string", "enum": [ "pending", "success", "failed", "retrying" ] } }, "required": [ "workspaceId", "webhookId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.deliveries.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deliveries": { "type": "array", "items": { "type": "object", "properties": { "deliveryId": { "type": "string" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "eventType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "success", "failed", "retrying" ] }, "statusCode": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "attemptCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "attemptedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "responseTimeMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "errorMessage": { "type": "string" } }, "required": [ "deliveryId", "webhookId", "eventType", "status", "attemptCount", "attemptedAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "deliveries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000" }, "output": { "deliveries": [], "nextCursor": null }, "note": "List delivery attempts." } ] }, { "name": "webhooks_deliveries_retry", "description": "Retry a specific failed delivery.", "function_declarations": [ { "name": "webhooks_deliveries_retry", "description": "Retry a specific failed delivery.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "deliveryId": { "type": "string" } }, "required": [ "workspaceId", "webhookId", "deliveryId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/webhooks.deliveries.retry" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deliveryId": { "type": "string" }, "webhookId": { "type": "string", "pattern": "^wh_[0-9A-Z]{20,}$" }, "eventType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "success", "failed", "retrying" ] }, "statusCode": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "attemptCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "attemptedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "responseTimeMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "errorMessage": { "type": "string" } }, "required": [ "deliveryId", "webhookId", "eventType", "status", "attemptCount", "attemptedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_DEMO00000000000000000000", "deliveryId": "del_abc" }, "output": { "deliveryId": "del_abc", "webhookId": "wh_DEMO00000000000000000000", "eventType": "alert.fired", "status": "success", "statusCode": 200, "attemptCount": 2, "attemptedAt": "2026-05-22T12:00:00.000Z", "responseTimeMs": 42 }, "note": "Retry a delivery." } ] }, { "name": "alerts_list", "description": "List alert rules for a workspace.", "function_declarations": [ { "name": "alerts_list", "description": "List alert rules for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "enabledOnly": { "default": false, "type": "boolean" }, "typeFilter": { "type": "string" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "alerts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } }, "lastFiredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "firedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "type", "label", "enabled", "config", "channels", "lastFiredAt", "firedCount", "createdAt", "updatedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "alerts", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "alerts": [], "nextCursor": null }, "note": "List alerts." } ] }, { "name": "alerts_get", "description": "Get a single alert rule.", "function_declarations": [ { "name": "alerts_get", "description": "Get a single alert rule.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } }, "lastFiredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "firedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "type", "label", "enabled", "config", "channels", "lastFiredAt", "firedCount", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000" }, "output": { "id": "alert_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "type": "quota_threshold", "label": "80% quota", "enabled": true, "config": { "type": "quota_threshold", "thresholdPercent": 80, "quotaKind": "runs" }, "channels": [], "lastFiredAt": null, "firedCount": 0, "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Read an alert rule." } ] }, { "name": "alerts_create", "description": "Create a new alert rule.", "function_declarations": [ { "name": "alerts_create", "description": "Create a new alert rule.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string", "enum": [ "quota_threshold", "pack_balance_low", "payment_failed", "auto_topup_succeeded", "auto_topup_failed", "auto_topup_cap_hit", "hash_chain_mismatch", "webhook_delivery_failing", "notarian_anchor_failed", "lens_hit", "scheduled_for_deletion", "admin_read", "member_role_change", "key_issued", "key_revoked", "tools_abuse_flagged", "tools_abuse_suspended", "tools_quota_threshold", "tools_monitor_check_failing", "tools_tls_vantages_disagree", "mandate_expiring", "ledger_bundles_anchor_failed", "attestor_abuse_flagged", "attestor_abuse_suspended", "attestor_quota_threshold", "attestor_monitor_check_failing" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } } }, "required": [ "workspaceId", "type", "label", "config", "channels" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } }, "lastFiredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "firedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "type", "label", "enabled", "config", "channels", "lastFiredAt", "firedCount", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "alert.created", "examples": [ { "input": { "workspaceId": "ws_demo_default", "type": "quota_threshold", "label": "80% quota", "config": { "type": "quota_threshold", "thresholdPercent": 80, "quotaKind": "runs" }, "channels": [ { "kind": "email", "addresses": [ "ops@example.com" ] } ] }, "output": { "id": "alert_NEW0000000000000000000", "workspaceId": "ws_demo_default", "type": "quota_threshold", "label": "80% quota", "enabled": true, "config": { "type": "quota_threshold", "thresholdPercent": 80, "quotaKind": "runs" }, "channels": [ { "kind": "email", "addresses": [ "ops@example.com" ] } ], "lastFiredAt": null, "firedCount": 0, "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Create alert." } ] }, { "name": "alerts_update", "description": "Update an alert's label / config / channels / enabled flag.", "function_declarations": [ { "name": "alerts_update", "description": "Update an alert's label / config / channels / enabled flag.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } }, "lastFiredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "firedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "type", "label", "enabled", "config", "channels", "lastFiredAt", "firedCount", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "alert.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000", "label": "Renamed" }, "output": { "id": "alert_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "type": "quota_threshold", "label": "Renamed", "enabled": true, "config": {}, "channels": [], "lastFiredAt": null, "firedCount": 0, "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:05:00.000Z" }, "note": "Update alert." } ] }, { "name": "alerts_delete", "description": "Delete an alert rule.", "function_declarations": [ { "name": "alerts_delete", "description": "Delete an alert rule.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "alert.deleted", "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000" }, "output": { "deleted": true }, "note": "Delete alert." } ] }, { "name": "alerts_enable", "description": "Enable an alert rule.", "function_declarations": [ { "name": "alerts_enable", "description": "Enable an alert rule.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.enable" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } }, "lastFiredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "firedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "type", "label", "enabled", "config", "channels", "lastFiredAt", "firedCount", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "alert.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000" }, "output": { "id": "alert_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "type": "quota_threshold", "label": "Quota", "enabled": true, "config": {}, "channels": [], "lastFiredAt": null, "firedCount": 0, "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Enable." } ] }, { "name": "alerts_disable", "description": "Disable an alert rule without deleting it.", "function_declarations": [ { "name": "alerts_disable", "description": "Disable an alert rule without deleting it.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.disable" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "type": { "type": "string" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "enabled": { "type": "boolean" }, "config": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] }, "quotaKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdPercent", "quotaKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "pack_balance_low" }, "thresholdRuns": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "packKind": { "type": "string", "enum": [ "runs", "number-one" ] } }, "required": [ "type", "thresholdRuns", "packKind" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "payment_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_succeeded" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "auto_topup_cap_hit" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "hash_chain_mismatch" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "webhook_delivery_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "notarian_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "lens_hit" }, "lensId": { "type": "string", "minLength": 1 } }, "required": [ "type", "lensId" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "scheduled_for_deletion" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "admin_read" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "member_role_change" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_issued" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "key_revoked" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "tools_tls_vantages_disagree" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "mandate_expiring" }, "daysBefore": { "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 3 }, { "type": "number", "const": 7 }, { "type": "number", "const": 14 }, { "type": "number", "const": 30 } ] } }, "required": [ "type", "daysBefore" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "ledger_bundles_anchor_failed" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_flagged" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_abuse_suspended" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_quota_threshold" }, "thresholdPercent": { "anyOf": [ { "type": "number", "const": 50 }, { "type": "number", "const": 75 }, { "type": "number", "const": 80 }, { "type": "number", "const": 90 }, { "type": "number", "const": 95 }, { "type": "number", "const": 100 } ] } }, "required": [ "type", "thresholdPercent" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "attestor_monitor_check_failing" }, "consecutiveFailures": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "windowMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "consecutiveFailures", "windowMinutes" ], "additionalProperties": false } ] }, "channels": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "email" }, "addresses": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } } }, "required": [ "kind", "addresses" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "webhook" }, "webhookId": { "type": "string", "minLength": 1 } }, "required": [ "kind", "webhookId" ], "additionalProperties": false } ] } }, "lastFiredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "firedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "id", "workspaceId", "type", "label", "enabled", "config", "channels", "lastFiredAt", "firedCount", "createdAt", "updatedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "alert.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000" }, "output": { "id": "alert_DEMO00000000000000000000", "workspaceId": "ws_demo_default", "type": "quota_threshold", "label": "Quota", "enabled": false, "config": {}, "channels": [], "lastFiredAt": null, "firedCount": 0, "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Disable." } ] }, { "name": "alerts_test-fire", "description": "Fire a synthetic test of an alert to verify channels.", "function_declarations": [ { "name": "alerts_test-fire", "description": "Fire a synthetic test of an alert to verify channels.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.test-fire" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "fired": { "type": "boolean" }, "channelResults": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "success": { "type": "boolean" }, "message": { "type": "string" } }, "required": [ "kind", "success" ], "additionalProperties": false } } }, "required": [ "fired", "channelResults" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000" }, "output": { "fired": true, "channelResults": [ { "kind": "email", "success": true } ] }, "note": "Test fire." } ] }, { "name": "alerts_kinds_list", "description": "List all supported alert kinds + their config shapes + severity classifications.", "function_declarations": [ { "name": "alerts_kinds_list", "description": "List all supported alert kinds + their config shapes + severity classifications.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.kinds.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kinds": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "severity": { "type": "string", "enum": [ "ops", "billing", "compliance", "informational" ] }, "configurable": { "type": "boolean" } }, "required": [ "id", "label", "description", "severity", "configurable" ], "additionalProperties": false } } }, "required": [ "kinds" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "kinds": [ { "id": "quota_threshold", "label": "Quota threshold tripped", "description": "Run or Number One quota crossed a configured percent of the monthly allowance.", "severity": "ops", "configurable": true } ] }, "note": "Discover alert kinds." } ] }, { "name": "alerts_history_list", "description": "List historical firings for a given alert rule.", "function_declarations": [ { "name": "alerts_history_list", "description": "List historical firings for a given alert rule.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "alertId": { "type": "string", "pattern": "^alert_[0-9A-Z]{20,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId", "alertId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/alerts.history.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "firings": { "type": "array", "items": { "type": "object", "properties": { "firedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "context": {} }, "required": [ "firedAt", "context" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "firings", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "alertId": "alert_DEMO00000000000000000000" }, "output": { "firings": [], "nextCursor": null }, "note": "Read alert fire history." } ] }, { "name": "exports_list", "description": "List exports for a workspace.", "function_declarations": [ { "name": "exports_list", "description": "List exports for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "status": { "type": "string", "enum": [ "queued", "running", "ready", "failed", "expired" ] }, "kind": { "type": "string", "enum": [ "audit-log", "tools-receipts", "attestor-receipts", "eu-ai-act-article-12", "workspace-snapshot", "policy-pack", "tops-feed", "custody-log", "pii-portability", "compliance-bundle" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exports": { "type": "array", "items": { "type": "object", "properties": { "exportId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "audit-log", "tools-receipts", "attestor-receipts", "eu-ai-act-article-12", "workspace-snapshot", "policy-pack", "tops-feed", "custody-log", "pii-portability", "compliance-bundle" ] }, "status": { "type": "string", "enum": [ "queued", "running", "ready", "failed", "expired" ] }, "format": { "type": "string", "enum": [ "json", "csv", "zip", "compliance-bundle" ] }, "requestedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "readyAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signature": { "type": "string" }, "signingKeyId": { "type": "string" }, "schemaVersion": { "type": "string" }, "errorMessage": { "type": "string" }, "anchorProof": { "type": "object", "properties": { "superRoot": { "type": "string" }, "inclusionProof": { "type": "array", "items": { "type": "object", "properties": { "sibling": { "type": "string" }, "position": { "type": "string", "enum": [ "left", "right" ] } }, "required": [ "sibling", "position" ], "additionalProperties": false } }, "calendars": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "pending", "anchored", "failed" ] }, "anchoredAt": { "type": "string" }, "bitcoinBlockHeight": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "bitcoinBlockHash": { "type": [ "string", "null" ] } }, "required": [ "superRoot", "inclusionProof", "calendars", "state", "anchoredAt", "bitcoinBlockHeight", "bitcoinBlockHash" ], "additionalProperties": false } }, "required": [ "exportId", "workspaceId", "kind", "status", "format", "requestedAt", "readyAt", "expiresAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "exports", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "exports": [], "nextCursor": null }, "note": "List exports." } ] }, { "name": "exports_get", "description": "Get a single export's status + metadata.", "function_declarations": [ { "name": "exports_get", "description": "Get a single export's status + metadata.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "exportId": { "type": "string" } }, "required": [ "workspaceId", "exportId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "audit-log", "tools-receipts", "attestor-receipts", "eu-ai-act-article-12", "workspace-snapshot", "policy-pack", "tops-feed", "custody-log", "pii-portability", "compliance-bundle" ] }, "status": { "type": "string", "enum": [ "queued", "running", "ready", "failed", "expired" ] }, "format": { "type": "string", "enum": [ "json", "csv", "zip", "compliance-bundle" ] }, "requestedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "readyAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signature": { "type": "string" }, "signingKeyId": { "type": "string" }, "schemaVersion": { "type": "string" }, "errorMessage": { "type": "string" }, "anchorProof": { "type": "object", "properties": { "superRoot": { "type": "string" }, "inclusionProof": { "type": "array", "items": { "type": "object", "properties": { "sibling": { "type": "string" }, "position": { "type": "string", "enum": [ "left", "right" ] } }, "required": [ "sibling", "position" ], "additionalProperties": false } }, "calendars": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "pending", "anchored", "failed" ] }, "anchoredAt": { "type": "string" }, "bitcoinBlockHeight": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "bitcoinBlockHash": { "type": [ "string", "null" ] } }, "required": [ "superRoot", "inclusionProof", "calendars", "state", "anchoredAt", "bitcoinBlockHeight", "bitcoinBlockHash" ], "additionalProperties": false } }, "required": [ "exportId", "workspaceId", "kind", "status", "format", "requestedAt", "readyAt", "expiresAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "exportId": "exp_abc" }, "output": { "exportId": "exp_abc", "workspaceId": "ws_demo_default", "kind": "audit-log", "status": "ready", "format": "json", "requestedAt": "2026-05-22T12:00:00.000Z", "readyAt": "2026-05-22T12:10:00.000Z", "expiresAt": "2026-05-29T12:10:00.000Z" }, "note": "Read export status." } ] }, { "name": "exports_request", "description": "Request a new compliance export. Returns the export id; status polls reveal readiness.", "function_declarations": [ { "name": "exports_request", "description": "Request a new compliance export. Returns the export id; status polls reveal readiness.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "audit-log", "tools-receipts", "attestor-receipts", "eu-ai-act-article-12", "workspace-snapshot", "policy-pack", "tops-feed", "custody-log", "pii-portability", "compliance-bundle" ] }, "format": { "default": "compliance-bundle", "type": "string", "enum": [ "json", "csv", "zip", "compliance-bundle" ] }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "filters": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "workspaceId", "kind" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.request" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "estimatedReadyAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "exportId", "estimatedReadyAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "export.requested", "examples": [ { "input": { "workspaceId": "ws_demo_default", "kind": "compliance-bundle", "format": "zip" }, "output": { "exportId": "exp_abc", "estimatedReadyAt": "2026-05-22T12:10:00.000Z" }, "note": "Request a compliance bundle." } ] }, { "name": "exports_download", "description": "Get the signed download URL for a ready export (URL is time-bounded; SHA-256 included for integrity check).", "function_declarations": [ { "name": "exports_download", "description": "Get the signed download URL for a ready export (URL is time-bounded; SHA-256 included for integrity check).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "exportId": { "type": "string" } }, "required": [ "workspaceId", "exportId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.download" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "url", "expiresAt", "sha256" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "export.completed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "exportId": "exp_abc" }, "output": { "url": "https://r2.agined.com/exports/abc", "expiresAt": "2026-05-22T13:00:00.000Z", "sha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab" }, "note": "Get signed download URL." } ] }, { "name": "exports_verify", "description": "Verify an export's Ed25519 signature + OTS Bitcoin proof. Offline-verifiable.", "function_declarations": [ { "name": "exports_verify", "description": "Verify an export's Ed25519 signature + OTS Bitcoin proof. Offline-verifiable.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signature": { "type": "string" }, "signingKeyId": { "type": "string" }, "otsProof": { "type": "string" } }, "required": [ "exportSha256", "signature", "signingKeyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "valid": { "type": "boolean" }, "signatureValid": { "type": "boolean" }, "otsValid": { "type": "boolean" }, "errors": { "type": "array", "items": { "type": "string" } }, "anchor": { "type": "object", "properties": { "checked": { "type": "string", "const": "inclusion_only" }, "inclusionValid": { "type": "boolean" }, "superRoot": { "type": "string" }, "state": { "anyOf": [ { "type": "string", "enum": [ "pending", "anchored", "failed" ] }, { "type": "null" } ] }, "bitcoinBlockHeight": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "reason": { "type": "string" } }, "required": [ "checked", "inclusionValid" ], "additionalProperties": false } }, "required": [ "valid", "signatureValid", "otsValid", "errors" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "exportSha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab", "signature": "...", "signingKeyId": "agined-2026-q2-enam" }, "output": { "valid": true, "signatureValid": true, "otsValid": true, "errors": [] }, "note": "Offline verify an export." } ] }, { "name": "exports_attestor_receipt-bundle_request", "description": "Request a portable Attestor-receipt bundle — JSON manifest + receipt files + public key JWK + verify README. Verifiable with @attestor/verify.", "function_declarations": [ { "name": "exports_attestor_receipt-bundle_request", "description": "Request a portable Attestor-receipt bundle — JSON manifest + receipt files + public key JWK + verify README. Verifiable with @attestor/verify.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "primitiveFilter": { "type": "array", "items": { "type": "string" } }, "signingKeyIdFilter": { "type": "string" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.attestor.receipt-bundle.request" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "estimatedReadyAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "exportId", "estimatedReadyAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "export.requested", "examples": [ { "input": { "workspaceId": "ws_demo_default", "primitiveFilter": [ "agent.call", "content.attest" ] }, "output": { "exportId": "exp_atst_abc", "estimatedReadyAt": "2026-05-22T12:15:00.000Z" }, "note": "Bundle Attestor receipts." } ] }, { "name": "exports_eu-ai-act_article-12_request", "description": "Request an EU AI Act Article 12 compliant log bundle (prEN 18229-1 + ISO/IEC DIS 24970 schema). Cannot be disabled — regulatory mandate.", "function_declarations": [ { "name": "exports_eu-ai-act_article-12_request", "description": "Request an EU AI Act Article 12 compliant log bundle (prEN 18229-1 + ISO/IEC DIS 24970 schema). Cannot be disabled — regulatory mandate.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "jurisdictionFilter": { "default": "all", "type": "string", "enum": [ "WEUR", "ENAM", "all" ] } }, "required": [ "workspaceId", "since", "until" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.eu-ai-act.article-12.request" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "estimatedReadyAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "schemaVersion": { "type": "string" } }, "required": [ "exportId", "estimatedReadyAt", "schemaVersion" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "export.requested", "examples": [ { "input": { "workspaceId": "ws_demo_default", "since": "2026-04-01T00:00:00.000Z", "until": "2026-05-01T00:00:00.000Z" }, "output": { "exportId": "exp_eu12_abc", "estimatedReadyAt": "2026-05-22T12:30:00.000Z", "schemaVersion": "prEN-18229-1-draft-2026-03" }, "note": "EU AI Act Art. 12 compliance export." } ] }, { "name": "exports_audit-log_request", "description": "Request a JSON or CSV export of the workspace audit log filtered by time + kind.", "function_declarations": [ { "name": "exports_audit-log_request", "description": "Request a JSON or CSV export of the workspace audit log filtered by time + kind.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kindsFilter": { "type": "array", "items": { "type": "string" } }, "format": { "default": "json", "type": "string", "enum": [ "json", "csv" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.audit-log.request" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "estimatedReadyAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "exportId", "estimatedReadyAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "export.requested", "examples": [ { "input": { "workspaceId": "ws_demo_default", "format": "csv" }, "output": { "exportId": "exp_audit_abc", "estimatedReadyAt": "2026-05-22T12:10:00.000Z" }, "note": "Export audit log as CSV." } ] }, { "name": "exports_kinds_list", "description": "List the supported export kinds + their output formats + retention.", "function_declarations": [ { "name": "exports_kinds_list", "description": "List the supported export kinds + their output formats + retention.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.kinds.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kinds": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "audit-log", "tools-receipts", "attestor-receipts", "eu-ai-act-article-12", "workspace-snapshot", "policy-pack", "tops-feed", "custody-log", "pii-portability", "compliance-bundle" ] }, "label": { "type": "string" }, "description": { "type": "string" }, "supportedFormats": { "type": "array", "items": { "type": "string" } }, "retentionDays": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "label", "description", "supportedFormats", "retentionDays" ], "additionalProperties": false } } }, "required": [ "kinds" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "kinds": [ { "id": "compliance-bundle", "label": "Compliance bundle", "description": "Full audit + custody + receipts + signing keys for offline verification.", "supportedFormats": [ "zip" ], "retentionDays": 7 } ] }, "note": "Discover export kinds." } ] }, { "name": "exports_delete", "description": "Delete a completed export (frees R2 storage immediately).", "function_declarations": [ { "name": "exports_delete", "description": "Delete a completed export (frees R2 storage immediately).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "exportId": { "type": "string" } }, "required": [ "workspaceId", "exportId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/exports.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "exportId": "exp_abc" }, "output": { "deleted": true }, "note": "Delete an export." } ] }, { "name": "retention_policy_get", "description": "Get the active retention policy for a workspace.", "function_declarations": [ { "name": "retention_policy_get", "description": "Get the active retention policy for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.policy.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "retentionDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "isCustom": { "type": "boolean" }, "appliedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "appliedBy": { "type": "string" } }, "required": [ "workspaceId", "retentionDays", "isCustom", "appliedAt", "appliedBy" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "workspaceId": "ws_demo_default", "retentionDays": 365, "isCustom": false, "appliedAt": "2026-01-01T00:00:00.000Z", "appliedBy": "plan" }, "note": "Read retention policy." } ] }, { "name": "retention_policy_update", "description": "Update workspace retention days (within tier limits).", "function_declarations": [ { "name": "retention_policy_update", "description": "Update workspace retention days (within tier limits).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "retentionDays": { "type": "integer", "minimum": 7, "maximum": 1825 } }, "required": [ "workspaceId", "retentionDays" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.policy.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "retentionDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "isCustom": { "type": "boolean" }, "appliedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "appliedBy": { "type": "string" } }, "required": [ "workspaceId", "retentionDays", "isCustom", "appliedAt", "appliedBy" ], "additionalProperties": {} }, "safety": { "level": "destructive", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "default", "audit_kind": "retention.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "retentionDays": 730 }, "output": { "workspaceId": "ws_demo_default", "retentionDays": 730, "isCustom": true, "appliedAt": "2026-05-22T12:00:00.000Z", "appliedBy": "extension" }, "note": "Extend retention via paid extension." } ] }, { "name": "retention_histogram_get", "description": "Get a histogram of record ages in the workspace (helps visualize what's near purge).", "function_declarations": [ { "name": "retention_histogram_get", "description": "Get a histogram of record ages in the workspace (helps visualize what's near purge).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "bucketSizeDays": { "default": 7, "type": "integer", "minimum": 1, "maximum": 30 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.histogram.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "buckets": { "type": "array", "items": { "type": "object", "properties": { "ageDays": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "recordCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "ageDays", "recordCount" ], "additionalProperties": false } }, "totalRecords": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "oldestRecordAge": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "buckets", "totalRecords", "oldestRecordAge" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "buckets": [ { "ageDays": 0, "recordCount": 1000 }, { "ageDays": 7, "recordCount": 900 } ], "totalRecords": 12000, "oldestRecordAge": 350 }, "note": "Read age distribution." } ] }, { "name": "retention_next-purge_preview", "description": "Preview which records will purge in the next cycle (live 1-Hz countdown on the dashboard).", "function_declarations": [ { "name": "retention_next-purge_preview", "description": "Preview which records will purge in the next cycle (live 1-Hz countdown on the dashboard).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.next-purge.preview" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "purgeAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "recordsToBepurged": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sampleEntries": { "type": "array", "items": {} } }, "required": [ "purgeAt", "recordsToBepurged", "sampleEntries" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "purgeAt": "2026-05-22T13:00:00.000Z", "recordsToBepurged": 42, "sampleEntries": [] }, "note": "Preview upcoming purge." } ] }, { "name": "retention_purge-history_list", "description": "List historical purge events with verification status.", "function_declarations": [ { "name": "retention_purge-history_list", "description": "List historical purge events with verification status.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.purge-history.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "purges": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "purgedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "recordsPurged": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cutoffAge": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "effectiveSource": { "anyOf": [ { "type": "string", "enum": [ "tier_floor", "paid_extension" ] }, { "type": "null" } ] }, "verificationState": { "type": "string", "enum": [ "verified", "awaiting_anchor", "unanchored" ] } }, "required": [ "id", "purgedAt", "recordsPurged", "cutoffAge", "effectiveSource", "verificationState" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "purges", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "purges": [], "nextCursor": null }, "note": "Read purge history." } ] }, { "name": "retention_extension_subscribe", "description": "Subscribe to the paid retention extension at the per-tier rate.", "function_declarations": [ { "name": "retention_extension_subscribe", "description": "Subscribe to the paid retention extension at the per-tier rate.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 } }, "required": [ "workspaceId", "extendedToDays" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.extension.subscribe" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "monthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "perGbMonthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "storageGbBilled": { "type": "number", "minimum": 0 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "canceledAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "effectiveUntil": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "workspaceId", "extendedToDays", "monthlyCostUsdMinor", "perGbMonthlyCostUsdMinor", "storageGbBilled", "startedAt", "canceledAt", "effectiveUntil" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "retention.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "extendedToDays": 1095 }, "output": { "workspaceId": "ws_demo_default", "extendedToDays": 1095, "monthlyCostUsdMinor": 1200, "perGbMonthlyCostUsdMinor": 1000, "storageGbBilled": 1.2, "startedAt": "2026-05-22T12:00:00.000Z", "canceledAt": null, "effectiveUntil": null }, "note": "Subscribe to 3-year retention extension." } ] }, { "name": "retention_extension_get", "description": "Get the current retention extension subscription (if any).", "function_declarations": [ { "name": "retention_extension_get", "description": "Get the current retention extension subscription (if any).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.extension.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "monthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "perGbMonthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "storageGbBilled": { "type": "number", "minimum": 0 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "canceledAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "effectiveUntil": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "workspaceId", "extendedToDays", "monthlyCostUsdMinor", "perGbMonthlyCostUsdMinor", "storageGbBilled", "startedAt", "canceledAt", "effectiveUntil" ], "additionalProperties": {} }, { "type": "null" } ] }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": null, "note": "Workspace has no extension subscription." } ] }, { "name": "retention_extension_update", "description": "Update the active retention extension (change duration).", "function_declarations": [ { "name": "retention_extension_update", "description": "Update the active retention extension (change duration).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 } }, "required": [ "workspaceId", "extendedToDays" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.extension.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "monthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "perGbMonthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "storageGbBilled": { "type": "number", "minimum": 0 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "canceledAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "effectiveUntil": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "workspaceId", "extendedToDays", "monthlyCostUsdMinor", "perGbMonthlyCostUsdMinor", "storageGbBilled", "startedAt", "canceledAt", "effectiveUntil" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "retention.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default", "extendedToDays": 1825 }, "output": { "workspaceId": "ws_demo_default", "extendedToDays": 1825, "monthlyCostUsdMinor": 2400, "perGbMonthlyCostUsdMinor": 1000, "storageGbBilled": 2.4, "startedAt": "2026-05-22T12:00:00.000Z", "canceledAt": null, "effectiveUntil": null }, "note": "Bump to 5-year retention." } ] }, { "name": "retention_extension_cancel", "description": "Cancel the retention extension at the end of the current billing period.", "function_declarations": [ { "name": "retention_extension_cancel", "description": "Cancel the retention extension at the end of the current billing period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.extension.cancel" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "extendedToDays": { "type": "integer", "minimum": 7, "maximum": 1825 }, "monthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "perGbMonthlyCostUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "storageGbBilled": { "type": "number", "minimum": 0 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "canceledAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "effectiveUntil": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "workspaceId", "extendedToDays", "monthlyCostUsdMinor", "perGbMonthlyCostUsdMinor", "storageGbBilled", "startedAt", "canceledAt", "effectiveUntil" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "retention.updated", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "workspaceId": "ws_demo_default", "extendedToDays": 1825, "monthlyCostUsdMinor": 2400, "perGbMonthlyCostUsdMinor": 1000, "storageGbBilled": 2.4, "startedAt": "2026-05-22T12:00:00.000Z", "canceledAt": "2026-05-22T12:00:00.000Z", "effectiveUntil": "2026-06-22T00:00:00.000Z" }, "note": "Cancel at period end." } ] }, { "name": "retention_extension_rates_list", "description": "List the per-tier retention extension rates (USD cents per GB per month).", "function_declarations": [ { "name": "retention_extension_rates_list", "description": "List the per-tier retention extension rates (USD cents per GB per month).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.extension.rates.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rates": { "type": "array", "items": { "type": "object", "properties": { "tier": { "type": "string" }, "perGbCentsPerMonth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "tier", "perGbCentsPerMonth" ], "additionalProperties": false } } }, "required": [ "rates" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "rates": [ { "tier": "free", "perGbCentsPerMonth": 1200 }, { "tier": "starter", "perGbCentsPerMonth": 1100 } ] }, "note": "List per-tier rates." } ] }, { "name": "retention_policy_suggested-tier_get", "description": "Recommend a higher tier if the workspace's data growth + retention needs make extension uneconomical.", "function_declarations": [ { "name": "retention_policy_suggested-tier_get", "description": "Recommend a higher tier if the workspace's data growth + retention needs make extension uneconomical.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.policy.suggested-tier.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "suggestedTier": { "type": [ "string", "null" ] }, "monthlySavingsUsdMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "explanation": { "type": "string" } }, "required": [ "suggestedTier", "monthlySavingsUsdMinor", "explanation" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "suggestedTier": "pro", "monthlySavingsUsdMinor": 800, "explanation": "At your current storage growth, Pro tier's bundled retention saves about $8/mo over the extension." }, "note": "Suggested upgrade." } ] }, { "name": "retention_audit_list", "description": "List retention-policy audit events (changes, purges, extensions).", "function_declarations": [ { "name": "retention_audit_list", "description": "List retention-policy audit events (changes, purges, extensions).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/retention.audit.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": {} }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "entries": [], "nextCursor": null }, "note": "Read retention audit." } ] }, { "name": "audit_workspace_list", "description": "List audit log entries for a workspace.", "function_declarations": [ { "name": "audit_workspace_list", "description": "List audit log entries for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kinds": { "type": "array", "items": { "type": "string" } }, "transport": { "type": "string", "enum": [ "rest", "mcp", "mcp_apps", "chatgpt_app", "gemini", "perplexity", "claude_cowork", "a2a", "claude_skill", "nlweb", "dashboard", "sidecar", "service_to_service" ] }, "agentClientId": { "type": "string" }, "outcome": { "type": "string", "enum": [ "success", "denied", "failed", "partial" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.workspace.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^aud_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string" }, "actorAccountId": { "type": "string" }, "transport": { "type": "string", "enum": [ "rest", "mcp", "mcp_apps", "chatgpt_app", "gemini", "perplexity", "claude_cowork", "a2a", "claude_skill", "nlweb", "dashboard", "sidecar", "service_to_service" ] }, "agentClientId": { "type": "string" }, "promptExcerpt": { "type": "string", "maxLength": 200 }, "confirmationTokenId": { "type": "string" }, "governance": { "type": "object", "properties": { "refusedBy": { "type": "string" }, "charterEnforced": { "type": "boolean" }, "charterSha256": { "type": "string" }, "conscienceEnforced": { "type": "boolean" }, "consciencePolicyVersionId": { "type": "string" }, "cordonPosture": { "type": "string", "enum": [ "off", "flag", "block" ] }, "cordonFlaggedRuleId": { "type": "string" } }, "additionalProperties": false }, "delegationChainDepth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "outcome": { "type": "string", "enum": [ "success", "denied", "failed", "partial" ] }, "inputHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "storageTier": { "type": "string", "enum": [ "r2_standard", "r2_ia", "glacier_deep_archive" ] } }, "required": [ "id", "workspaceId", "timestamp", "kind", "outcome" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "entries": [], "nextCursor": null }, "note": "Read workspace audit log." } ] }, { "name": "audit_workspace_get", "description": "Get a specific audit entry by id.", "function_declarations": [ { "name": "audit_workspace_get", "description": "Get a specific audit entry by id.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "entryId": { "type": "string", "pattern": "^aud_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" } }, "required": [ "workspaceId", "entryId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.workspace.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^aud_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string" }, "actorAccountId": { "type": "string" }, "transport": { "type": "string", "enum": [ "rest", "mcp", "mcp_apps", "chatgpt_app", "gemini", "perplexity", "claude_cowork", "a2a", "claude_skill", "nlweb", "dashboard", "sidecar", "service_to_service" ] }, "agentClientId": { "type": "string" }, "promptExcerpt": { "type": "string", "maxLength": 200 }, "confirmationTokenId": { "type": "string" }, "governance": { "type": "object", "properties": { "refusedBy": { "type": "string" }, "charterEnforced": { "type": "boolean" }, "charterSha256": { "type": "string" }, "conscienceEnforced": { "type": "boolean" }, "consciencePolicyVersionId": { "type": "string" }, "cordonPosture": { "type": "string", "enum": [ "off", "flag", "block" ] }, "cordonFlaggedRuleId": { "type": "string" } }, "additionalProperties": false }, "delegationChainDepth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "outcome": { "type": "string", "enum": [ "success", "denied", "failed", "partial" ] }, "inputHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "storageTier": { "type": "string", "enum": [ "r2_standard", "r2_ia", "glacier_deep_archive" ] } }, "required": [ "id", "workspaceId", "timestamp", "kind", "outcome" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "entryId": "aud_9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f" }, "output": { "id": "aud_9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f", "workspaceId": "ws_demo_default", "timestamp": "2026-05-22T12:00:00.000Z", "kind": "workspace.created", "outcome": "success" }, "note": "Fetch a single entry." } ] }, { "name": "audit_workspace_search", "description": "Full-text search across a workspace's audit log.", "function_declarations": [ { "name": "audit_workspace_search", "description": "Full-text search across a workspace's audit log.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "query": { "type": "string", "minLength": 1, "maxLength": 500 }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "workspaceId", "query" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.workspace.search" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^aud_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string" }, "actorAccountId": { "type": "string" }, "transport": { "type": "string", "enum": [ "rest", "mcp", "mcp_apps", "chatgpt_app", "gemini", "perplexity", "claude_cowork", "a2a", "claude_skill", "nlweb", "dashboard", "sidecar", "service_to_service" ] }, "agentClientId": { "type": "string" }, "promptExcerpt": { "type": "string", "maxLength": 200 }, "confirmationTokenId": { "type": "string" }, "governance": { "type": "object", "properties": { "refusedBy": { "type": "string" }, "charterEnforced": { "type": "boolean" }, "charterSha256": { "type": "string" }, "conscienceEnforced": { "type": "boolean" }, "consciencePolicyVersionId": { "type": "string" }, "cordonPosture": { "type": "string", "enum": [ "off", "flag", "block" ] }, "cordonFlaggedRuleId": { "type": "string" } }, "additionalProperties": false }, "delegationChainDepth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "outcome": { "type": "string", "enum": [ "success", "denied", "failed", "partial" ] }, "inputHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "storageTier": { "type": "string", "enum": [ "r2_standard", "r2_ia", "glacier_deep_archive" ] } }, "required": [ "id", "workspaceId", "timestamp", "kind", "outcome" ], "additionalProperties": {} } } }, "required": [ "entries" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "query": "alice@example.com" }, "output": { "entries": [] }, "note": "Search for any mention of an email in the audit log." } ] }, { "name": "audit_workspace_share", "description": "Generate a time-bounded share URL to an audit entry (for external auditors).", "function_declarations": [ { "name": "audit_workspace_share", "description": "Generate a time-bounded share URL to an audit entry (for external auditors).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "entryId": { "type": "string", "pattern": "^aud_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "ttlHours": { "default": 24, "anyOf": [ { "type": "number", "const": 1 }, { "type": "number", "const": 24 }, { "type": "number", "const": 168 } ] }, "note": { "type": "string", "maxLength": 500 } }, "required": [ "workspaceId", "entryId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.workspace.share" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "shareUrl": { "type": "string", "format": "uri" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "shareId": { "type": "string" } }, "required": [ "shareUrl", "expiresAt", "shareId" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "entryId": "aud_9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f", "ttlHours": 24, "note": "Q3 audit — Foo & Co LLP" }, "output": { "shareUrl": "https://agined.com/audit/share/abc", "expiresAt": "2026-05-23T12:00:00.000Z", "shareId": "9f2c1a7b3e4d5f60" }, "note": "Share with auditor." } ] }, { "name": "audit_workspace_shares_list", "description": "List the audit share links minted for this workspace, with their expiry and revocation state.", "function_declarations": [ { "name": "audit_workspace_shares_list", "description": "List the audit share links minted for this workspace, with their expiry and revocation state.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "includeInactive": { "default": false, "type": "boolean" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.workspace.shares.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "shares": { "type": "array", "items": { "type": "object", "properties": { "shareId": { "type": "string" }, "tokenPrefix": { "type": "string" }, "entryId": { "type": [ "string", "null" ] }, "note": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "createdBy": { "type": [ "string", "null" ] }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "active": { "type": "boolean" } }, "required": [ "shareId", "tokenPrefix", "entryId", "note", "createdAt", "createdBy", "expiresAt", "revokedAt", "active" ], "additionalProperties": false } } }, "required": [ "shares" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "includeInactive": false }, "output": { "shares": [ { "shareId": "9f2c1a7b3e4d5f60", "tokenPrefix": "abc12345", "entryId": "aud_9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f", "note": "Q3 audit — Foo & Co LLP", "createdAt": "2026-05-22T12:00:00.000Z", "createdBy": "acct_demo", "expiresAt": "2026-05-23T12:00:00.000Z", "revokedAt": null, "active": true } ] }, "note": "See what is still shared." } ] }, { "name": "audit_workspace_share_revoke", "description": "Revoke an audit share link immediately, before its expiry.", "function_declarations": [ { "name": "audit_workspace_share_revoke", "description": "Revoke an audit share link immediately, before its expiry.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "shareId": { "type": "string", "minLength": 8, "maxLength": 64 } }, "required": [ "workspaceId", "shareId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.workspace.share.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "shareId": { "type": "string" }, "revoked": { "type": "boolean" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "shareId", "revoked", "revokedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "shareId": "9f2c1a7b3e4d5f60" }, "output": { "shareId": "9f2c1a7b3e4d5f60", "revoked": true, "revokedAt": "2026-05-22T18:00:00.000Z" }, "note": "Kill a leaked share." } ] }, { "name": "audit_custody_list", "description": "List custody chain entries for a workspace (hash-chained, Ed25519-signed).", "function_declarations": [ { "name": "audit_custody_list", "description": "List custody chain entries for a workspace (hash-chained, Ed25519-signed).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.custody.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^cust_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "seq": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sourceAuditId": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "action": { "type": "string" }, "actorDid": { "type": [ "string", "null" ] }, "payload": { "anyOf": [ {}, { "type": "null" } ] }, "prevHash": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] }, "rowHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signingKeyId": { "type": "string" } }, "required": [ "id", "seq", "sourceAuditId", "timestamp", "action", "actorDid", "payload", "prevHash", "rowHash", "recordedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "entries": [], "nextCursor": null }, "note": "Read custody chain." } ] }, { "name": "audit_custody_get", "description": "Get a custody entry by id (hash-chained via prevHash→entryHash; per-entry signature is optional — the Ed25519 seal covers a range, not each entry).", "function_declarations": [ { "name": "audit_custody_get", "description": "Get a custody entry by id (hash-chained via prevHash→entryHash; per-entry signature is optional — the Ed25519 seal covers a range, not each entry).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "entryId": { "type": "string", "pattern": "^cust_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" } }, "required": [ "workspaceId", "entryId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.custody.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^cust_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "seq": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sourceAuditId": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "action": { "type": "string" }, "actorDid": { "type": [ "string", "null" ] }, "payload": { "anyOf": [ {}, { "type": "null" } ] }, "prevHash": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] }, "rowHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "recordedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signingKeyId": { "type": "string" } }, "required": [ "id", "seq", "sourceAuditId", "timestamp", "action", "actorDid", "payload", "prevHash", "rowHash", "recordedAt" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "entryId": "cust_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" }, "output": { "id": "cust_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "workspaceId": "ws_demo_default", "seq": 42, "sourceAuditId": "aud_9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f", "action": "workspace.settings.update", "actorDid": "did:web:agined.com:accounts:acc_demo00000000000000000000", "payload": { "field": "retentionDays", "from": 30, "to": 90 }, "rowHash": "1111567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", "recordedAt": "2026-05-22T12:00:00.000Z", "timestamp": "2026-05-22T12:00:00.000Z", "prevHash": "0000000000000000000000000000000000000000000000000000000000000000", "entryHash": "abcd567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", "signature": "...", "signingKeyId": "tools-2026-q2-enam" }, "note": "Fetch a custody entry." } ] }, { "name": "audit_tops_list", "description": "List Tops feed entries (hash-chained per entry; authenticity is the periodically Ed25519-signed + OTS Bitcoin-anchored SEAL ROOT — per-entry signature is null until its seal exists).", "function_declarations": [ { "name": "audit_tops_list", "description": "List Tops feed entries (hash-chained per entry; authenticity is the periodically Ed25519-signed + OTS Bitcoin-anchored SEAL ROOT — per-entry signature is null until its seal exists).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kinds": { "type": "array", "items": { "type": "string" } }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.tops.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[0-9]+$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string" }, "prevHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "entryHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signature": { "type": [ "string", "null" ] }, "signingKeyId": { "type": [ "string", "null" ] }, "otsProof": { "type": "string" }, "storageTier": { "type": "string", "enum": [ "r2_standard", "r2_ia", "glacier_deep_archive" ] } }, "required": [ "id", "workspaceId", "timestamp", "kind", "prevHash", "entryHash", "signature", "signingKeyId" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "entries": [], "nextCursor": null }, "note": "Read Tops feed." } ] }, { "name": "audit_tops_verify", "description": "Verify the hash chain of this workspace's Tops entries.", "function_declarations": [ { "name": "audit_tops_verify", "description": "Verify the hash chain of this workspace's Tops entries.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "fromEntryId": { "type": "string", "pattern": "^[0-9]+$" }, "toEntryId": { "type": "string", "pattern": "^[0-9]+$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.tops.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "chainValid": { "type": "boolean" }, "signaturesValid": { "type": "boolean" }, "otsValid": { "type": "boolean" }, "entriesChecked": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "errors": { "type": "array", "items": { "type": "string" } } }, "required": [ "chainValid", "signaturesValid", "otsValid", "entriesChecked", "truncated", "errors" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "fromEntryId": "1024", "toEntryId": "2048" }, "output": { "chainValid": true, "signaturesValid": true, "otsValid": true, "errors": [], "entriesChecked": 1284, "truncated": false }, "note": "Verify a Tops range end-to-end." } ] }, { "name": "audit_shadow-sessions_list", "description": "List Agined-staff shadow-mode sessions on a workspace.", "function_declarations": [ { "name": "audit_shadow-sessions_list", "description": "List Agined-staff shadow-mode sessions on a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.shadow-sessions.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sessions": { "type": "array", "items": { "type": "object", "properties": { "sessionId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "accountId": { "type": "string" }, "operatorDid": { "type": [ "string", "null" ] }, "origin": { "type": "string", "const": "operator_shadow" }, "costCenterId": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokeReason": { "type": [ "string", "null" ] }, "ipAddress": { "type": [ "string", "null" ] }, "userAgent": { "type": [ "string", "null" ] } }, "required": [ "sessionId", "workspaceId", "accountId", "operatorDid", "origin", "costCenterId", "createdAt", "expiresAt", "lastUsedAt", "revokedAt", "revokeReason", "ipAddress", "userAgent" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "sessions", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "sessions": [], "nextCursor": null }, "note": "List Agined-staff shadow sessions." } ] }, { "name": "audit_shadow-sessions_get", "description": "Get full details + action feed of a shadow-mode session.", "function_declarations": [ { "name": "audit_shadow-sessions_get", "description": "Get full details + action feed of a shadow-mode session.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sessionId": { "type": "string" } }, "required": [ "workspaceId", "sessionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.shadow-sessions.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "session": { "type": "object", "properties": { "sessionId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "accountId": { "type": "string" }, "operatorDid": { "type": [ "string", "null" ] }, "origin": { "type": "string", "const": "operator_shadow" }, "costCenterId": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastUsedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revokeReason": { "type": [ "string", "null" ] }, "ipAddress": { "type": [ "string", "null" ] }, "userAgent": { "type": [ "string", "null" ] } }, "required": [ "sessionId", "workspaceId", "accountId", "operatorDid", "origin", "costCenterId", "createdAt", "expiresAt", "lastUsedAt", "revokedAt", "revokeReason", "ipAddress", "userAgent" ], "additionalProperties": {} }, "actions": { "type": "array", "items": {} } }, "required": [ "session", "actions" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "sessionId": "shadow_abc" }, "output": { "session": { "sessionId": "shadow_abc", "workspaceId": "ws_demo_default", "accountId": "acct_demo00000000000000000000", "operatorDid": "did:web:agined.com:operators:ops_demo", "origin": "support-console", "costCenterId": null, "createdAt": "2026-05-22T12:00:00.000Z", "expiresAt": "2026-05-22T14:00:00.000Z", "lastUsedAt": "2026-05-22T12:31:00.000Z", "revokedAt": null, "revokeReason": null, "ipAddress": "203.0.113.7", "userAgent": "Mozilla/5.0" }, "actions": [] }, "note": "Inspect a shadow session." } ] }, { "name": "audit_aggregate", "description": "Group + count audit entries by a dimension (kind, transport, outcome, agentClientId).", "function_declarations": [ { "name": "audit_aggregate", "description": "Group + count audit entries by a dimension (kind, transport, outcome, agentClientId).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "by": { "type": "string", "enum": [ "kind", "transport", "outcome", "agentClientId" ] }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId", "by" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.aggregate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "buckets": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "key", "count" ], "additionalProperties": false } } }, "required": [ "buckets" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "by": "transport" }, "output": { "buckets": [ { "key": "rest", "count": 1234 }, { "key": "mcp", "count": 567 } ] }, "note": "Group by transport." } ] }, { "name": "audit_kinds_list", "description": "List all audit-kind discriminator values supported by the platform.", "function_declarations": [ { "name": "audit_kinds_list", "description": "List all audit-kind discriminator values supported by the platform.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.kinds.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kinds": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "category": { "type": "string" }, "description": { "type": "string" } }, "required": [ "id", "category", "description" ], "additionalProperties": false } } }, "required": [ "kinds" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "kinds": [ { "id": "workspace.created", "category": "workspace", "description": "A new workspace was created." } ] }, "note": "Discover audit kinds." } ] }, { "name": "audit_export_scoped", "description": "Request a scoped CSV/JSON export of audit entries matching filters. Returns a download URL when ready (signed, time-bounded).", "function_declarations": [ { "name": "audit_export_scoped", "description": "Request a scoped CSV/JSON export of audit entries matching filters. Returns a download URL when ready (signed, time-bounded).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "source": { "type": "string", "enum": [ "all", "tops", "audit_log" ] }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kinds": { "type": "array", "items": { "type": "string" } }, "format": { "default": "json", "type": "string", "enum": [ "csv", "json", "compliance-bundle" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.export.scoped" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "status": { "type": "string", "enum": [ "queued", "running", "ready" ] } }, "required": [ "exportId", "status" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "export.requested", "examples": [ { "input": { "workspaceId": "ws_demo_default", "format": "compliance-bundle" }, "output": { "exportId": "exp_abc", "status": "queued" }, "note": "Queue a compliance-bundle export." } ] }, { "name": "audit_outside-access_list", "description": "List entries representing access from outside the workspace's normal principals (admin reads, side-car reads, share-url access).", "function_declarations": [ { "name": "audit_outside-access_list", "description": "List entries representing access from outside the workspace's normal principals (admin reads, side-car reads, share-url access).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.outside-access.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^aud_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "timestamp": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string" }, "actorAccountId": { "type": "string" }, "transport": { "type": "string", "enum": [ "rest", "mcp", "mcp_apps", "chatgpt_app", "gemini", "perplexity", "claude_cowork", "a2a", "claude_skill", "nlweb", "dashboard", "sidecar", "service_to_service" ] }, "agentClientId": { "type": "string" }, "promptExcerpt": { "type": "string", "maxLength": 200 }, "confirmationTokenId": { "type": "string" }, "governance": { "type": "object", "properties": { "refusedBy": { "type": "string" }, "charterEnforced": { "type": "boolean" }, "charterSha256": { "type": "string" }, "conscienceEnforced": { "type": "boolean" }, "consciencePolicyVersionId": { "type": "string" }, "cordonPosture": { "type": "string", "enum": [ "off", "flag", "block" ] }, "cordonFlaggedRuleId": { "type": "string" } }, "additionalProperties": false }, "delegationChainDepth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "outcome": { "type": "string", "enum": [ "success", "denied", "failed", "partial" ] }, "inputHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "storageTier": { "type": "string", "enum": [ "r2_standard", "r2_ia", "glacier_deep_archive" ] } }, "required": [ "id", "workspaceId", "timestamp", "kind", "outcome" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "entries", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "entries": [], "nextCursor": null }, "note": "See every external touch on this workspace." } ] }, { "name": "audit_stream_list", "description": "List the workspace's SIEM/S3 audit-stream destinations (Splunk HEC / Datadog / webhook / S3), with sealed credentials masked.", "function_declarations": [ { "name": "audit_stream_list", "description": "List the workspace's SIEM/S3 audit-stream destinations (Splunk HEC / Datadog / webhook / S3), with sealed credentials masked.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.stream.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "destinations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "splunk_hec", "datadog", "webhook", "s3" ] }, "displayName": { "type": "string" }, "enabled": { "type": "boolean" }, "endpoint": { "type": [ "string", "null" ] }, "datadogSite": { "type": [ "string", "null" ] }, "splunkIndex": { "type": [ "string", "null" ] }, "splunkSourcetype": { "type": [ "string", "null" ] }, "datadogService": { "type": [ "string", "null" ] }, "datadogTags": { "type": [ "string", "null" ] }, "s3Bucket": { "type": [ "string", "null" ] }, "s3Region": { "type": [ "string", "null" ] }, "s3Prefix": { "type": [ "string", "null" ] }, "s3AccessKeyId": { "type": [ "string", "null" ] }, "tokenConfigured": { "type": "boolean" }, "webhookSecretConfigured": { "type": "boolean" }, "cursorChainSeq": { "type": "number" }, "healthy": { "type": "boolean" }, "consecutiveFailures": { "type": "number" }, "lastSuccessAt": { "type": [ "string", "null" ] }, "lastError": { "type": [ "string", "null" ] }, "updatedAt": { "type": "string" } }, "required": [ "id", "kind", "displayName", "enabled", "endpoint", "datadogSite", "splunkIndex", "splunkSourcetype", "datadogService", "datadogTags", "s3Bucket", "s3Region", "s3Prefix", "s3AccessKeyId", "tokenConfigured", "webhookSecretConfigured", "cursorChainSeq", "healthy", "consecutiveFailures", "lastSuccessAt", "lastError", "updatedAt" ], "additionalProperties": false } } }, "required": [ "destinations" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "destinations": [] }, "note": "List audit-stream destinations." } ] }, { "name": "audit_stream_configure", "description": "Create or update a SIEM/S3 audit-stream destination. A provided vendor token / S3 secret / webhook secret is sealed at rest.", "function_declarations": [ { "name": "audit_stream_configure", "description": "Create or update a SIEM/S3 audit-stream destination. A provided vendor token / S3 secret / webhook secret is sealed at rest.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "splunk_hec", "datadog", "webhook", "s3" ] }, "displayName": { "type": "string", "minLength": 1, "maxLength": 120 }, "enabled": { "type": "boolean" }, "endpoint": { "type": "string", "format": "uri" }, "datadogSite": { "type": "string" }, "splunkIndex": { "type": "string" }, "splunkSourcetype": { "type": "string" }, "datadogService": { "type": "string" }, "datadogTags": { "type": "string" }, "s3Bucket": { "type": "string" }, "s3Region": { "type": "string" }, "s3Prefix": { "type": "string" }, "s3AccessKeyId": { "type": "string" }, "token": { "type": "string" }, "webhookSecret": { "type": "string" }, "s3SecretAccessKey": { "type": "string" } }, "required": [ "kind", "displayName" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.stream.configure" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "destination": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "splunk_hec", "datadog", "webhook", "s3" ] }, "displayName": { "type": "string" }, "enabled": { "type": "boolean" }, "endpoint": { "type": [ "string", "null" ] }, "datadogSite": { "type": [ "string", "null" ] }, "splunkIndex": { "type": [ "string", "null" ] }, "splunkSourcetype": { "type": [ "string", "null" ] }, "datadogService": { "type": [ "string", "null" ] }, "datadogTags": { "type": [ "string", "null" ] }, "s3Bucket": { "type": [ "string", "null" ] }, "s3Region": { "type": [ "string", "null" ] }, "s3Prefix": { "type": [ "string", "null" ] }, "s3AccessKeyId": { "type": [ "string", "null" ] }, "tokenConfigured": { "type": "boolean" }, "webhookSecretConfigured": { "type": "boolean" }, "cursorChainSeq": { "type": "number" }, "healthy": { "type": "boolean" }, "consecutiveFailures": { "type": "number" }, "lastSuccessAt": { "type": [ "string", "null" ] }, "lastError": { "type": [ "string", "null" ] }, "updatedAt": { "type": "string" } }, "required": [ "id", "kind", "displayName", "enabled", "endpoint", "datadogSite", "splunkIndex", "splunkSourcetype", "datadogService", "datadogTags", "s3Bucket", "s3Region", "s3Prefix", "s3AccessKeyId", "tokenConfigured", "webhookSecretConfigured", "cursorChainSeq", "healthy", "consecutiveFailures", "lastSuccessAt", "lastError", "updatedAt" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "destination" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "default", "audit_kind": "audit.stream.configured", "examples": [ { "input": { "kind": "splunk_hec", "displayName": "SOC Splunk", "endpoint": "https://http-inputs.splunkcloud.com", "token": "hec-…" }, "output": { "destination": null }, "note": "Add a Splunk HEC destination." } ] }, { "name": "audit_stream_delete", "description": "Delete an audit-stream destination by id (workspace-scoped).", "function_declarations": [ { "name": "audit_stream_delete", "description": "Delete an audit-stream destination by id (workspace-scoped).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/audit.stream.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "audit.stream.configured", "examples": [ { "input": { "id": "astr_abc" }, "output": { "deleted": true }, "note": "Delete a destination." } ] }, { "name": "tops_config_get", "description": "Get the Tops config for a specific scope (org, workspace, or actor).", "function_declarations": [ { "name": "tops_config_get", "description": "Get the Tops config for a specific scope (org, workspace, or actor).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" } }, "required": [ "scope", "scopeId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedBy": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel", "updatedAt", "updatedBy" ], "additionalProperties": {} }, { "type": "null" } ] }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "scope": "workspace", "scopeId": "ws_demo_default" }, "output": { "scope": "workspace", "scopeId": "ws_demo_default", "enabled": true, "kinds": [ "admin_read", "key_issue" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "safe", "updatedAt": "2026-05-22T12:00:00.000Z", "updatedBy": "acct_demo00000000000000000000" }, "note": "Read scope config." } ] }, { "name": "tops_config_set", "description": "Set the Tops config for a scope. Forensic detail level requires explicit acknowledgement.", "function_declarations": [ { "name": "tops_config_set", "description": "Set the Tops config for a scope. Forensic detail level requires explicit acknowledgement.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "forensicAck": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedBy": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel", "updatedAt", "updatedBy" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "scope": "workspace", "scopeId": "ws_demo_default", "enabled": true, "kinds": [ "admin_read", "key_issue" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "extended" }, "output": { "scope": "workspace", "scopeId": "ws_demo_default", "enabled": true, "kinds": [ "admin_read", "key_issue" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "extended", "updatedAt": "2026-05-22T12:00:00.000Z", "updatedBy": "acct_demo00000000000000000000" }, "note": "Set scope config." } ] }, { "name": "tops_config_delete", "description": "Delete a scope-level Tops config (scope reverts to parent inheritance).", "function_declarations": [ { "name": "tops_config_delete", "description": "Delete a scope-level Tops config (scope reverts to parent inheritance).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "scope", "scopeId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "scope": "workspace", "scopeId": "ws_demo_default" }, "output": { "deleted": true }, "note": "Delete scope config." } ] }, { "name": "tops_config_list", "description": "List Tops configs (all scopes in an org or workspace).", "function_declarations": [ { "name": "tops_config_list", "description": "List Tops configs (all scopes in an org or workspace).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "configs": { "type": "array", "items": { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedBy": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel", "updatedAt", "updatedBy" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "configs", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "configs": [], "nextCursor": null }, "note": "List configs." } ] }, { "name": "tops_config_cascade_resolve", "description": "Resolve the effective Tops config at a specific (org, workspace, actor) leaf — applies the leaf-wins cascade.", "function_declarations": [ { "name": "tops_config_cascade_resolve", "description": "Resolve the effective Tops config at a specific (org, workspace, actor) leaf — applies the leaf-wins cascade.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "actorId": { "type": "string", "pattern": "^actor_[a-z0-9]{20,}$" } }, "required": [ "organizationId", "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.cascade.resolve" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "effectiveConfig": { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedBy": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel", "updatedAt", "updatedBy" ], "additionalProperties": {} }, "source": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "inheritedFields": { "type": "array", "items": { "type": "string" } } }, "required": [ "effectiveConfig", "source", "inheritedFields" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "organizationId": "org_demo00000000000000000000", "workspaceId": "ws_demo_default" }, "output": { "effectiveConfig": { "scope": "workspace", "scopeId": "ws_demo_default", "enabled": true, "kinds": [ "admin_read" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "safe", "updatedAt": "2026-05-22T12:00:00.000Z", "updatedBy": "acct_demo00000000000000000000" }, "source": "workspace", "inheritedFields": [ "environments" ] }, "note": "Resolve effective config." } ] }, { "name": "tops_config_preset_apply", "description": "Apply one of the 3 presets (Minimal / Recommended / Forensic) to a scope.", "function_declarations": [ { "name": "tops_config_preset_apply", "description": "Apply one of the 3 presets (Minimal / Recommended / Forensic) to a scope.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "presetId": { "type": "string", "enum": [ "minimal", "recommended", "forensic" ] }, "forensicAck": { "type": "string" } }, "required": [ "scope", "scopeId", "presetId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.preset.apply" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedBy": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel", "updatedAt", "updatedBy" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "scope": "workspace", "scopeId": "ws_demo_default", "presetId": "recommended" }, "output": { "scope": "workspace", "scopeId": "ws_demo_default", "enabled": true, "kinds": [ "ingest", "export", "key_issue", "admin_read", "spot_decide" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "safe", "updatedAt": "2026-05-22T12:00:00.000Z", "updatedBy": "acct_demo00000000000000000000" }, "note": "Apply recommended preset." } ] }, { "name": "tops_config_presets_list", "description": "List the 3 supported presets with their config shapes + tradeoff labels.", "function_declarations": [ { "name": "tops_config_presets_list", "description": "List the 3 supported presets with their config shapes + tradeoff labels.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.presets.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "presets": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "config": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] } }, "required": [ "enabled", "kinds", "environments", "samplingPercent", "detailLevel" ], "additionalProperties": false }, "tradeoff": { "type": "string" } }, "required": [ "id", "label", "description", "config", "tradeoff" ], "additionalProperties": false } } }, "required": [ "presets" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "presets": [ { "id": "minimal", "label": "Minimal", "description": "Smallest footprint; just the essentials.", "config": { "enabled": true, "kinds": [ "ingest", "export" ], "environments": [ "production" ], "samplingPercent": 10, "detailLevel": "safe" }, "tradeoff": "May miss forensic detail in incidents." } ] }, "note": "Discover presets." } ] }, { "name": "tops_config_testbed_run", "description": "Test the cascade resolver against a synthetic actor id to preview what entries it would generate.", "function_declarations": [ { "name": "tops_config_testbed_run", "description": "Test the cascade resolver against a synthetic actor id to preview what entries it would generate.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "actorId": { "type": "string", "pattern": "^actor_[a-z0-9]{20,}$" }, "syntheticEvent": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "organizationId", "workspaceId", "actorId", "syntheticEvent" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.testbed.run" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "resolved": { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedBy": { "type": "string" } }, "required": [ "scope", "scopeId", "enabled", "kinds", "environments", "samplingPercent", "detailLevel", "updatedAt", "updatedBy" ], "additionalProperties": {} }, "wouldRecord": { "type": "boolean" }, "wouldRecordFields": { "type": "array", "items": { "type": "string" } } }, "required": [ "resolved", "wouldRecord", "wouldRecordFields" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "organizationId": "org_demo00000000000000000000", "workspaceId": "ws_demo_default", "actorId": "actor_demo00000000000000000000", "syntheticEvent": { "kind": "admin_read" } }, "output": { "resolved": { "scope": "workspace", "scopeId": "ws_demo_default", "enabled": true, "kinds": [ "admin_read" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "safe", "updatedAt": "2026-05-22T12:00:00.000Z", "updatedBy": "acct_demo00000000000000000000" }, "wouldRecord": true, "wouldRecordFields": [ "kind", "timestamp" ] }, "note": "Test cascade." } ] }, { "name": "tops_config_change-history_list", "description": "List Tops-config change events (audit cross-link).", "function_declarations": [ { "name": "tops_config_change-history_list", "description": "List Tops-config change events (audit cross-link).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.change-history.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "changes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" }, "changedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "change": { "anyOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "set", "preset.apply", "delete" ] }, "before": { "anyOf": [ { "type": "object", "properties": { "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] } }, "required": [ "enabled", "kinds", "environments", "samplingPercent", "detailLevel" ], "additionalProperties": false }, { "type": "null" } ] }, "after": { "anyOf": [ { "type": "object", "properties": { "enabled": { "type": "boolean" }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "ingest", "export", "key_issue", "admin_read", "chat_query", "webhook_delivered", "notary_anchor", "ledger_bundles_anchor", "cron_run", "tops_config_change", "spot_observe", "spot_decide", "spot_skip", "spot_state", "spot_drift" ] } }, "environments": { "type": "array", "items": { "type": "string" } }, "samplingPercent": { "type": "number", "minimum": 0, "maximum": 100 }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] } }, "required": [ "enabled", "kinds", "environments", "samplingPercent", "detailLevel" ], "additionalProperties": false }, { "type": "null" } ] }, "detailLevel": { "anyOf": [ { "type": "string", "enum": [ "safe", "extended", "forensic" ] }, { "type": "null" } ] }, "by": { "type": "string" } }, "required": [ "op", "before", "after", "detailLevel", "by" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "scope", "scopeId", "changedAt", "change" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "changes", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "changes": [ { "id": "0f4a2b1c-0000-4000-8000-000000000000", "scope": "workspace", "scopeId": "ws_demo_default", "changedAt": "2026-05-22T12:00:00.000Z", "change": { "op": "set", "before": { "enabled": true, "kinds": [ "admin_read" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "safe" }, "after": { "enabled": true, "kinds": [ "admin_read" ], "environments": [ "production" ], "samplingPercent": 100, "detailLevel": "forensic" }, "detailLevel": "forensic", "by": "acct_demo00000000000000000000" } } ], "nextCursor": null }, "note": "Read config change history." } ] }, { "name": "tops_config_sparkline_get", "description": "Get a 30-day sparkline of Tops detail-level changes (visualizes forensic-cooldown nudge).", "function_declarations": [ { "name": "tops_config_sparkline_get", "description": "Get a 30-day sparkline of Tops detail-level changes (visualizes forensic-cooldown nudge).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" } }, "required": [ "scope", "scopeId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.sparkline.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "detailLevel": { "type": "string", "enum": [ "safe", "extended", "forensic" ] } }, "required": [ "date", "detailLevel" ], "additionalProperties": false } } }, "required": [ "data" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "scope": "workspace", "scopeId": "ws_demo_default" }, "output": { "data": [] }, "note": "Sparkline data." } ] }, { "name": "tops_config_audit-cross-links_get", "description": "Get deep-links to the workspace audit log filtered by Tops-config-change events.", "function_declarations": [ { "name": "tops_config_audit-cross-links_get", "description": "Get deep-links to the workspace audit log filtered by Tops-config-change events.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.audit-cross-links.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "links": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "href": { "type": "string" } }, "required": [ "label", "href" ], "additionalProperties": false } } }, "required": [ "links" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "links": [ { "label": "Recent config changes", "href": "/app/audit-log?source=tops" } ] }, "note": "Audit cross-link helper." } ] }, { "name": "tops_config_cooldown-status_get", "description": "Check if a scope is in the forensic cooldown window (auto-revert nudge).", "function_declarations": [ { "name": "tops_config_cooldown-status_get", "description": "Check if a scope is in the forensic cooldown window (auto-revert nudge).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "type": "string", "enum": [ "org", "workspace", "actor" ] }, "scopeId": { "type": "string" } }, "required": [ "scope", "scopeId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.config.cooldown-status.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "inCooldown": { "type": "boolean" }, "enteredAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "inCooldown", "enteredAt", "expiresAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "scope": "workspace", "scopeId": "ws_demo_default" }, "output": { "inCooldown": false, "enteredAt": null, "expiresAt": null }, "note": "Read cooldown state." } ] }, { "name": "tops_specimen_get", "description": "Read this workspace's public trust page settings. `null` when nothing has ever been published.", "function_declarations": [ { "name": "tops_specimen_get", "description": "Read this workspace's public trust page settings. `null` when nothing has ever been published.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.specimen.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "page": { "anyOf": [ { "type": "object", "properties": { "handle": { "type": "string" }, "enabled": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "handle", "enabled", "createdAt", "updatedAt" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "page" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "page": null }, "note": "Nothing published." } ] }, { "name": "tops_specimen_set", "description": "Claim or rename the workspace's public handle, and turn the page on or off.", "function_declarations": [ { "name": "tops_specimen_set", "description": "Claim or rename the workspace's public handle, and turn the page on or off.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "handle": { "type": "string", "minLength": 2, "maxLength": 40 }, "enabled": { "type": "boolean" } }, "required": [ "handle", "enabled" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.specimen.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "page": { "type": "object", "properties": { "handle": { "type": "string" }, "enabled": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "handle", "enabled", "createdAt", "updatedAt" ], "additionalProperties": false } }, "required": [ "page" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "handle": "acme", "enabled": false }, "output": { "page": { "handle": "acme", "enabled": false, "createdAt": "2026-09-03T00:00:00.000Z", "updatedAt": "2026-09-03T00:00:00.000Z" } }, "note": "Claim the handle without publishing yet." } ] }, { "name": "tops_specimen_delete", "description": "Take the public page down and RELEASE the handle for anyone else to claim.", "function_declarations": [ { "name": "tops_specimen_delete", "description": "Take the public page down and RELEASE the handle for anyone else to claim.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/tops.specimen.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": {}, "output": { "deleted": true }, "note": "Unpublish." } ] }, { "name": "referrals_code_get", "description": "Get your active referral code + share URL.", "function_declarations": [ { "name": "referrals_code_get", "description": "Get your active referral code + share URL.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.code.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "code": { "type": "string", "pattern": "^[A-Z0-9]{6,16}$" }, "shareUrl": { "type": "string", "format": "uri" }, "qrCodeDataUrl": { "type": "string" }, "shareMessage": { "type": [ "string", "null" ] } }, "required": [ "code", "shareUrl", "qrCodeDataUrl", "shareMessage" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "code": "DEMO12", "shareUrl": "https://agined.com/?ref=DEMO12", "qrCodeDataUrl": "data:image/png;base64,...", "shareMessage": null }, "note": "Read your referral code." } ] }, { "name": "referrals_code_regenerate", "description": "Regenerate referral code. Old code stops working.", "function_declarations": [ { "name": "referrals_code_regenerate", "description": "Regenerate referral code. Old code stops working.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.code.regenerate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "code": { "type": "string", "pattern": "^[A-Z0-9]{6,16}$" } }, "required": [ "code" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "code": "NEWCODE99" }, "note": "Get a fresh referral code." } ] }, { "name": "referrals_share-message_set", "description": "Set the message shared alongside your referral link.", "function_declarations": [ { "name": "referrals_share-message_set", "description": "Set the message shared alongside your referral link.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "message": { "type": "string", "maxLength": 1000 } }, "required": [ "message" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.share-message.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "message": "I use Agined to run my agents — sign up with my link." }, "output": { "message": "I use Agined to run my agents — sign up with my link." }, "note": "Replace your share message." } ] }, { "name": "referrals_share_record", "description": "Record that you shared your referral link, and where.", "function_declarations": [ { "name": "referrals_share_record", "description": "Record that you shared your referral link, and where.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "channel": { "type": "string", "enum": [ "url", "email", "qr", "voucher_gift", "x", "linkedin", "whatsapp", "telegram", "slack", "copy", "other" ] } }, "required": [ "channel" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.share.record" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "recorded": { "type": "boolean", "const": true }, "channel": { "type": "string", "enum": [ "url", "email", "qr", "voucher_gift", "x", "linkedin", "whatsapp", "telegram", "slack", "copy", "other" ] } }, "required": [ "recorded", "channel" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "channel": "slack" }, "output": { "recorded": true, "channel": "slack" }, "note": "Record a share to Slack." } ] }, { "name": "referrals_list-sent", "description": "List referrals you have sent.", "function_declarations": [ { "name": "referrals_list-sent", "description": "List referrals you have sent.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "status": { "type": "string", "enum": [ "sent", "joined", "redeemed", "expired" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.list-sent" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "referrals": { "type": "array", "items": { "type": "object", "properties": { "referralId": { "type": "string" }, "code": { "type": "string", "pattern": "^[A-Z0-9]{6,16}$" }, "status": { "type": "string", "enum": [ "sent", "joined", "redeemed", "expired" ] }, "recipientEmailHash": { "type": "string" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "redeemedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "rewardPoints": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "referralId", "code", "status", "sentAt", "redeemedAt", "rewardPoints" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "referrals", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "referrals": [], "nextCursor": null }, "note": "List sent referrals." } ] }, { "name": "referrals_list-received", "description": "List referrals where you were the referee.", "function_declarations": [ { "name": "referrals_list-received", "description": "List referrals where you were the referee.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.list-received" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "referrals": { "type": "array", "items": { "type": "object", "properties": { "referralId": { "type": "string" }, "code": { "type": "string", "pattern": "^[A-Z0-9]{6,16}$" }, "status": { "type": "string", "enum": [ "sent", "joined", "redeemed", "expired" ] }, "recipientEmailHash": { "type": "string" }, "sentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "redeemedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "rewardPoints": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "referralId", "code", "status", "sentAt", "redeemedAt", "rewardPoints" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "referrals", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "referrals": [], "nextCursor": null }, "note": "List received referrals." } ] }, { "name": "referrals_balance_get", "description": "Get your current point balance + lifetime multiplier tier.", "function_declarations": [ { "name": "referrals_balance_get", "description": "Get your current point balance + lifetime multiplier tier.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.balance.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pointBalance": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lifetimeMultiplier": { "type": "number", "minimum": 1, "maximum": 2 }, "nextMultiplierAt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "pointBalance", "lifetimeMultiplier", "nextMultiplierAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "pointBalance": 1500, "lifetimeMultiplier": 1.2, "nextMultiplierAt": 2500 }, "note": "Read point balance." } ] }, { "name": "referrals_funnel_get", "description": "Get conversion funnel analytics (sent → clicked → joined → redeemed).", "function_declarations": [ { "name": "referrals_funnel_get", "description": "Get conversion funnel analytics (sent → clicked → joined → redeemed).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.funnel.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sent": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "clicked": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "joined": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "redeemed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "joinRate": { "type": [ "number", "null" ] }, "redeemRate": { "type": [ "number", "null" ] }, "channelBreakdown": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string", "enum": [ "url", "email", "qr", "voucher_gift", "x", "linkedin", "whatsapp", "telegram", "slack", "copy", "other" ] }, "sent": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "clicked": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "channel", "sent", "clicked" ], "additionalProperties": false } } }, "required": [ "sent", "clicked", "joined", "redeemed", "joinRate", "redeemRate", "channelBreakdown" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "sent": 50, "clicked": 30, "joined": 12, "redeemed": 8, "joinRate": 0.4, "redeemRate": 0.6667, "channelBreakdown": [ { "channel": "slack", "sent": 30, "clicked": 20 } ] }, "note": "Read funnel." } ] }, { "name": "referrals_redeem", "description": "Redeem a referral or voucher code.", "function_declarations": [ { "name": "referrals_redeem", "description": "Redeem a referral or voucher code.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "code": { "type": "string", "minLength": 6, "maxLength": 20 } }, "required": [ "code" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.redeem" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "redeemed": { "type": "boolean" }, "rewardKind": { "type": "string" }, "rewardValue": {} }, "required": [ "redeemed", "rewardKind", "rewardValue" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "code": "DEMO12" }, "output": { "redeemed": true, "rewardKind": "points", "rewardValue": 1000 }, "note": "Redeem a code." } ] }, { "name": "referrals_spend", "description": "Spend points on a reward (run pack, add-on credit, Every.org charity, etc.).", "function_declarations": [ { "name": "referrals_spend", "description": "Spend points on a reward (run pack, add-on credit, Every.org charity, etc.).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "product": { "type": "string" }, "pointAmount": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "metadata": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "product", "pointAmount" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.spend" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "spentAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "transactionId": { "type": "string" }, "remainingBalance": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "spentAt", "transactionId", "remainingBalance" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "product": "every-org-charity", "pointAmount": 200, "metadata": { "charityId": "every:childrens-hospital" } }, "output": { "spentAt": "2026-05-22T12:00:00.000Z", "transactionId": "tx_abc", "remainingBalance": 1300 }, "note": "Donate to charity." } ] }, { "name": "referrals_spend-products_list", "description": "List the products you can redeem points against.", "function_declarations": [ { "name": "referrals_spend-products_list", "description": "List the products you can redeem points against.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.spend-products.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "pointCost": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "description": { "type": "string" } }, "required": [ "id", "label", "pointCost", "description" ], "additionalProperties": false } } }, "required": [ "products" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "products": [ { "id": "every-org-charity", "label": "Charity donation via Every.org", "pointCost": 1, "description": "Donate to any Every.org charity at the cents-per-point rate." } ] }, "note": "Discover spend products." } ] }, { "name": "referrals_ledger_list", "description": "List point transactions (earned + spent).", "function_declarations": [ { "name": "referrals_ledger_list", "description": "List point transactions (earned + spent).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/referrals.ledger.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "transactions": { "type": "array", "items": { "type": "object", "properties": { "ts": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "kind": { "type": "string", "enum": [ "earned", "spent", "expired", "adjustment" ] }, "amount": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "description": { "type": "string" } }, "required": [ "ts", "kind", "amount", "description" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "transactions", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "transactions": [], "nextCursor": null }, "note": "Read point ledger." } ] }, { "name": "number_one_conversation_create", "description": "Start a new Number One conversation.", "function_declarations": [ { "name": "number_one_conversation_create", "description": "Start a new Number One conversation.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 80 } }, "required": [ "workspaceId", "mode" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.conversation.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 80 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastActivityAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "messageCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "preview": { "type": "string" } }, "required": [ "conversationId", "workspaceId", "mode", "startedAt", "lastActivityAt", "messageCount" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "mode": "analyst", "title": "Q3 audit review" }, "output": { "conversationId": "conv_demo0000000000A", "workspaceId": "ws_demo_default", "mode": "analyst", "title": "Q3 audit review", "startedAt": "2026-05-22T12:00:00.000Z", "lastActivityAt": "2026-05-22T12:00:00.000Z", "messageCount": 0, "preview": "" }, "note": "Start a new conversation." } ] }, { "name": "number_one_conversation_list", "description": "List your conversations (most recent first).", "function_declarations": [ { "name": "number_one_conversation_list", "description": "List your conversations (most recent first).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.conversation.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "conversations": { "type": "array", "items": { "type": "object", "properties": { "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 80 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastActivityAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "messageCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "preview": { "type": "string" } }, "required": [ "conversationId", "workspaceId", "mode", "startedAt", "lastActivityAt", "messageCount" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "conversations", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "conversations": [], "nextCursor": null }, "note": "List conversations." } ] }, { "name": "number_one_conversation_get", "description": "Get a conversation's metadata + recent messages.", "function_declarations": [ { "name": "number_one_conversation_get", "description": "Get a conversation's metadata + recent messages.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "messageLimit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "workspaceId", "conversationId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.conversation.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "conversation": { "type": "object", "properties": { "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 80 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastActivityAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "messageCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "preview": { "type": "string" } }, "required": [ "conversationId", "workspaceId", "mode", "startedAt", "lastActivityAt", "messageCount" ], "additionalProperties": {} }, "messages": { "type": "array", "items": { "type": "object", "properties": { "messageId": { "type": "string", "pattern": "^no_mem_[A-Za-z0-9_-]{8,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "role": { "type": "string", "enum": [ "user", "assistant", "system" ] }, "body": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "mode": { "type": "string" }, "erased": { "type": "boolean" }, "contentOrigin": { "type": [ "string", "null" ] }, "trace": {} }, "required": [ "messageId", "conversationId", "role", "body", "createdAt" ], "additionalProperties": {} } } }, "required": [ "conversation", "messages" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "conversationId": "conv_demo0000000000A" }, "output": { "conversation": { "conversationId": "conv_demo0000000000A", "workspaceId": "ws_demo_default", "mode": "analyst", "title": "Q3 audit review", "startedAt": "2026-05-22T12:00:00.000Z", "lastActivityAt": "2026-05-22T12:00:00.000Z", "messageCount": 0, "preview": "" }, "messages": [] }, "note": "Read a conversation." } ] }, { "name": "number_one_conversation_delete", "description": "Delete a conversation. Memory facts attached to it survive but lose conversation context.", "function_declarations": [ { "name": "number_one_conversation_delete", "description": "Delete a conversation. Memory facts attached to it survive but lose conversation context.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "conversationId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.conversation.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "conversationId": "conv_demo0000000000A" }, "output": { "deleted": true }, "note": "Delete a conversation." } ] }, { "name": "number_one_message_send", "description": "Send a user message in a Number One conversation. Returns the full buffered assistant turn.", "function_declarations": [ { "name": "number_one_message_send", "description": "Send a user message in a Number One conversation. Returns the full buffered assistant turn.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "body": { "type": "string", "minLength": 1, "maxLength": 50000 } }, "required": [ "workspaceId", "conversationId", "body" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.message.send" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "assistantMessageId": { "anyOf": [ { "type": "string", "pattern": "^no_mem_[A-Za-z0-9_-]{8,}$" }, { "type": "null" } ] }, "decision": { "type": "string", "enum": [ "calculator", "analyst", "admin", "off_limits" ] }, "assistantBody": { "type": "string" }, "contentOrigin": { "type": [ "string", "null" ] }, "marking": {}, "quotaCostUnits": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "classification": {}, "memory": { "type": "object", "properties": { "usedBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "capBytes": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "infinite": { "type": "boolean" }, "capExceeded": { "type": "boolean" } }, "required": [ "usedBytes", "capBytes", "infinite" ], "additionalProperties": {} }, "confirmationRequired": { "type": "boolean" }, "actionId": { "type": "string" } }, "required": [ "sessionId", "assistantMessageId", "decision", "assistantBody", "contentOrigin", "quotaCostUnits" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "conversationId": "conv_demo0000000000A", "body": "What was my Tools usage last week?" }, "output": { "sessionId": "conv_demo0000000000A", "assistantMessageId": "no_mem_demo0000000000A", "decision": "calculator", "assistantBody": "Your workspace ran 42 checks last week.", "contentOrigin": "computed", "quotaCostUnits": 1, "memory": { "usedBytes": 529, "capBytes": 52428800, "infinite": false, "capExceeded": false } }, "note": "Send a message." } ] }, { "name": "number_one_message_list", "description": "List messages in a conversation.", "function_declarations": [ { "name": "number_one_message_list", "description": "List messages in a conversation.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" } }, "required": [ "workspaceId", "conversationId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.message.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "messages": { "type": "array", "items": { "type": "object", "properties": { "messageId": { "type": "string", "pattern": "^no_mem_[A-Za-z0-9_-]{8,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "role": { "type": "string", "enum": [ "user", "assistant", "system" ] }, "body": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "mode": { "type": "string" }, "erased": { "type": "boolean" }, "contentOrigin": { "type": [ "string", "null" ] }, "trace": {} }, "required": [ "messageId", "conversationId", "role", "body", "createdAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "messages", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "conversationId": "conv_demo0000000000A" }, "output": { "messages": [], "nextCursor": null }, "note": "List messages." } ] }, { "name": "number_one_mode_set", "description": "Switch a conversation's mode (Calculator / Analyst / Admin).", "function_declarations": [ { "name": "number_one_mode_set", "description": "Switch a conversation's mode (Calculator / Analyst / Admin).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] } }, "required": [ "workspaceId", "conversationId", "mode" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.mode.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "calculator", "analyst", "admin" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 80 }, "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastActivityAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "messageCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "preview": { "type": "string" } }, "required": [ "conversationId", "workspaceId", "mode", "startedAt", "lastActivityAt", "messageCount" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "conversationId": "conv_demo0000000000A", "mode": "admin" }, "output": { "conversationId": "conv_demo0000000000A", "workspaceId": "ws_demo_default", "mode": "admin", "title": "Q3 audit review", "startedAt": "2026-05-22T12:00:00.000Z", "lastActivityAt": "2026-05-22T12:00:00.000Z", "messageCount": 5, "preview": "Done — 3 monitors active." }, "note": "Switch to Admin mode (requires step-up auth)." } ] }, { "name": "number_one_memory_list", "description": "List memory facts pinned in a workspace.", "function_declarations": [ { "name": "number_one_memory_list", "description": "List memory facts pinned in a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "pinnedOnly": { "default": false, "type": "boolean" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.memory.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "facts": { "type": "array", "items": { "type": "object", "properties": { "factId": { "type": "string", "pattern": "^fact_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "text": { "type": "string" }, "pinned": { "type": "boolean" }, "learnedFrom": { "type": "string" }, "learnedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "reinforcedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "conversationId": { "type": [ "string", "null" ] } }, "required": [ "factId", "workspaceId", "text", "pinned", "learnedFrom", "learnedAt", "reinforcedAt", "conversationId" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "facts", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "facts": [], "nextCursor": null }, "note": "List memory facts." } ] }, { "name": "number_one_memory_pin", "description": "Pin a memory fact so Number One reliably recalls it across conversations. Pass factId to re-pin an existing fact, or text (optionally with conversationId provenance) to create + pin a new one.", "function_declarations": [ { "name": "number_one_memory_pin", "description": "Pin a memory fact so Number One reliably recalls it across conversations. Pass factId to re-pin an existing fact, or text (optionally with conversationId provenance) to create + pin a new one.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "factId": { "type": "string", "pattern": "^fact_[A-Za-z0-9_-]{8,}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "conversationId": { "type": "string", "pattern": "^(conv|sess)_[A-Za-z0-9_-]{8,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.memory.pin" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "factId": { "type": "string", "pattern": "^fact_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "text": { "type": "string" }, "pinned": { "type": "boolean" }, "learnedFrom": { "type": "string" }, "learnedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "reinforcedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "conversationId": { "type": [ "string", "null" ] } }, "required": [ "factId", "workspaceId", "text", "pinned", "learnedFrom", "learnedAt", "reinforcedAt", "conversationId" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "factId": "fact_demo0000000000A" }, "output": { "factId": "fact_demo0000000000A", "workspaceId": "ws_demo_default", "text": "Q3 audit is led by Foo & Co LLP", "pinned": true, "learnedFrom": "user", "learnedAt": "2026-05-22T12:00:00.000Z", "reinforcedAt": "2026-05-23T09:00:00.000Z", "conversationId": null }, "note": "Re-pin an existing fact." }, { "input": { "workspaceId": "ws_demo_default", "text": "Q3 audit is led by Foo & Co LLP", "conversationId": "conv_demo0000000000A" }, "output": { "factId": "fact_demo0000000000B", "workspaceId": "ws_demo_default", "text": "Q3 audit is led by Foo & Co LLP", "pinned": true, "learnedFrom": "user", "learnedAt": "2026-05-22T12:00:00.000Z", "reinforcedAt": null, "conversationId": "conv_demo0000000000A" }, "note": "Create + pin a new fact." } ] }, { "name": "number_one_memory_unpin", "description": "Unpin a memory fact.", "function_declarations": [ { "name": "number_one_memory_unpin", "description": "Unpin a memory fact.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "factId": { "type": "string", "pattern": "^fact_[A-Za-z0-9_-]{8,}$" } }, "required": [ "workspaceId", "factId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.memory.unpin" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "factId": { "type": "string", "pattern": "^fact_[A-Za-z0-9_-]{8,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "text": { "type": "string" }, "pinned": { "type": "boolean" }, "learnedFrom": { "type": "string" }, "learnedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "reinforcedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "conversationId": { "type": [ "string", "null" ] } }, "required": [ "factId", "workspaceId", "text", "pinned", "learnedFrom", "learnedAt", "reinforcedAt", "conversationId" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "factId": "fact_demo0000000000A" }, "output": { "factId": "fact_demo0000000000A", "workspaceId": "ws_demo_default", "text": "Q3 audit is led by Foo & Co LLP", "pinned": false, "learnedFrom": "user", "learnedAt": "2026-05-22T12:00:00.000Z", "reinforcedAt": null, "conversationId": null }, "note": "Unpin." } ] }, { "name": "number_one_memory_erase", "description": "Permanently erase a memory-ledger turn's content (ADR-014 marker — the redaction cannot be undone). memoryId is a message id from message.list; pinned facts are managed via memory.unpin instead.", "function_declarations": [ { "name": "number_one_memory_erase", "description": "Permanently erase a memory-ledger turn's content (ADR-014 marker — the redaction cannot be undone). memoryId is a message id from message.list; pinned facts are managed via memory.unpin instead.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "memoryId": { "type": "string", "pattern": "^no_mem_[A-Za-z0-9_-]{8,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "memoryId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.memory.erase" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "erased": { "type": "boolean" } }, "required": [ "erased" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "memoryId": "no_mem_demo0000000000A" }, "output": { "erased": true }, "note": "Erase a remembered turn's content." } ] }, { "name": "number_one_memory_cap_get", "description": "Get the workspace's memory usage + cap. The ledger is byte-capped (Z-07); capBytes is -1 when the Infinite Memory add-on is active.", "function_declarations": [ { "name": "number_one_memory_cap_get", "description": "Get the workspace's memory usage + cap. The ledger is byte-capped (Z-07); capBytes is -1 when the Infinite Memory add-on is active.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.memory.cap.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "usedBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "capBytes": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "number", "const": -1 } ] }, "infinite": { "type": "boolean" } }, "required": [ "usedBytes", "capBytes", "infinite" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "usedBytes": 529, "capBytes": 52428800, "infinite": false }, "note": "Read memory usage + cap." } ] }, { "name": "number_one_llm-billing_get", "description": "Read whether this workspace's Number One calls run on Agined's LLM key (metered) or on its own provider key (BYOK, not metered).", "function_declarations": [ { "name": "number_one_llm-billing_get", "description": "Read whether this workspace's Number One calls run on Agined's LLM key (metered) or on its own provider key (BYOK, not metered).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.llm-billing.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mode": { "type": "string", "enum": [ "agined_billed", "byok" ] }, "keyAvailable": { "type": "boolean" }, "metered": { "type": "boolean" } }, "required": [ "mode", "keyAvailable", "metered" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "mode": "agined_billed", "keyAvailable": false, "metered": true }, "note": "Read the billing posture." } ] }, { "name": "number_one_llm-billing_set", "description": "Choose whether this workspace's Number One calls run on Agined's LLM key (metered) or on its own provider key (BYOK, not metered).", "function_declarations": [ { "name": "number_one_llm-billing_set", "description": "Choose whether this workspace's Number One calls run on Agined's LLM key (metered) or on its own provider key (BYOK, not metered).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "mode": { "type": "string", "enum": [ "agined_billed", "byok" ] } }, "required": [ "workspaceId", "mode" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.llm-billing.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mode": { "type": "string", "enum": [ "agined_billed", "byok" ] }, "keyAvailable": { "type": "boolean" }, "metered": { "type": "boolean" } }, "required": [ "mode", "keyAvailable", "metered" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "mode": "byok" }, "output": { "mode": "byok", "keyAvailable": true, "metered": false }, "note": "Run on our own key." } ] }, { "name": "number_one_analyst_get", "description": "Read whether Analyst mode is enabled for this workspace.", "function_declarations": [ { "name": "number_one_analyst_get", "description": "Read whether Analyst mode is enabled for this workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.analyst.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "enabled": true }, "note": "Is Analyst on?" } ] }, { "name": "number_one_analyst_set", "description": "Turn Analyst mode on or off for everyone in this workspace.", "function_declarations": [ { "name": "number_one_analyst_set", "description": "Turn Analyst mode on or off for everyone in this workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "enabled": { "type": "boolean" } }, "required": [ "workspaceId", "enabled" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.analyst.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "enabled": false }, "output": { "enabled": false }, "note": "Disable Analyst for the workspace." } ] }, { "name": "number_one_assistant-posture_get", "description": "Read which posture the assistant runs in for this workspace — membrane-protected, in-boundary or off — and which model provider its calls go to.", "function_declarations": [ { "name": "number_one_assistant-posture_get", "description": "Read which posture the assistant runs in for this workspace — membrane-protected, in-boundary or off — and which model provider its calls go to.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.assistant-posture.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "posture": { "type": "string", "enum": [ "membrane-protected", "in-boundary", "off" ] }, "provider": { "anyOf": [ { "type": "string", "enum": [ "anthropic", "openai", "google", "mistral" ] }, { "type": "null" } ] }, "membraneKeyConfigured": { "type": "boolean" }, "inBoundaryConfigured": { "type": "boolean" } }, "required": [ "posture", "provider", "membraneKeyConfigured", "inBoundaryConfigured" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "posture": "membrane-protected", "provider": null, "membraneKeyConfigured": true, "inBoundaryConfigured": false }, "note": "Read the assistant posture." } ] }, { "name": "number_one_assistant-posture_set", "description": "Choose the assistant's posture for this workspace, and which model provider its calls go to.", "function_declarations": [ { "name": "number_one_assistant-posture_set", "description": "Choose the assistant's posture for this workspace, and which model provider its calls go to.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "posture": { "type": "string", "enum": [ "membrane-protected", "in-boundary", "off" ] }, "provider": { "anyOf": [ { "type": "string", "enum": [ "anthropic", "openai", "google", "mistral" ] }, { "type": "null" } ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/number_one.assistant-posture.set" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "posture": { "type": "string", "enum": [ "membrane-protected", "in-boundary", "off" ] }, "provider": { "anyOf": [ { "type": "string", "enum": [ "anthropic", "openai", "google", "mistral" ] }, { "type": "null" } ] }, "membraneKeyConfigured": { "type": "boolean" }, "inBoundaryConfigured": { "type": "boolean" } }, "required": [ "posture", "provider", "membraneKeyConfigured", "inBoundaryConfigured" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "posture": "off" }, "output": { "posture": "off", "provider": null, "membraneKeyConfigured": true, "inBoundaryConfigured": false }, "note": "Disable the assistant workspace-wide." } ] }, { "name": "attestor_attest_agent-call", "description": "Issue an Attestor receipt for an agent.call primitive (outbound API call by a customer's agent).", "function_declarations": [ { "name": "attestor_attest_agent-call", "description": "Issue an Attestor receipt for an agent.call primitive (outbound API call by a customer's agent).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "destination": { "type": "string", "format": "uri" }, "method": { "type": "string" }, "requestBodySha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "responseBodySha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "responseStatus": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "durationMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "agentId": { "type": "string" }, "purpose": { "type": "string" } }, "required": [ "workspaceId", "destination", "method", "requestBodySha256", "responseBodySha256", "responseStatus", "durationMs", "agentId", "purpose" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.attest.agent-call" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "destination": "https://api.stripe.com/v1/charges", "method": "POST", "requestBodySha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd", "responseBodySha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890abce", "responseStatus": 200, "durationMs": 387, "agentId": "billing-bot", "purpose": "refund_processing" }, "output": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV2", "workspaceId": "ws_demo_default", "kind": "agent.call", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} }, "note": "Attest an agent call." } ] }, { "name": "attestor_attest_content", "description": "Attest a content blob (text, image hash, document). Returns a signed receipt.", "function_declarations": [ { "name": "attestor_attest_content", "description": "Attest a content blob (text, image hash, document). Returns a signed receipt.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "contentSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "contentType": { "type": "string" }, "policyId": { "type": "string" }, "purpose": { "type": "string" } }, "required": [ "workspaceId", "contentSha256", "contentType", "purpose" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.attest.content" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "contentSha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd", "contentType": "text/plain", "purpose": "marketing_copy_approval" }, "output": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV3", "workspaceId": "ws_demo_default", "kind": "content.attest", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} }, "note": "Attest content." } ] }, { "name": "attestor_attest_llm", "description": "Attest an LLM inference (model + prompt hash + response hash + provider).", "function_declarations": [ { "name": "attestor_attest_llm", "description": "Attest an LLM inference (model + prompt hash + response hash + provider).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "modelId": { "type": "string" }, "providerId": { "type": "string" }, "promptSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "responseSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "latencyMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "promptTokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "completionTokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "workspaceId", "modelId", "providerId", "promptSha256", "responseSha256", "latencyMs", "promptTokens", "completionTokens" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.attest.llm" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "modelId": "claude-opus-4.7", "providerId": "anthropic", "promptSha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd", "responseSha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890abce", "latencyMs": 1500, "promptTokens": 1200, "completionTokens": 850 }, "output": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV4", "workspaceId": "ws_demo_default", "kind": "llm.attest", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} }, "note": "Attest LLM call." } ] }, { "name": "attestor_attest_commit", "description": "Attest a Git commit (commit hash + author + repo URL). Pairs with the @attestor/attest-commit GitHub Action.", "function_declarations": [ { "name": "attestor_attest_commit", "description": "Attest a Git commit (commit hash + author + repo URL). Pairs with the @attestor/attest-commit GitHub Action.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "commitSha": { "type": "string" }, "repoUrl": { "type": "string", "format": "uri" }, "author": { "type": "string" }, "message": { "type": "string", "maxLength": 5000 } }, "required": [ "workspaceId", "commitSha", "repoUrl", "author", "message" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.attest.commit" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "commitSha": "abc1234567890abcdef1234567890abcdef1234567", "repoUrl": "https://github.com/example/repo", "author": "alice@example.com", "message": "Refactor billing service" }, "output": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV5", "workspaceId": "ws_demo_default", "kind": "commit.attest", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} }, "note": "Attest a Git commit." } ] }, { "name": "attestor_deliver_webhook", "description": "Issue a receipt for an outbound webhook delivery attempt.", "function_declarations": [ { "name": "attestor_deliver_webhook", "description": "Issue a receipt for an outbound webhook delivery attempt.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "webhookId": { "type": "string" }, "destination": { "type": "string", "format": "uri" }, "payloadSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "statusCode": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "attemptNumber": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "workspaceId", "webhookId", "destination", "payloadSha256", "statusCode", "attemptNumber" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.deliver.webhook" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "webhookId": "wh_abc", "destination": "https://example.com/webhook", "payloadSha256": "abcd1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd", "statusCode": 200, "attemptNumber": 1 }, "output": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV6", "workspaceId": "ws_demo_default", "kind": "webhook.deliver", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} }, "note": "Attest webhook delivery." } ] }, { "name": "attestor_monitor_http_add", "description": "Register a new HTTP monitor (1-minute minimum interval).", "function_declarations": [ { "name": "attestor_monitor_http_add", "description": "Register a new HTTP monitor (1-minute minimum interval).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "method": { "default": "GET", "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD" ] }, "intervalSeconds": { "default": 300, "type": "integer", "minimum": 30, "maximum": 86400 }, "expectedStatusCodes": { "default": [ 200 ], "type": "array", "items": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } } }, "required": [ "workspaceId", "url" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.monitor.http.add" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "monitorId": { "type": "string", "pattern": "^mon_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "method": { "default": "GET", "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD" ] }, "intervalSeconds": { "type": "integer", "minimum": 30, "maximum": 86400 }, "expectedStatusCodes": { "type": "array", "items": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "enabled": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastCheckAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastStatus": { "type": "string", "enum": [ "pass", "fail", "pending" ] } }, "required": [ "monitorId", "workspaceId", "url", "method", "intervalSeconds", "expectedStatusCodes", "enabled", "createdAt", "lastCheckAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "url": "https://api.example.com/health", "intervalSeconds": 60 }, "output": { "monitorId": "mon_demo00000000000000000000", "workspaceId": "ws_demo_default", "url": "https://api.example.com/health", "method": "GET", "intervalSeconds": 60, "expectedStatusCodes": [ 200 ], "enabled": true, "createdAt": "2026-05-22T12:00:00.000Z", "lastCheckAt": null }, "note": "Register HTTP monitor." } ] }, { "name": "attestor_monitor_http_list", "description": "List HTTP monitors in a workspace.", "function_declarations": [ { "name": "attestor_monitor_http_list", "description": "List HTTP monitors in a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "enabledOnly": { "default": false, "type": "boolean" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.monitor.http.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "monitors": { "type": "array", "items": { "type": "object", "properties": { "monitorId": { "type": "string", "pattern": "^mon_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "url": { "type": "string", "format": "uri" }, "method": { "default": "GET", "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD" ] }, "intervalSeconds": { "type": "integer", "minimum": 30, "maximum": 86400 }, "expectedStatusCodes": { "type": "array", "items": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "enabled": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastCheckAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastStatus": { "type": "string", "enum": [ "pass", "fail", "pending" ] } }, "required": [ "monitorId", "workspaceId", "url", "method", "intervalSeconds", "expectedStatusCodes", "enabled", "createdAt", "lastCheckAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "monitors", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "monitors": [], "nextCursor": null }, "note": "List monitors." } ] }, { "name": "attestor_monitor_http_run-now", "description": "Run a monitor check immediately (bypasses the scheduled interval).", "function_declarations": [ { "name": "attestor_monitor_http_run-now", "description": "Run a monitor check immediately (bypasses the scheduled interval).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "monitorId": { "type": "string", "pattern": "^mon_[0-9A-Z]{20,}$" } }, "required": [ "workspaceId", "monitorId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.monitor.http.run-now" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "statusCode": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "latencyMs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" } }, "required": [ "statusCode", "latencyMs", "receiptId" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "monitorId": "mon_demo00000000000000000000" }, "output": { "statusCode": 200, "latencyMs": 87, "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV7" }, "note": "Run a monitor check now." } ] }, { "name": "attestor_monitor_http_remove", "description": "Delete an HTTP monitor.", "function_declarations": [ { "name": "attestor_monitor_http_remove", "description": "Delete an HTTP monitor.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "monitorId": { "type": "string", "pattern": "^mon_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "monitorId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.monitor.http.remove" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "monitorId": "mon_demo00000000000000000000" }, "output": { "deleted": true }, "note": "Delete monitor." } ] }, { "name": "attestor_watch_dns_add", "description": "Register a DNS watch (detects record drift; signs every check as a receipt).", "function_declarations": [ { "name": "attestor_watch_dns_add", "description": "Register a DNS watch (detects record drift; signs every check as a receipt).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "domain": { "type": "string" }, "recordType": { "type": "string", "enum": [ "A", "AAAA", "CNAME", "MX", "TXT", "NS", "SRV", "CAA" ] }, "intervalSeconds": { "default": 3600, "type": "integer", "minimum": 60, "maximum": 86400 }, "pinExpectedValues": { "default": false, "type": "boolean" } }, "required": [ "workspaceId", "domain", "recordType" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.watch.dns.add" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "dnsWatchId": { "type": "string", "pattern": "^dnsw_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "domain": { "type": "string" }, "recordType": { "type": "string", "enum": [ "A", "AAAA", "CNAME", "MX", "TXT", "NS", "SRV", "CAA" ] }, "expectedValuesHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "intervalSeconds": { "type": "integer", "minimum": 60, "maximum": 86400 }, "enabled": { "type": "boolean" } }, "required": [ "dnsWatchId", "workspaceId", "domain", "recordType", "intervalSeconds", "enabled" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "domain": "example.com", "recordType": "A" }, "output": { "dnsWatchId": "dnsw_demo00000000000000000000", "workspaceId": "ws_demo_default", "domain": "example.com", "recordType": "A", "intervalSeconds": 3600, "enabled": true }, "note": "Register DNS watch." } ] }, { "name": "attestor_watch_dns_list", "description": "List DNS watches in a workspace.", "function_declarations": [ { "name": "attestor_watch_dns_list", "description": "List DNS watches in a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.watch.dns.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "watches": { "type": "array", "items": { "type": "object", "properties": { "dnsWatchId": { "type": "string", "pattern": "^dnsw_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "domain": { "type": "string" }, "recordType": { "type": "string", "enum": [ "A", "AAAA", "CNAME", "MX", "TXT", "NS", "SRV", "CAA" ] }, "expectedValuesHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "intervalSeconds": { "type": "integer", "minimum": 60, "maximum": 86400 }, "enabled": { "type": "boolean" } }, "required": [ "dnsWatchId", "workspaceId", "domain", "recordType", "intervalSeconds", "enabled" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "watches", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "watches": [], "nextCursor": null }, "note": "List DNS watches." } ] }, { "name": "attestor_watch_dns_remove", "description": "Delete a DNS watch.", "function_declarations": [ { "name": "attestor_watch_dns_remove", "description": "Delete a DNS watch.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "dnsWatchId": { "type": "string", "pattern": "^dnsw_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "dnsWatchId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.watch.dns.remove" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "dnsWatchId": "dnsw_demo00000000000000000000" }, "output": { "deleted": true }, "note": "Delete DNS watch." } ] }, { "name": "attestor_watch_tls_add", "description": "Register a TLS certificate watch (detects cert changes; signs every check).", "function_declarations": [ { "name": "attestor_watch_tls_add", "description": "Register a TLS certificate watch (detects cert changes; signs every check).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "host": { "type": "string" }, "port": { "default": 443, "type": "integer", "minimum": 1, "maximum": 65535 }, "intervalSeconds": { "default": 3600, "type": "integer", "minimum": 300, "maximum": 86400 }, "pinFingerprint": { "default": false, "type": "boolean" } }, "required": [ "workspaceId", "host" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.watch.tls.add" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tlsWatchId": { "type": "string", "pattern": "^tlsw_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "host": { "type": "string" }, "port": { "default": 443, "type": "integer", "minimum": 1, "maximum": 65535 }, "expectedFingerprintSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "intervalSeconds": { "type": "integer", "minimum": 60, "maximum": 86400 }, "enabled": { "type": "boolean" } }, "required": [ "tlsWatchId", "workspaceId", "host", "port", "intervalSeconds", "enabled" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "host": "example.com" }, "output": { "tlsWatchId": "tlsw_demo00000000000000000000", "workspaceId": "ws_demo_default", "host": "example.com", "port": 443, "intervalSeconds": 3600, "enabled": true }, "note": "Register TLS watch." } ] }, { "name": "attestor_watch_tls_list", "description": "List TLS watches in a workspace.", "function_declarations": [ { "name": "attestor_watch_tls_list", "description": "List TLS watches in a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.watch.tls.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "watches": { "type": "array", "items": { "type": "object", "properties": { "tlsWatchId": { "type": "string", "pattern": "^tlsw_[0-9A-Z]{20,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "host": { "type": "string" }, "port": { "default": 443, "type": "integer", "minimum": 1, "maximum": 65535 }, "expectedFingerprintSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "intervalSeconds": { "type": "integer", "minimum": 60, "maximum": 86400 }, "enabled": { "type": "boolean" } }, "required": [ "tlsWatchId", "workspaceId", "host", "port", "intervalSeconds", "enabled" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "watches", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "watches": [], "nextCursor": null }, "note": "List TLS watches." } ] }, { "name": "attestor_watch_tls_remove", "description": "Delete a TLS watch.", "function_declarations": [ { "name": "attestor_watch_tls_remove", "description": "Delete a TLS watch.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "tlsWatchId": { "type": "string", "pattern": "^tlsw_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "tlsWatchId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.watch.tls.remove" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "tlsWatchId": "tlsw_demo00000000000000000000" }, "output": { "deleted": true }, "note": "Delete TLS watch." } ] }, { "name": "attestor_receipt_list", "description": "List Attestor receipts for a workspace.", "function_declarations": [ { "name": "attestor_receipt_list", "description": "List Attestor receipts for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.receipt.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receipts": { "type": "array", "items": { "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "receipts", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "kind": "agent.call" }, "output": { "receipts": [], "nextCursor": null }, "note": "List receipts." } ] }, { "name": "attestor_receipt_get", "description": "Get a single receipt with full body.", "function_declarations": [ { "name": "attestor_receipt_get", "description": "Get a single receipt with full body.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" } }, "required": [ "workspaceId", "receiptId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.receipt.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV2" }, "output": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV2", "workspaceId": "ws_demo_default", "kind": "agent.call", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} }, "note": "Read a receipt." } ] }, { "name": "attestor_receipt_verify", "description": "Verify a receipt's Ed25519 signature against the published public key. Cannot be disabled.", "function_declarations": [ { "name": "attestor_receipt_verify", "description": "Verify a receipt's Ed25519 signature against the published public key. Cannot be disabled.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "receipt": { "type": "object", "properties": { "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kind": { "type": "string", "enum": [ "agent.call", "content.attest", "llm.attest", "commit.attest", "webhook.deliver", "monitor.http", "dns.watch", "tls.watch" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "signature": { "type": "string" }, "signatureKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "body": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "receiptId", "workspaceId", "kind", "issuedAt", "signature", "signatureKeyId", "body" ], "additionalProperties": {} } }, "required": [ "receipt" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.receipt.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "valid": { "type": "boolean" }, "signatureValid": { "type": "boolean" }, "publishedKeyUrl": { "type": "string", "format": "uri" }, "errors": { "type": "array", "items": { "type": "string" } } }, "required": [ "valid", "signatureValid", "publishedKeyUrl", "errors" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "receipt": { "receiptId": "01H8X4P9R7Z2C1A1F2A8VBJYV2", "workspaceId": "ws_demo_default", "kind": "agent.call", "issuedAt": "2026-05-22T12:00:00.000Z", "signature": "...", "signatureKeyId": "attestor-2026-q2-enam", "body": {} } }, "output": { "valid": true, "signatureValid": true, "publishedKeyUrl": "https://agined.com/.well-known/attestor-keys.json", "errors": [] }, "note": "Verify a receipt." } ] }, { "name": "attestor_usage_current", "description": "Get current-period Attestor usage for a workspace (calls per primitive + budget consumed).", "function_declarations": [ { "name": "attestor_usage_current", "description": "Get current-period Attestor usage for a workspace (calls per primitive + budget consumed).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.usage.current" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "totalCalls": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "perPrimitive": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "monthlyAllowance": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "periodEnd": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "totalCalls", "perPrimitive", "monthlyAllowance", "periodEnd" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "totalCalls": 12345, "perPrimitive": { "agent.call": 10000, "content.attest": 2345 }, "monthlyAllowance": 100000, "periodEnd": "2026-06-01T00:00:00.000Z" }, "note": "Read current usage." } ] }, { "name": "attestor_usage_historical", "description": "Get historical Attestor usage (per-day breakdown for a date range).", "function_declarations": [ { "name": "attestor_usage_historical", "description": "Get historical Attestor usage (per-day breakdown for a date range).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId", "since" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.usage.historical" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "daily": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "totalCalls": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "perPrimitive": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } } }, "required": [ "date", "totalCalls", "perPrimitive" ], "additionalProperties": false } } }, "required": [ "daily" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "since": "2026-05-01T00:00:00.000Z" }, "output": { "daily": [] }, "note": "Read historical usage." } ] }, { "name": "attestor_subscription_get", "description": "Get workspace Attestor subscription state.", "function_declarations": [ { "name": "attestor_subscription_get", "description": "Get workspace Attestor subscription state.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.subscription.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" }, "tier": { "type": [ "string", "null" ] }, "abuseStatus": { "type": "string" }, "autoOverageEnabled": { "type": "boolean" }, "billingMode": { "type": "string" } }, "required": [ "enabled", "tier", "abuseStatus", "autoOverageEnabled", "billingMode" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "enabled": true, "tier": "team", "abuseStatus": "clean", "autoOverageEnabled": true, "billingMode": "combined" }, "note": "Read subscription state." } ] }, { "name": "attestor_subscription_cancel", "description": "Cancel the Attestor subscription at the next billing period. Workspace's existing receipts remain accessible.", "function_declarations": [ { "name": "attestor_subscription_cancel", "description": "Cancel the Attestor subscription at the next billing period. Workspace's existing receipts remain accessible.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.subscription.cancel" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "canceled": { "type": "boolean" }, "effectiveAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "canceled", "effectiveAt" ], "additionalProperties": false }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "plan.changed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "reason": "Migrating to alternative receipt provider" }, "output": { "canceled": true, "effectiveAt": "2026-06-22T00:00:00.000Z" }, "note": "Cancel Attestor subscription." } ] }, { "name": "attestor_abuse-status_get", "description": "Get the current Attestor abuse status for a workspace.", "function_declarations": [ { "name": "attestor_abuse-status_get", "description": "Get the current Attestor abuse status for a workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.abuse-status.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "status": { "type": "string", "enum": [ "clean", "flagged", "under_review", "suspended" ] }, "flaggedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "suspendedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "reason": { "type": [ "string", "null" ] } }, "required": [ "workspaceId", "status", "flaggedAt", "suspendedAt", "reason" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "workspaceId": "ws_demo_default", "status": "clean", "flaggedAt": null, "suspendedAt": null, "reason": null }, "note": "Read abuse status." } ] }, { "name": "attestor_abuse-status_appeal", "description": "Submit an appeal against an abuse-status flag or suspension.", "function_declarations": [ { "name": "attestor_abuse-status_appeal", "description": "Submit an appeal against an abuse-status flag or suspension.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "appealText": { "type": "string", "minLength": 50, "maxLength": 5000 } }, "required": [ "workspaceId", "appealText" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.abuse-status.appeal" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "appealId": { "type": "string" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "appealId", "submittedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "appealText": "Our agent's traffic spike was a planned load test; here are the details + timestamps + IP CIDRs ..." }, "output": { "appealId": "app_abc", "submittedAt": "2026-05-22T12:00:00.000Z" }, "note": "Submit abuse appeal." } ] }, { "name": "attestor_signing-key_get", "description": "Get the current active Attestor signing key id for the workspace's jurisdiction.", "function_declarations": [ { "name": "attestor_signing-key_get", "description": "Get the current active Attestor signing key id for the workspace's jurisdiction.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.signing-key.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "signingKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "publishedAtUrl": { "type": "string", "format": "uri" } }, "required": [ "signingKeyId", "jurisdiction", "issuedAt", "expiresAt", "publishedAtUrl" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "signingKeyId": "attestor-2026-q2-enam", "jurisdiction": "ENAM", "issuedAt": "2026-04-01T00:00:00.000Z", "expiresAt": "2027-04-01T00:00:00.000Z", "publishedAtUrl": "https://agined.com/.well-known/attestor-keys.json" }, "note": "Read signing key id." } ] }, { "name": "attestor_signing-key_list", "description": "List all signing keys (active + historical) usable to verify the workspace's receipts.", "function_declarations": [ { "name": "attestor_signing-key_list", "description": "List all signing keys (active + historical) usable to verify the workspace's receipts.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.signing-key.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "signingKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" }, "jurisdiction": { "type": "string", "enum": [ "WEUR", "ENAM" ] }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "active": { "type": "boolean" } }, "required": [ "signingKeyId", "jurisdiction", "issuedAt", "expiresAt", "active" ], "additionalProperties": false } } }, "required": [ "keys" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "keys": [ { "signingKeyId": "attestor-2026-q2-enam", "jurisdiction": "ENAM", "issuedAt": "2026-04-01T00:00:00.000Z", "expiresAt": "2027-04-01T00:00:00.000Z", "active": true } ] }, "note": "List signing keys." } ] }, { "name": "attestor_signing-key_rotate-request", "description": "Request signing-key rotation (Enterprise tier dedicated keys only). Agined ops fulfils via key ceremony.", "function_declarations": [ { "name": "attestor_signing-key_rotate-request", "description": "Request signing-key rotation (Enterprise tier dedicated keys only). Agined ops fulfils via key ceremony.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.signing-key.rotate-request" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "requestId": { "type": "string" }, "estimatedRotationAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "requestId", "estimatedRotationAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "workspaceId": "ws_demo_default", "reason": "Q4 scheduled rotation per our internal policy" }, "output": { "requestId": "rot_abc", "estimatedRotationAt": "2026-06-01T00:00:00.000Z" }, "note": "Request key rotation." } ] }, { "name": "attestor_signing-key_public_get", "description": "Get the public-key JWK for a specific signing key id (for offline verification).", "function_declarations": [ { "name": "attestor_signing-key_public_get", "description": "Get the public-key JWK for a specific signing key id (for offline verification).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "signingKeyId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{4,64}$" } }, "required": [ "signingKeyId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.signing-key.public.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "jwk": {}, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "jwk", "issuedAt", "expiresAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "signingKeyId": "attestor-2026-q2-enam" }, "output": { "jwk": { "kty": "OKP", "crv": "Ed25519", "x": "..." }, "issuedAt": "2026-04-01T00:00:00.000Z", "expiresAt": "2027-04-01T00:00:00.000Z" }, "note": "Read public key JWK." } ] }, { "name": "attestor_status_get", "description": "Get the Attestor subsystem health (per-jurisdiction Worker uptime, per-primitive error rate, last self-attestation receipt).", "function_declarations": [ { "name": "attestor_status_get", "description": "Get the Attestor subsystem health (per-jurisdiction Worker uptime, per-primitive error rate, last self-attestation receipt).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.status.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "jurisdictions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "WEUR", "ENAM" ] }, "uptimePercent": { "type": "number", "minimum": 0, "maximum": 100 }, "errorRatePercent": { "type": "number", "minimum": 0, "maximum": 100 }, "lastSelfAttestationAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "id", "uptimePercent", "errorRatePercent", "lastSelfAttestationAt" ], "additionalProperties": false } } }, "required": [ "jurisdictions" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "jurisdictions": [ { "id": "ENAM", "uptimePercent": 99.95, "errorRatePercent": 0.02, "lastSelfAttestationAt": "2026-05-22T11:00:00.000Z" } ] }, "note": "Read Attestor health." } ] }, { "name": "attestor_attestation-feed_get", "description": "Get the daily Attestor self-attestation receipt feed (Agined attesting to its own platform integrity).", "function_declarations": [ { "name": "attestor_attestation-feed_get", "description": "Get the daily Attestor self-attestation receipt feed (Agined attesting to its own platform integrity).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/attestor.attestation-feed.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "attestations": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "receiptId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "signature": { "type": "string" } }, "required": [ "date", "receiptId", "signature" ], "additionalProperties": false } } }, "required": [ "attestations" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "attestations": [] }, "note": "Read self-attestation feed." } ] }, { "name": "starfleet_run", "description": "Post a run to a Starfleet spot actor (witness/council/historian/custodian/conscience/…) — observe + decide + anchor it in the workspace hash-chain.", "function_declarations": [ { "name": "starfleet_run", "description": "Post a run to a Starfleet spot actor (witness/council/historian/custodian/conscience/…) — observe + decide + anchor it in the workspace hash-chain.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "version": { "default": "v1", "type": "string", "enum": [ "v0", "v1", "v2" ] }, "actor": { "type": "string", "minLength": 1, "maxLength": 32, "description": "Actor id, e.g. 'witness'." }, "agentDid": { "description": "DID of the agent that produced the run.", "type": [ "string", "null" ] }, "input": { "description": "The agent run payload — opaque; the actor interprets it." } }, "required": [ "actor", "input" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.run" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "status": { "type": "string" }, "receipt": {}, "spillToR2": { "type": "boolean" } }, "required": [ "status", "receipt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "version": "v1", "actor": "witness", "agentDid": "did:web:example.com:agent:billing", "input": { "task": "refund", "amount": 4200 } }, "output": { "status": "ok", "receipt": { "runId": "run_abc" } }, "note": "Witness a billing-agent run." } ] }, { "name": "starfleet_runs_list", "description": "List the workspace's Starfleet runs (actor IS the surface: witness | historian | custodian | conscience | …).", "function_declarations": [ { "name": "starfleet_runs_list", "description": "List the workspace's Starfleet runs (actor IS the surface: witness | historian | custodian | conscience | …).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "actor": { "type": "string", "maxLength": 32 }, "version": { "type": "string", "enum": [ "v0", "v1", "v2" ] }, "agentDid": { "type": "string" }, "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 200 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.runs.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "runs": { "type": "array", "items": {} }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "runs", "count" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "actor": "witness", "limit": 20 }, "output": { "runs": [], "count": 0 }, "note": "Recent witness runs." } ] }, { "name": "starfleet_actors_list", "description": "List the Starfleet roster (optionally for one version) with each actor's min tier.", "function_declarations": [ { "name": "starfleet_actors_list", "description": "List the Starfleet roster (optionally for one version) with each actor's min tier.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "version": { "type": "string", "enum": [ "v0", "v1", "v2" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.actors.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "actors": { "type": "array", "items": {} } }, "required": [ "actors" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "version": "v1" }, "output": { "actors": [ { "id": "witness", "version": "v1", "minTier": "free" } ] }, "note": "Discover v1 actors." } ] }, { "name": "starfleet_agents_list", "description": "List the workspace's posting agents (distinct agent DIDs across runs, with counts + last-seen).", "function_declarations": [ { "name": "starfleet_agents_list", "description": "List the workspace's posting agents (distinct agent DIDs across runs, with counts + last-seen).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.agents.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "agents": { "type": "array", "items": {} }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "agents", "count" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "agents": [], "count": 0 }, "note": "Who's posting runs." } ] }, { "name": "starfleet_runs_verify-chain", "description": "Verify the integrity of the workspace's run hash-chain from a starting sequence.", "function_declarations": [ { "name": "starfleet_runs_verify-chain", "description": "Verify the integrity of the workspace's run hash-chain from a starting sequence.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "from": { "default": 1, "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.runs.verify-chain" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "agent_read", "examples": [ { "input": { "from": 1 }, "output": { "ok": true }, "note": "Prove the chain is intact." } ] }, { "name": "starfleet_runs_diff", "description": "Compare two Starfleet runs (classification + payload diff).", "function_declarations": [ { "name": "starfleet_runs_diff", "description": "Compare two Starfleet runs (classification + payload diff).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "a": { "type": "string", "minLength": 1 }, "b": { "type": "string", "minLength": 1 } }, "required": [ "a", "b" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.runs.diff" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "a": "run_abc", "b": "run_def" }, "output": { "ok": true }, "note": "Diff two runs." } ] }, { "name": "starfleet_runs_replay", "description": "Reconstruct + re-verify a single run from its chain entry.", "function_declarations": [ { "name": "starfleet_runs_replay", "description": "Reconstruct + re-verify a single run from its chain entry.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "runId": { "type": "string", "minLength": 1 }, "expectInputHash": { "type": "string" } }, "required": [ "runId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/starfleet.runs.replay" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "found": { "type": "boolean" } }, "required": [ "ok", "found" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "runId": "run_abc" }, "output": { "ok": true, "found": true }, "note": "Replay a run." } ] }, { "name": "ledger-bundles_snapshot_create", "description": "Create a signed LedgerBundles snapshot of the workspace's audit state (a paid action).", "function_declarations": [ { "name": "ledger-bundles_snapshot_create", "description": "Create a signed LedgerBundles snapshot of the workspace's audit state (a paid action).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "description": "Optional snapshot scope / label.", "type": "string" }, "params": {} }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/ledger-bundles.snapshot.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "agent_invocation", "examples": [ { "input": { "scope": "month-end" }, "output": {}, "note": "Seal a signed snapshot." } ] }, { "name": "ledger-bundles_verify-chain", "description": "Verify the LedgerBundles transparency chain (free — a transparency guarantee).", "function_declarations": [ { "name": "ledger-bundles_verify-chain", "description": "Verify the LedgerBundles transparency chain (free — a transparency guarantee).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/ledger-bundles.verify-chain" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": {}, "note": "Prove the chain is intact." } ] }, { "name": "ledger-bundles_anchors_list", "description": "List the LedgerBundles anchors (the published chain checkpoints).", "function_declarations": [ { "name": "ledger-bundles_anchors_list", "description": "List the LedgerBundles anchors (the published chain checkpoints).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/ledger-bundles.anchors.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": {}, "note": "List anchors." } ] }, { "name": "privacy_dsr_submit", "description": "Submit a data-subject request (GDPR / CCPA). Cannot be disabled — statutory right.", "function_declarations": [ { "name": "privacy_dsr_submit", "description": "Submit a data-subject request (GDPR / CCPA). Cannot be disabled — statutory right.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kind": { "type": "string", "enum": [ "access", "erasure", "restriction", "portability", "objection", "rectification", "automated_decision_review", "withdraw_consent" ] }, "subjectEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 }, "contactEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" } }, "required": [ "kind", "subjectEmail" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/privacy.dsr.submit" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "dsrId": { "type": "string" }, "kind": { "type": "string", "enum": [ "access", "erasure", "restriction", "portability", "objection", "rectification", "automated_decision_review", "withdraw_consent" ] }, "subjectEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "status": { "type": "string", "enum": [ "received", "verifying-identity", "in-progress", "completed", "rejected" ] }, "completedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "dsrId", "kind", "subjectEmail", "submittedAt", "status", "completedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "admin.action", "examples": [ { "input": { "kind": "access", "subjectEmail": "alice@example.com" }, "output": { "dsrId": "dsr_abc", "kind": "access", "subjectEmail": "alice@example.com", "submittedAt": "2026-05-22T12:00:00.000Z", "status": "received", "completedAt": null }, "note": "File an Art. 15 access request." } ] }, { "name": "privacy_dsr_status", "description": "Check status of a submitted DSR. Cannot be disabled — statutory right.", "function_declarations": [ { "name": "privacy_dsr_status", "description": "Check status of a submitted DSR. Cannot be disabled — statutory right.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "dsrId": { "type": "string" } }, "required": [ "dsrId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/privacy.dsr.status" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "dsrId": { "type": "string" }, "kind": { "type": "string", "enum": [ "access", "erasure", "restriction", "portability", "objection", "rectification", "automated_decision_review", "withdraw_consent" ] }, "subjectEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "status": { "type": "string", "enum": [ "received", "verifying-identity", "in-progress", "completed", "rejected" ] }, "completedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "dsrId", "kind", "subjectEmail", "submittedAt", "status", "completedAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "dsrId": "dsr_abc" }, "output": { "dsrId": "dsr_abc", "kind": "access", "subjectEmail": "alice@example.com", "submittedAt": "2026-05-22T12:00:00.000Z", "status": "in-progress", "completedAt": null }, "note": "Status check." } ] }, { "name": "privacy_dsr_list", "description": "List all DSRs filed for this account / workspace.", "function_declarations": [ { "name": "privacy_dsr_list", "description": "List all DSRs filed for this account / workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "status": { "type": "string", "enum": [ "received", "verifying-identity", "in-progress", "completed", "rejected" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/privacy.dsr.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "dsrs": { "type": "array", "items": { "type": "object", "properties": { "dsrId": { "type": "string" }, "kind": { "type": "string", "enum": [ "access", "erasure", "restriction", "portability", "objection", "rectification", "automated_decision_review", "withdraw_consent" ] }, "subjectEmail": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "submittedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "status": { "type": "string", "enum": [ "received", "verifying-identity", "in-progress", "completed", "rejected" ] }, "completedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "dsrId", "kind", "subjectEmail", "submittedAt", "status", "completedAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "dsrs", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 25 }, "output": { "dsrs": [], "nextCursor": null }, "note": "List your filed DSRs." } ] }, { "name": "privacy_export_request", "description": "Request a personal-data export (GDPR Art. 20 — data portability). Cannot be disabled.", "function_declarations": [ { "name": "privacy_export_request", "description": "Request a personal-data export (GDPR Art. 20 — data portability). Cannot be disabled.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "format": { "default": "portable-archive", "type": "string", "enum": [ "json", "portable-archive" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/privacy.export.request" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" }, "estimatedReadyAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "format": { "type": "string" } }, "required": [ "exportId", "estimatedReadyAt", "format" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "expensive", "audit_kind": "export.requested", "examples": [ { "input": { "format": "portable-archive" }, "output": { "exportId": "exp_pii_abc", "estimatedReadyAt": "2026-05-22T13:00:00.000Z", "format": "portable-archive" }, "note": "Art. 20 portability export." } ] }, { "name": "privacy_export_download", "description": "Get a signed download URL for a completed personal-data export.", "function_declarations": [ { "name": "privacy_export_download", "description": "Get a signed download URL for a completed personal-data export.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "exportId": { "type": "string" } }, "required": [ "exportId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/privacy.export.download" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "expiresAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "sha256": { "type": "string" } }, "required": [ "url", "expiresAt", "sha256" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "export.completed", "examples": [ { "input": { "exportId": "exp_pii_abc" }, "output": { "url": "https://r2.agined.com/exports/abc", "expiresAt": "2026-05-22T13:30:00.000Z", "sha256": "abcd..." }, "note": "Download your export." } ] }, { "name": "privacy_subject-rights_list", "description": "List the data-subject rights Agined honours (GDPR, CCPA, LGPD) + the legal references.", "function_declarations": [ { "name": "privacy_subject-rights_list", "description": "List the data-subject rights Agined honours (GDPR, CCPA, LGPD) + the legal references.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/privacy.subject-rights.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rights": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "access", "erasure", "restriction", "portability", "objection", "rectification", "automated_decision_review", "withdraw_consent" ] }, "legalRef": { "type": "string" }, "description": { "type": "string" } }, "required": [ "kind", "legalRef", "description" ], "additionalProperties": false } } }, "required": [ "rights" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "rights": [ { "kind": "access", "legalRef": "GDPR Art. 15", "description": "Right to access your personal data." } ] }, "note": "Read supported rights." } ] }, { "name": "support_tickets_list", "description": "List your support tickets.", "function_declarations": [ { "name": "support_tickets_list", "description": "List your support tickets.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "status": { "type": "string", "enum": [ "open", "in-progress", "waiting-customer", "resolved", "closed" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/support.tickets.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tickets": { "type": "array", "items": { "type": "object", "properties": { "ticketId": { "type": "string" }, "subject": { "type": "string", "minLength": 1, "maxLength": 80 }, "status": { "type": "string", "enum": [ "open", "in-progress", "waiting-customer", "resolved", "closed" ] }, "priority": { "type": "string", "enum": [ "critical", "high", "medium", "low" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "resolvedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "ticketId", "subject", "status", "priority", "createdAt", "updatedAt", "resolvedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "tickets", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "limit": 25 }, "output": { "tickets": [], "nextCursor": null }, "note": "List your tickets." } ] }, { "name": "support_tickets_create", "description": "Open a new support ticket.", "function_declarations": [ { "name": "support_tickets_create", "description": "Open a new support ticket.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subject": { "type": "string", "minLength": 1, "maxLength": 80 }, "body": { "type": "string", "minLength": 20, "maxLength": 50000 }, "priority": { "default": "medium", "type": "string", "enum": [ "critical", "high", "medium", "low" ] } }, "required": [ "subject", "body" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/support.tickets.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticketId": { "type": "string" }, "subject": { "type": "string", "minLength": 1, "maxLength": 80 }, "status": { "type": "string", "enum": [ "open", "in-progress", "waiting-customer", "resolved", "closed" ] }, "priority": { "type": "string", "enum": [ "critical", "high", "medium", "low" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "resolvedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "ticketId", "subject", "status", "priority", "createdAt", "updatedAt", "resolvedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "subject": "Issue with Tools receipt verification", "body": "Hi — I'm seeing a signature_invalid error when verifying receipts from workspace ws_X. Could you take a look?", "priority": "medium" }, "output": { "ticketId": "tkt_abc", "subject": "Issue with Tools receipt verification", "status": "open", "priority": "medium", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z", "resolvedAt": null }, "note": "Open a new ticket." } ] }, { "name": "support_tickets_get", "description": "Get a ticket's details + reply thread.", "function_declarations": [ { "name": "support_tickets_get", "description": "Get a ticket's details + reply thread.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticketId": { "type": "string" } }, "required": [ "ticketId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/support.tickets.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticket": { "type": "object", "properties": { "ticketId": { "type": "string" }, "subject": { "type": "string", "minLength": 1, "maxLength": 80 }, "status": { "type": "string", "enum": [ "open", "in-progress", "waiting-customer", "resolved", "closed" ] }, "priority": { "type": "string", "enum": [ "critical", "high", "medium", "low" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "resolvedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "ticketId", "subject", "status", "priority", "createdAt", "updatedAt", "resolvedAt" ], "additionalProperties": {} }, "replies": { "type": "array", "items": { "type": "object", "properties": { "replyId": { "type": "string" }, "ticketId": { "type": "string" }, "author": { "type": "string", "enum": [ "customer", "agined-support", "agined-ai", "system" ] }, "body": { "type": "string", "maxLength": 50000 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "replyId", "ticketId", "author", "body", "createdAt" ], "additionalProperties": false } } }, "required": [ "ticket", "replies" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "ticketId": "tkt_abc" }, "output": { "ticket": { "ticketId": "tkt_abc", "subject": "Issue", "status": "open", "priority": "medium", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:00:00.000Z", "resolvedAt": null }, "replies": [] }, "note": "Read ticket + thread." } ] }, { "name": "support_tickets_reply", "description": "Post a reply to a ticket.", "function_declarations": [ { "name": "support_tickets_reply", "description": "Post a reply to a ticket.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticketId": { "type": "string" }, "body": { "type": "string", "minLength": 1, "maxLength": 50000 } }, "required": [ "ticketId", "body" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/support.tickets.reply" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "replyId": { "type": "string" }, "ticketId": { "type": "string" }, "author": { "type": "string", "enum": [ "customer", "agined-support", "agined-ai", "system" ] }, "body": { "type": "string", "maxLength": 50000 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "replyId", "ticketId", "author", "body", "createdAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "ticketId": "tkt_abc", "body": "Thanks — here's the receipt hash …" }, "output": { "replyId": "rep_abc", "ticketId": "tkt_abc", "author": "customer", "body": "Thanks — here's the receipt hash …", "createdAt": "2026-05-22T12:05:00.000Z" }, "note": "Reply to a ticket." } ] }, { "name": "support_tickets_close", "description": "Close a ticket (optionally with a reason).", "function_declarations": [ { "name": "support_tickets_close", "description": "Close a ticket (optionally with a reason).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticketId": { "type": "string" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "ticketId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/support.tickets.close" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticketId": { "type": "string" }, "subject": { "type": "string", "minLength": 1, "maxLength": 80 }, "status": { "type": "string", "enum": [ "open", "in-progress", "waiting-customer", "resolved", "closed" ] }, "priority": { "type": "string", "enum": [ "critical", "high", "medium", "low" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "resolvedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "ticketId", "subject", "status", "priority", "createdAt", "updatedAt", "resolvedAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "ticketId": "tkt_abc" }, "output": { "ticketId": "tkt_abc", "subject": "Issue", "status": "closed", "priority": "medium", "createdAt": "2026-05-22T12:00:00.000Z", "updatedAt": "2026-05-22T12:10:00.000Z", "resolvedAt": "2026-05-22T12:10:00.000Z" }, "note": "Close a ticket." } ] }, { "name": "support_satisfaction_rate", "description": "Rate the support experience after a ticket closes — five dimensions, 1–5 each (ADR-034). A 2-or-below on any dimension triggers the feedback loop.", "function_declarations": [ { "name": "support_satisfaction_rate", "description": "Rate the support experience after a ticket closes — five dimensions, 1–5 each (ADR-034). A 2-or-below on any dimension triggers the feedback loop.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ticketId": { "type": "string" }, "speed": { "type": "integer", "minimum": 1, "maximum": 5 }, "knowledge": { "type": "integer", "minimum": 1, "maximum": 5 }, "friendliness": { "type": "integer", "minimum": 1, "maximum": 5 }, "followThrough": { "type": "integer", "minimum": 1, "maximum": 5 }, "outcome": { "type": "integer", "minimum": 1, "maximum": 5 }, "comment": { "type": "string", "maxLength": 500 } }, "required": [ "ticketId", "speed", "knowledge", "friendliness", "followThrough", "outcome" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/support.satisfaction.rate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "recorded": { "type": "boolean" }, "rebuildTriggered": { "type": "boolean" } }, "required": [ "recorded" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "ticketId": "tkt_abc", "speed": 5, "knowledge": 5, "friendliness": 5, "followThrough": 5, "outcome": 5 }, "output": { "recorded": true, "rebuildTriggered": false }, "note": "Rate support 5/5 across the board." } ] }, { "name": "discovery_capabilities_get", "description": "Get the full action registry catalogue (machine-readable). Same content as `/api/v1/actions.json`.", "function_declarations": [ { "name": "discovery_capabilities_get", "description": "Get the full action registry catalogue (machine-readable). Same content as `/api/v1/actions.json`.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "domainFilter": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.capabilities.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "actions": { "type": "array", "items": {} }, "generatedAt": { "type": "string" } }, "required": [ "actions", "generatedAt" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "actions": [], "generatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Discover all actions." } ] }, { "name": "discovery_version_get", "description": "Get the platform version + contracts package version + supported MCP / OpenAPI spec versions.", "function_declarations": [ { "name": "discovery_version_get", "description": "Get the platform version + contracts package version + supported MCP / OpenAPI spec versions.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.version.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "platform": { "type": "string" }, "contracts": { "type": "string" }, "mcpSpecVersion": { "type": "string" }, "openapiVersion": { "type": "string" }, "asyncapiVersion": { "type": "string" } }, "required": [ "platform", "contracts", "mcpSpecVersion", "openapiVersion", "asyncapiVersion" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "platform": "agined/1.0.0", "contracts": "0.1.23", "mcpSpecVersion": "2025-06-18", "openapiVersion": "3.1.0", "asyncapiVersion": "3.0.0" }, "note": "Read all version + spec info." } ] }, { "name": "discovery_schema_get", "description": "Get the JSON Schema for a specific action's input or output.", "function_declarations": [ { "name": "discovery_schema_get", "description": "Get the JSON Schema for a specific action's input or output.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "actionId": { "type": "string" }, "shape": { "type": "string", "enum": [ "input", "output" ] } }, "required": [ "actionId", "shape" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.schema.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "schema": {} }, "required": [ "schema" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "actionId": "workspace.create", "shape": "input" }, "output": { "schema": {} }, "note": "Get an action's JSON Schema." } ] }, { "name": "discovery_locales_list", "description": "List supported user-facing locales.", "function_declarations": [ { "name": "discovery_locales_list", "description": "List supported user-facing locales.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.locales.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locales": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "en", "es", "fr", "de", "de-du", "zh", "pt", "it" ] }, "name": { "type": "string" }, "nativeName": { "type": "string" } }, "required": [ "id", "name", "nativeName" ], "additionalProperties": false } } }, "required": [ "locales" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "locales": [ { "id": "en", "name": "English", "nativeName": "English" }, { "id": "de", "name": "German", "nativeName": "Deutsch" } ] }, "note": "Six supported locales." } ] }, { "name": "discovery_plans_list", "description": "List the available Agined + Tools subscription plans.", "function_declarations": [ { "name": "discovery_plans_list", "description": "List the available Agined + Tools subscription plans.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "product": { "default": "all", "type": "string", "enum": [ "agined", "tools", "attestor", "all" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.plans.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "plans": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "product": { "type": "string", "enum": [ "agined", "tools", "attestor" ] }, "name": { "type": "string" }, "priceUsdMinor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "features": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "product", "name", "priceUsdMinor", "features" ], "additionalProperties": false } } }, "required": [ "plans" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "product": "all" }, "output": { "plans": [ { "id": "free", "product": "agined", "name": "Free", "priceUsdMinor": 0, "features": [ "1 workspace", "1k runs/mo" ] } ] }, "note": "List all plans." } ] }, { "name": "discovery_regions_list", "description": "List the 32 data-residency regions a workspace can be bound to.", "function_declarations": [ { "name": "discovery_regions_list", "description": "List the 32 data-residency regions a workspace can be bound to.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "euOnly": { "default": false, "type": "boolean" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.regions.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "regions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string", "enum": [ "cloudflare-d1", "aws-aurora" ] }, "label": { "type": "string" }, "countryCode": { "type": "string" }, "euJurisdictionBound": { "type": "boolean" } }, "required": [ "id", "provider", "label", "countryCode", "euJurisdictionBound" ], "additionalProperties": false } } }, "required": [ "regions" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": {}, "output": { "regions": [ { "id": "cloudflare-d1:weur", "provider": "cloudflare-d1", "label": "Western Europe", "countryCode": "DE", "euJurisdictionBound": true } ] }, "note": "List all 32 regions (6 Cloudflare + 26 AWS Aurora)." } ] }, { "name": "discovery_confirmation_token_verify", "description": "Verify a confirmation token is well-formed + still valid (cannot be disabled — safety floor).", "function_declarations": [ { "name": "discovery_confirmation_token_verify", "description": "Verify a confirmation token is well-formed + still valid (cannot be disabled — safety floor).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "token": { "type": "string" } }, "required": [ "token" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/discovery.confirmation.token.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "valid": { "type": "boolean" }, "actionId": { "type": "string" }, "expiresAt": { "type": "string" } }, "required": [ "valid" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "token": "..." }, "output": { "valid": true, "actionId": "workspace.delete.schedule", "expiresAt": "2026-05-22T12:01:00.000Z" }, "note": "Verify confirmation token." } ] }, { "name": "agents_identity_enroll", "description": "Enroll a new W3C DID Web agent identity under your principal.", "function_declarations": [ { "name": "agents_identity_enroll", "description": "Enroll a new W3C DID Web agent identity under your principal.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "displayName": { "type": "string", "minLength": 1, "maxLength": 80 }, "scopeKind": { "type": "string", "enum": [ "workspace", "organization", "agent" ] }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "description": { "type": "string", "maxLength": 500 }, "alg": { "default": "EdDSA", "type": "string", "enum": [ "EdDSA", "ES256" ] } }, "required": [ "displayName", "scopeKind" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.enroll" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "documentUrl": { "type": "string", "format": "uri" }, "enrollmentCredential": { "type": [ "string", "null" ] }, "privateKeyRecoveryEnvelope": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "did", "documentUrl", "enrollmentCredential", "privateKeyRecoveryEnvelope", "createdAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.identity.enrolled", "examples": [ { "input": { "displayName": "GitHub Actions release attestor", "scopeKind": "workspace", "workspaceId": "ws_demo_default" }, "output": { "did": "did:web:agined.com:agents:ws_demo_default:abc", "documentUrl": "https://agined.com/.well-known/agents/ws_demo_default/abc/did.json", "enrollmentCredential": null, "privateKeyRecoveryEnvelope": null, "createdAt": "2026-05-22T12:00:00.000Z" }, "note": "Enroll a workspace-scoped agent DID for CI signing. One-time secrets are minted by rotate, not enroll." } ] }, { "name": "agents_identity_list", "description": "List enrolled agent DIDs visible to the principal.", "function_declarations": [ { "name": "agents_identity_list", "description": "List enrolled agent DIDs visible to the principal.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "organizationId": { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, "includeDeactivated": { "default": false, "type": "boolean" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "agents": { "type": "array", "items": { "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "displayName": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "scopeKind": { "type": "string", "enum": [ "workspace", "organization", "agent" ] }, "workspaceId": { "anyOf": [ { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, { "type": "null" } ] }, "organizationId": { "anyOf": [ { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, { "type": "null" } ] }, "alg": { "type": "string", "enum": [ "EdDSA", "ES256" ] }, "activeMethodId": { "type": [ "string", "null" ] }, "enrolledAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "deactivatedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastSeenAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "rotationsCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lastTrustBundleSignedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "did", "displayName", "description", "scopeKind", "workspaceId", "organizationId", "alg", "activeMethodId", "enrolledAt", "deactivatedAt", "lastSeenAt", "rotationsCount", "lastTrustBundleSignedAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "agents", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "agents": [], "nextCursor": null }, "note": "List workspace-scoped agents." } ] }, { "name": "agents_identity_get", "description": "Get one enrolled agent DID with full document + rotation history.", "function_declarations": [ { "name": "agents_identity_get", "description": "Get one enrolled agent DID with full document + rotation history.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" } }, "required": [ "did" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "record": { "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "displayName": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "scopeKind": { "type": "string", "enum": [ "workspace", "organization", "agent" ] }, "workspaceId": { "anyOf": [ { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, { "type": "null" } ] }, "organizationId": { "anyOf": [ { "type": "string", "pattern": "^org_[A-Za-z0-9_-]{11,}$" }, { "type": "null" } ] }, "alg": { "type": "string", "enum": [ "EdDSA", "ES256" ] }, "activeMethodId": { "type": [ "string", "null" ] }, "enrolledAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "deactivatedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastSeenAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "rotationsCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lastTrustBundleSignedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] } }, "required": [ "did", "displayName", "description", "scopeKind", "workspaceId", "organizationId", "alg", "activeMethodId", "enrolledAt", "deactivatedAt", "lastSeenAt", "rotationsCount", "lastTrustBundleSignedAt" ], "additionalProperties": {} }, "document": {}, "rotationHistory": { "type": "array", "items": {} } }, "required": [ "record", "document", "rotationHistory" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "did": "did:web:agined.com:agents:ws_demo_default:abc" }, "output": { "record": { "did": "did:web:agined.com:agents:ws_demo_default:abc", "displayName": "GitHub Actions release attestor", "description": null, "scopeKind": "workspace", "workspaceId": "ws_demo_default", "organizationId": null, "alg": "EdDSA", "activeMethodId": "did:web:agined.com:agents:ws_demo_default:abc#key-1", "enrolledAt": "2026-05-22T12:00:00.000Z", "deactivatedAt": null, "lastSeenAt": null, "rotationsCount": 0, "lastTrustBundleSignedAt": null }, "document": {}, "rotationHistory": [] }, "note": "Read one agent DID." } ] }, { "name": "agents_identity_rotate", "description": "Rotate the signing key for an agent DID. Old key kept active for a cooldown period.", "function_declarations": [ { "name": "agents_identity_rotate", "description": "Rotate the signing key for an agent DID. Old key kept active for a cooldown period.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "reason": { "type": "string", "enum": [ "scheduled", "incident", "compromise", "operator_request", "policy_required" ] }, "rationale": { "type": "string", "minLength": 10, "maxLength": 500 }, "alg": { "type": "string", "enum": [ "EdDSA", "ES256" ] }, "cooldownSeconds": { "default": 3600, "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "did", "reason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.rotate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "newMethodId": { "type": "string" }, "oldMethodRetiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "privateKeyRecoveryEnvelope": { "type": "string" } }, "required": [ "did", "newMethodId", "oldMethodRetiresAt", "privateKeyRecoveryEnvelope" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.identity.rotated", "examples": [ { "input": { "did": "did:web:agined.com:agents:ws_demo_default:abc", "reason": "scheduled" }, "output": { "did": "did:web:agined.com:agents:ws_demo_default:abc", "newMethodId": "did:web:agined.com:agents:ws_demo_default:abc#key-2", "oldMethodRetiresAt": "2026-05-22T13:00:00.000Z", "privateKeyRecoveryEnvelope": "v1:AES-256-GCM:…" }, "note": "Quarterly key rotation." } ] }, { "name": "agents_identity_revoke", "description": "Permanently revoke an agent DID. Cannot be undone; the DID id cannot be re-enrolled.", "function_declarations": [ { "name": "agents_identity_revoke", "description": "Permanently revoke an agent DID. Cannot be undone; the DID id cannot be re-enrolled.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "reason": { "type": "string", "enum": [ "scheduled", "incident", "compromise", "operator_request", "policy_required" ] }, "rationale": { "type": "string", "minLength": 10, "maxLength": 500 }, "irreversibleAcknowledged": { "type": "boolean", "const": true } }, "required": [ "did", "reason", "irreversibleAcknowledged" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "deactivatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "did", "deactivatedAt" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.identity.revoked", "examples": [ { "input": { "did": "did:web:agined.com:agents:ws_demo_default:abc", "reason": "compromise", "irreversibleAcknowledged": true }, "output": { "did": "did:web:agined.com:agents:ws_demo_default:abc", "deactivatedAt": "2026-05-22T12:00:00.000Z" }, "note": "Compromise-recovery revoke." } ] }, { "name": "agents_identity_did_resolve", "description": "Resolve any DID (did:web, did:key, did:peer) and return the resolution result envelope.", "function_declarations": [ { "name": "agents_identity_did_resolve", "description": "Resolve any DID (did:web, did:key, did:peer) and return the resolution result envelope.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:(web|key|peer):[A-Za-z0-9.\\-_:%]+$" } }, "required": [ "did" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.did.resolve" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "didDocument": {}, "didResolutionMetadata": {}, "didDocumentMetadata": {} }, "required": [ "didDocument", "didResolutionMetadata", "didDocumentMetadata" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "did": "did:web:agined.com:agents:mandate-issuer" }, "output": { "didDocument": { "id": "did:web:agined.com:agents:mandate-issuer" }, "didResolutionMetadata": { "resolutionSource": "live", "resolvedAt": "2026-05-22T12:00:00.000Z" }, "didDocumentMetadata": {} }, "note": "Resolve a DID to its document." } ] }, { "name": "agents_identity_delegate", "description": "Issue an A2A delegation token granting a remote partner DID a scope subset on your behalf.", "function_declarations": [ { "name": "agents_identity_delegate", "description": "Issue an A2A delegation token granting a remote partner DID a scope subset on your behalf.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "fromAgentDid": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "toRemoteDid": { "type": "string", "pattern": "^did:(web|key|peer):[A-Za-z0-9.\\-_:%]+$" }, "scopes": { "minItems": 1, "type": "array", "items": { "type": "string" } }, "maxSpendUsdFractional": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "validForDays": { "default": 7, "type": "integer", "minimum": 1, "maximum": 90 }, "purposeReason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "fromAgentDid", "toRemoteDid", "scopes", "purposeReason" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.delegate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "delegationVcSerialized": { "type": "string" }, "delegationHandle": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "delegationVcSerialized", "delegationHandle", "expiresAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.delegation.issued", "examples": [ { "input": { "workspaceId": "ws_demo_default", "fromAgentDid": "did:web:agined.com:agents:ws_demo_default:abc", "toRemoteDid": "did:web:partner.example.com:agents:bot", "scopes": [ "read:audit" ], "validForDays": 7, "purposeReason": "Partner integration handoff" }, "output": { "delegationVcSerialized": "eyJhbGciOiJFZERTQSJ9…", "delegationHandle": "delg_demo00000000000000000000", "expiresAt": "2026-05-29T12:00:00.000Z" }, "note": "Issue A2A delegation." } ] }, { "name": "agents_identity_delegate_revoke", "description": "Revoke an A2A delegation. Flips its bit in the published BitstringStatusList.", "function_declarations": [ { "name": "agents_identity_delegate_revoke", "description": "Revoke an A2A delegation. Flips its bit in the published BitstringStatusList.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "delegationHandle": { "type": "string", "minLength": 1 }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "delegationHandle" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.delegate.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revokedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "listRevocable": { "type": "boolean" } }, "required": [ "revokedAt", "listRevocable" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.delegation.revoked", "examples": [ { "input": { "delegationHandle": "delg_demo00000000000000000000", "reason": "Partner integration ended" }, "output": { "revokedAt": "2026-05-22T12:00:00.000Z", "listRevocable": true }, "note": "Revoke an A2A delegation." } ] }, { "name": "agents_identity_delegate_verify", "description": "Verify a presented A2A delegation credential. Returns ok, or a structured reason.", "function_declarations": [ { "name": "agents_identity_delegate_verify", "description": "Verify a presented A2A delegation credential. Returns ok, or a structured reason.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "presentationSerialized": { "type": "string", "minLength": 1 }, "requestedScope": { "type": "string" } }, "required": [ "presentationSerialized" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.delegate.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "delegationHandle": { "type": "string" }, "vcId": { "type": "string" }, "fromAgentDid": { "type": "string" }, "toRemoteDid": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "revocationChecked": { "type": "boolean" } }, "required": [ "ok", "delegationHandle", "vcId", "fromAgentDid", "toRemoteDid", "scopes", "expiresAt", "revocationChecked" ], "additionalProperties": false }, { "type": "object", "properties": { "ok": { "type": "boolean", "const": false }, "reason": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "ok", "reason" ], "additionalProperties": false } ] }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "presentationSerialized": "eyJhbGciOiJFZERTQSJ9…", "requestedScope": "read:audit" }, "output": { "ok": true, "delegationHandle": "delg_demo00000000000000000000", "vcId": "urn:uuid:0000", "fromAgentDid": "did:web:agined.com:agents:ws_demo_default:abc", "toRemoteDid": "did:web:partner.example.com:agents:bot", "scopes": [ "read:audit" ], "expiresAt": "2026-05-29T12:00:00.000Z", "revocationChecked": true }, "note": "Verify a presented A2A delegation." } ] }, { "name": "agents_identity_authority_get", "description": "Resolve who an agent acts on behalf of, from verified identity rather than operator configuration.", "function_declarations": [ { "name": "agents_identity_authority_get", "description": "Resolve who an agent acts on behalf of, from verified identity rather than operator configuration.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "agentDid": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "selfAsserted": { "type": "string" } }, "required": [ "agentDid" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.identity.authority.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "agentDid": { "type": "string" }, "confidence": { "type": "string", "enum": [ "verified", "unverified", "conflicted" ] }, "grade": { "type": "string", "enum": [ "self-asserted", "domain-control", "workload-identity", "tenant-attested", "business-verified", "wallet-attested" ] }, "principal": { "type": [ "string", "null" ] }, "source": { "type": [ "string", "null" ] }, "basis": { "type": "string" }, "reliedOn": { "type": "array", "items": { "type": "string" } }, "competingPrincipals": { "type": "array", "items": { "type": "string" } }, "evidence": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "principal": { "type": "string" }, "verified": { "type": "boolean" }, "failureReason": { "type": "string" } }, "required": [ "source", "principal", "verified" ], "additionalProperties": false } } }, "required": [ "agentDid", "confidence", "grade", "principal", "source", "basis", "reliedOn", "competingPrincipals", "evidence" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "agentDid": "did:web:agined.com:agents:ws_demo_default:abc" }, "output": { "agentDid": "did:web:agined.com:agents:ws_demo_default:abc", "confidence": "verified", "grade": "tenant-attested", "principal": "did:web:agined.com:workspaces:ws_demo_default", "source": "ap2-mandate", "basis": "A mandate signed by the workspace principal names this agent.", "reliedOn": [ "Art. 50(1)", "Art. 50(1) — on-whose-behalf element" ], "competingPrincipals": [], "evidence": [ { "source": "ap2-mandate", "principal": "did:web:agined.com:workspaces:ws_demo_default", "verified": true } ] }, "note": "Resolve the on-whose-behalf value." } ] }, { "name": "agents_mandate_issue", "description": "Issue an AP2 Verifiable Credential mandate authorising an agent up to spend / volume limits.", "function_declarations": [ { "name": "agents_mandate_issue", "description": "Issue an AP2 Verifiable Credential mandate authorising an agent up to spend / volume limits.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "agentDid": { "type": "string", "pattern": "^did:(web|key|peer):[A-Za-z0-9.\\-_:%]+$" }, "allowedActionIds": { "minItems": 1, "type": "array", "items": { "type": "string" } }, "maxSafetyLevel": { "type": "string", "enum": [ "read", "mutation", "destructive", "billing_impacting" ] }, "workspaceIds": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "maxSpendUsdFractional": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "maxInvocations": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "validForDays": { "default": 30, "type": "integer", "minimum": 1, "maximum": 365 } }, "required": [ "label", "agentDid", "allowedActionIds", "maxSafetyLevel", "workspaceIds" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.mandate.issue" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mandateHandle": { "type": "string", "pattern": "^mandate_[0-9A-Z]{20,}$" }, "vcId": { "type": "string", "pattern": "^urn:uuid:[0-9a-f-]{36}$" }, "sdJwtVcSerialized": { "type": "string" }, "validUntil": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "issuerDid": { "type": "string" } }, "required": [ "mandateHandle", "vcId", "sdJwtVcSerialized", "validUntil", "issuerDid" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.mandate.issued", "examples": [ { "input": { "label": "Stripe refund bot — Q3", "agentDid": "did:web:agined.com:agents:ws_demo_default:refund-bot", "allowedActionIds": [ "billing.subscription.upgrade", "tools.attest.agent-call" ], "maxSafetyLevel": "billing_impacting", "workspaceIds": [ "ws_demo_default" ], "maxSpendUsdFractional": 50000, "maxInvocations": 100, "validForDays": 30 }, "output": { "mandateHandle": "mandate_DEMO00000000000000000000", "vcId": "urn:uuid:11111111-2222-3333-4444-555555555555", "sdJwtVcSerialized": "eyJhbGciOiJFZERTQSJ9…~WyJzYWx0Iiw…~", "validUntil": "2026-06-21T12:00:00.000Z", "issuerDid": "did:web:agined.com:agents:mandate-issuer" }, "note": "Issue an AP2 mandate." } ] }, { "name": "agents_mandate_list", "description": "List mandates issued under the principal.", "function_declarations": [ { "name": "agents_mandate_list", "description": "List mandates issued under the principal.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "activeOnly": { "default": false, "type": "boolean" } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.mandate.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mandates": { "type": "array", "items": { "type": "object", "properties": { "mandateHandle": { "type": "string", "pattern": "^mandate_[0-9A-Z]{20,}$" }, "vcId": { "type": "string", "pattern": "^urn:uuid:[0-9a-f-]{36}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "agentDid": { "type": "string", "pattern": "^did:(web|key|peer):[A-Za-z0-9.\\-_:%]+$" }, "agentDisplayName": { "type": "string" }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "validUntil": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "revokedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "revocationReason": { "type": [ "string", "null" ] } }, "required": [ "mandateHandle", "vcId", "label", "agentDid", "agentDisplayName", "issuedAt", "validUntil", "revokedAt", "revocationReason" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "mandates", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "mandates": [], "nextCursor": null }, "note": "List mandates." } ] }, { "name": "agents_mandate_verify", "description": "Verify a presented mandate VC against an action request. Returns ok or a structured reason.", "function_declarations": [ { "name": "agents_mandate_verify", "description": "Verify a presented mandate VC against an action request. Returns ok or a structured reason.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "presentationSerialized": { "type": "string" }, "requestedActionId": { "type": "string" }, "estimatedSpendUsdFractional": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "audience": { "type": "string", "format": "uri" }, "nonce": { "type": "string", "minLength": 8 } }, "required": [ "presentationSerialized", "requestedActionId", "audience", "nonce" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.mandate.verify" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "mandateHandle": { "type": "string", "pattern": "^mandate_[0-9A-Z]{20,}$" }, "vcId": { "type": "string", "pattern": "^urn:uuid:[0-9a-f-]{36}$" }, "remainingSpendUsdFractional": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "remainingInvocations": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "issuerResolutionSource": { "type": "string", "enum": [ "live", "cache", "ots-anchored-cold" ] } }, "required": [ "ok", "mandateHandle", "vcId", "issuerResolutionSource" ], "additionalProperties": false }, { "type": "object", "properties": { "ok": { "type": "boolean", "const": false }, "reason": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "ok", "reason" ], "additionalProperties": false } ] }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "presentationSerialized": "eyJhbGciOiJFZERTQSJ9…", "requestedActionId": "billing.subscription.upgrade", "audience": "https://api.agined.com", "nonce": "abc123abc123" }, "output": { "ok": true, "mandateHandle": "mandate_DEMO00000000000000000000", "vcId": "urn:uuid:11111111-2222-3333-4444-555555555555", "remainingSpendUsdFractional": 25000, "remainingInvocations": 50, "issuerResolutionSource": "live" }, "note": "Verify a mandate." } ] }, { "name": "agents_mandate_revoke", "description": "Revoke a mandate, and every A2A delegation the agent issued under it (the kill chain). Goes into the BitstringStatusList revocation register immediately.", "function_declarations": [ { "name": "agents_mandate_revoke", "description": "Revoke a mandate, and every A2A delegation the agent issued under it (the kill chain). Goes into the BitstringStatusList revocation register immediately.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "mandateHandle": { "type": "string", "pattern": "^mandate_[0-9A-Z]{20,}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "mandateHandle" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.mandate.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revokedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "cascade": { "type": "object", "properties": { "delegationsRevoked": { "type": "array", "items": { "type": "string" }, "description": "Delegation handles withdrawn by this revoke." }, "notWalked": { "type": "array", "items": { "type": "string" }, "description": "Delegate DIDs whose OWN delegations were not reached because the walk hit its depth cap. Their delegations are still active and must be revoked directly." }, "depth": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "How many hops the walk went." }, "complete": { "type": "boolean", "description": "False when anything was left un-walked or a write failed." }, "keysStillLive": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Live API keys that were minted under this mandate and are STILL ACTIVE. Revoking a mandate does not revoke what it minted (BLOCKED-ON-JAKE §27) — these must be revoked directly. Zero means none were minted under it, not that none were checked." } }, "required": [ "delegationsRevoked", "notWalked", "depth", "complete", "keysStillLive" ], "additionalProperties": false } }, "required": [ "revokedAt", "cascade" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.mandate.revoked", "examples": [ { "input": { "mandateHandle": "mandate_DEMO00000000000000000000" }, "output": { "revokedAt": "2026-05-22T12:00:00.000Z", "cascade": { "delegationsRevoked": [ "delg_abc" ], "notWalked": [], "depth": 1, "complete": true, "keysStillLive": 2 } }, "note": "Revoking the mandate also withdrew one delegation the agent had issued — and named the two API keys it minted, which are STILL LIVE and must be revoked directly." } ] }, { "name": "agents_spiffe_bind", "description": "Bind a SPIFFE ID to an agent DID so its JWT-SVIDs can attest as that agent.", "function_declarations": [ { "name": "agents_spiffe_bind", "description": "Bind a SPIFFE ID to an agent DID so its JWT-SVIDs can attest as that agent.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "agentDid": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "spiffeId": { "type": "string", "pattern": "^spiffe:\\/\\/[A-Za-z0-9.\\-]+(\\/[A-Za-z0-9._\\-/]*)?$" }, "svidType": { "type": "string", "enum": [ "jwt" ] } }, "required": [ "agentDid", "spiffeId", "svidType" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.spiffe.bind" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "agentDid": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "spiffeId": { "type": "string", "pattern": "^spiffe:\\/\\/[A-Za-z0-9.\\-]+(\\/[A-Za-z0-9._\\-/]*)?$" }, "boundAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "agentDid", "spiffeId", "boundAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.spiffe.bound", "examples": [ { "input": { "agentDid": "did:web:agined.com:agents:ws_demo_default:abc", "spiffeId": "spiffe://corp.example.com/svc/billing", "svidType": "jwt" }, "output": { "agentDid": "did:web:agined.com:agents:ws_demo_default:abc", "spiffeId": "spiffe://corp.example.com/svc/billing", "boundAt": "2026-05-22T12:00:00.000Z" }, "note": "Bind SPIFFE workload to agent." } ] }, { "name": "agents_spiffe_unbind", "description": "Unbind a SPIFFE ID from its agent DID so its SVIDs stop attesting as that agent.", "function_declarations": [ { "name": "agents_spiffe_unbind", "description": "Unbind a SPIFFE ID from its agent DID so its SVIDs stop attesting as that agent.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "spiffeId": { "type": "string", "pattern": "^spiffe:\\/\\/[A-Za-z0-9.\\-]+(\\/[A-Za-z0-9._\\-/]*)?$" } }, "required": [ "spiffeId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.spiffe.unbind" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "spiffeId": { "type": "string", "pattern": "^spiffe:\\/\\/[A-Za-z0-9.\\-]+(\\/[A-Za-z0-9._\\-/]*)?$" }, "unboundAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "spiffeId", "unboundAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.spiffe.unbound", "examples": [ { "input": { "spiffeId": "spiffe://corp.example.com/svc/billing" }, "output": { "spiffeId": "spiffe://corp.example.com/svc/billing", "unboundAt": "2026-08-23T12:00:00.000Z" }, "note": "Stop a decommissioned workload attesting as this agent." } ] }, { "name": "agents_spiffe_workload_attest", "description": "Exchange a SPIFFE SVID for a short-lived DPoP-bound Agined session.", "function_declarations": [ { "name": "agents_spiffe_workload_attest", "description": "Exchange a SPIFFE SVID for a short-lived DPoP-bound Agined session.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "svid": { "type": "object", "properties": { "type": { "type": "string", "const": "jwt" }, "token": { "type": "string" } }, "required": [ "type", "token" ] }, "dpopKey": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "svid", "dpopKey" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.spiffe.workload.attest" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sessionToken": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "agentDid": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "effectiveScopes": { "type": "array", "items": { "type": "string" } } }, "required": [ "sessionToken", "expiresAt", "agentDid", "effectiveScopes" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.spiffe.workload_attested", "examples": [ { "input": { "svid": { "type": "jwt", "token": "eyJhbGciOiJFZERTQSJ9…" }, "dpopKey": { "kty": "OKP", "crv": "Ed25519", "x": "" } }, "output": { "sessionToken": "av_sess_demo…", "expiresAt": "2026-05-22T12:05:00.000Z", "agentDid": "did:web:agined.com:agents:ws_demo_default:abc", "effectiveScopes": [ "read:audit" ] }, "note": "Workload exchange." } ] }, { "name": "agents_trusted-roots_list", "description": "List partner organization DIDs the workspace accepts as A2A federation roots.", "function_declarations": [ { "name": "agents_trusted-roots_list", "description": "List partner organization DIDs the workspace accepts as A2A federation roots.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.trusted-roots.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "roots": { "type": "array", "items": { "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "organizationName": { "type": "string" }, "trustedSince": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "maxAcceptedSafetyLevel": { "type": "string", "enum": [ "read", "mutation", "destructive", "billing_impacting" ] }, "allowsFederation": { "type": "boolean" } }, "required": [ "did", "organizationName", "trustedSince", "maxAcceptedSafetyLevel", "allowsFederation" ], "additionalProperties": false } } }, "required": [ "roots" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "roots": [] }, "note": "List trusted A2A roots." } ] }, { "name": "agents_trusted-roots_add", "description": "Add a partner organization DID to the trusted-roots list for this workspace.", "function_declarations": [ { "name": "agents_trusted-roots_add", "description": "Add a partner organization DID to the trusted-roots list for this workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "organizationName": { "type": "string", "minLength": 1, "maxLength": 80 }, "maxAcceptedSafetyLevel": { "default": "mutation", "type": "string", "enum": [ "read", "mutation", "destructive", "billing_impacting" ] }, "allowsFederation": { "default": false, "type": "boolean" } }, "required": [ "workspaceId", "did", "organizationName" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.trusted-roots.add" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "addedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "addedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.trusted_root.added", "examples": [ { "input": { "workspaceId": "ws_demo_default", "did": "did:web:partner.example.com", "organizationName": "Partner Example Corp", "maxAcceptedSafetyLevel": "mutation" }, "output": { "addedAt": "2026-05-22T12:00:00.000Z" }, "note": "Add federated root." } ] }, { "name": "agents_trusted-roots_remove", "description": "Remove a partner organization DID from the trusted-roots list for this workspace.", "function_declarations": [ { "name": "agents_trusted-roots_remove", "description": "Remove a partner organization DID from the trusted-roots list for this workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" } }, "required": [ "workspaceId", "did" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/agents.trusted-roots.remove" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "did": { "type": "string", "pattern": "^did:web:[A-Za-z0-9.\\-_:%]+$" }, "removedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "did", "removedAt" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent.trusted_root.removed", "examples": [ { "input": { "workspaceId": "ws_demo_default", "did": "did:web:partner.example.com" }, "output": { "did": "did:web:partner.example.com", "removedAt": "2026-08-23T12:00:00.000Z" }, "note": "Stop trusting a federated root." } ] }, { "name": "fabric_retrieve_signed", "description": "Query the fabric and seal the result as a signed-retrieval receipt — the query hash plus every returned record's content hash, so a grounded claim can be proved after the fact.", "function_declarations": [ { "name": "fabric_retrieve_signed", "description": "Query the fabric and seal the result as a signed-retrieval receipt — the query hash plus every returned record's content hash, so a grounded claim can be proved after the fact.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kinds": { "maxItems": 23, "type": "array", "items": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] } }, "sourceId": { "type": "string" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 }, "embeddingModel": { "description": "The model that produced the grounding, when one did. Absent records `none/structured-query` — the fabric does not embed, and asserting a model would be a claim nobody made.", "type": "string" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.retrieve.signed" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "records": { "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sourceId": { "type": "string" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "connectionLabel": { "type": "string" }, "kind": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] }, "payload": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "extractedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "contentHash": { "type": "string" }, "anchorUrl": { "type": [ "string", "null" ] } }, "required": [ "recordId", "workspaceId", "sourceId", "connectionId", "connectionLabel", "kind", "payload", "observedAt", "extractedAt", "contentHash", "anchorUrl" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] }, "retrieval": { "type": "object", "properties": { "retrievalRef": { "type": "string" }, "queryHash": { "type": "string", "description": "SHA-256 over the canonicalised FILTERS — not a rendered query string, which would differ over whitespace." }, "sources": { "type": "array", "items": { "type": "object", "properties": { "sourceRef": { "type": "string" }, "contentSha256": { "type": "string", "description": "SHA-256 over the record's canonicalised payload, computed at retrieval time. Hashing the id instead would verify perfectly and prove nothing." }, "score": { "type": "number" } }, "required": [ "sourceRef", "contentSha256", "score" ], "additionalProperties": false } }, "retrievedAt": { "type": "string" }, "sealed": { "type": "boolean" }, "artifactId": { "type": [ "string", "null" ] }, "unsealedReason": { "description": "Why it could not be sealed, when it could not. Never a fabricated artifact id.", "type": [ "string", "null" ] } }, "required": [ "retrievalRef", "queryHash", "sources", "retrievedAt", "sealed", "artifactId", "unsealedReason" ], "additionalProperties": {} } }, "required": [ "records", "nextCursor", "retrieval" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "agent_invocation", "examples": [ { "input": { "workspaceId": "ws_demo_default", "kinds": [ "policy-clause" ] }, "output": { "records": [], "nextCursor": null, "retrieval": { "retrievalRef": "ret_…", "queryHash": "…", "sources": [], "retrievedAt": "2026-09-03T00:00:00.000Z", "sealed": true, "artifactId": "art_01J…", "unsealedReason": null } }, "note": "Ground a claim on policy clauses, provably." } ] }, { "name": "fabric_memory_snapshot", "description": "Snapshot the fabric's records as a signed memory-attestation receipt — entry count, Merkle root over every entry's content hash, and the provenance window — so an export can be verified without trusting the exporter.", "function_declarations": [ { "name": "fabric_memory_snapshot", "description": "Snapshot the fabric's records as a signed memory-attestation receipt — entry count, Merkle root over every entry's content hash, and the provenance window — so an export can be verified without trusting the exporter.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kinds": { "maxItems": 23, "type": "array", "items": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] } }, "sourceId": { "type": "string" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "since": { "description": "Only entries extracted at or after this instant. Narrows a memory too large to snapshot whole.", "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.memory.snapshot" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "snapshot": { "type": "object", "properties": { "agentRef": { "type": "string", "description": "The acting agent's DID, as verified by the gateway — never a caller-supplied value." }, "snapshotRef": { "type": "string" }, "entryCount": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "merkleRoot": { "type": "string", "description": "Domain-separated binary Merkle root over every entry's content hash, leaves in record-id order. An empty memory has the well-defined root SHA-256(\"\")." }, "earliestEntryAt": { "description": "Null when the memory is empty — no window, which is not the same as a zero-length one.", "type": [ "string", "null" ] }, "latestEntryAt": { "type": [ "string", "null" ] }, "snapshotAt": { "type": "string" }, "sealed": { "type": "boolean" }, "artifactId": { "type": [ "string", "null" ] }, "unsealedReason": { "description": "Why it could not be sealed, when it could not. The root is still returned — it is re-derivable from the export — but never a fabricated artifact id.", "type": [ "string", "null" ] } }, "required": [ "agentRef", "snapshotRef", "entryCount", "merkleRoot", "earliestEntryAt", "latestEntryAt", "snapshotAt", "sealed", "artifactId", "unsealedReason" ], "additionalProperties": {} } }, "required": [ "snapshot" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "mandate", "require_user_attestation": true }, "rate_limit_class": "billing", "audit_kind": "agent_invocation", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "snapshot": { "agentRef": "did:key:z6Mk…", "snapshotRef": "mem_…", "entryCount": 42, "merkleRoot": "…", "earliestEntryAt": "2026-08-01T00:00:00.000Z", "latestEntryAt": "2026-09-04T00:00:00.000Z", "snapshotAt": "2026-09-04T00:00:00.000Z", "sealed": true, "artifactId": "art_01J…", "unsealedReason": null } }, "note": "Make an agent's memory portable and independently checkable." } ] }, { "name": "fabric_sources_catalog", "description": "List the connectable source catalog — each source's category, purpose, auth method, and the engine classes it contributes.", "function_declarations": [ { "name": "fabric_sources_catalog", "description": "List the connectable source catalog — each source's category, purpose, auth method, and the engine classes it contributes.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "category": { "type": "string", "enum": [ "identity", "crm", "hris", "finance", "collab", "devtools", "endpoint" ] }, "purpose": { "type": "string", "enum": [ "catalogue", "inventory", "endpoint" ] }, "query": { "type": "string", "maxLength": 200 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.sources.catalog" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "vendor": { "type": "string" }, "category": { "type": "string", "enum": [ "identity", "crm", "hris", "finance", "collab", "devtools", "endpoint" ] }, "purpose": { "type": "array", "items": { "type": "string", "enum": [ "catalogue", "inventory", "endpoint" ] } }, "authMethod": { "type": "string", "enum": [ "oauth2", "api_key", "service_account" ] }, "contributes": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "docsUrl": { "type": "string" }, "description": { "type": "string" } }, "required": [ "id", "vendor", "category", "purpose", "authMethod", "contributes", "status", "docsUrl", "description" ], "additionalProperties": {} } } }, "required": [ "sources" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "category": "devtools" }, "output": { "sources": [] }, "note": "Browse developer-tool sources." } ] }, { "name": "fabric_connections_connect", "description": "Connect a catalog source (BYO credentials) into the fabric. The connection's records broadcast to every subscribing product.", "function_declarations": [ { "name": "fabric_connections_connect", "description": "Connect a catalog source (BYO credentials) into the fabric. The connection's records broadcast to every subscribing product.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sourceId": { "type": "string", "minLength": 1, "maxLength": 120 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 }, "scope": { "default": [], "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 300 } }, "syncSchedule": { "default": "daily", "type": "string", "enum": [ "manual", "hourly", "daily", "event" ] }, "connectionRef": { "type": "string", "maxLength": 500 }, "credential": { "type": "string", "maxLength": 8192 } }, "required": [ "workspaceId", "sourceId", "label" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.connections.connect" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sourceId": { "type": "string" }, "category": { "type": "string", "enum": [ "identity", "crm", "hris", "finance", "collab", "devtools", "endpoint" ] }, "authMethod": { "type": "string", "enum": [ "oauth2", "api_key", "service_account" ] }, "label": { "type": "string" }, "scope": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "pending", "connected", "error", "revoked" ] }, "syncState": { "type": "string", "enum": [ "never", "syncing", "healthy", "stale", "error" ] }, "emits": { "type": "array", "items": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] } }, "lastSyncAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "connectionRef": { "type": [ "string", "null" ] }, "credentialRef": { "type": [ "string", "null" ] }, "syncSchedule": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "connectionId", "workspaceId", "sourceId", "category", "authMethod", "label", "scope", "state", "syncState", "emits", "lastSyncAt", "connectionRef", "credentialRef", "syncSchedule", "createdAt" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "sourceId": "jira", "label": "Acme Jira", "scope": [ "ACME" ], "syncSchedule": "daily" }, "output": { "connectionId": "01J9X4P9R7Z2C1A1F2A8VBJYS1", "workspaceId": "ws_demo_default", "sourceId": "jira", "category": "devtools", "authMethod": "oauth2", "label": "Acme Jira", "scope": [ "ACME" ], "state": "pending", "syncState": "never", "emits": [ "ticket" ], "lastSyncAt": null, "connectionRef": null, "credentialRef": null, "syncSchedule": "daily", "createdAt": "2026-05-22T12:00:00.000Z" }, "note": "Connect Jira — an OAuth source stays pending until its oauth/start → callback completes." } ] }, { "name": "fabric_connections_list", "description": "List the workspace's fabric connections with their sync health.", "function_declarations": [ { "name": "fabric_connections_list", "description": "List the workspace's fabric connections with their sync health.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sourceId": { "type": "string" }, "category": { "type": "string", "enum": [ "identity", "crm", "hris", "finance", "collab", "devtools", "endpoint" ] } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.connections.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "connections": { "type": "array", "items": { "type": "object", "properties": { "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sourceId": { "type": "string" }, "category": { "type": "string", "enum": [ "identity", "crm", "hris", "finance", "collab", "devtools", "endpoint" ] }, "authMethod": { "type": "string", "enum": [ "oauth2", "api_key", "service_account" ] }, "label": { "type": "string" }, "scope": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "enum": [ "pending", "connected", "error", "revoked" ] }, "syncState": { "type": "string", "enum": [ "never", "syncing", "healthy", "stale", "error" ] }, "emits": { "type": "array", "items": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] } }, "lastSyncAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "connectionRef": { "type": [ "string", "null" ] }, "credentialRef": { "type": [ "string", "null" ] }, "syncSchedule": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "connectionId", "workspaceId", "sourceId", "category", "authMethod", "label", "scope", "state", "syncState", "emits", "lastSyncAt", "connectionRef", "credentialRef", "syncSchedule", "createdAt" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "connections", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "connections": [], "nextCursor": null }, "note": "List connections." } ] }, { "name": "fabric_connections_sync", "description": "Enqueue an on-demand sync + re-extraction of a fabric connection.", "function_declarations": [ { "name": "fabric_connections_sync", "description": "Enqueue an on-demand sync + re-extraction of a fabric connection.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" } }, "required": [ "workspaceId", "connectionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.connections.sync" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enqueued": { "type": "boolean" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" } }, "required": [ "enqueued", "connectionId" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "connectionId": "01J9X4P9R7Z2C1A1F2A8VBJYS1" }, "output": { "enqueued": true, "connectionId": "01J9X4P9R7Z2C1A1F2A8VBJYS1" }, "note": "Sync now." } ] }, { "name": "fabric_connections_revoke", "description": "Revoke a fabric connection — purges its extracted records per the platform's data-handling terms.", "function_declarations": [ { "name": "fabric_connections_revoke", "description": "Revoke a fabric connection — purges its extracted records per the platform's data-handling terms.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "reason": { "type": "string", "minLength": 10, "maxLength": 500 } }, "required": [ "workspaceId", "connectionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.connections.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" }, "recordsPurged": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "revoked", "recordsPurged" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "connectionId": "01J9X4P9R7Z2C1A1F2A8VBJYS1" }, "output": { "revoked": true, "recordsPurged": 1280 }, "note": "Revoke + purge." } ] }, { "name": "fabric_webhooks_list", "description": "List the workspace's inbound webhook endpoints, with which sources can push and whether each scheme binds the body.", "function_declarations": [ { "name": "fabric_webhooks_list", "description": "List the workspace's inbound webhook endpoints, with which sources can push and whether each scheme binds the body.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.webhooks.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endpoints": { "type": "array", "items": { "type": "object", "properties": { "endpointId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "sourceId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "lastEventAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastErrorAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, { "type": "null" } ] }, "lastError": { "type": [ "string", "null" ] } }, "required": [ "endpointId", "workspaceId", "connectionId", "sourceId", "createdAt", "lastEventAt", "lastErrorAt", "lastError" ], "additionalProperties": false } }, "supportedSources": { "type": "array", "items": { "type": "object", "properties": { "sourceId": { "type": "string" }, "label": { "type": "string" }, "signatureHeader": { "type": "string" }, "bindsBody": { "type": "boolean" } }, "required": [ "sourceId", "label", "signatureHeader", "bindsBody" ], "additionalProperties": false } } }, "required": [ "endpoints", "supportedSources" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default" }, "output": { "endpoints": [], "supportedSources": [] }, "note": "What can push, and what has." } ] }, { "name": "fabric_webhooks_open", "description": "Open an inbound webhook endpoint for a connection — returns the signing secret ONCE.", "function_declarations": [ { "name": "fabric_webhooks_open", "description": "Open an inbound webhook endpoint for a connection — returns the signing secret ONCE.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" } }, "required": [ "workspaceId", "connectionId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.webhooks.open" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endpointId": { "type": "string" }, "sourceId": { "type": "string" }, "deliveryPath": { "type": "string" }, "signatureHeader": { "type": "string" }, "secret": { "type": "string" } }, "required": [ "endpointId", "sourceId", "deliveryPath", "signatureHeader", "secret" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "connectionId": "01J9X4P9R7Z2C1A1F2A8VBJYS1" }, "output": { "endpointId": "01J9X4P9R7Z2C1A1F2A8VBJYS2", "sourceId": "github", "deliveryPath": "/api/v1/fabric/deliveries/01J9X4P9R7Z2C1A1F2A8VBJYS2", "signatureHeader": "x-hub-signature-256", "secret": "shown-once" }, "note": "Open an endpoint for a GitHub connection." } ] }, { "name": "fabric_webhooks_revoke", "description": "Revoke an inbound webhook endpoint — deliveries to it stop immediately.", "function_declarations": [ { "name": "fabric_webhooks_revoke", "description": "Revoke an inbound webhook endpoint — deliveries to it stop immediately.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "endpointId": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "workspaceId", "endpointId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.webhooks.revoke" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "revoked": { "type": "boolean" }, "endpointId": { "type": "string" } }, "required": [ "revoked", "endpointId" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "workspaceId": "ws_demo_default", "endpointId": "01J9X4P9R7Z2C1A1F2A8VBJYS2" }, "output": { "revoked": true, "endpointId": "01J9X4P9R7Z2C1A1F2A8VBJYS2" }, "note": "Stop accepting pushes." } ] }, { "name": "fabric_records_query", "description": "Query extracted records by kind / source / subscriber — the universal read every product (and agent) uses to consume the fabric.", "function_declarations": [ { "name": "fabric_records_query", "description": "Query extracted records by kind / source / subscriber — the universal read every product (and agent) uses to consume the fabric.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string" }, "limit": { "default": 25, "type": "integer", "minimum": 1, "maximum": 100 }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "kinds": { "maxItems": 23, "type": "array", "items": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] } }, "sourceId": { "type": "string" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "subscriber": { "type": "string", "enum": [ "tools", "actionflow", "norman", "magazine" ] }, "since": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" } }, "required": [ "workspaceId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.records.query" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "records": { "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string" }, "workspaceId": { "type": "string", "pattern": "^(?:agn-ws|ws)_[A-Za-z0-9_-]{11,}$" }, "sourceId": { "type": "string" }, "connectionId": { "type": "string", "pattern": "^[0-9A-HJKMNP-TV-Z]{26}$" }, "connectionLabel": { "type": "string" }, "kind": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] }, "payload": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "extractedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}(?:Z))$" }, "contentHash": { "type": "string" }, "anchorUrl": { "type": [ "string", "null" ] } }, "required": [ "recordId", "workspaceId", "sourceId", "connectionId", "connectionLabel", "kind", "payload", "observedAt", "extractedAt", "contentHash", "anchorUrl" ], "additionalProperties": {} } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "records", "nextCursor" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "workspaceId": "ws_demo_default", "kinds": [ "policy-clause" ] }, "output": { "records": [], "nextCursor": null }, "note": "Read policy clauses across all sources." } ] }, { "name": "fabric_subscriptions_matrix", "description": "Return the fabric subscription matrix — which product consumes which record kinds, and how many products each kind powers.", "function_declarations": [ { "name": "fabric_subscriptions_matrix", "description": "Return the fabric subscription matrix — which product consumes which record kinds, and how many products each kind powers.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriber": { "type": "string", "enum": [ "tools", "actionflow", "norman", "magazine" ] } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/fabric.subscriptions.matrix" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptions": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "array", "items": { "type": "string", "enum": [ "code-identifier", "commit", "review", "approval", "doc-chunk", "prose-section", "glossary-entry", "policy-clause", "faq-entry", "published-article", "metric-definition", "view-definition", "warehouse-schema", "api-spec-field", "event-taxonomy", "ui-string", "spreadsheet-row", "communication-message", "communication-thread", "ticket", "pricing-rule", "invoice-row", "webhook-event" ] } } }, "kindReach": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } } }, "required": [ "subscriptions", "kindReach" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "subscriptions": {}, "kindReach": {} }, "note": "Introspect the matrix." } ] }, { "name": "actionflow_flows_list", "description": "List the workspace's ActionFlow flows.", "function_declarations": [ { "name": "actionflow_flows_list", "description": "List the workspace's ActionFlow flows.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.flows.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "flows": { "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string" }, "id": { "type": "string" }, "workspaceId": { "type": "string" }, "tenantId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "properties": {}, "additionalProperties": {} }, "triggers": { "type": "array", "items": {} }, "steps": { "type": "array", "items": {} }, "version": { "type": "object", "properties": { "semver": { "type": "string" }, "status": { "type": "string" }, "publishedAt": { "type": "string" } }, "required": [ "semver", "status" ], "additionalProperties": {} }, "authoredBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "schemaVersion", "id", "workspaceId", "name", "tags", "source", "triggers", "steps", "version", "createdAt", "updatedAt" ], "additionalProperties": {} } } }, "required": [ "flows" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "flows": [] }, "note": "List flows." } ] }, { "name": "actionflow_flows_run", "description": "Run a flow — trigger an execution through the bounded graph engine.", "function_declarations": [ { "name": "actionflow_flows_run", "description": "Run a flow — trigger an execution through the bounded graph engine.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "Flow id." }, "input": { "description": "Optional run input passed to the flow's variable scope." }, "mode": { "description": "Sandbox runs execute the graph without real side effects (default real).", "type": "string", "enum": [ "real", "sandbox" ] }, "async": { "description": "true → queue-backed run: returns a 'queued' execution immediately; poll executions.list for state. Default runs inline.", "type": "boolean" } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.flows.run" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "execution": { "type": "object", "properties": { "executionId": { "type": "string" }, "flowId": { "type": "string" }, "flowVersion": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" }, "initiatedBy": { "type": "object", "properties": {}, "additionalProperties": {} }, "triggeredBy": { "type": "object", "properties": {}, "additionalProperties": {} }, "status": { "type": "string" }, "stepStates": { "type": "object", "properties": {}, "additionalProperties": {} }, "result": {}, "error": {}, "mode": { "type": "string" }, "startedAt": { "type": "string" }, "completedAt": { "type": "string" }, "waiting": { "type": "boolean" } }, "required": [ "executionId", "flowId", "workspaceId", "initiatedBy", "triggeredBy", "status", "stepStates", "mode", "startedAt", "waiting" ], "additionalProperties": {} } }, "required": [ "execution" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "flow_incident", "input": { "severity": "high" } }, "output": { "execution": { "executionId": "exec_…", "flowId": "flow_incident", "workspaceId": "ws_…", "initiatedBy": {}, "triggeredBy": {}, "status": "succeeded", "stepStates": {}, "mode": "real", "startedAt": "2026-08-10T00:00:00Z", "waiting": false } }, "note": "Run the incident flow." } ] }, { "name": "actionflow_flows_publish", "description": "Publish a flow (make the current draft the live version).", "function_declarations": [ { "name": "actionflow_flows_publish", "description": "Publish a flow (make the current draft the live version).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1 } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.flows.publish" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "flow": { "type": "object", "properties": { "schemaVersion": { "type": "string" }, "id": { "type": "string" }, "workspaceId": { "type": "string" }, "tenantId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "properties": {}, "additionalProperties": {} }, "triggers": { "type": "array", "items": {} }, "steps": { "type": "array", "items": {} }, "version": { "type": "object", "properties": { "semver": { "type": "string" }, "status": { "type": "string" }, "publishedAt": { "type": "string" } }, "required": [ "semver", "status" ], "additionalProperties": {} }, "authoredBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "schemaVersion", "id", "workspaceId", "name", "tags", "source", "triggers", "steps", "version", "createdAt", "updatedAt" ], "additionalProperties": {} } }, "required": [ "flow" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "flow_incident" }, "output": { "flow": { "schemaVersion": "1.0", "id": "flow_incident", "workspaceId": "ws_…", "name": "Incident flow", "tags": [], "source": {}, "triggers": [], "steps": [], "version": { "semver": "0.1.0", "status": "published" }, "createdAt": "2026-08-10T00:00:00Z", "updatedAt": "2026-08-10T00:00:00Z" } }, "note": "Publish a flow." } ] }, { "name": "actionflow_flows_deprecate", "description": "Retire a published flow. It stops running on its triggers; its execution history is kept.", "function_declarations": [ { "name": "actionflow_flows_deprecate", "description": "Retire a published flow. It stops running on its triggers; its execution history is kept.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1 } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.flows.deprecate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "flow": { "type": "object", "properties": { "schemaVersion": { "type": "string" }, "id": { "type": "string" }, "workspaceId": { "type": "string" }, "tenantId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "properties": {}, "additionalProperties": {} }, "triggers": { "type": "array", "items": {} }, "steps": { "type": "array", "items": {} }, "version": { "type": "object", "properties": { "semver": { "type": "string" }, "status": { "type": "string" }, "publishedAt": { "type": "string" } }, "required": [ "semver", "status" ], "additionalProperties": {} }, "authoredBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "schemaVersion", "id", "workspaceId", "name", "tags", "source", "triggers", "steps", "version", "createdAt", "updatedAt" ], "additionalProperties": {} } }, "required": [ "flow" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "flow_incident" }, "output": { "flow": { "schemaVersion": "1.0", "id": "flow_incident", "workspaceId": "ws_…", "name": "Incident flow", "tags": [], "source": {}, "triggers": [], "steps": [], "version": { "semver": "1.0.0", "status": "deprecated", "deprecatedAt": "2026-08-24T12:00:00Z" }, "createdAt": "2026-08-10T00:00:00Z", "updatedAt": "2026-08-24T12:00:00Z" } }, "note": "Retire a published flow." } ] }, { "name": "actionflow_templates_list", "description": "List the ActionFlow starter templates.", "function_declarations": [ { "name": "actionflow_templates_list", "description": "List the ActionFlow starter templates.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.templates.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "templates": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "name", "description", "tags" ], "additionalProperties": {} } } }, "required": [ "templates" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "templates": [ { "id": "tmpl_incident_alert", "name": "Sentinel incident → alert", "description": "When Sentinel opens a high-severity incident, emit an alert webhook.", "tags": [ "security", "alerting" ] } ] }, "note": "Browse templates." } ] }, { "name": "actionflow_templates_instantiate", "description": "Instantiate a template into a new draft flow in the workspace.", "function_declarations": [ { "name": "actionflow_templates_instantiate", "description": "Instantiate a template into a new draft flow in the workspace.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "Template id." }, "name": { "type": "string", "maxLength": 120 } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.templates.instantiate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "flow": { "type": "object", "properties": { "schemaVersion": { "type": "string" }, "id": { "type": "string" }, "workspaceId": { "type": "string" }, "tenantId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "properties": {}, "additionalProperties": {} }, "triggers": { "type": "array", "items": {} }, "steps": { "type": "array", "items": {} }, "version": { "type": "object", "properties": { "semver": { "type": "string" }, "status": { "type": "string" }, "publishedAt": { "type": "string" } }, "required": [ "semver", "status" ], "additionalProperties": {} }, "authoredBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "schemaVersion", "id", "workspaceId", "name", "tags", "source", "triggers", "steps", "version", "createdAt", "updatedAt" ], "additionalProperties": {} } }, "required": [ "flow" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "tmpl_incident_alert", "name": "My incident flow" }, "output": { "flow": { "schemaVersion": "1.0", "id": "flow_…", "workspaceId": "ws_…", "name": "My incident flow", "tags": [ "security", "alerting" ], "source": {}, "triggers": [], "steps": [], "version": { "semver": "0.1.0", "status": "draft" }, "createdAt": "2026-08-10T00:00:00Z", "updatedAt": "2026-08-10T00:00:00Z" } }, "note": "Create a flow from a template." } ] }, { "name": "actionflow_executions_list", "description": "List recent ActionFlow executions.", "function_declarations": [ { "name": "actionflow_executions_list", "description": "List recent ActionFlow executions.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/actionflow.executions.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "executions": { "type": "array", "items": { "type": "object", "properties": { "executionId": { "type": "string" }, "flowId": { "type": "string" }, "flowVersion": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" }, "initiatedBy": { "type": "object", "properties": {}, "additionalProperties": {} }, "triggeredBy": { "type": "object", "properties": {}, "additionalProperties": {} }, "status": { "type": "string" }, "stepStates": { "type": "object", "properties": {}, "additionalProperties": {} }, "result": {}, "error": {}, "mode": { "type": "string" }, "startedAt": { "type": "string" }, "completedAt": { "type": "string" }, "waiting": { "type": "boolean" } }, "required": [ "executionId", "flowId", "workspaceId", "initiatedBy", "triggeredBy", "status", "stepStates", "mode", "startedAt", "waiting" ], "additionalProperties": {} } } }, "required": [ "executions" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "executions": [] }, "note": "List executions." } ] }, { "name": "lens_list", "description": "List the available compliance-evidence lenses.", "function_declarations": [ { "name": "lens_list", "description": "List the available compliance-evidence lenses.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lenses": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "description": { "type": "string" }, "category": { "type": "string" }, "framework": { "type": [ "string", "null" ] }, "source": { "type": "string" }, "custom": { "type": "boolean" }, "sections": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "kind": { "type": "string" } }, "required": [ "id", "title", "kind" ], "additionalProperties": {} } } }, "required": [ "id", "name", "version", "description", "category", "source", "custom" ], "additionalProperties": {} } } }, "required": [ "lenses" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "lenses": [] }, "note": "Browse lenses." } ] }, { "name": "lens_execute", "description": "Execute a lens over the audit chain — produces a signed compliance-evidence bundle (a paid action).", "function_declarations": [ { "name": "lens_execute", "description": "Execute a lens over the audit chain — produces a signed compliance-evidence bundle (a paid action).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "Lens id." }, "params": { "description": "Optional lens parameters (time window, scope, …)." } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.execute" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "resultId": { "type": "string" }, "signed": { "type": "boolean" }, "bundle": { "type": "object", "properties": {}, "additionalProperties": {} } }, "required": [ "ok" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "lens_gdpr_art30", "params": { "since": "2026-01-01T00:00:00.000Z" } }, "output": { "ok": true, "resultId": "lres_…", "signed": true, "bundle": {} }, "note": "Run a GDPR lens." } ] }, { "name": "lens_validate", "description": "Validate a lens definition (dry-run; no evidence bundle, no charge).", "function_declarations": [ { "name": "lens_validate", "description": "Validate a lens definition (dry-run; no evidence bundle, no charge).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "definition": { "description": "The lens definition to validate." } }, "required": [ "definition" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.validate" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "errors": { "type": "array", "items": { "type": "string" } } }, "required": [ "ok" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "definition": { "framework": "gdpr" } }, "output": { "ok": true }, "note": "Validate a lens." } ] }, { "name": "lens_results_list", "description": "List prior lens-execution results (the evidence-bundle history).", "function_declarations": [ { "name": "lens_results_list", "description": "List prior lens-execution results (the evidence-bundle history).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.results.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "lensId": { "type": "string" }, "lensVersion": { "type": "string" }, "contentHash": { "type": "string" }, "executedAt": { "type": "string" }, "rangeStart": { "type": [ "string", "null" ] }, "rangeEnd": { "type": [ "string", "null" ] }, "signed": { "type": "boolean" }, "jurisdiction": { "type": [ "string", "null" ] }, "signingKeyId": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "otsProofId": { "type": [ "string", "null" ] }, "btcBlockHeight": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "lensId", "lensVersion", "contentHash", "executedAt", "signed", "status" ], "additionalProperties": {} } } }, "required": [ "results" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "results": [] }, "note": "List evidence bundles." } ] }, { "name": "lens_custom_list", "description": "List the custom lenses this workspace has authored.", "function_declarations": [ { "name": "lens_custom_list", "description": "List the custom lenses this workspace has authored.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.custom.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lenses": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "updatedAt": { "type": "string" }, "definition": {} }, "required": [ "id", "updatedAt", "definition" ], "additionalProperties": {} } } }, "required": [ "lenses" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "lenses": [] }, "note": "Browse the workspace's own lenses." } ] }, { "name": "lens_custom_get", "description": "Read one custom lens definition.", "function_declarations": [ { "name": "lens_custom_get", "description": "Read one custom lens definition.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1 } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.custom.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "updatedAt": { "type": "string" }, "definition": {} }, "required": [ "id", "updatedAt", "definition" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "id": "lensc_…" }, "output": { "id": "lensc_…", "updatedAt": "2026-08-24T12:00:00.000Z", "definition": {} }, "note": "Read one." } ] }, { "name": "lens_custom_create", "description": "Author a custom lens. The runtime sanitises the definition and refuses an invalid one with the specific errors.", "function_declarations": [ { "name": "lens_custom_create", "description": "Author a custom lens. The runtime sanitises the definition and refuses an invalid one with the specific errors.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "definition": {} }, "required": [ "definition" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.custom.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "id": { "type": "string" }, "definition": {} }, "required": [ "ok", "id", "definition" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "definition": {} }, "output": { "ok": true, "id": "lensc_…", "definition": {} }, "note": "Author a lens." } ] }, { "name": "lens_custom_update", "description": "Replace a custom lens definition.", "function_declarations": [ { "name": "lens_custom_update", "description": "Replace a custom lens definition.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "definition": {} }, "required": [ "id", "definition" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.custom.update" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "id": { "type": "string" }, "definition": {} }, "required": [ "ok", "id", "definition" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "lensc_…", "definition": {} }, "output": { "ok": true, "id": "lensc_…", "definition": {} }, "note": "Revise a lens." } ] }, { "name": "lens_custom_delete", "description": "Delete a custom lens. Its past results keep the definition hash they were produced under.", "function_declarations": [ { "name": "lens_custom_delete", "description": "Delete a custom lens. Its past results keep the definition hash they were produced under.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1 } }, "required": [ "id" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.custom.delete" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "id": "lensc_…" }, "output": { "ok": true }, "note": "Remove a lens the workspace authored." } ] }, { "name": "lens_marketplace_list", "description": "Browse the lens marketplace, with what this workspace has published and installed.", "function_declarations": [ { "name": "lens_marketplace_list", "description": "Browse the lens marketplace, with what this workspace has published and installed.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.marketplace.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "listings": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "publisherWorkspaceId": { "type": "string" }, "sourceLensId": { "type": "string" }, "name": { "type": "string" }, "summary": { "type": "string" }, "version": { "type": "string" }, "publishedAt": { "type": "string" }, "unpublishedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "publisherWorkspaceId", "sourceLensId", "name", "summary", "version", "publishedAt", "unpublishedAt" ], "additionalProperties": false } }, "published": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "publisherWorkspaceId": { "type": "string" }, "sourceLensId": { "type": "string" }, "name": { "type": "string" }, "summary": { "type": "string" }, "version": { "type": "string" }, "publishedAt": { "type": "string" }, "unpublishedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "publisherWorkspaceId", "sourceLensId", "name", "summary", "version", "publishedAt", "unpublishedAt" ], "additionalProperties": false } }, "installs": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "listingId": { "type": "string" }, "version": { "type": "string" }, "installedLensId": { "type": "string" }, "installedAt": { "type": "string" } }, "required": [ "id", "listingId", "version", "installedLensId", "installedAt" ], "additionalProperties": false } } }, "required": [ "listings", "published", "installs" ], "additionalProperties": false }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "listings": [], "published": [], "installs": [] }, "note": "What is available, and what I have." } ] }, { "name": "lens_marketplace_publish", "description": "Publish one of the workspace's own custom lenses at its pinned version. Enterprise only.", "function_declarations": [ { "name": "lens_marketplace_publish", "description": "Publish one of the workspace's own custom lenses at its pinned version. Enterprise only.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lensId": { "type": "string", "minLength": 1 }, "summary": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "lensId", "summary" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.marketplace.publish" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "listing": { "type": "object", "properties": { "id": { "type": "string" }, "publisherWorkspaceId": { "type": "string" }, "sourceLensId": { "type": "string" }, "name": { "type": "string" }, "summary": { "type": "string" }, "version": { "type": "string" }, "publishedAt": { "type": "string" }, "unpublishedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "publisherWorkspaceId", "sourceLensId", "name", "summary", "version", "publishedAt", "unpublishedAt" ], "additionalProperties": false } }, "required": [ "listing" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "lensId": "clens_…", "summary": "Counts sign-ins on the audit chain." }, "output": { "listing": { "id": "llist_…", "publisherWorkspaceId": "ws_1", "sourceLensId": "clens_…", "name": "Sign-in review", "summary": "Counts sign-ins on the audit chain.", "version": "1.0.0", "publishedAt": "2026-09-02T00:00:00.000Z", "unpublishedAt": null } }, "note": "Share a lens." } ] }, { "name": "lens_marketplace_unpublish", "description": "Withdraw a listing. It leaves the catalogue; workspaces that already installed it keep the lens.", "function_declarations": [ { "name": "lens_marketplace_unpublish", "description": "Withdraw a listing. It leaves the catalogue; workspaces that already installed it keep the lens.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "listingId": { "type": "string", "minLength": 1 } }, "required": [ "listingId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.marketplace.unpublish" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "unpublished": { "type": "boolean" }, "listingId": { "type": "string" } }, "required": [ "unpublished", "listingId" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "listingId": "llist_…" }, "output": { "unpublished": true, "listingId": "llist_…" }, "note": "Stop offering it." } ] }, { "name": "lens_marketplace_install", "description": "Install a listing into this workspace as a custom lens, pinned to the published version.", "function_declarations": [ { "name": "lens_marketplace_install", "description": "Install a listing into this workspace as a custom lens, pinned to the published version.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "listingId": { "type": "string", "minLength": 1 } }, "required": [ "listingId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.marketplace.install" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "install": { "type": "object", "properties": { "id": { "type": "string" }, "listingId": { "type": "string" }, "version": { "type": "string" }, "installedLensId": { "type": "string" }, "installedAt": { "type": "string" } }, "required": [ "id", "listingId", "version", "installedLensId", "installedAt" ], "additionalProperties": false }, "alreadyInstalled": { "type": "boolean" } }, "required": [ "install", "alreadyInstalled" ], "additionalProperties": false }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "listingId": "llist_…" }, "output": { "install": { "id": "linst_…", "listingId": "llist_…", "version": "1.0.0", "installedLensId": "clens_…", "installedAt": "2026-09-02T00:00:00.000Z" }, "alreadyInstalled": false }, "note": "Take a shared lens." } ] }, { "name": "lens_marketplace_uninstall", "description": "Remove an installed lens and its install receipt together — the inverse of install.", "function_declarations": [ { "name": "lens_marketplace_uninstall", "description": "Remove an installed lens and its install receipt together — the inverse of install.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "listingId": { "type": "string", "minLength": 1 } }, "required": [ "listingId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/lens.marketplace.uninstall" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "uninstalled": { "type": "boolean" }, "listingId": { "type": "string" } }, "required": [ "uninstalled", "listingId" ], "additionalProperties": false }, "safety": { "level": "destructive", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_invocation", "examples": [ { "input": { "listingId": "llist_…" }, "output": { "uninstalled": true, "listingId": "llist_…" }, "note": "Give a shared lens back." } ] }, { "name": "notarian_snapshot_create", "description": "Create a signed Notarian snapshot of the workspace's audit state (a paid action).", "function_declarations": [ { "name": "notarian_snapshot_create", "description": "Create a signed Notarian snapshot of the workspace's audit state (a paid action).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scope": { "description": "Optional snapshot scope / label.", "type": "string" }, "params": {} }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/notarian.snapshot.create" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "bundle": { "type": "object", "properties": {}, "additionalProperties": {} } }, "required": [ "ok" ], "additionalProperties": {} }, "safety": { "level": "billing_impacting", "confirmation": "always", "require_user_attestation": false }, "rate_limit_class": "billing", "audit_kind": "agent_invocation", "examples": [ { "input": { "scope": "month-end" }, "output": { "ok": true, "bundle": {} }, "note": "Seal a signed snapshot." } ] }, { "name": "notarian_verify-chain", "description": "Verify the Notarian transparency chain (free — a transparency guarantee).", "function_declarations": [ { "name": "notarian_verify-chain", "description": "Verify the Notarian transparency chain (free — a transparency guarantee).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/notarian.verify-chain" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "verification": { "type": "object", "properties": { "ok": { "type": "boolean" }, "workspaceId": { "type": "string" }, "checkedCount": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "tipHash": { "type": [ "string", "null" ] } }, "required": [ "ok" ], "additionalProperties": {} } }, "required": [ "ok", "verification" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "ok": true, "verification": { "ok": true, "checkedCount": 0, "tipHash": null } }, "note": "Prove the chain is intact." } ] }, { "name": "notarian_anchors_list", "description": "List the Notarian anchors (the published chain checkpoints).", "function_declarations": [ { "name": "notarian_anchors_list", "description": "List the Notarian anchors (the published chain checkpoints).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/notarian.anchors.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "anchors": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "workspaceId": { "type": "string" }, "ledgerSha256": { "type": "string" }, "snapshottedAt": { "type": "string" }, "otsProofId": { "type": [ "string", "null" ] }, "btcBlockHeight": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "status": { "type": "string" }, "source": { "type": "string" }, "label": { "type": [ "string", "null" ] }, "recordCount": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "rangeStart": { "type": [ "string", "null" ] }, "rangeEnd": { "type": [ "string", "null" ] }, "jurisdiction": { "type": [ "string", "null" ] }, "bundleId": { "type": "string" } }, "required": [ "id", "workspaceId", "ledgerSha256", "snapshottedAt", "status", "source" ], "additionalProperties": {} } } }, "required": [ "anchors" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "anchors": [] }, "note": "List anchors." } ] }, { "name": "witness_frameworks_list", "description": "List the supported agent-framework catalog (~180 frameworks) with status, category, and integration pattern — the platform-wide registry, not product-scoped.", "function_declarations": [ { "name": "witness_frameworks_list", "description": "List the supported agent-framework catalog (~180 frameworks) with status, category, and integration pattern — the platform-wide registry, not product-scoped.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "category": { "description": "Filter by framework category.", "type": "string", "minLength": 1 }, "status": { "description": "Filter by support status.", "type": "string", "enum": [ "stable", "beta", "coming-soon" ] }, "pattern": { "description": "Filter by integration pattern (sdk | webhook | otel | …).", "type": "string", "minLength": 1 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.frameworks.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "frameworks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "tagline": { "type": "string" }, "category": { "type": "string" }, "runtime": { "type": "string" }, "status": { "type": "string" }, "integrationPattern": { "type": "string" }, "sdkPackage": { "type": [ "string", "null" ] }, "sdkVersion": { "type": [ "string", "null" ] }, "integrationDocHref": { "type": [ "string", "null" ] }, "upstreamHref": { "type": [ "string", "null" ] }, "coverage": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "name", "category", "status" ], "additionalProperties": {} } }, "counts": { "type": "object", "properties": { "stable": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "beta": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "comingSoon": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "total": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "stable", "beta", "comingSoon", "total" ], "additionalProperties": {} } }, "required": [ "frameworks" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "status": "stable" }, "output": { "frameworks": [], "counts": { "stable": 0, "beta": 0, "comingSoon": 0, "total": 0 } }, "note": "All stable frameworks." } ] }, { "name": "witness_frameworks_get", "description": "Get one agent framework's catalog entry (support status, integration pattern, SDK package, docs).", "function_declarations": [ { "name": "witness_frameworks_get", "description": "Get one agent framework's catalog entry (support status, integration pattern, SDK package, docs).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "frameworkId": { "type": "string", "minLength": 1, "description": "Catalog id, e.g. langchain / crewai / openclaw." } }, "required": [ "frameworkId" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.frameworks.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "framework": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "tagline": { "type": "string" }, "category": { "type": "string" }, "runtime": { "type": "string" }, "status": { "type": "string" }, "integrationPattern": { "type": "string" }, "sdkPackage": { "type": [ "string", "null" ] }, "sdkVersion": { "type": [ "string", "null" ] }, "integrationDocHref": { "type": [ "string", "null" ] }, "upstreamHref": { "type": [ "string", "null" ] }, "coverage": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "name", "category", "status" ], "additionalProperties": {} } }, "required": [ "framework" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "frameworkId": "langchain" }, "output": { "framework": { "id": "langchain", "name": "LangChain", "category": "orchestration", "status": "beta" } }, "note": "LangChain's catalog entry." } ] }, { "name": "witness_patterns_list", "description": "List the 9 integration patterns an agent runtime can attach through (SDK, webhook, OAuth polling, cloud event, OTel, MCP server, LLM proxy, browser instrument, proprietary).", "function_declarations": [ { "name": "witness_patterns_list", "description": "List the 9 integration patterns an agent runtime can attach through (SDK, webhook, OAuth polling, cloud event, OTel, MCP server, LLM proxy, browser instrument, proprietary).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.patterns.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "patterns": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "setup": { "type": "string" } }, "required": [ "id", "label", "setup" ], "additionalProperties": {} } } }, "required": [ "patterns" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "patterns": [] }, "note": "The pattern catalog." } ] }, { "name": "witness_subscriptions_get", "description": "Get the Witness-Fabric subscription matrix — which products consume which record event classes from the neutral stream.", "function_declarations": [ { "name": "witness_subscriptions_get", "description": "Get the Witness-Fabric subscription matrix — which products consume which record event classes from the neutral stream.", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.subscriptions.get" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "subscriptions": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "array", "items": { "type": "string" } } } }, "required": [ "subscriptions" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "subscriptions": {} }, "note": "The WITNESS_SUBSCRIPTIONS routing matrix." } ] }, { "name": "witness_records_list", "description": "List the workspace's adapter-captured agent records from the neutral Witness-Fabric store (chain-free read — product-independent; no enrollment required).", "function_declarations": [ { "name": "witness_records_list", "description": "List the workspace's adapter-captured agent records from the neutral Witness-Fabric store (chain-free read — product-independent; no enrollment required).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "frameworkId": { "description": "Filter by source framework.", "type": "string", "minLength": 1 }, "pattern": { "description": "Filter by integration pattern.", "type": "string", "minLength": 1 }, "event": { "description": "Filter by record event class.", "type": "string", "enum": [ "invocation", "tool.call", "memory.write", "sub_agent.spawn", "channel.message" ] }, "agentId": { "description": "Filter by agent DID/id.", "type": "string", "minLength": 1 }, "before": { "description": "Cursor: rows stored strictly before this ISO timestamp (pass the previous page's nextCursor.before).", "type": "string", "minLength": 1 }, "beforeId": { "description": "Composite-cursor tiebreaker (the previous page's nextCursor.beforeId) — with `before`, guarantees same-millisecond rows are never skipped.", "type": "string", "minLength": 1 }, "limit": { "description": "Page size (default 50, max 200).", "type": "integer", "minimum": 1, "maximum": 200 } }, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.records.list" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "records": { "type": "array", "items": { "type": "object", "properties": { "recordId": { "type": "string" }, "workspaceId": { "type": "string" }, "agentId": { "type": "string" }, "event": { "type": "string" }, "frameworkId": { "type": "string" }, "pattern": { "type": "string" }, "actorRunId": { "type": "string" }, "contentHash": { "type": "string" }, "record": { "type": "object", "properties": {}, "additionalProperties": {} }, "occurredAt": { "type": "string" }, "broadcastAt": { "type": "string" }, "storedAt": { "type": "string" } }, "required": [ "recordId", "workspaceId", "agentId", "event", "frameworkId", "pattern", "actorRunId", "contentHash", "record", "occurredAt", "broadcastAt", "storedAt" ], "additionalProperties": {} } }, "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "nextCursor": { "anyOf": [ { "type": "object", "properties": { "before": { "type": "string" }, "beforeId": { "type": "string" } }, "required": [ "before", "beforeId" ], "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "records" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": { "frameworkId": "crewai", "limit": 20 }, "output": { "records": [], "count": 0, "nextCursor": null }, "note": "Latest CrewAI records." } ] }, { "name": "witness_records_post", "description": "Post an adapter record directly onto the neutral Witness-Fabric plane (stored chain-free + fanned out to subscribing products; NOT anchored in Agined's Tops chain — use the ingest lane for evidentiary anchoring).", "function_declarations": [ { "name": "witness_records_post", "description": "Post an adapter record directly onto the neutral Witness-Fabric plane (stored chain-free + fanned out to subscribing products; NOT anchored in Agined's Tops chain — use the ingest lane for evidentiary anchoring).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "record": { "type": "object", "properties": { "agentId": { "type": "string", "minLength": 1, "description": "The agent DID/id the record observes." }, "event": { "type": "string", "enum": [ "invocation", "tool.call", "memory.write", "sub_agent.spawn", "channel.message" ] }, "occurredAt": { "type": "string", "minLength": 1, "description": "ISO timestamp of the agent event." }, "source": { "type": "object", "properties": { "pattern": { "type": "string", "minLength": 1 }, "frameworkId": { "type": "string", "minLength": 1 }, "adapterVersion": { "type": "string" }, "ingestMode": { "type": "string", "enum": [ "push", "pull" ] } }, "required": [ "pattern", "frameworkId", "adapterVersion", "ingestMode" ], "additionalProperties": {} } }, "required": [ "agentId", "event", "occurredAt", "source" ], "additionalProperties": {}, "description": "The AdapterRecord (workspaceId is gateway-resolved and overrides any body value)." } }, "required": [ "record" ], "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.records.post" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "recordId": { "type": "string" }, "deduplicated": { "type": "boolean" }, "chainAnchored": { "type": "boolean" }, "delivery": { "type": "object", "properties": {}, "additionalProperties": {} } }, "required": [ "recordId", "deduplicated", "chainAnchored" ], "additionalProperties": {} }, "safety": { "level": "mutation", "confirmation": "ask", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": null, "examples": [ { "input": { "record": { "agentId": "did:web:example.com:agent:support", "event": "invocation", "occurredAt": "2026-07-19T12:00:00Z", "source": { "pattern": "sdk", "frameworkId": "langchain", "adapterVersion": "1.0.0", "ingestMode": "push" } } }, "output": { "recordId": "wr_demo00000000000000000000", "deduplicated": false, "chainAnchored": true }, "note": "Neutral-plane record post." } ] }, { "name": "witness_records_stats", "description": "Aggregate stats over the workspace's neutral witness stream (totals + per-framework / per-pattern / per-event counts).", "function_declarations": [ { "name": "witness_records_stats", "description": "Aggregate stats over the workspace's neutral witness stream (totals + per-framework / per-pattern / per-event counts).", "parameters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } } ], "invocation": { "method": "POST", "url": "https://api.agined.com/api/v1/actions/witness.records.stats" }, "response_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "stats": { "type": "object", "properties": { "total": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "byFramework": { "type": "array", "items": { "type": "object", "properties": { "frameworkId": { "type": "string" }, "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "frameworkId", "count" ], "additionalProperties": {} } }, "byPattern": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "pattern", "count" ], "additionalProperties": {} } }, "byEvent": { "type": "array", "items": { "type": "object", "properties": { "event": { "type": "string" }, "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "event", "count" ], "additionalProperties": {} } } }, "required": [ "total", "byFramework", "byPattern", "byEvent" ], "additionalProperties": {} } }, "required": [ "stats" ], "additionalProperties": {} }, "safety": { "level": "read", "confirmation": "none", "require_user_attestation": false }, "rate_limit_class": "default", "audit_kind": "agent_read", "examples": [ { "input": {}, "output": { "stats": { "total": 0, "byFramework": [], "byPattern": [], "byEvent": [] } }, "note": "Stream aggregates for dashboards." } ] } ], "meta": { "generated_at": "2026-11-10T21:32:07.834Z", "contracts_version": "0.32.289-agined.1", "tool_count": 337 } }