---
title: "Generate an installation access token"
method: POST
path: "/app/installations/{installationId}/accessTokens"
tags: ["App installations"]
---

# Generate an installation access token

`POST /app/installations/{installationId}/accessTokens`

## Request

- Base URL: `https://api.carbonregistry.com`
- URL: `https://api.carbonregistry.com/app/installations/{installationId}/accessTokens`
- Auth: none declared
- TypeScript: <https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/docs/app/installations/:installationId/accessTokens/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint generates an installation access token for a specific installation. This access token can be used to access organization resources.

## Path parameters

- `installationId` string, required

## Headers

- `x-icr-api-version` string

## Response `200`

- ApiInstallationAccessToken
  - `id` string, required: The ID of the access token
  - `createdAt` string, date-time, required: The date and time the access token was created
  - `updatedAt` string, date-time, required: The date and time the access token was last updated
  - `token` string, required: The access token string
  - `expiresAt` string, date-time, required: The date and time the access token expires
  - `isActive` boolean, required: Whether the access token is currently active
  - `permissions` object, required: The permissions of the access token
  - `appId` string, required: The ID of the app associated with the access token
  - `installationId` string, required: The ID of the installation associated with the access token
  - `organizationId` string, required: The ID of the organization associated with the access token

---

[API](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api.md) - [All operations](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/revisions/a9f1b102faca?raw)