resources

Copy Resources

Copy a subgraph of resources within the current project.

Selects all resources reachable from the given root IDs via dependency edges, then creates a copy of each. Copies are created in DRAFT state with a COPY event dispatched to the provider for actual duplication.

Dependency rewiring (enabled by default) ensures that dependencies between copied resources point to their copies instead of originals. Dependencies on resources outside the copied subgraph remain unchanged.

Same-project copy is the only supported mode. Every root id must already encode the URL project, and every traversed node must live inside the same project; cross-project copy is rejected at the engine layer and is not a planned feature.

Returns: CopyResponse with per-resource results and summary counts.

Raises: InvalidResourceIdentityError: If any root resource_id is malformed or belongs to a different project than the URL. ProjectMismatchError: If the engine discovers a traversed resource that escapes the URL project.

POST

/

projects

/

{project_id}

/

resources

/

copy

Copy Resources

curl --request POST \
  --url https://api.example.com/projects/{project_id}/resources/copy \
  --header 'Content-Type: application/json' \
  --data '
{
  "resource_ids": [
    "<string>"
  ],
  "tags": [],
  "rewire_dependencies": true,
  "depth": 1,
  "strategy": "stateless"
}
'

{
  "copied": [
    {
      "source_id": "<string>",
      "copied_resource": {
        "provider": "<string>",
        "resource": "<string>",
        "name": "<string>",
        "project_id": "<string>",
        "id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "config": {},
        "resolved_config": {},
        "dependencies": [],
        "owner_references": [],
        "outputs": {},
        "error": "<string>",
        "lifecycle_state": "draft",
        "health": "healthy",
        "health_message": "<string>",
        "pending_event_id": "<string>",
        "pending_event_type": "<string>",
        "provisioned": false,
        "reconcile_count": 0,
        "version": 0,
        "tags": [
          "<string>"
        ],
        "provider_version": "<string>"
      },
      "error": "<string>"
    }
  ],
  "total": 123,
  "succeeded": 123,
  "failed": 123
}

Path Parameters

project_id

string

required

Body

application/json

Request body for the subgraph copy operation.

Attributes: resource_ids: SurrealDB resource IDs to copy (roots of the subgraph). tags: Tags to apply to all copied resources. rewire_dependencies: If True, rewrite dependencies between copied resources to point to their copies instead of the originals. depth: Maximum traversal depth from roots. None means unlimited. strategy: Default copy strategy for resources that do not specify one.

resource_ids

string[]

required

Minimum array length: 1

tags

string[]

rewire_dependencies

boolean

default:true

depth

integer | null

Required range: x >= 0

strategy

enum<string>

default:stateless

Strategy for how a resource should be copied.

Attributes: STATELESS: Config-only copy. The resource is duplicated by creating a new instance with the same (or modified) configuration. No data migration. STATEFUL: Data-bearing copy. The resource needs to clone underlying data (e.g., database contents, vector indices) and may produce patches for ongoing synchronization.

Available options:

stateless,

stateful

Response

Successful Response

Response body for the subgraph copy operation.

Attributes: copied: List of per-resource copy results. total: Total resources in the selected subgraph. succeeded: Number of resources successfully copied. failed: Number of resources that failed to copy.

copied

CopyResourceResult · object[]

required

Show child attributes

total

integer

required

succeeded

integer

required

failed

integer

required

Deactivate ResourceDeactivate a resource (soft delete). Triggers provider teardown. Resource returns to DRAFT state when complete. Only available for READY and FAILED resources. Sensitive fields are masked by default in the response. Returns: Resource in DELETING state awaiting provider teardown.

Copy Resources

curl --request POST \
  --url https://api.example.com/projects/{project_id}/resources/copy \
  --header 'Content-Type: application/json' \
  --data '
{
  "resource_ids": [
    "<string>"
  ],
  "tags": [],
  "rewire_dependencies": true,
  "depth": 1,
  "strategy": "stateless"
}
'

{
  "copied": [
    {
      "source_id": "<string>",
      "copied_resource": {
        "provider": "<string>",
        "resource": "<string>",
        "name": "<string>",
        "project_id": "<string>",
        "id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "config": {},
        "resolved_config": {},
        "dependencies": [],
        "owner_references": [],
        "outputs": {},
        "error": "<string>",
        "lifecycle_state": "draft",
        "health": "healthy",
        "health_message": "<string>",
        "pending_event_id": "<string>",
        "pending_event_type": "<string>",
        "provisioned": false,
        "reconcile_count": 0,
        "version": 0,
        "tags": [
          "<string>"
        ],
        "provider_version": "<string>"
      },
      "error": "<string>"
    }
  ],
  "total": 123,
  "succeeded": 123,
  "failed": 123
}