Social API Reference

Block a user

Authentication

JWT Bearer Token

Request Body

Response (Success)

Example Request

curl -X POST "https://api.buddo.xyz/api/social/block" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "user_id": "00000000-0000-0000-0000-000000000000"
}'

Example Response

{
  "status": "blocked"
}

Unblock a user

Authentication

JWT Bearer Token

Path Parameters

Response (Success)

Example Request

curl -X DELETE "https://api.buddo.xyz/api/social/block/:user_id" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

{
  "status": "unblocked"
}

Create or ensure a chat channel

Creates a chat channel of the given type, or returns the existing one if it already exists.

Authentication

JWT Bearer Token

Request Body

Response (Success)

Example Request

curl -X POST "https://api.buddo.xyz/api/social/chat/channels" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ref_id": "string",
  "type": "lobby"
}'

Example Response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "ref_id": {},
  "type": "lobby"
}

Get messages from a chat channel

Returns messages in reverse chronological order. Supports cursor-based pagination via the 'before' parameter.

Authentication

JWT Bearer Token

Path Parameters

Query Parameters

Example Request

curl -X GET "https://api.buddo.xyz/api/social/chat/:channel_id/messages" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

[
  {
    "filtered_body": "string",
    "id": "00000000-0000-0000-0000-000000000000",
    "sender_id": "00000000-0000-0000-0000-000000000000",
    "sender_username": {},
    "sent_at": "2026-01-01T00:00:00Z"
  }
]

Send a message to a chat channel

Authentication

JWT Bearer Token

Path Parameters

Request Body

Response (Success)

Example Request

curl -X POST "https://api.buddo.xyz/api/social/chat/:channel_id/messages" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "string"
}'

Example Response

{
  "filtered_body": "string",
  "id": "00000000-0000-0000-0000-000000000000",
  "sender_id": "00000000-0000-0000-0000-000000000000",
  "sender_username": {},
  "sent_at": "2026-01-01T00:00:00Z"
}

List current user's friends

Authentication

JWT Bearer Token

Example Request

curl -X GET "https://api.buddo.xyz/api/social/friends" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

[
  {
    "email": "user@example.com",
    "id": "00000000-0000-0000-0000-000000000000",
    "username": "string"
  }
]

Send a friend request

Authentication

JWT Bearer Token

Request Body

Response (Success)

Example Request

curl -X POST "https://api.buddo.xyz/api/social/friends" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "friend_id": "00000000-0000-0000-0000-000000000000"
}'

Example Response

{
  "friendship_id": "00000000-0000-0000-0000-000000000000",
  "status": "pending"
}

List pending friend requests to the current user

Authentication

JWT Bearer Token

Example Request

curl -X GET "https://api.buddo.xyz/api/social/friends/pending" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

[
  {
    "friendship_id": "00000000-0000-0000-0000-000000000000",
    "id": "00000000-0000-0000-0000-000000000000",
    "sent_at": "2026-01-01T00:00:00Z",
    "username": "string"
  }
]

Remove a friendship

Authentication

JWT Bearer Token

Path Parameters

Response (Success)

Example Request

curl -X DELETE "https://api.buddo.xyz/api/social/friends/:id" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

{
  "status": "removed"
}

Accept or reject a friend request

Authentication

JWT Bearer Token

Path Parameters

Request Body

Response (Success)

Example Request

curl -X PUT "https://api.buddo.xyz/api/social/friends/:id" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "accept"
}'

Example Response

{
  "status": "accepted"
}

Untrack user presence

Removes the current user's presence record.

Authentication

JWT Bearer Token

Response (Success)

Example Request

curl -X DELETE "https://api.buddo.xyz/api/social/presence" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

{
  "status": "ok"
}

Get friends' online presence

Returns presence status for the current user's friends. Optionally filter by specific user IDs.

Authentication

JWT Bearer Token

Query Parameters

Example Request

curl -X GET "https://api.buddo.xyz/api/social/presence" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Track user presence

Reports the current user as online, optionally in a specific game or lobby.

Authentication

JWT Bearer Token

Request Body

Response (Success)

Example Request

curl -X POST "https://api.buddo.xyz/api/social/presence" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "game": "string",
  "lobby": "string"
}'

Example Response

{
  "status": "ok"
}

Get presence for a game table

Returns presence status for all users at a specific game table.

Authentication

JWT Bearer Token

Query Parameters

Response (Success)

Example Request

curl -X GET "https://api.buddo.xyz/api/social/presence/table?game=VALUE&ref_id=VALUE" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

{
  "users": [
    {
      "last_seen": "2026-01-01T00:00:00Z",
      "status": "online",
      "user_id": "00000000-0000-0000-0000-000000000000"
    }
  ]
}

Search users by username

Returns up to 20 matching users. Excludes the current user and blocked users.

Authentication

JWT Bearer Token

Query Parameters

Response (Success)

Example Request

curl -X GET "https://api.buddo.xyz/api/social/users/search?q=VALUE" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

{
  "users": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "username": "string"
    }
  ]
}