Skip to main content

Endpoints Overview

ActivityPub defines several endpoints for federation and client interaction.

Core Endpoints

ACTIVITYPUB ENDPOINTSDiscovery/.well-known/webfingerActor/users/{username}Collections/users/{username}/inbox/users/{username}/outbox/users/{username}/followers/users/{username}/followingShared/inboxRequired:WebFinger, Actor, InboxRecommended:Outbox, Shared Inbox

Endpoint Reference

EndpointMethodPurposeAuth Required
WebFingerGETActor discoveryNo
ActorGETFetch profileNo*
InboxPOSTReceive activitiesHTTP Signature
OutboxGETList activitiesNo
OutboxPOSTCreate (C2S)OAuth
FollowersGETList followersVaries
FollowingGETList followingVaries

*Requires Accept header for content negotiation

Required vs Optional

Required for Federation:

  • WebFinger - Actor discovery
  • Actor endpoint - Profile data
  • Inbox - Receiving activities

Recommended:

  • Outbox - Activity history
  • Shared Inbox - Efficient delivery
  • Followers/Following - Social graph

See Also