Synupv1
Schlüssel erstellen
v1Ressourcen/Post Ideas/getBeitragsidee abrufen

Beitragsidee abrufen

Liefert eine einzelne Beitragsidee. id akzeptiert entweder die eigene id oder die externalId, mit der sie erstellt wurde.

get/api/v1/post-ideas/{id}
ideas:read
Query-Parameter
idstringerforderlich
Die abzurufende Beitragsidee — ihre id oder externalId.
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
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.
get/api/v1/post-ideas/{id}
Ihr API-Schlüssel
id *
{
  "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",
    "content": "Book this month and get 20% 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:00:00.000Z"
  }
}