Schedule Discussion

curl --request PUT \
  --url https://api.member.dev/api/v1/discussions/{discussion_id}/schedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{}'

{
  "data": {
    "attributes": {
      "attachments": [
        {}
      ],
      "author_contact_id": "<string>",
      "author_display_name": "<string>",
      "author_photo_thumbnail_url": "<string>",
      "author_photo_thumbnail_url_expires_at": "2023-11-07T05:31:56Z",
      "author_photo_url": "<string>",
      "author_photo_url_expires_at": "2023-11-07T05:31:56Z",
      "body": "<string>",
      "comment_count": 123,
      "created_at": "<string>",
      "deleted_at": "<string>",
      "hub_id": "<string>",
      "is_broadcast": true,
      "is_locked": true,
      "is_pinned": true,
      "is_published": true,
      "last_activity_at": "<string>",
      "published_at": "<string>",
      "reaction_count": 123,
      "reactions": [
        "<unknown>"
      ],
      "scheduled_at": "<string>",
      "space_id": "<string>",
      "status": "<string>",
      "team_id": "<string>",
      "title": "<string>",
      "updated_at": "<string>"
    },
    "id": "<string>",
    "type": "<string>",
    "links": {
      "self": "<string>"
    },
    "meta": {},
    "relationships": {}
  },
  "included": [
    "<unknown>"
  ],
  "links": {
    "self": "<string>"
  },
  "meta": {}
}

community-discussions

Schedule Discussion

Schedule (or reschedule) a draft discussion for future auto-publication. Body: {data: {attributes: {scheduled_at: "<tz-aware ISO-8601>"}}} hub_id is sourced from the query string (?hub_id=...) — mirrors the /publish, /unpin, PATCH, and DELETE sibling action routes on this router. Returns 200 with the updated discussion resource on success. Returns 422 when scheduled_at is absent, naive (no tz offset), or fails business-rule bounds (too soon, too far). Returns 403 when the caller is not the author or is banned. Returns 404 when the discussion does not exist. Returns 409 when the discussion is already published.

PUT

api

discussions

{discussion_id}

schedule

Schedule Discussion

curl --request PUT \
  --url https://api.member.dev/api/v1/discussions/{discussion_id}/schedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{}'

{
  "data": {
    "attributes": {
      "attachments": [
        {}
      ],
      "author_contact_id": "<string>",
      "author_display_name": "<string>",
      "author_photo_thumbnail_url": "<string>",
      "author_photo_thumbnail_url_expires_at": "2023-11-07T05:31:56Z",
      "author_photo_url": "<string>",
      "author_photo_url_expires_at": "2023-11-07T05:31:56Z",
      "body": "<string>",
      "comment_count": 123,
      "created_at": "<string>",
      "deleted_at": "<string>",
      "hub_id": "<string>",
      "is_broadcast": true,
      "is_locked": true,
      "is_pinned": true,
      "is_published": true,
      "last_activity_at": "<string>",
      "published_at": "<string>",
      "reaction_count": 123,
      "reactions": [
        "<unknown>"
      ],
      "scheduled_at": "<string>",
      "space_id": "<string>",
      "status": "<string>",
      "team_id": "<string>",
      "title": "<string>",
      "updated_at": "<string>"
    },
    "id": "<string>",
    "type": "<string>",
    "links": {
      "self": "<string>"
    },
    "meta": {},
    "relationships": {}
  },
  "included": [
    "<unknown>"
  ],
  "links": {
    "self": "<string>"
  },
  "meta": {}
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

discussion_id

string

required

Query Parameters

hub_id

string

required

Body

application/vnd.api+json

The body is of type Body · object.

Response

Successful Response

data

JsonApiResource[DiscussionResponseAttributes] · object

required

Show child attributes

included

any[] | null

links

JsonApiLinks · object

Show child attributes