/bff/ai-agent/provision

Revokes any existing AI-agent credential for the current (user, member) pair, mints a new one (30-day lifetime, AGENT-prefixed), and returns a ready-to-paste system prompt with the credential embedded as a cookie header. Only human sessions may call this — an AI-agent credential itself is not allowed to mint further credentials.

AI AgentpostBffAi-agentProvision

Parameters

No parameters required

This endpoint takes no path, query, header or body parameters.

Response schema

1 status code documented

200SuccessReady-to-copy system prompt for an external AI agent.

systemPromptstringRequired

Multi-line English system prompt with the AI-agent auth cookie, organisation name, user identity and operational rules baked in.

generatedAtstringRequired

Date the prompt was generated (YYYY-MM-DD).

expiresAtstringRequired

Date the embedded credential expires (YYYY-MM-DD, 30 days after generation).

Response example

application/json

{
  "systemPrompt": "example_systemPrompt",
  "generatedAt": "example_generatedAt",
  "expiresAt": "example_expiresAt"
}

Request example

POST /bff/ai-agent/provision

post

curl -X POST "https://api.bizkithub.com/bff/ai-agent/provision" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key