---
title: "Service Desk - record your Freshservice agent id"
method: POST
path: "/ServiceDesk/Identity"
tags: ["Servicedesk"]
---

# Service Desk - record your Freshservice agent id

`POST /ServiceDesk/Identity`

**Requires permission:** *IT*

Stores the caller's agent id so the module can work without agent-read access on the API key, or clears it. Requires the IT permission.

## Request body

- PostServiceDeskIdentityRequest
  - `agentId` string, nullable
  - `useSuggested` boolean
  - `displayName` string, nullable
  - `clear` boolean

## Response `200`

Success

- PostServiceDeskIdentityResponse
  - `isAgent` boolean
  - `agentId` string, nullable
  - `agentName` string, nullable
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — No agent id supplied
- `401` — Unauthorized
- `403` — Missing IT permission

## Changes

- **2026-08-18** `4d9bcf62aa69` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/changes/ServiceDesk/Identity/post.md)

---

[API](https://skmtc.dev/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/revisions/223cb0feedeb/schema)