---
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

---

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