> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://docs.prividium.com/api/mcp` to find what you need.
>
> **Have feedback?** Use `submit_feedback` on the same MCP server.

# m2m-app-api-keys

## GET /m2m-applications/{m2mAppId}/api-keys

`GET /m2m-applications/{m2mAppId}/api-keys`

List API keys for an m2m application (paginated)

### Path parameters

- `m2mAppId` `string` _(required)_

### Query parameters

- `limit` `integer`
- `offset` `integer`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `name` `string` _(required)_
  - `keyPrefix` `string` _(required)_
  - `expiresAt` `string <date-time>` _(required)_
  - `lastUsedAt` `string <date-time>` _(required)_
  - `lastUsedIp` `string | null` _(required)_
  - `revokedAt` `string <date-time>` _(required)_
  - `createdAt` `string <date-time>` _(required)_
  - `updatedAt` `string <date-time>` _(required)_
  - `tenantId` `string | null` _(required)_
  - `m2mAppId` `string | null` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `404`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/m2m-applications/string/api-keys?limit=10&offset=0'
```

```ts
fetch('/api/m2m-applications/string/api-keys?limit=10&offset=0')
```

## POST /m2m-applications/{m2mAppId}/api-keys

`POST /m2m-applications/{m2mAppId}/api-keys`

Create a new API key for an m2m application (returns full key only once)

### Path parameters

- `m2mAppId` `string` _(required)_

### Request body (required) (`application/json`)

- `name` `string` _(required)_
- `expiresAt` `unknown` _(required)_

### Responses

#### `201`: Default Response

Body (`application/json`):

- `id` `string` _(required)_
- `name` `string` _(required)_
- `keyPrefix` `string` _(required)_
- `expiresAt` `string <date-time>` _(required)_
- `lastUsedAt` `string <date-time>` _(required)_
- `lastUsedIp` `string | null` _(required)_
- `revokedAt` `string <date-time>` _(required)_
- `createdAt` `string <date-time>` _(required)_
- `updatedAt` `string <date-time>` _(required)_
- `tenantId` `string | null` _(required)_
- `m2mAppId` `string | null` _(required)_
- `fullKey` `string` _(required)_

#### `400`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `404`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/m2m-applications/string/api-keys \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "string"
}'
```

```ts
fetch('/api/m2m-applications/string/api-keys', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'string'
  })
})
```

## DELETE /m2m-applications/{m2mAppId}/api-keys/{keyId}

`DELETE /m2m-applications/{m2mAppId}/api-keys/{keyId}`

Revoke an API key for an m2m application

### Path parameters

- `m2mAppId` `string` _(required)_
- `keyId` `string` _(required)_

### Responses

#### `204`: Default Response

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `404`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/m2m-applications/string/api-keys/string \
  --request DELETE
```

```ts
fetch('/api/m2m-applications/string/api-keys/string', {
  method: 'DELETE'
})
```