Update an Ambassador Post

PATCH /manager/posts/{id}

Path parameters

  • id integer(int32) Required

    The id of the ambassador post

application/json

Body Required

  • status string | null
  • contents array[object]
    Hide contents attributes Show contents attributes object
    • lang string

      Values are en_GB, fr_FR, es_ES, or de_DE.

    • content string
  • titles array[object]
    Hide titles attributes Show titles attributes object
    • lang string

      Values are en_GB, fr_FR, es_ES, or de_DE.

    • content string
  • is_on_boarding boolean
  • is_welcome boolean
  • shareable boolean
  • no_comment boolean
  • is_akn boolean
  • is_planned boolean
  • start_date string
  • data1 string
  • data2 string
  • thread_last_update string

Responses

  • 200 application/json

    returns the updated ambassador post

    Hide response attributes Show response attributes object
    • id_ambassador_post integer(int32)
    • id_ambassador_post_shared integer(int32)
    • date_post string(date-time)
    • date_insert string(date-time)
    • date_update string(date-time)
    • author object

      Additional properties are allowed.

      Hide author attributes Show author attributes object
      • id_ambassador integer(int32)
      • image string
      • firstname string
      • lastname string
      • username string
      • email string
      • email_tmp string
      • active integer(int32)
      • status integer(int32)
      • online boolean

        true: when last_action_date is less than 5 minutes ago

      • last_action_date string(date-time)
      • customer_id string
      • anonymized boolean
    • type string(nullable)
    • content string(nullable)
    • nb_likes integer(int32)
    • nb_comments integer(int32)
    • visibility string(nullable)
    • view_on_blog boolean
    • products array[object]
      Hide products attributes Show products attributes object
      • id_product integer(int32)
      • name string(nullable)
      • type string(nullable)
      • discount_percentage number(float)
      • price_catalog integer(float)
      • reference_unit_price integer(float)
      • sku string(nullable)
      • youtube_id string(nullable)
      • url string(nullable)
      • description string(nullable)
      • images array[object]
        Hide images attributes Show images attributes object
        • id_i18n_content integer
        • lang string

          Values are en_GB, fr_FR, es_ES, or de_DE.

        • content string
      • price number(float)
      • stock integer(float)
      • stock_available number(float)
      • old_image string(nullable)
    • comments array[object]
      Hide comments attributes Show comments attributes object
      • id_ambassador_post integer(int32)
      • author object

        Additional properties are allowed.

        Hide author attributes Show author attributes object
        • id_ambassador integer(int32)
        • image string(nullable)
        • full_name string
        • username string(nullable)
        • description string
        • status integer(int32)
        • availability string(nullable)
        • unavailable boolean
        • is_absent boolean
        • absent_msg string(nullable)
        • fb_account string(nullable)
        • twitter_account string(nullable)
        • instagram_account string(nullable)
        • linkedIn_account string(nullable)
        • youtube_account string(nullable)
        • online boolean

          true: when last_action_date is less than 5 minutes ago

        • last_action_date string
        • location string

          Label of the point of sale, or city of the ambassador

      • content string(nullable)
      • nb_likes integer(int32)
      • comments array[object]

        Additional properties are allowed.

      • date_created string(date-time)
      • date_timestamp boolean
      • liked boolean
    • videos array[object]
      Hide videos attributes Show videos attributes object
      • id_video integer
      • date_insert string(date-time)
      • date_update string(date-time)
      • date_delete string(date-time)
      • id_blob string
      • state integer

        Values are 0, 1, 2, or 3.

    • nb_orders integer(int32)
    • liked boolean
    • contents array[object]
      Hide contents attributes Show contents attributes object
      • id_i18n_content integer
      • lang string

        Values are en_GB, fr_FR, es_ES, or de_DE.

      • content string
    • titles array[object]
      Hide titles attributes Show titles attributes object
      • id_i18n_content integer
      • lang string

        Values are en_GB, fr_FR, es_ES, or de_DE.

      • content string
    • is_planned boolean
    • shares integer(int32)
    • status string(nullable)
    • is_brand boolean
    • is_akn boolean
    • data1 string
    • data2 string
    • thread_last_update string(date-time)
    • start_date string(date-time)
    • is_on_boarding boolean
    • is_welcome boolean
    • shareable boolean
    • no_comment boolean
    • id_popliste number
  • 401 application/json

    Unauthorized.

    Hide response attribute Show response attribute object
    • message string
  • 403

    Forbidden - You don't have permission to access this route

  • 404

    Not found

  • 422 application/json

    Unprocessable Content

    Hide response attributes Show response attributes object
    • message string

      Error message.

    • errors object
      Hide errors attributes Show errors attributes object
      • field array[string]

        Error message details.

      • * array[string] Additional properties

        Error message details.

PATCH /manager/posts/{id}
curl \
 --request PATCH 'https://domain.tld/api/v2/manager/posts/{id}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"status":"string","contents":[{"lang":"en_GB","content":"Hello"}],"titles":[{"lang":"en_GB","content":"Hello"}],"is_on_boarding":true,"is_welcome":true,"shareable":true,"no_comment":true,"is_akn":true,"is_planned":true,"start_date":"string","data1":"string","data2":"string","thread_last_update":"string"}'
Request examples
{
  "status": "string",
  "contents": [
    {
      "lang": "en_GB",
      "content": "Hello"
    }
  ],
  "titles": [
    {
      "lang": "en_GB",
      "content": "Hello"
    }
  ],
  "is_on_boarding": true,
  "is_welcome": true,
  "shareable": true,
  "no_comment": true,
  "is_akn": true,
  "is_planned": true,
  "start_date": "string",
  "data1": "string",
  "data2": "string",
  "thread_last_update": "string"
}
Response examples (200)
{
  "id_ambassador_post": 42,
  "id_ambassador_post_shared": 42,
  "date_post": "2025-05-04T09:42:00Z",
  "date_insert": "2025-05-04T09:42:00Z",
  "date_update": "2025-05-04T09:42:00Z",
  "author": {
    "id_ambassador": 42,
    "image": "string",
    "firstname": "string",
    "lastname": "string",
    "username": "string",
    "email": "string",
    "email_tmp": "string",
    "active": 42,
    "status": 42,
    "online": true,
    "last_action_date": "2025-05-04T09:42:00Z",
    "customer_id": "string",
    "anonymized": true
  },
  "type": "string",
  "content": "string",
  "nb_likes": 42,
  "nb_comments": 42,
  "visibility": "PUBLIC",
  "view_on_blog": true,
  "products": [
    {
      "id_product": 42,
      "name": "string",
      "type": "string",
      "discount_percentage": 42.0,
      "price_catalog": 42,
      "reference_unit_price": 42,
      "sku": "string",
      "youtube_id": "string",
      "url": "string",
      "description": "string",
      "images": [
        {
          "id_i18n_content": 42,
          "lang": "en_GB",
          "content": "Hello"
        }
      ],
      "price": 42.0,
      "stock": 42,
      "stock_available": 42.0,
      "old_image": "string"
    }
  ],
  "comments": [
    {
      "id_ambassador_post": 42,
      "author": {
        "id_ambassador": 42,
        "image": "string",
        "full_name": "string",
        "username": "string",
        "description": "string",
        "status": 42,
        "availability": "string",
        "unavailable": true,
        "is_absent": true,
        "absent_msg": "string",
        "fb_account": "string",
        "twitter_account": "string",
        "instagram_account": "string",
        "linkedIn_account": "string",
        "youtube_account": "string",
        "online": true,
        "last_action_date": "string",
        "location": "Paris"
      },
      "content": "string",
      "nb_likes": 42,
      "comments": [
        {}
      ],
      "date_created": "2025-05-04T09:42:00Z",
      "date_timestamp": true,
      "liked": true
    }
  ],
  "videos": [
    {
      "id_video": 1,
      "date_insert": "2023-10-09T12:12:40.220000Z",
      "date_update": "2023-10-09T12:12:40.220000Z",
      "date_delete": "2023-10-09T12:12:40.220000Z",
      "id_blob": "f0dab429-ae29-4e26-b6ea-138d351831eb",
      "state": 0
    }
  ],
  "nb_orders": 42,
  "liked": true,
  "contents": [
    {
      "id_i18n_content": 42,
      "lang": "en_GB",
      "content": "Hello"
    }
  ],
  "titles": [
    {
      "id_i18n_content": 42,
      "lang": "en_GB",
      "content": "Hello"
    }
  ],
  "is_planned": true,
  "shares": 42,
  "status": "PUBLISHED",
  "is_brand": true,
  "is_akn": true,
  "link": 42.0,
  "data1": "string",
  "data2": "string",
  "thread_last_update": "2025-05-04T09:42:00Z",
  "start_date": "2025-05-04T09:42:00Z",
  "is_on_boarding": true,
  "is_welcome": true,
  "shareable": true,
  "no_comment": true,
  "id_popliste": 42.0
}
Response examples (401)
{
  "message": "Unauthorized."
}
Response examples (422)
{
  "message": "field is required! (and 3 more error)",
  "errors": {
    "field": [
      "Error message details here"
    ],
    "additionalProperty1": [
      "Error message details here"
    ],
    "additionalProperty2": [
      "Error message details here"
    ]
  }
}