Skip to main content
POST
Forward a message

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Path Parameters

id
string
required

The id.

Body

application/json

Forward a message's content from this conversation to its other member, as the token tenant. The route reads content and message_id off the body (app/api/oauth/v1/conversations/[id]/forward/route.ts:25).

content
string
required

The message content to forward. Required and non-blank (the use-case returns 400 'content is required' otherwise).

message_id
string

Optional source Firebase message id. Accepted for symmetry with the legacy forward signature; not persisted.

Response

Forward result (recipient + created message ids, or forwarded:false when no recipient).

data
object
required

Result of forwarding. From forwardConversationMessage (lib/api/messages/conversation-actions.usecase.ts:166,178-186). When no other member exists, returns { success:true, forwarded:false, message }.