Resources

Hostname

The App.net API is rooted under https://api.app.net/. The API endpoints were previously available at https://alpha-api.app.net/stream/0/. The old base URL will continue to function indefinitely.

User

Description Method Path Token
Retrieve a User GET /users/{user_id} None
Update a User PUT /users/me User
Partially Update a User PATCH /users/me User
Retrieve a User's avatar image GET /users/{user_id}/avatar None
Update a User's avatar image POST /users/me/avatar User
Retrieve a User's cover image GET /users/{user_id}/cover None
Update a User's cover image POST /users/me/cover User
Follow a User POST /users/{user_id}/follow User
Unfollow a User DELETE /users/{user_id}/follow User
Mute a User POST /users/{user_id}/mute User
Unmute a User DELETE /users/{user_id}/mute User
Block a User POST /users/{user_id}/block User
Unblock a User DELETE /users/{user_id}/block User
Retrieve multiple Users GET /users Any
Search for Users GET /users/search Any
Retrieve Users a User is following GET /users/{user_id}/following Any
Retrieve Users following a User GET /users/{user_id}/followers Any
Retrieve IDs of Users a User is following GET /users/{user_id}/following/ids Any
Retrieve IDs of Users following a User GET /users/{user_id}/followers/ids Any
Retrieve muted Users GET /users/{user_id}/muted Any
Retrieve muted User IDs for multiple Users GET /users/muted/ids App
Retrieve blocked Users GET /users/{user_id}/blocked Any
Retrieve blocked User IDs for multiple Users GET /users/blocked/ids App
Retrieve Users who reposted a Post GET /posts/{post_id}/reposters Any
Retrieve Users who starred a Post GET /posts/{post_id}/stars Any

Post

Description Method Path Token
Create a Post POST /posts User
Retrieve a Post GET /posts/{post_id} None
Delete a Post DELETE /posts/{post_id} User
Repost a Post POST /posts/{post_id}/repost User
Unrepost a Post DELETE /posts/{post_id}/repost User
Star a Post POST /posts/{post_id}/star User
Unstar a Post DELETE /posts/{post_id}/star User
Retrieve multiple Posts GET /posts Any
Retrieve a User's posts GET /users/{user_id}/posts None
Retrieve a User's starred posts GET /users/{user_id}/stars None
Retrieve Posts mentioning a User GET /users/{user_id}/mentions Any
Retrieve Posts containing a hashtag GET /posts/tag/{hashtag} None
Retrieve replies to a Post GET /posts/{post_id}/replies Any
Retrieve a User's personalized stream GET /posts/stream User
Retrieve a User's unified stream GET /posts/stream/unified User
Retrieve the Global stream GET /posts/stream/global None
Report a Post POST /posts/{post_id}/report User
Search for Posts GET /posts/search Any

Channel

Description Method Path Token
Get current user's subscribed channels GET /channels User
Create a Channel POST /channels User
Retrieve a Channel GET /channels/{channel_id} Varies
Retrieve multiple Channels GET /channels Any
Retrieve my Channels GET /users/me/channels User
Retrieve number of unread PM Channels GET /users/me/channels/pm/num_unread User
Retrieve number of unread Broadcast Channels GET /users/me/channels/broadcast/num_unread User
Mark all Broadcast Channels as read DELETE /users/me/channels/broadcast/num_unread User
Update a Channel PUT /channels/{channel_id} User
Deactivate a Channel DELETE /channels/{channel_id} User
Subscribe to a Channel POST /channels/{channel_id}/subscribe User
Unsubscribe from a Channel DELETE /channels/{channel_id}/subscribe User
Retrieve users subscribed to a Channel GET /channels/{channel_id}/subscribers Varies
Retrieve user ids subscribed to a Channel GET /channels/{channel_id}/subscribers/ids Varies
Retrieve user ids subscribed to multiple Channels GET /channels/subscribers/ids Varies
Mute a Channel POST /channels/{channel_id}/mute User
Unmute a Channel DELETE /channels/{channel_id}/mute User
Get current user's muted Channels GET /users/me/channels/muted User
Search for Channels GET /channels/search User

Message

Description Method Path Token
Retrieve the Messages in a Channel GET /channels/{channel_id}/messages Varies
Create a Message POST /channels/{channel_id}/messages User
Retrieve a Message GET /channels/{channel_id}/messages/{message_id} Varies
Retrieve multiple Messages GET /channels/messages Any
Retrieve my Messages GET /users/me/messages User
Delete a Message DELETE /channels/{channel_id}/messages/{message_id} User
Search for Messages GET /channels/messages/search Any

File

Description Method Path Token
Create a File POST /files User
Create a Derived File POST /files/{file_id}/{derived_key} User
Retrieve a File GET /files/{file_id} Varies
Retrieve multiple Files GET /files User
Delete a File DELETE /files/{file_id} User
Retrieve my Files GET /users/me/files User
Update a File PUT /files/{file_id} User
Get File content GET /files/{file_id}/content User
Set File content PUT /files/{file_id}/content User
Set Derived File content PUT /files/{file_id}/content/{derived_key} User

App Stream

Description Method Path Token
Create an App Stream POST /streams App
Retrieve an App Stream GET /streams/{stream_id} App
Update an App Stream PUT /streams/{stream_id} App
Delete an App Stream DELETE /streams/{stream_id} App
Retrieve all App Streams for the current Token GET /streams App
Delete all App Streams for the current Token DELETE /streams App

User Stream

Description Method Path Token
Delete a User Stream DELETE /users/me/streams/{connection_id} User
Delete a User Stream subscription DELETE /users/me/streams/{connection_id}/{subscription_id} User

Filter

Description Method Path Token
Create a Filter POST /filters User
Retrieve a Filter GET /filters/{filter_id} User
Update a Filter PUT /filters/{filter_id} User
Delete a Filter DELETE /filters/{filter_id} User
Get the current User's Filters GET /filters User
Delete the current User's Filters DELETE /filters User

Interaction

Description Method Path Token
Retrieve Interactions with the current User GET /users/me/interactions User

Stream Marker

Description Method Path Token
Update a Stream Marker POST /posts/marker User

Text Processor

Description Method Path Token
Process text POST /text/process Any

Token

Description Method Path Token
Retrieve the current token GET /token Any
Retrieve authorized User IDs for an app GET /apps/me/tokens/user_ids App
Retrieve authorized User tokens for an app GET /apps/me/tokens App

Place

Description Method Path Token
Retrieve a Place GET /places/{factual_id} Any
Search for Places GET /places/search User

Explore Stream

Description Method Path Token
Retrieve all Explore Streams GET /posts/stream/explore None
Retrieve an Explore Stream GET /posts/stream/explore/{slug} None

Configuration

Description Method Path Token
Retrieve the Configuration object GET /config None