---
title: "Mint a New Identifier for a Node"
method: POST
path: "/nodes/{node_id}/identifiers/"
tags: ["Nodes", "Identifiers"]
---

# Mint a New Identifier for a Node

`POST /nodes/{node_id}/identifiers/`

Mint (create) a new identifier for the specified node. 
Currently, the OSF supports minting **DOI** identifiers through this endpoint. Once created, identifiers are permanent and cannot be modified or deleted.
#### Supported Identifier Categories

 - `doi`: Digital Object Identifier.

#### Requirements

 - You must have **Admin** or **Write** permissions on the node.
 - The node must be **public** and must **not** be a collection or folder.
 - Only nodes representing individual projects or components are eligible for DOI creation.

#### Example Request Payload

```json
{
  "data": {
    "type": "identifiers",
    "attributes": {
      "category": "doi"
    }
  }
}
```

#### Permissions
 - Only authenticated users with the required permissions can mint new identifiers.
 - This endpoint is does not authenticate for nodes that are private or not publicly available.

## Path parameters

- `node_id` string, required

## Response `201`

Identifier successfully created.

## Other responses

- `400` — Bad Request. Possible reasons include: - The node already has a DOI identifier. - The requested identifier category is not supported (only `doi` is allowed). - The node is not eligible for DOI creation (e.g., it's a folder or collection).
- `403` — Forbidden. You do not have permission to create identifiers on this node. This may occur if: - The node is private. - You do not have Admin or Write access to the node.
- `404` — Node not found. Verify the node ID is correct and that you have permission to view the node.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/versions/ca701048eb0d/schema)