---
title: Replace a participant's detail
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Realtime Kit](https://developers.cloudflare.com/api/resources/realtime_kit)
[Meetings](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/meetings)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Replace a participant's detail
PUT/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/participants/{participant\_id}
Replaces a participant’s details for the given meeting and participant ID.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`Realtime Admin``Realtime`
##### P ath ParametersExpand Collapse
account\_id: string
The account identifier tag.
maxLength32
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
app\_id: string
The app identifier tag.
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>)
meeting\_id: string
formatuuid
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%20default%20%3E%20(param)%20meeting_id%20%3E%20(schema)>)
participant\_id: string
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%20default%20%3E%20(param)%20participant_id%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
custom\_participant\_id: string
Unique participant ID accepted by the replace participant API.
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%200%20%3E%20(param)%20custom_participant_id%20%3E%20(schema)>)
preset\_name: string
Name of the preset to apply to this participant.
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%200%20%3E%20(param)%20preset_name%20%3E%20(schema)>)
name: optional string
(Optional) Name of the participant.
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>)
picture: optional string
(Optional) A URL to a picture to be used for the participant.
formaturi
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20replace_participant%20%3E%20(params)%200%20%3E%20(param)%20picture%20%3E%20(schema)>)
##### ReturnsExpand Collapse
success: boolean
Success status of the operation
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(model)%20meeting_replace_participant_response%20%3E%20(schema)%20%3E%20(property)%20success>)
data: optional object {id, token, created\_at, 7 more }
Represents a participant.
id: string
ID of the participant.
formatuuid
Link to this property
token: string
The participant’s auth token that can be used for joining a meeting from the client side.
Link to this property
created\_at: string
When this object was created. The time is returned in ISO format.
formatdate-time
Link to this property
custom\_participant\_id: string
A unique participant ID generated by the client.
Link to this property
preset\_name: string
Preset applied to the participant.
Link to this property
updated\_at: string
When this object was updated. The time is returned in ISO format.
formatdate-time
Link to this property
expires\_on: optional string
Time at which the token stops being valid, in UTC. Returned when adding a participant.
formatdate-time
Link to this property
name: optional string
Name of the participant.
Link to this property
not\_before: optional string
Time from which the token is valid, in UTC. Returned when adding a participant.
formatdate-time
Link to this property
picture: optional string
URL to a picture of the participant.
formaturi
Link to this property
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(model)%20meeting_replace_participant_response%20%3E%20(schema)%20%3E%20(property)%20data>)
### Replace a participant's detail
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/meetings/$MEETING_ID/participants/$PARTICIPANT_ID \
-X PUT \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{
"custom_participant_id": "custom_participant_id",
"preset_name": "preset_name"
}'
```
200 example
```
{
"success": true,
"data": {
"id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"token": "token",
"created_at": "2019-12-27T18:11:19.117Z",
"custom_participant_id": "custom_participant_id",
"preset_name": "preset_name",
"updated_at": "2019-12-27T18:11:19.117Z",
"expires_on": "2026-10-01T11:00:00Z",
"name": "name",
"not_before": "2026-10-01T09:00:00Z",
"picture": "https://example.com"
}
}
```
##### Returns Examples
200 example
```
{
"success": true,
"data": {
"id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"token": "token",
"created_at": "2019-12-27T18:11:19.117Z",
"custom_participant_id": "custom_participant_id",
"preset_name": "preset_name",
"updated_at": "2019-12-27T18:11:19.117Z",
"expires_on": "2026-10-01T11:00:00Z",
"name": "name",
"not_before": "2026-10-01T09:00:00Z",
"picture": "https://example.com"
}
}
```