---
title: "create a new API key based on caller rights"
method: POST
path: "/api/servicesecurity/processes/apikey/generate"
tags: ["apikeys"]
---

# create a new API key based on caller rights

`POST /api/servicesecurity/processes/apikey/generate`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicesecurity/processes/apikey/generate`
- Auth: HTTP bearer

## Request body

- object
  - `label` string, required

## Response `200`

Create a new API key

- object
  - `data` Apikey
    - `uuid` string, uuid
    - `createdAt` string, date-time
    - `createdBy` string, uuid
    - `lastUpdatedAt` string, date-time
    - `lastUpdatedBy` string, uuid
    - `lastUpdatedByAudience` string
    - `lastUpdatedByAudienceUuid` string, uuid
    - `lastUpdatedByImpersonatedBy` string, uuid
    - `lastUpdatedByCompanyUuid` string, uuid
    - `lastUpdatedByEnterpriseUuid` string, uuid
    - `key` string, required
    - `secret` string, required
    - `label` string
    - `audience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent', required: The parent object type
    - `audienceUuid` string, uuid, required: Reference to the parent object identifier
    - `companyUuid` string, uuid, required
    - `userUuid` string, uuid
    - `lastAuthenticatedAt` string, date-time
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)