List conversations
curl --request GET \
--url https://workspace.passionfroot.me/api/v1/conversations \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://workspace.passionfroot.me/api/v1/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://workspace.passionfroot.me/api/v1/conversations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "<string>",
"creatorId": "<string>",
"isUnread": true,
"isArchived": true,
"isBlocked": true,
"lastActivityAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"creator": {
"id": "<string>",
"displayName": "<string>",
"country": "<string>",
"note": "<string>",
"labels": [
{
"id": "<string>",
"name": "<string>",
"color": "<string>",
"position": "<string>"
}
],
"channels": [
{
"id": "<string>",
"title": "<string>",
"platformType": "<string>",
"url": "<string>",
"metrics": {
"reach": 123,
"views": 123,
"engagement": 123,
"engagementRate": 123,
"metricsUpdatedAt": "2023-11-07T05:31:56Z"
}
}
]
}
}
],
"pagination": {
"hasMore": true,
"nextCursor": "<string>"
}
}{
"error": {
"code": "INVALID_QUERY_PARAMETER",
"message": "Invalid query parameters",
"details": [
{
"field": "limit",
"message": "Number must be less than or equal to 250"
}
]
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid or expired API key"
}
}{
"error": {
"code": "MISSING_SCOPE",
"message": "API key missing required scope: write:conversations"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "This API key is over its rate limit. Wait for Retry-After before sending more.",
"details": {
"limit": 2,
"windowSeconds": 1
}
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "API key verification is temporarily unavailable, retry shortly"
}
}Conversations
List conversations
Returns conversations ordered by most recent message activity. Archived and blocked conversations are included unless filtered out.
GET
/
conversations
List conversations
curl --request GET \
--url https://workspace.passionfroot.me/api/v1/conversations \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://workspace.passionfroot.me/api/v1/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://workspace.passionfroot.me/api/v1/conversations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "<string>",
"creatorId": "<string>",
"isUnread": true,
"isArchived": true,
"isBlocked": true,
"lastActivityAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"creator": {
"id": "<string>",
"displayName": "<string>",
"country": "<string>",
"note": "<string>",
"labels": [
{
"id": "<string>",
"name": "<string>",
"color": "<string>",
"position": "<string>"
}
],
"channels": [
{
"id": "<string>",
"title": "<string>",
"platformType": "<string>",
"url": "<string>",
"metrics": {
"reach": 123,
"views": 123,
"engagement": 123,
"engagementRate": 123,
"metricsUpdatedAt": "2023-11-07T05:31:56Z"
}
}
]
}
}
],
"pagination": {
"hasMore": true,
"nextCursor": "<string>"
}
}{
"error": {
"code": "INVALID_QUERY_PARAMETER",
"message": "Invalid query parameters",
"details": [
{
"field": "limit",
"message": "Number must be less than or equal to 250"
}
]
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid or expired API key"
}
}{
"error": {
"code": "MISSING_SCOPE",
"message": "API key missing required scope: write:conversations"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "This API key is over its rate limit. Wait for Retry-After before sending more.",
"details": {
"limit": 2,
"windowSeconds": 1
}
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "API key verification is temporarily unavailable, retry shortly"
}
}Authorizations
Create an API key from Settings → AI agents & API in your Partner workspace.
Query Parameters
Include conversations with message activity on or after this date or timestamp.
Return the conversation with this creator, if one exists.
true returns only archived items, false only the rest. Omitted, both.
Case-insensitive search across names and message text.
Required string length:
2 - 200Set to creator to include creator details.
Available options:
creator Required range:
1 <= x <= 250Opaque cursor returned by the previous page.

