docs-mastodon/content/en/entities/ScheduledStatus.md
trwnh ffbe66a389
Update content for 4.0, part 2 (#1060)
* fix relrefs around trends and related entities

* revert moving caption-links to middle of page

* hide empty menu in table of contents

* clarify edit notifs are only for boosted statuses

* following/followers no longer need auth

* fix typo

* specify cooldown period for account Move

* use the correct cooldown

* add missing parameters to accounts/id/statuses

* link to account_statuses_filter.rb

* fix typo (#1072)

* fix typo (#1073)

* fix link to http sig spec (#1067)

* simply HTTP request examples in api methods docs

* add missing client_secret to oauth/token (#1062)

* Add any, all, none to hashtag timeline

* minor formatting changes

* Update signature requirements and advice

* fix public key -> private key

* clarify use of RSA with SHA256

* Add note about saving your profile after adding rel-me link

* v2 filters api

* comment out params that shouldn't be used in v2 filter api

* admin trends

* remove old todo

* canonical email blocks + scheduled statuses

* remove under-construction warnings from finished pages

* verify api method params with source code

* fix typo (#1088)

* fix broken caption-links (#1100)

* fix formatting of entities (#1094)

* Remove keybase section from user guide (#1093)

* fix typos (#1092)

* Verify limits are accurate (#1086)

* add mention of iframe limitation (#1084)

* Add CORS header to WEB_DOMAIN example (#1083)

* Fix typo (#1081)

* pin http sigs spec at draft 8

* Revert "pin http sigs spec at draft 8"

This reverts commit 9fd5f7032b69b29e77599dd62adfe8d2f5cd4f20.

* add case sensitivity warning to 4.0 roles

* Add url length note to bio (#1087)

* remove follow scope from examples (#1103)

* clarify usage of update_credentials to update profile fields

* add noindex to Account entitity

* remove required hint from technically not required property
2022-12-14 22:55:30 +01:00

5.4 KiB

title description menu aliases
ScheduledStatus Represents a status that will be published at a future scheduled date.
docs
parent
entities
/entities/scheduledstatus
/entities/ScheduledStatus
/api/entities/scheduledstatus
/api/entities/ScheduledStatus

Example

Returned from POST /api/v1/statuses?status=test post&scheduled_at=2022-09-29

{
  "id": "1",
  "scheduled_at": "2022-09-29T00:00:00.000Z",
  "params": {
    "text": "test post",
    "media_ids": null,
    "sensitive": null,
    "spoiler_text": null,
    "visibility": null,
    "language": null,
    "scheduled_at": null,
    "poll": null,
    "idempotency": null,
    "with_rate_limit": false,
    "in_reply_to_id": null,
    "application_id": 3
  },
  "media_attachments": []
}

Returned from GET /api/v1/scheduled_statuses:

{
  "id": "1",
  "scheduled_at": "2022-09-29T00:00:00.000Z",
  "params": {
    "poll": null,
    "text": "test post",
    "language": null,
    "media_ids": null,
    "sensitive": null,
    "visibility": null,
    "idempotency": null,
    "scheduled_at": null,
    "spoiler_text": null,
    "application_id": 3,
    "in_reply_to_id": null,
    "with_rate_limit": false
  },
  "media_attachments": []
}

Attributes

id

Description: ID of the scheduled status in the database.
Type: String (cast from an integer but not guaranteed to be a number)
Version history:
2.7.0 - added

scheduled_at

Description: ID of the status in the database.
Type: String (ISO 8601 Datetime)
Version history:
2.7.0 - added

params

Description: The parameters that were used when scheduling the status, to be used when the status is posted.
Type: Hash
Version history:
2.7.0 - added

params[text]

Description: Text to be used as status content.
Type: String
Version history:
2.7.0 - added

params[poll]

Description: Poll to be attached to the status.
Type: {{}} Hash
Version history:
2.8.0 - added

params[poll][options[]]

Description: The poll options to be used.
Type: Array of String
Version history:
2.8.0 - added

params[poll][expires_in]

Description: How many seconds the poll should last before closing.
Type: String (cast from integer)
Version history:
2.8.0 - added

params[poll][multiple]

Description: Whether the poll allows multiple choices.
Type: {{}} Boolean
Version history:
2.8.0 - added

params[poll][hide_totals]

Description: Whether the poll should hide total votes until after voting has ended.
Type: {{}} Boolean
Version history:
2.8.0 - added

params[media_ids]

Description: IDs of the MediaAttachments that will be attached to the status.
Type: {{}} Array of String
Version history:
2.7.0 - added

params[sensitive]

Description: Whether the status will be marked as sensitive.
Type: {{}} Boolean
Version history:
2.7.0 - added

params[spoiler_text]

Description: The text of the content warning or summary for the status.
Type: {{}} String
Version history:
2.7.0 - added

params[visibility]

Description: The language that will be used for the status.
Type: {{}} String (ISO 639-1 two-letter language code)
Version history:
2.7.0 - added

params[in_reply_to_id]

Description: ID of the Status that will be replied to.
Type: {{}} Integer
Version history:
2.7.0 - added

params[language]

Description: The language that will be used for the status.
Type: {{}} String (ISO 639-1 two-letter language code)
Version history:
2.7.0 - added

params[application_id]

Description: ID of the Application that posted the status.
Type: Integer
Version history:
2.7.0 - added

params[scheduled_at]

Description: When the status will be scheduled. This will be null because the status is only scheduled once.
Type: {{}} Null
Version history:
2.7.0 - added

params[idempotency]

Description: Idempotency key to prevent duplicate statuses.
Type: {{}} String
Version history:
2.7.0 - added

params[with_rate_limit]

Description: Whether the status should be rate limited .
Type: Boolean
Version history:
2.7.0 - added

media_attachments

Description: Media that will be attached when the status is posted.
Type: Array of [MediaAttachment]({{< relref "entities/MediaAttachment" >}})
Version history:
2.7.0 - added

See also

{{< page-relref ref="methods/statuses#create" caption="POST /api/v1/statuses (with scheduled_at parameter)" >}}

{{< page-relref ref="methods/scheduled_statuses" caption="scheduled_statuses API methods" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/scheduled_status_serializer.rb" caption="app/serializers/rest/scheduled_status_serializer.rb" >}}