Access Requests (EAP)14

Activity Log2

API History4

API Keys7

Audit Elements Data1

Audit Log Replay1

Audit Logs2

Bulk Operations8

Condition Set Rules3

Condition Sets7

Data Export2

Elements Configs (EAP)6

Email Configurations3

Email Templates4

Environments10

Groups16

Implicit Grants3

Invites3

Members7

OPAL Data ( EAP )6

Operation Approval (EAP)7

Organizations8

Policy Decision Points8

Policy Git Repositories7

Policy Guards (EAP)9

Projects5

Proxy Config5

Relationship tuples6

Resource Action Groups5

Resource Actions5

Resource Attributes5

Resource Instances6

Resource Relations4

Resource Roles9

Resources6

Role Assignments6

Roles9

Scope Configurations3

Tenants8

User Attributes5

User Invites6

Users8

Users Elements Data8

Environments

Copy Environment Async

Changed on Oct 22, 2026

Copy environment

This endpoint either duplicates an existing environment to a new environment in the same project, or copies from an existing environment to another existing environment.

The scope object controls which objects will be copied to the target environment.

To clone to a new environment, the user must have write permissions to the containing project. To clone into an existing environment, the user must have write permissions to the target environment, and, with delete_target_only_condition_sets, permission to delete its condition sets. In an environment protected by a policy guard, the copy task fails with 403 when it would change or delete an object the guard protects (the error is in the task's result), and the request itself answers 503, enqueueing nothing, when the guard's decision point cannot be reached.

Poll the task's result through this same environment.

Copying environments across projects or organizations is not allowed.

post/v2/projects/{proj_id}/envs/{env_id}/copy/async

Request

Base URL
https://api.permit.io (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer

Path parameters

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

env_idstring required

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Query parameters

waitnumber

Time in seconds to wait for the task to complete. Default is 0, means no wait. At most 60: a larger value waits that long.

Request body

conflict_strategy'fail' | 'overwrite'

An enumeration.

delete_target_only_condition_setsboolean

Only applies to copying into an existing environment. Delete the target environment's condition sets whose key the source environment does not have and that scope selects (with the same matching as the copy), together with their rules; a resource set is selected only when its resource is copied. Autogenerated condition sets are never deleted, and the copy fails with 409 instead of deleting a condition set that has a descendant which would not itself be deleted. Requires permission to delete condition sets in the target; in a policy-guarded target a guarded condition set is not deleted (the copy fails with 403, or 503 if the guard cannot be reached). Off by default: without it, neither conflict strategy deletes condition sets

Response

Successful Response

task_idstring required

The unique id of the task.

status'processing' | 'success' | 'failure' | 'cancelled' required