# AgentStack Agent Social API

**Canonical:** https://apis.io/apis/agentstack-tech/agentstack-tech-agentsocial-api/  
**Provider:** AgentStack — https://apis.io/providers/agentstack-tech/  
**Documentation:** https://agentstack.tech/api-docs

AgentStack Agent Social API is one of 90 APIs that [AgentStack](https://apis.io/providers/agentstack-tech/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include AgentSocial. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

AgentSocial chat, channels, and social graph. REST compatibility surface; for new integrations prefer MCP actions, GET/POST /api/dna/data, or POST /api/commands (see docs/API_CHANNELS_AND_PROTOCOLS.md).

## Operations (60 of 77)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/social/friends` | List Friends |
| GET | `/api/social/friends/user-ids` | List Friend User Ids |
| GET | `/api/social/friends/cards` | List Friend Cards |
| POST | `/api/social/friends/cards/batch` | Friend Cards Batch |
| POST | `/api/social/users/public-cards` | Social Public User Cards |
| POST | `/api/social/users/lookup` | Social User Lookup |
| GET | `/api/social/followers` | Social Followers List |
| GET | `/api/social/settings/privacy` | Social Privacy Get |
| PUT | `/api/social/settings/privacy` | Social Privacy Put |
| GET | `/api/social/friends/requests/in` | Friend Requests In |
| GET | `/api/social/friends/requests/out` | Friend Requests Out |
| POST | `/api/social/friends/request/respond` | Friend Request Respond |
| POST | `/api/social/friends/request` | Friend Request |
| POST | `/api/social/friends/accept` | Friend Accept |
| POST | `/api/social/friends/remove` | Friend Remove |
| POST | `/api/social/friends/reject` | Friend Reject |
| POST | `/api/social/friends/cancel` | Friend Cancel |
| POST | `/api/social/friends/block` | Friend Block |
| GET | `/api/social/chat/index` | Chat Index Get |
| PUT | `/api/social/chat/index` | Chat Index Put |
| GET | `/api/social/dm/chat-index` | Dm Chat Index Get |
| GET | `/api/social/initial-snapshot` | Messenger Initial Snapshot |
| POST | `/api/social/history/repair` | Social History Repair |
| POST | `/api/social/chat/index/remove` | Chat Index Remove |
| GET | `/api/social/messenger/prefs` | Messenger Prefs Get |
| PUT | `/api/social/messenger/prefs` | Messenger Prefs Put |
| POST | `/api/social/messenger/push-surface` | Messenger Push Surface Post |
| GET | `/api/social/chat/read-map` | Chat Read Map Get |
| POST | `/api/social/dm/ensure` | Dm Ensure |
| GET | `/api/social/chat/history` | Chat History |
| GET | `/api/social/dm/thread` | Dm Thread Get |
| GET | `/api/social/delta` | Social Delta |
| POST | `/api/social/chat/message/react` | Chat Message React |
| POST | `/api/social/chat/message/comment` | Chat Message Comment |
| POST | `/api/social/crdt/update` | Social Crdt Update |
| GET | `/api/social/crdt/state` | Social Crdt State |
| POST | `/api/social/dm/message` | Dm Message Post |
| POST | `/api/social/chat/message` | Chat Post |
| POST | `/api/social/chat/pin` | Chat Pin |
| POST | `/api/social/chat/unpin` | Chat Unpin |
| POST | `/api/social/chat/message/edit` | Chat Message Edit |
| POST | `/api/social/chat/message/delete` | Chat Message Delete |
| POST | `/api/social/chat/read` | Chat Read Set |
| GET | `/api/social/chat/read` | Chat Read Get |
| GET | `/api/social/presence/online` | Presence Online Users |
| POST | `/api/social/party-invite/token` | Party Invite Token |
| POST | `/api/social/party-invite/verify` | Party Invite Verify |
| POST | `/api/social/channel-invites/link-token` | Channel Invite Link Token |
| POST | `/api/social/channel-invites/direct` | Channel Invite Direct |
| GET | `/api/social/channel-invites/inbox` | Channel Invite Inbox |
| POST | `/api/social/channel-invites/accept` | Channel Invite Accept |
| POST | `/api/social/channel-invites/decline` | Channel Invite Decline |
| POST | `/api/social/channel-invites/redeem` | Channel Invite Redeem |
| POST | `/api/social/federation/add` | Federation Add |
| GET | `/api/social/federation/{consumer_project_id}` | Federation List |
| POST | `/api/social/channels/register` | Channel Register |
| POST | `/api/social/channels/update` | Channel Update |
| POST | `/api/social/channels/delete` | Channel Delete |
| GET | `/api/social/public/quota` | Social Public Quota Get |
| GET | `/api/social/public/me` | Social Public Me |

…and 17 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agentstack-tech/openapi/agentstack-tech-agentsocial-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-knowledge-config-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-create-payment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-generation-settings-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-project-data-patch-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-content-metadata-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentstack-tech/json-schema/agentstack-tech-plan-claim-response-schema.json

## Other AgentStack APIs (12)

- [AgentStack 8DNA API](https://apis.io/apis/agentstack-tech/agentstack-tech-8dna-api-api/)
- [AgentStack Admin API](https://apis.io/apis/agentstack-tech/agentstack-tech-admin-api/)
- [AgentStack Admin Drain API](https://apis.io/apis/agentstack-tech/agentstack-tech-admin-drain-api/)
- [AgentStack Agent Net API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-api/)
- [AgentStack AgentNet Arbitrum API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-arbitrum-api/)
- [AgentStack AgentNet BNB API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-bnb-api/)
- [AgentStack AgentNet Chain Control API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-chain-control-api/)
- [AgentStack AgentNet Chain Control Public API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-chain-control-public-api/)
- [AgentStack AgentNet PTR API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-ptr-api/)
- [AgentStack AgentNet Solana API](https://apis.io/apis/agentstack-tech/agentstack-tech-agentnet-solana-api/)
- [AgentStack Agents Fleet API](https://apis.io/apis/agentstack-tech/agentstack-tech-agents-fleet-api/)
- [AgentStack AI Builder API](https://apis.io/apis/agentstack-tech/agentstack-tech-ai-builder-api/)

## Tags

AgentSocial

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentstack-tech/agentstack-tech-agentsocial-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentstack-tech/.
