---
title: "Create API Key"
method: POST
path: "/api_keys"
tags: ["default"]
---

# Create API Key

`POST /api_keys`

`org:write`

## Request body

- object
  - `keyName` string, required — Name of the API key
  - `permissions` object
    - `admin` boolean — Provides full access to permissions
    - `resources` string[] — Provide an array of scopes in the form `org:<RESOURCE>:<PERMISSION>`. Resources include `files`, `groups`, `gateways`, and `analytics`. Permissions are either `read` or `write` (`write` includes `read` permissions)
    - `endpoints` object — ### Legacy endpoints These properties are to be used with [legacy endpoints](/api-reference/endpoint/ipfs/pin-file-to-ipfs), any V3 endpoints should use `resources` instead
      - `data` object
        - `pinList` boolean
        - `userPinnedDataTotal` boolean
      - `pinning` object
        - `hashMetadata` boolean
        - `hashPinPolicy` boolean
        - `pinByHash` boolean
        - `pinFileToIPFS` boolean
        - `pinJSONToIPFS` boolean
        - `pinJobs` boolean
        - `unpin` boolean
        - `userPinPolicy` boolean

## Response `200`

OK

- object

---

[API](https://skmtc.net/pinata/apis/pinata-v3-api.md) · [All operations](https://skmtc.net/pinata/apis/pinata-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinata/pinata-v3-api/versions/734684efd9c4/schema)