Get a Resource
get_resourceFetch one Control Plane resource by kind + name (no name for kind="org"). Returns a summary plus the full JSON; a volume set also lists its snapshots. The single read-one tool for every resource kind. Secrets return metadata only: the API never includes their data. Read the target here before update_* or delete_resource; job tools such as rollback_workload and diagnose_workload read it themselves. schema: true returns the kind's apply-ready schema and REST endpoints instead (no name): read it before writing a cpln apply manifest or an API body; never guess field names.
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": {
"kind": "<kind>"
},
"name": "get_resource"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gvc | No | GVC slug — REQUIRED only for GVC-scoped kinds (workload, identity, volumeset); ignored otherwise. | |
| org | No | Organization slug. | |
| kind | Yes | Resource kind to fetch. | |
| name | No | Resource name. Required except for kind `org` (singular) and with `schema`. Most kinds use lowercase kebab-case names; exceptions: domain = the full hostname ("app.example.com"), image = NAME or NAME:TAG ("my-app:v1.2"). | |
| path | No | With `schema`: a dot-path to expand, e.g. "spec.containers" or an {"_expand":"<path>"} stub value. | |
| schema | No | true returns the kind's schema, not a resource. | |
| maxDepth | No | With `schema`: object levels to expand from `path`; default: whole when small. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | The full result. Read this, not only the summary. | |
| details | No | ||
| summary | Yes | ||
| nextSteps | No |