# DELETE /v1/sessions/{session_id}/participants/{participant_id} - Leave a participant

Source: <https://everruns.com/docs/api/operations/leave_session_participant/>

DELETE

/v1/sessions/{session\_id}/participants/{participant\_id}

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/sessions/example/participants/example';
const options = {method: 'DELETE'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request DELETE \
  --url https://app.everruns.com/api/v1/sessions/example/participants/example
```

* Production APIapp.everruns.com/api/v1/sessions/{session\_id}/participants/{participant\_id}

## Parameters

### Path Parameters

**session\_id**

required

string

Session ID (prefixed, e.g., session\_…)

**participant\_id**

required

string

Participant ID (prefixed, e.g., part\_…)

## Responses

### 200

Participant left successfully

Media typeapplication/json

Session participant - an agent or user that has joined a session.

object

**agent\_id**

Present for agent participants.

string | null

**display\_name**

Human-readable name captured for this participant.

string | null

**id**

required

Unique identifier for the participant row (format: part\_{32-hex}).

string

**joined\_at**

required

string format: date-time

**kind**

required

Kind of actor participating in a session.

string

Allowed values: agent user

**left\_at**

string | null format: date-time

**principal\_id**

required

Principal that joined the session.

string

**role**

required

Role a participant has inside a session.

string

Allowed values: host member

**session\_id**

required

Session this participant belongs to.

string

##### Example

```json
{
  "agent_id": "agent_01933b5a00007000800000000000001",
  "id": "part_01933b5a00007000800000000000001",
  "kind": "agent",
  "principal_id": "principal_01933b5a000070008000000000000001",
  "role": "host",
  "session_id": "session_01933b5a00007000800000000000001"
}
```

### 400

Invalid ID

### 404

Session or participant not found

### 409

Host participant cannot leave through this endpoint

### 500

Internal server error