Export Policy

07 May 2024
1 Minute to read

Print
Dark
Light
PDF

Export Policy

Updated on 07 May 2024
1 Minute to read

Print
Dark
Light
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

Get

/api/2.0/policies/{envId}

Export Policy by Environment ID and Workspace ID.
Note - for the older version, see Export Policy V1.

Notice

Name	Value
Accept	`text/plain;language=rego`

Accessing the Policy Management APIs is through a dedicated domain/URL, according to your PlainID Tenant Location
United States (US) - https://api.us1.plainid.io
Canada (CA) - https://api.ca1.plainid.io
Europe (EU) - https://api.eu1.plainid.io
Local PAA - https://api.plainid.local

Headers
*Required
Name Value
Accept text/plain;language=rego

Security

HTTP

Type bearer

For more details about Administration API Authentication, check out the Authentication APIs documentation
Provide your bearer token in the Authorization header when making requests to protected resources.
Example: Authorization: Bearer 123

Path parameters

envId

string (uuid) Required

The Environment ID can be found under the Details tab in the Environment Settings.

Query parameters

filter[authWsId]

string (uuid) Required

Authorization Workspace ID

filter[id]

stringRequired

Policy ID Filter

extendedSchema

boolean

Toggle to either enable or disable additional metadata, like the Policy id and description, in the response.

Default"True"

Responses

200

successful operation

Headers

x-request-id

string

Policy

"# METADATA\n# custom:\n#   plainid:\n#     policyId: 08ae32e4-fbf3-4cc8-b3b9-3b4061d1c825\n#     name: Manage personal account and Credit cards\n#     description: Customer can view and manage their own accounts an credit cards only with MFA\n#     accessType: Allow\npackage policy\nimport future.keywords\n\n# METADATA\n# custom:\n#   plainid:\n#     kind: DynamicGroup\n#     name: dg1\n#     id: f28c17c2-caeb-4cf2-a549-02bf03fe4e17\n#     description: \"test DG\"\ndynamic_group(identity){\n  identity.template == \"idWs1\"\n  identity[\"idAttr1\"] == \"test\"\n  identity[\"idAttr1\"] != \"prod\"\n}\n"

string

Policy as Rego code

400

bad request

Headers

x-request-id

string

Authorization WS not found

{
  "errors": [
    {
      "args": {
        "0": "ceef5853-1491-4d1c-ae52-2f2a1729b3a4"
      },
      "code": "PAC-001",
      "id": "EWWOTR",
      "message": "AuthorizationWs: [ceef5853-1491-4d1c-ae52-2f2a1729b3a4] not found",
      "name": "AuthorizationWsNotFound",
      "status": 400
    }
  ]
}

Expand All

object

errors

Array of object (error)

object

args

object

path

string

code

string

message

string

name

string

status

integer

401

Unauthorized

Headers

x-request-id

string

404

not found

Headers

x-request-id

string

Policy not found

{
  "errors": [
    {
      "args": {
        "0": "a0a455bb-7dc3-4cd3-b0d2-86631ac75379",
        "1": "ceef5853-1491-4d1c-ae52-2f2a1729b3a4"
      },
      "code": "PUA-033",
      "id": "E7WJBB",
      "message": "Policy Id doesn't exist in the environment",
      "name": "PolicyNotFoundError",
      "status": 404
    }
  ]
}

Expand All

object

errors

Array of object (error)

object

args

object

path

string

code

string

message

string

name

string

status

integer

422

Validation Failed - Invalid UUID

Headers

x-request-id

string

Invalid ID Format

{
  "errors": [
    {
      "args": {
        "0": "ed252aa5-9d0c-4193-838-60bf20b13109",
        "1": "uuid"
      },
      "code": "V-032",
      "id": "EEJQMA",
      "message": "$: test is an invalid uuid",
      "name": "UnprocessableEntityError",
      "status": 422
    }
  ]
}

Expand All

object

errors

Array of object (error)

object

args

object

path

string

code

string

message

string

name

string

status

integer

Was this article helpful?

What's Next

Delete Policy