Docs home
Sign in
ChannelDesk docs

Story tasks

Fetch prepared Story drafts and report mobile-assisted publishing state.

Story tasks

Stories that require mobile-assisted completion are prepared as tasks.

  • GET /api/v1/mobile/story-drafts lists Story drafts; brand_id is required.
  • GET /api/v1/mobile/story-drafts/{id} returns copy, media, network, and task state.
  • POST /api/v1/mobile/story-drafts/{id}/status reports the mobile outcome.

List prepared Stories

GET /api/v1/mobile/story-drafts?brand_id=42&page=1&perPage=20

Each item contains id, brand_id, title, media_url, media_type, link, story_note, and status.

Load and complete a task

GET /api/v1/mobile/story-drafts/{id} loads one prepared task. After the native Story flow, call POST /api/v1/mobile/story-drafts/{id}/status:

{
  "status": "posted"
}

Allowed statuses are now, posted, error, and rejected. Use posted only after confirmed success and rejected when the user declines the task.

Related pages

API authentication

Login, registration, token refresh, password recovery, and account endpoints.
Mobile devices

Register and deactivate Android and iOS push tokens.
Publishing jobs

Validate, publish, monitor, and retry selected social network targets.
API errors

Validation, authorization, conflict, rate-limit, and provider failure handling.
Brands and connections

Select a brand and discover its available publishing context.
Content drafts

Create, edit, list, and configure per-network content drafts.
Media and image templates

Upload images and videos or generate an image from a reusable template.
Android and iOS implementation checklist

End-to-end implementation and release checklist for ChannelDesk mobile publishing clients.