Skip to main content
POST
Capture a story draft from a shared inbox conversation

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

conversationId
integer
required

Conversation id in the current organization.

Body

application/json

Validated request fields for this operation.

title
string | null

Title. Validation: nullable, string, max:255.

Maximum string length: 255
Example:

"Field update from the education program"

headline
string | null

Headline. Validation: nullable, string, max:255.

Maximum string length: 255
Example:

"Headline"

summary
string | null

Summary. Validation: nullable, string, max:5000.

Maximum string length: 5000
Example:

"Summary"

body
string | null

Body. Validation: nullable, string.

Example:

"Students received their new supplies this week."

story_type
string | null

Story type. Validation: nullable, string, max:64.

Maximum string length: 64
Example:

"field_update"

privacy_level
enum<string> | null

Privacy level. Validation: nullable, string; allowed values: internal, donor_safe, public.

Available options:
internal,
donor_safe,
public,
null
Example:

"internal"

Consent status. Validation: nullable, string; allowed values: unknown, internal_only, donor_safe, public_safe.

Available options:
unknown,
internal_only,
donor_safe,
public_safe,
null
Example:

"unknown"

Response

Operation result.

data
object

Detailed governed story. Related records are filtered by current user access; unavailable references can be null.