Skip to content
Console
On this page

Create a support thread message

Creates an idempotent SupportThreadMessage; changed replay and illegal state are refused.

This method is not served on the public API. api.sylphx.com does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

Creates an idempotent SupportThreadMessage; changed replay and illegal state are refused.

Not available yet. This method answers 501 with the problem code UNIMPLEMENTED.

  • Path POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_thread_messages
  • Scope notify:support:operate
  • Effect write — a successful call changes state.
  • Collection support_thread_messages
  • Query support_thread_message_id, request_id, validate_only, expected_version
  • Validate-only validate_only=true runs every check and writes nothing

Request

FieldTypeWhat it is
parentstringAuthenticated parent scope. Required.
support_thread_messageSupportThreadMessageRecord to admit; actor and output fields are derived by the service. Required.
support_thread_message_idstringOptional caller-selected platform ID; legacy IDs stay in source_records.
request_idstringUUID request identity, stable across transport retries.
validate_onlyboolValidate without admitting a case, message or effect.
expected_versionint64Case aggregate version observed by the caller. Required.

SupportThreadMessage

FieldTypeWhat it is
namestringCanonical thread message name.
metaResourceMetaTimestamps and metadata.
source_keystringImmutable source-scoped event identity; changed replays are refused. Required.
visibilitySupportMessageVisibilityExplicit audience; internal notes never enter the customer timeline. Required. One of public, internal.
authorSupportActorVerified author; never inferred from a claimed From address.
bodystringText body or evidence projection; untrusted personal content. Never returned again.
evidenceSupportEvidence[]Source evidence, including explicitly untrusted HTML and attachments.
channel_idstringExisting channel-link ID, not a credential.
thread_keysstring[]Original provider message identity and ancestry.
actionstringRelated business action, never a notification delivery state alias.
erasedboolTombstone; source keys/ancestry survive authorized erasure.
source_recordsSupportSourceRecord[]Original IDs/records for lossless migration.
directionstringSource direction: inbound, outbound or internal; independent of visibility.

ResourceMeta

FieldTypeWhat it is
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.

SupportActor

FieldTypeWhat it is
principalstringActing Access principal or authenticated external source identity. Required.
delegated_forstringDelegating principal, when the grant records one.
authoritystringPublic source authority for a workload or channel event.

SupportEvidence

FieldTypeWhat it is
idstringStable evidence identity in the tenant environment.
authoritystringAuthenticated source, not a caller-selected trust claim.
resourcestringPermissioned public API resource containing the bytes; never a credential URL.
sha256stringSHA-256 of the original evidence bytes, lowercase hexadecimal.
media_typestringRegistered media type of the original bytes.
size_bytesint64Exact byte length, not the number of Unicode characters.
receive_timetimestampSource-reported received time.
erasedboolErasure keeps identity/hash/dedupe tombstones, never resurrects source content.

SupportSourceRecord

FieldTypeWhat it is
sourcestringStable source namespace, retained across retries and migration phases.
source_tablestringOriginal relation or event kind.
source_idstringUnchanged source primary key, including numeric case/message/outbox IDs.
evidenceSupportEvidenceEvidence holding the full canonical source record, not a lossy projection.
source_versionint64Original source version, if present; zero means absent, not fabricated.

Response

FieldTypeWhat it is
namestringCanonical thread message name.
uidstringImmutable identity. Output only.
metaResourceMetaTimestamps and metadata.
source_keystringImmutable source-scoped event identity; changed replays are refused. Required.
visibilitySupportMessageVisibilityExplicit audience; internal notes never enter the customer timeline. Required. One of public, internal.
authorSupportActorVerified author; never inferred from a claimed From address.
bodystringText body or evidence projection; untrusted personal content. Never returned again.
evidenceSupportEvidence[]Source evidence, including explicitly untrusted HTML and attachments.
channel_idstringExisting channel-link ID, not a credential.
thread_keysstring[]Original provider message identity and ancestry.
actionstringRelated business action, never a notification delivery state alias.
erasedboolTombstone; source keys/ancestry survive authorized erasure.
source_recordsSupportSourceRecord[]Original IDs/records for lossless migration.
directionstringSource direction: inbound, outbound or internal; independent of visibility.

ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

SupportActor

FieldTypeWhat it is
principalstringActing Access principal or authenticated external source identity. Required.
delegated_forstringDelegating principal, when the grant records one.
authoritystringPublic source authority for a workload or channel event.

SupportEvidence

FieldTypeWhat it is
idstringStable evidence identity in the tenant environment.
authoritystringAuthenticated source, not a caller-selected trust claim.
resourcestringPermissioned public API resource containing the bytes; never a credential URL.
sha256stringSHA-256 of the original evidence bytes, lowercase hexadecimal.
media_typestringRegistered media type of the original bytes.
size_bytesint64Exact byte length, not the number of Unicode characters.
receive_timetimestampSource-reported received time.
erasedboolErasure keeps identity/hash/dedupe tombstones, never resurrects source content.

SupportSourceRecord

FieldTypeWhat it is
sourcestringStable source namespace, retained across retries and migration phases.
source_tablestringOriginal relation or event kind.
source_idstringUnchanged source primary key, including numeric case/message/outbox IDs.
evidenceSupportEvidenceEvidence holding the full canonical source record, not a lossy projection.
source_versionint64Original source version, if present; zero means absent, not fabricated.

Errors

Every error arrives in the body Errors describes.

Examples

curl -X POST "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_thread_messages" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_key":"…","visibility":"public"}'