---
title: "Mark an API key copied"
method: POST
path: "/v1/api-keys/{id}/copied"
tags: ["api_keys"]
---

# Mark an API key copied

`POST /v1/api-keys/{id}/copied`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/api-keys/{id}/copied`
- Auth: HTTP bearer

Records that something carrying the key's secret was copied, such as a Connect setup. A connect key is then yours: it is listed, and a newer connect key never revokes it to make room. Only the first mark changes the key: a connect key then lives 90 days from it, never less than it had. A key that has expired or been revoked is not found.

## Path parameters

- `id` string, required

## Response `200`

The key, now listed

- ApiKey
  - `id` string, required: an API key ID: key_ and 32 lowercase hex digits
  - `name` string, required
  - `permissions` string[], required
  - `integration_id` string, required: an integration ID: int_ and 32 lowercase hex digits
  - `prefix` string, required: The token's visible start, pom_ and 8 hex digits, to tell keys apart
  - `created_via` 'dashboard' | 'api' | 'mcp', required: Where the key was created
  - `created_at` string, date-time, required: An ISO 8601 timestamp in UTC
  - `expires_at` string, date-time, required: An ISO 8601 timestamp in UTC
  - `last_used_at` string, date-time, required: An ISO 8601 timestamp in UTC
  - `purpose` 'connect', nullable, required: connect for a key the Connect page made, else null

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `404`: not_found
- `500`: internal_error
- `503`: temporarily_unavailable

## Changes

- **2026-10-20** `c07cea59691c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pomerado/apis/pomerado-api/changes/v1/api-keys/:id/copied/post.md)

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/32090cfa5fca?raw)