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

# External IDs

> Attach identifiers from your own systems to PromptLayer resources so your integrations can easily find and sync resources.

```json theme={null}
{
  "source": "acme_cms",
  "external_id": "prompt_template_123"
}
```

## Common tasks

| Task                                 | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Set when creating an entity          | [`POST /rest/prompt-templates`](/reference/templates-publish#body-external-ids) include `external_ids` in the payload body.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Set on an existing resource          | [`POST /prompt-templates/{prompt_template_id}/external-ids`](/reference/external-ids-prompt-templates-attach)                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Get an entity by external ID         | Add `external_source` and `external_id` to supported list endpoints such as [`GET /prompt-templates`](/reference/list-prompt-templates), [`GET /workflows`](/reference/list-workflows), [`GET /api/public/v2/datasets`](/reference/list-datasets), [`GET /api/public/v2/evaluations`](/reference/list-evaluations), [`GET /api/public/v2/skill-collections`](/reference/list-skill-collections), [`GET /api/public/v2/tool-registry`](/reference/tool-registry-list), or [`GET /api/public/v2/folders/entities`](/reference/list-folder-entities). |
| Get external IDs for an entity       | [`GET /prompt-templates/{prompt_template_id}/external-ids`](/reference/external-ids-prompt-templates-list)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Delete an external ID from an entity | [`DELETE /prompt-templates/{prompt_template_id}/external-ids/{source}/{external_id}`](/reference/external-ids-prompt-templates-delete)                                                                                                                                                                                                                                                                                                                                                                                                             |

## Supported resources

* [Prompt templates](/reference/templates-publish#body-external-ids)
* [Folders](/reference/create-folder#body-external-ids)
* [Workflows](/reference/create-workflow#body-external-ids)
* [Datasets](/reference/create-dataset-group#body-external-ids)
* [Evaluations](/reference/create-reports#body-external-ids)
* [Tools](/reference/tool-registry-create#body-external-ids)
* [Skill collections](/reference/create-skill-collection#body-external-ids)