v1

latestOpenAPI 3.0.3MIT2026-07-17241338.5 KB
Resources

Apply (create or update) a resource

Creates or updates a Kubernetes resource in the organization's namespace. The org context is automatically injected into metadata and spec.

post/api/orgs/{org}/resources

Path parameters

orgstring required
Example:default

Organization slug

Request body

apiVersionstring required
kindstring required

Resource kind (e.g. Repository, AgentStack)

specobject

Resource spec (kind-specific fields)

statusobject

Resource status (set by controller)

Example request

{
  "apiVersion": "kradle.a5c.ai/v1alpha1",
  "kind": "AgentStack",
  "metadata": {
    "name": "my-stack",
    "namespace": "kradle-org-default"
  }
}

Response

Resource applied

createdboolean

True if created, false if updated

namestring

Resource name

Example response

{
  "resource": {
    "apiVersion": "kradle.a5c.ai/v1alpha1",
    "kind": "AgentStack",
    "metadata": {
      "name": "my-stack",
      "namespace": "kradle-org-default"
    }
  }
}