# AI

> Reference generated from the OpenAPI contract: AI.

URL : https://docs.fanconvert.ai/en/api/reference/ia

{/* Généré par scripts/generer-reference.mjs depuis openapi/public-v1.json : ne pas modifier à la main. */}

## Qui répond à ce fan : l'IA, une personne, ou personne [#qui-répond-à-ce-fan--lia-une-personne-ou-personne]

`GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai` · `getAiState`

### Parameters [#parameters]

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `creator_id` | path | string | yes | Identifiant de la créatrice. |
| `conversation_id` | path | string | yes | Identifiant de la conversation. |
| `platform` | query | "mym" \| "telegram" | no | La plateforme du fan. (default : `mym`) |

### Response 200 [#response-200]

**`AiState`**

| Field | Type | Required | Description |
|---|---|---|---|
| `conversationId` | string | yes |  |
| `platform` | "mym" \| "telegram" | yes |  |
| `creatorAiEnabled` | boolean | yes |  |
| `control` | "ai" \| "human" \| "paused" \| "blocked" \| "transition" | yes | ai = l'IA répond ; human = une personne a la main ; paused = personne ne répond ; blocked = un envoi précédent est à vérifier ; transition = un changement est en cours. |

### Possible errors [#possible-errors]

`401` · `403` · `404` · `422` · `429` · `503` — Error format: [Errors](/en/api/rest/erreurs).

### Example [#example]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/ai" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Mettre l'IA en pause sur ce fan (« Arrêter le chatting »), MYM [#mettre-lia-en-pause-sur-ce-fan--arrêter-le-chatting--mym]

`POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/pause` · `pauseAi`

`Idempotency-Key` header required: see [Writes and idempotency](/en/api/rest/ecritures).

### Parameters [#parameters-1]

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `creator_id` | path | string | yes | Identifiant de la créatrice. |
| `conversation_id` | path | string | yes | Identifiant de la conversation. |
| `Idempotency-Key` | header | string | yes | Obligatoire : la même clé rejoue la même réponse, sans 2e écriture. |

### Response 200 [#response-200-1]

**`AiPause`**

| Field | Type | Required | Description |
|---|---|---|---|
| `conversationId` | string | yes |  |
| `platform` | string | yes |  |
| `paused` | boolean | yes | true = l'IA ne répond plus à ce fan. |
| `filterMode` | "none" \| "whitelist" \| "blacklist" | yes | Le mode du filtre de la créatrice, inchangé par l'API. |

### Possible errors [#possible-errors-1]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Error format: [Errors](/en/api/rest/erreurs).

### Example [#example-1]

```bash
curl -X POST "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/pause" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## Rendre ce fan à l'IA (« Relancer le chatting »), MYM [#rendre-ce-fan-à-lia--relancer-le-chatting--mym]

`POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/resume` · `resumeAi`

`Idempotency-Key` header required: see [Writes and idempotency](/en/api/rest/ecritures).

### Parameters [#parameters-2]

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `creator_id` | path | string | yes | Identifiant de la créatrice. |
| `conversation_id` | path | string | yes | Identifiant de la conversation. |
| `Idempotency-Key` | header | string | yes | Obligatoire : la même clé rejoue la même réponse, sans 2e écriture. |

### Response 200 [#response-200-2]

**`AiPause`**

| Field | Type | Required | Description |
|---|---|---|---|
| `conversationId` | string | yes |  |
| `platform` | string | yes |  |
| `paused` | boolean | yes | true = l'IA ne répond plus à ce fan. |
| `filterMode` | "none" \| "whitelist" \| "blacklist" | yes | Le mode du filtre de la créatrice, inchangé par l'API. |

### Possible errors [#possible-errors-2]

`401` · `403` · `404` · `409` · `422` · `429` · `503` — Error format: [Errors](/en/api/rest/erreurs).

### Example [#example-2]

```bash
curl -X POST "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/resume" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```