[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Set conversation status

> Set a conversation to Active, Pending, Closed or Spam. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/freescout/set_conversation_status

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Set a conversation to Active, Pending, Closed or Spam.

FreeScout API: https://cotlet.dev/docs/api/freescout.md

`PUT https://cotlet.dev/api/v1/freescout/conversations/{conversation_id}/status`

Access: write.

Changes the status of one conversation, the same as the Status dropdown. It sends nothing to the customer and one more call sets it back, so it does not wait for your OK. FreeScout has only these four statuses. If your team has a Workflows rule that emails the customer on closing, that rule still runs.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `conversation_id` | integer | yes | Conversation ID from list_conversations or get_conversation. It is not the #number shown in the list. |
| `status` | string | yes | active, pending, closed or spam. |

## Request

**cURL**

```bash
curl -X PUT https://cotlet.dev/api/v1/freescout/conversations/4790/status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"closed"}'
```

**Python**

```python
result = client.call("freescout", "set_conversation_status", {"conversation_id":4790,"status":"closed"})
```

**Node.js**

```js
const result = await cotlet.call('freescout', 'set_conversation_status', {"conversation_id":4790,"status":"closed"});
```

**CLI**

```bash
cotlet call freescout set_conversation_status --data '{"conversation_id":4790,"status":"closed"}'
```

## Example response

```json
{
  "conversation_id": 4790,
  "status": "closed",
  "changed_at": "2026-10-23T08:20:00Z"
}
```

Previous: [Reply to customer](https://cotlet.dev/docs/api/freescout/reply_to_customer.md)
Next: [Assign conversation](https://cotlet.dev/docs/api/freescout/assign_conversation.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.