# Archive a person

This endpoint allows you to archive a person in Calamari.

Endpoint: POST /people/v2/{id}/archive
Version: v1
Security: basicAuth

## Path parameters:

  - `id` (any, required)
    The person identifier. Supports:

• 24dc4a05-ef40-4c30-9b95-554bf3be8741 (UUID)  
• id:12345 (legacy numeric ID)  
• number:AO-00710 (external number)  
• email:example@local.com (email address)  

Reserved characters in path segments  
Any reserved or unsafe character—literal (#, /, ?, space) or percent-encoded (%23, %2F, %3F, %20, etc.)—will be blocked or truncated by the server at that character and everything after it.

Recommendation  
• Use only unreserved characters in path identifiers (no #, /, ?, spaces).  
• If an identifier may contain reserved characters, pass it as a query parameter or in the request body instead.

## Response 401 fields (application/problem+json):

  - `title` (string, required)
    Type of error
    Example: "Authentication failure"

  - `status` (string, required)
    HTTP status code
    Example: 401

  - `detail` (string, required)
    Detailed error message explaining the issue.
    Example: "Please check if valid API key was provided"

## Response 403 fields (application/json):

  - `type` (string, required)
    Example: "about:blank"

  - `title` (string, required)
    Example: "Licence error."

  - `detail` (string, required)
    Example: "Time Off module required."

  - `status` (number, required)
    Example: 402

  - `instance` (number, required)
    Example: 1

## Response 404 fields (application/json):

  - `type` (string, required)
    Example: "about:blank"

  - `title` (string, required)
    Example: "Person not found."

  - `detail` (string, required)
    Example: "The requested resource could not be found."

  - `status` (number, required)
    Example: 404

  - `instance` (number, required)
    Example: 1

## Response 429 fields (application/problem+json):

  - `title` (string, required)
    Type of error
    Example: "Request quota exceeded"

  - `status` (string, required)
    HTTP status code
    Example: 429

  - `detail` (string, required)
    Detailed error message explaining the issue.
    Example: "Your current usage is 101/day, 10/hour, 1/sec\nYour current limits 100/day, 10/hour, 1/sec."

## Response 500 fields (application/problem+json):

  - `title` (string, required)
    Type of error
    Example: "Internal server error."

  - `status` (string, required)
    HTTP status code
    Example: 500

  - `detail` (string, required)
    Detailed error message explaining the issue.
    Example: "Please try again later. If the issue persists, don't hesitate to reach to our Support via team@calamari.io"

## Response 504 fields (application/problem+json):

  - `title` (string, required)
    Type of error
    Example: "Public API call exceeded timeout."

  - `status` (string, required)
    HTTP status code
    Example: 504

  - `detail` (string, required)
    Detailed error message explaining the issue.
    Example: "Please try again later. If the issue persists, don't hesitate to reach to our Support via team@calamari.io"


## Response 204 fields