Update a script

Parameters

Body

application/json

• collection_idstring

  Moves the script to another collection of the same creator.

  format uuid
• namestring

  New name (1 to 30 characters).

  min length 1max length 30
• positioninteger

  New order in its collection (0 first).

  min 0
• context_notestring | null

  New note for the chatters. null or an empty string removes it.

  max length 1000
• messagesarray of objects

  Replaces the messages of the script: they become exactly this list, in this order (1 to 5); a stored message left out is deleted. Omit to keep them.

  min items 1max items 5
  Show fields (5)

  • idstring

    Id of an existing message of this script (from get_script), changed in place: its send history is kept. The first message is always the script itself. Omit it for a new message.

    format uuid
  • contentstringrequired

    Text of the message (1 to 500 characters).

    min length 1max length 500
  • price_centsinteger

    Price in euro cents to unlock the media of the message: 0 (free) or 500 to 100000. A paid message needs at least one media. Omitted: unchanged on a kept message, 0 on a new one.

    min 0max 100000
  • media_idsarray of strings

    MYM media uuids of the creator's vault, in order (20 max). Reuse the media_ids read on the scripts of the same creator. Omitted: unchanged on a kept message, none on a new one.

    format uuidmax items 20
  • is_voiceboolean

    A voice message: media_ids holds exactly one audio of the vault, and nothing else. Omitted: unchanged on a kept message, false on a new one.

Response

OK, application/json

• idstringrequired

  Fansquare script id. Path parameter of the /v1/scripts/{script_id} routes, and the script_id of a sequence option.

• creator_idstringrequired

  Fansquare creator id (see GET /v1/creators).

• collection_idstring | nullrequired

  Collection the script belongs to.

• namestringrequired

  Name of the script, as chatters see it in the script panel of the conversation.

• positionintegerrequired

  Order of the script in its collection (0 first).

• context_notestring | nullrequired

  Note for the chatters: when and why to send this script. Never sent to the fan. null without one.

• messagesarray of objectsrequired

  The messages a chatter sends, one after the other, when they pick the script: the first, then up to 4 more.

  Show fields (6)

  • idstringrequired

    Id of this message. The first message has the id of the script itself.

  • contentstringrequired

    Text of the message, sent as written.

  • price_centsintegerrequired

    Price in euro cents to unlock the media of the message (0 = free).

  • media_idsarray of stringsrequired

    MYM media uuids attached to the message, in order.

  • is_voicebooleanrequired

    The message is a voice message: its only media is an audio of the vault.

  • unresolved_media_countintegerrequired

    Media of the message stored under a former MYM id the API cannot serve, left out of media_ids (almost always 0). Above 0, the messages of this script are edited in the app (script_media_unresolved).

• created_atstringrequired

  When the script was created (ISO 8601).

  format date-time
• updated_atstringrequired

  When the script was last changed (ISO 8601).

  format date-time