---
title: "Export Identity Template"
slug: "export-identity-template"
updated: 2026-01-29T09:35:57Z
published: 2026-01-29T09:35:57Z
canonical: "docs.plainid.io/export-identity-template"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plainid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Export Identity Template

Get/api/1.0/identity-templates/{envId}/{identityTemplateId}

This version will be sunset (retired) in June 2026. Refer to [Export Identity Template V2](/apidocs/export-identity-template-v2) to use the newer version. Export Identity Template in the indicated Environment. This API call is designed to support EXPORT (read) operations in Asset Templates.

## Notice

Accessing the API call 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`   

## Using HTML Encoded Special Characters

 

Use HTML encoded patterns when working with values that contain special characters like spaces, dashes, etc. Refer to this [HTML URL Encoding Reference](https://www.w3schools.com/tags/ref_urlencode.ASP) for a full list.

   

## Important note about headers

 

Refer to the headers below to modify your cURL sample. Check if the following headers are in the sample, if not, ensure you add it to your cURL sample before pasting into your API tool.

 

### Headers

 *Required 

| Header | Value | cURL Line |
| --- | --- | --- |
| Accept | `application/json` | `-H "Accept:application/json"` |

   

### cURL Sample Guidelines

 

In order for the relevant parameters to appear in the cURL sample, you can input the values in the interactive API console on the right in the Try It or Code Sample tabs. You can then copy the cURL sample from the Code Sample tab in the correct format.

SecurityHTTPType 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 parametersenvIdstring (uuid) Required

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

identityTemplateIdstring (uuid) Required

The Identity Template ID. This can be found in the Details tab in the Identity Workspace Settings.

Responses200

Successful operation

Headersx-request-idstringThe ID of the request
<select class='api-response-data' aria-label='Media type'><option value='5695f1bc-ecbc-4ccd-9531-fec9be820517'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='923dcac1-37ad-4bfe-990b-f7216a1bc02e'>example</option>
</select>example

```json
{
  "data": {
    "templateId": "CaCIdentity",
    "attributes": [
      {
        "attributeId": "userAccount",
        "displayName": "userAccount",
        "description": "user account id",
        "type": "NUMERIC",
        "isAvailableForPolicies": true,
        "nameForRequest": "userAccount",
        "isUsedInAccessRequest": false
      },
      {
        "attributeId": "userRole",
        "displayName": "User Role",
        "description": "user role name",
        "type": "STRING",
        "isAvailableForPolicies": true,
        "nameForRequest": "userRole",
        "isUsedInAccessRequest": false
      }
    ]
  }
}
```

Expand Allobject  

Identity template

dataobject (IdentityTemplate)  

Identity Template

templateIdstring    

A unique string for the Identity Template.

Min length1Max length128
attributes Array of object (IdentityAttribute)   object  

Attribute

displayNamestring    

A display name that acts as a label for your Attribute.

Min length1Max length100
descriptionstring    

Attribute description.

Min length1Max length200
attributeIdstring    

The Attribute ID. This can be found in Identity Settings.

Min length1Max length128
attributeTypestring    

Attribute Data Type

Valid values[
  "STRING",
  "NUMERIC"
]
isAvailableForPoliciesboolean    

Indicates if the Attribute is allowed for Policies.

isUsedInAccessRequestboolean    

Indicates if the Attribute is used in an Access Request.

nameForRequeststring    

The name of the Attribute as it should appear in an Authorization Request.

Min length1

400

Validation Error

Headersx-request-idstringThe ID of the request

401

Unauthorized

Headersx-request-idstringThe ID of the request

403

Forbidden

Headersx-request-idstringThe ID of the request

404

Object not found

Headersx-request-idstringThe ID of the request
<select class='api-response-data' aria-label='Media type'><option value='cd9ccefb-e676-4080-9b99-ee7ad28f4edf'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='fa569f46-d255-4ea5-b0f2-62ca5f16f96a'>validationError</option>
</select>validationError

```json
{
  "errors": [
    {
      "code": "EMIT-002",
      "id": "EQ7CMX",
      "status": "404",
      "name": "IdentityTemplateNotFoundError",
      "message": "Identity Template: [User1] not found in Environment: [848aa1dd-3516-4dbe-b1bb-c32454302dc4], Hint: did you mean [User, Target]"
    }
  ]
}
```

object  codestring    
messagestring    
detailsstring    

500

Internal Server Error

Headersx-request-idstringThe ID of the request