Use Reddit API

All code must follow the Coding Principles in AGENTS.md (functional, minimal, readable, modular).

Available imports

typescript
1import { reddit, context } from '@devvit/web/server'

Context variables

Always guard optional context before use (see api-route skill for guard helpers).

Common operations

Get current user

typescript
1const user = await reddit.getCurrentUser()
2if (!user) {
3  return c.json({ status: 'error', message: 'Not logged in' }, 400)
4}
5const username = user.username

Get current subreddit

typescript
1const subreddit = await reddit.getCurrentSubreddit()

Submit a custom post

typescript
1const post = await reddit.submitCustomPost({
2  subredditName: context.subredditName!,
3  title: 'My Post Title',
4  entry: 'default',  // matches entrypoint key in devvit.json
5})
6// post.id is the new post ID (e.g. "t3_abc")

Submit a comment

typescript
1await reddit.submitComment({
2  postId: context.postId!,
3  text: 'Great job! 🎉',
4})

Set user flair

typescript
1await reddit.setUserFlair({
2  subredditName: context.subredditName!,
3  username: user.username,
4  text: 'Champion 🏆',
5})

Navigation response (menu items)

When a menu item handler needs to redirect the user to a post:

typescript
1app.post('/internal/menu/create-game', async (c) => {
2  const post = await reddit.submitCustomPost({
3    subredditName: context.subredditName!,
4    title: 'New Game',
5    entry: 'default',
6  })
7  return c.json({
8    navigateTo: `https://reddit.com/r/${context.subredditName}/comments/${post.id}`,
9  })
10})

Constraints

• Reddit API calls are server-side only — never from client Svelte code
• 30-second request timeout applies to all operations
• Error handling follows the api-route skill pattern (try/catch, instanceof Error)

Checklist before finishing

• Tests written FIRST in src/server/__tests__/ using bun:test and devvit-mocks
• All Reddit API calls are in server code (src/server/)
• context.userId and context.postId guarded before use
• Response uses standard shape from api-route skill
• Menu item handlers return { navigateTo: url } when redirecting
• bun run test passes with zero failures