Metadata Ingestion
/
IngestionService
/
Metadata Ingestion

Metadata Ingestion

Our Metadata Ingestion API allows clients to seamlessly upload and integrate metadata from diverse data sources, enabling powerful downstream analysis and retrieval.

Languages
Servers
https://{api-domain}.cresta.com/

IngestionService

Operations

Metadata Ingestion

Request

Path
profilestringrequired

Resource name of the profile where the data should be ingested

Format: customers/{customer_id}/profiles/{profile_id}

Bodyapplication/jsonrequired
ingestionTypestring(All known notifications must be registered here and need to have a matching)
  • INGESTION_TYPE_UNSPECIFIED: The default value which will be rejected by services as it indicates a not properly set ingestion
  • CONVERSATION_METADATA: ingesting conversation metadata
Default "INGESTION_TYPE_UNSPECIFIED"
Enum"INGESTION_TYPE_UNSPECIFIED""CONVERSATION_METADATA"
rawContentDatastring(byte)(raw bytes being transmitted directly in the request)
s3FilePathstring(path to uploaded file in s3 (internal customer bucket))
externalS3Fileobject(External S3 file from an integration)
conversationMetadataobject(AnalyzeConversationMetadataRequest payload for IngestionType.CONVERSATION_METADATA)
curl -i -X POST \
  'https://{api-domain}.cresta.com/v1/{profile}:analyzeIngestionData' \
  -H 'Content-Type: application/json' \
  -d '{
    "ingestionType": "INGESTION_TYPE_UNSPECIFIED",
    "rawContentData": "string",
    "s3FilePath": "string",
    "externalS3File": {
      "integration": "string",
      "objectKey": "string"
    },
    "conversationMetadata": {
      "previewRowCount": 0,
      "csvParsingConfig": {
        "delimiter": "string",
        "commentChar": "string",
        "expectedFieldsPerRecord": 0,
        "noLazyQuotes": true,
        "trimLeadingSpace": true
      }
    }
  }'

Responses

A successful response.

Bodyapplication/json
conversationMetadataobject(AnalyzeIngestionDataResponse payload for IngestionType.CONVERSATION_METADATA)
Response
application/json
{
  "conversationMetadata": {
    "headers": [ … ],
    "dataRowCount": 0,
    "previewData": [ … ],
    "candidatePlatformColumns": [ … ]
  }
}