Synupv1
Schlüssel erstellen
v1Ressourcen/Post Ideas/patchBeitragsidee aktualisieren

Beitragsidee aktualisieren

Aktualisiert die bearbeitbaren Felder einer Beitragsidee. id akzeptiert entweder die eigene id oder die externalId, mit der sie erstellt wurde.

patch/api/v1/post-ideas/{id}
ideas:write
Query-Parameter
idstringerforderlich
Die zu aktualisierende Beitragsidee — ihre id oder externalId.
Anfragetext
titlestringoptional
Der Titel der Idee. Bei der Erstellung erforderlich.
contentstringoptional
Der Text/Inhalt der Idee.
imageUrlstringoptional
URL eines an die Idee anzuhängenden Bildes.
imagePromptstringoptional
Der Prompt, mit dem das Bild der Idee generiert wurde.
typestring (announcement | offer | tip | showcase | story | event)optional
Ideentyp.
statusstring (draft | published | archived)optional
Ideenstatus.
platformsarray of stringoptional
Plattformen, für die diese Idee vorgesehen ist.
scheduledDatestringoptional
Geplantes Veröffentlichungsdatum (YYYY-MM-DD).
scheduledTimestringoptional
Geplante Veröffentlichungszeit.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung der Beitragsidee.
locationIdstringoptional
ID des Standorts, zu dem diese Idee gehört, oder null bei einer markenweiten Idee.
clientLocationIdstringoptional
Aufgelöste Standort-Datensatz-ID, oder null.
clientIdstringoptional
ID des Kunden, zu dem diese Idee gehört (markenweite Ideen), oder null.
brandNamestringoptional
Anzeigename des Markenprofils, bei markenweiten Ideen, oder null.
titlestringoptional
Der Titel der Idee.
contentstringoptional
Der Text/Inhalt der Idee.
imageUrlstringoptional
URL des Bildes der Idee, oder null.
imagePromptstringoptional
Der Prompt, mit dem das Bild der Idee generiert wurde, oder null.
typestring (announcement | offer | tip | showcase | story | event)optional
Ideentyp: announcement, offer, tip, showcase, story oder event.
statusstring (draft | published | archived)optional
Ideenstatus: draft, published oder archived.
bucketstring (idea | holiday | calendar | series)optional
In welchem Raster-Bucket die Idee liegt: idea, holiday, calendar oder series.
platformsarray of stringoptional
Plattformen, für die diese Idee vorgesehen ist.
seriesIdstringoptional
ID der Content-Serie, zu der diese Idee gehört, oder null.
scheduledDatestringoptional
Geplantes Veröffentlichungsdatum (YYYY-MM-DD), oder null.
scheduledTimestringoptional
Geplante Veröffentlichungszeit, oder null.
externalIdstringoptional
Stabile ID, mit der diese Idee erstellt wurde, falls sie aus einer externen Quelle stammt.
sourcestring (os | agent)optional
Woher die Idee stammt: os (in Synup erstellt) oder agent (von einem KI-Agenten übermittelt).
reviewStatusstring (pending | approved | rejected)optional
Genehmigungsgate: null (kein Gate), pending, approved oder rejected.
generationJobIdstringoptional
ID des KI-Generierungsjobs, der diese Idee erzeugt hat, falls vorhanden, oder null.
isUserGeneratedbooleanoptional
Ob ein Mensch (und nicht ein Agent) diese Idee erstellt hat.
archivedbooleanoptional
Ob diese Idee archiviert wurde.
archivedAtstringoptional
Wann diese Idee archiviert wurde, als ISO-8601-Zeitstempel, oder null.
createdAtstringoptional
Wann diese Idee erstellt wurde, als ISO-8601-Zeitstempel.
updatedAtstringoptional
Wann diese Idee zuletzt aktualisiert wurde, als ISO-8601-Zeitstempel.
locationNamestringoptional
Anzeigename des Standorts der Idee. Nur vorhanden, wenn die standortbezogenen Ideen eines Kunden aufgelistet werden.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
patch/api/v1/post-ideas/{id}
Ihr API-Schlüssel
id *
Anfragetext
{
  "data": {
    "id": "cm_idea_abc123",
    "agencyId": "cm_agency_1",
    "locationId": "cm_loc_1",
    "clientLocationId": "cm_loc_1",
    "clientId": null,
    "brandName": null,
    "agentMeta": null,
    "title": "Spotlight our new patient special (updated)",
    "content": "Book this month and get 25% off your first cleaning!",
    "imagePrompt": null,
    "imageUrl": null,
    "type": "announcement",
    "status": "draft",
    "bucket": "idea",
    "platforms": [
      "google",
      "facebook"
    ],
    "seriesId": null,
    "scheduledDate": null,
    "scheduledTime": null,
    "observanceName": null,
    "observanceDate": null,
    "generationBatchId": null,
    "generationJobId": null,
    "isUserGenerated": true,
    "source": "os",
    "externalId": "cm_idea_abc123",
    "reviewStatus": null,
    "archived": false,
    "archivedAt": null,
    "createdAt": "2026-01-20T09:00:00.000Z",
    "updatedAt": "2026-01-20T09:05:00.000Z"
  }
}