---
title: "Forward ICE candidate"
method: POST
path: "/v2/realtime/webrtc/ice"
tags: ["Realtime Emotion API"]
---

# Forward ICE candidate

`POST /v2/realtime/webrtc/ice`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v2/realtime/webrtc/ice`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.imentiv.ai/oauth/authorize`
    - Token URL: `https://api.imentiv.ai/oauth/token` scopes: `realtime.write`

Forward WebRTC ICE candidate for connection establishment.

## Request body

- ICECandidateRequest: Request model for forwarding ICE candidate.
  - `session_id` string, required: Active session identifier
  - `candidate` string, required: ICE candidate string
  - `sdp_mid` string, nullable: SDP media ID
  - `sdp_mline_index` integer, nullable: SDP media line index

## Response `200`

Successful Response

- ICECandidateResponse: Response model for ICE candidate acknowledgement.
  - `session_id` string, required: Session identifier
  - `status` string, required: Processing status

## Other responses

- `410`: The server holding this session restarted or went away, and the session ended with it. The body carries `{"code": "session_node_gone"}`. Start a new session; retrying this one will not help.
- `422`: Validation Error

## Changes

- **2026-10-31** `bd825cd86e8c`: 1 info
  - added the non-success response with the status `410`
- **2026-10-01** `72330e2229c7`: 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
  - the endpoint scheme security `OAuth2Delegated` was added to the API
- **2026-08-28** `3c1aeed97c95`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/realtime/webrtc/ice/post.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)