skycloak_create_openfga_instance
Creates an OpenFGA instance bound to one cluster realm for realm-scoped token authorization. Starts asynchronously in 'provisioning', so poll the instance status until it reaches 'ready' or 'failed'.
Instructions
Create an OpenFGA instance bound to one realm of a cluster; a realm has at most one. Asynchronous: it starts in 'provisioning', so poll skycloak_get_openfga_instance until the status is 'ready' or 'failed'. The instance accepts only tokens from that realm that carry the instance's audience. Fails with 403 when the workspace's plan does not include OpenFGA or the workspace reached its instance limit, 409 when the realm already has an instance, and 422 when the realm is 'master', does not exist or is disabled.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cluster_id": "<cluster_id>",
"realm": "<realm>"
},
"name": "skycloak_create_openfga_instance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| realm | Yes | the realm to bind; it must exist and be enabled, must not be master, and must not already have an instance | |
| cluster_id | Yes | the cluster that holds the realm |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| realm | Yes | ||
| issuer | Yes | ||
| status | Yes | ||
| api_url | Yes | ||
| audience | Yes | ||
| cluster_id | Yes | ||
| created_at | Yes | ||
| updated_at | Yes | ||
| status_message | No |