Atlasemoji API

openapi: 3.1.0
info:
  title: Atlasemoji API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 23 operation(s) read from 18 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Atlasemoji has published no machine-readable contract
    that the pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 3
    documentation: 20
    pages-with-code: 5
    pages-read: 18
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://atlasemoji.com/developers/api
  - https://atlasemoji.com/ar/developers/api/quick-start
  - https://atlasemoji.com/quick-starts/geojson-conversation
  - https://atlasemoji.com/quick-starts/emergency-planning
  - https://atlasemoji.com/quick-starts/historical-storytelling
  - https://atlasemoji.com/datasynch/developers/api
  - https://atlasemoji.com/datasynch/developers/examples
  - https://atlasemoji.com/learn/connected-systems/apis-openapi
  - https://atlasemoji.com/learn/connected-systems/openapi
  - https://atlasemoji.com/datasynch/developers/quick-starts
  - https://atlasemoji.com/datasynch/developers/gcp
  - https://atlasemoji.com/datasynch/developers/non-gcp
  - https://atlasemoji.com/datasynch/developers/api?query=%2Fapi%2Fdatasynch%2Flocations%2Fimport
  - https://atlasemoji.com/datasynch/developers/api?query=%2Fapi%2Fdatasynch%2Fgeofences
  - https://atlasemoji.com/datasynch/developers/api?query=%2Fapi%2Fdatasynch%2Ftelemetry%2Fevents
  - https://atlasemoji.com/datasynch/developers/api?query=%2Fapi%2Fdatasynch%2Fxref%2Fevaluate
  - https://atlasemoji.com/datasynch/developers/api?query=%2Fapi%2Fdatasynch%2Fnotification-dispatch
  - https://atlasemoji.com/datasynch/developers/api?query=GCP
paths:
  /api/datasynch/application-integration/status:
    get:
      operationId: get_api_datasynch_application_integration_status
      tags:
      - Api
      summary: Health GCP safe UI backed
      description: Check GCP Application Integration readiness. Inspect safe configuration status for Application Integration execution.
      x-source: https://atlasemoji.com/datasynch/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/crm/import:
    post:
      operationId: post_api_datasynch_crm_import
      tags:
      - Api
      summary: Import CRM records
      x-source: https://atlasemoji.com/datasynch/developers/examples
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchCrmImportRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiDatasynchCrmImportResponse'
      x-evidence:
        kind: documentation
  /api/datasynch/geofence-events:
    post:
      operationId: post_api_datasynch_geofence_events
      tags:
      - Api
      summary: Geofence Events
      description: Create a geofence event. Record an enter, exit, dwell, wrong-site, or nearby event for a subject and geofence.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchGeofenceEventsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/geofences:
    post:
      operationId: post_api_datasynch_geofences
      tags:
      - Api
      summary: Geofences
      description: Create a geofence. Create a point-radius or polygon geofence tied to a manifest and optionally a location.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchGeofencesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/health:
    get:
      operationId: get_api_datasynch_health
      tags:
      - Api
      summary: Health
      description: Check DataSynch health. Confirm that the DataSynch API is responding before testing deeper workflows.
      x-source: https://atlasemoji.com/datasynch/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/integrations/profiles:
    get:
      operationId: get_api_datasynch_integrations_profiles
      tags:
      - Api
      summary: Profiles GCP safe UI backed
      description: List integration profiles. List reusable source, processing, and outbound profiles scoped to a manifest.
      x-source: https://atlasemoji.com/datasynch/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/integrations/receiver:
    post:
      operationId: post_api_datasynch_integrations_receiver
      tags:
      - Api
      summary: Integration Intake
      description: Receive integration payload records. Accept normalized or semi-normalized records from GCP Application Integration, a webhook,
        file processor, scanner, or internal source.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchIntegrationsReceiverRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/locations/import:
    post:
      operationId: post_api_datasynch_locations_import
      tags:
      - Api
      summary: Locations
      description: Import location records. Import location master data from WMS, TMS, ERP, spreadsheet, partner feed, or integration connector.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchLocationsImportRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/master-tables/import:
    post:
      operationId: post_api_datasynch_master_tables_import
      tags:
      - Api
      summary: Master Tables
      description: Import master table records. Import mapper-safe dynamic records into CRM, locations, items, inventory, or telemetry.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchMasterTablesImportRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/notification-dispatch:
    post:
      operationId: post_api_datasynch_notification_dispatch
      tags:
      - Api
      summary: Dispatch
      description: Dispatch a notification. Queue or send internal notification, email, webhook, Slack message, or CSV export request.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchNotificationDispatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/processing/normalize:
    post:
      operationId: post_api_datasynch_processing_normalize
      tags:
      - Api
      summary: Processing
      description: Normalize records. Normalize mapper-safe records and infer fields before importing or evaluating rules.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchProcessingNormalizeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/runs:
    get:
      operationId: get_api_datasynch_runs
      tags:
      - Api
      summary: List integration runs
      description: List run logs for operational traceability and support. Required context manifestId.
      x-source: https://atlasemoji.com/datasynch/developers/api
      parameters:
      - name: manifestId
        in: query
        required: true
        schema:
          type: string
        description: Required context manifestId
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/telemetry/events:
    post:
      operationId: post_api_datasynch_telemetry_events
      tags:
      - Api
      summary: Telemetry
      description: Create a telemetry event. Send one telemetry or logistics event, such as arrival, departure, in-transit, exception, or status
        update.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchTelemetryEventsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/datasynch/xref/evaluate:
    post:
      operationId: post_api_datasynch_xref_evaluate
      tags:
      - Api
      summary: XREF
      description: Evaluate XREF rules. Evaluate cross-reference rules against incoming records before import or dispatch.
      x-source: https://atlasemoji.com/datasynch/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDatasynchXrefEvaluateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/embed/{manifestid}/share:
    get:
      operationId: get_api_embed_manifestid_share
      tags:
      - Api
      summary: GET /api/embed/{manifestId}/share
      x-source: https://atlasemoji.com/ar/developers/api/quick-start
      parameters:
      - name: manifestid
        in: path
        required: true
        schema:
          type: string
      - name: lang
        in: query
        required: false
        schema:
          type: string
        description: Language code for the embed
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/embed/{manifestid}/static:
    get:
      operationId: get_api_embed_manifestid_static
      tags:
      - Api
      summary: GET /api/embed/{manifestId}/static
      x-source: https://atlasemoji.com/ar/developers/api/quick-start
      parameters:
      - name: manifestid
        in: path
        required: true
        schema:
          type: string
      - name: lang
        in: query
        required: false
        schema:
          type: string
        description: Language code for the static image
      - name: width
        in: query
        required: false
        schema:
          type: string
        description: Width of the generated image
      - name: height
        in: query
        required: false
        schema:
          type: string
        description: Height of the generated image
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/import/geojson:
    post:
      operationId: post_api_import_geojson
      tags:
      - Api
      summary: POST /api/import/geojson
      x-source: https://atlasemoji.com/quick-starts/geojson-conversation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiImportGeojsonRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiImportGeojsonResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl example Copy curl -X POST \"https://atlasemoji.com/api/import/geojson\"  -H \"Content-Type: application/json\"  -d '{\n\
          \ \"title\": \"My first Atlasemoji route\",\n \"geojson\": {\n \"type\": \"FeatureCollection\",\n \"features\": [\n {\n \"type\": \"\
          Feature\",\n \"properties\": {\n \"title\": \"First waypoint\",\n \"emoji\": \"\U0001F4CD\",\n \"kind\": \"demo-point\"\n },\n \"geometry\"\
          : {\n \"type\": \"Point\",\n \"coordinates\": [-122.335167, 47.608013]\n"
  /api/manifests/{manifestid}:
    get:
      operationId: get_api_manifests_manifestid
      tags:
      - Api
      summary: GET /api/manifests/{manifestId}
      x-source: https://atlasemoji.com/ar/developers/api/quick-start
      parameters:
      - name: manifestid
        in: path
        required: true
        schema:
          type: string
      - name: pretty
        in: query
        required: false
        schema:
          type: string
        description: Pretty‑print the JSON response
      - name: format
        in: query
        required: false
        schema:
          type: string
        description: Response format, e.g., "geojson"
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/partners/arcgis/connect:
    post:
      operationId: post_api_partners_arcgis_connect
      tags:
      - Api
      summary: Partner connection routes
      x-source: https://atlasemoji.com/developers/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/partners/mapbox/connect:
    post:
      operationId: post_api_partners_mapbox_connect
      tags:
      - Api
      summary: Partner connection routes
      x-source: https://atlasemoji.com/developers/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/partners/{partner}/disconnect:
    post:
      operationId: post_api_partners_partner_disconnect
      tags:
      - Api
      summary: Partner connection routes
      x-source: https://atlasemoji.com/developers/api
      parameters:
      - name: partner
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/partners/{partner}/test:
    post:
      operationId: post_api_partners_partner_test
      tags:
      - Api
      summary: Partner connection routes
      x-source: https://atlasemoji.com/developers/api
      parameters:
      - name: partner
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /observations:
    post:
      operationId: post_observations
      tags:
      - Observations
      summary: POST /observations
      x-source: https://atlasemoji.com/learn/connected-systems/apis-openapi
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiDatasynchCrmImportRequest:
      type: object
      properties:
        manifestId:
          type: string
        records:
          type: array
      required:
      - manifestId
      - records
    PostApiDatasynchCrmImportResponse:
      type: object
      properties:
        ok:
          type: boolean
        manifestId:
          type: string
        importedCount:
          type: integer
        failedCount:
          type: integer
        errors:
          type: array
    PostApiDatasynchGeofenceEventsRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        eventType:
          type: string
          description: Type of geofence event.
        subjectId:
          type: string
          description: Identifier of the subject involved.
        assetReference:
          type: string
          description: Reference to the asset if subjectId not used.
      required:
      - manifestId
      - eventType
      - subjectId
      - assetReference
    PostApiDatasynchGeofencesRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        name:
          type: string
          description: Name of the geofence.
        geometryType:
          type: string
          description: Geometry type (point-radius or polygon).
      required:
      - manifestId
      - name
      - geometryType
    PostApiDatasynchIntegrationsReceiverRequest:
      type: object
      properties:
        companyId:
          type: string
          description: Company identifier when enforcement is enabled.
        workspaceId:
          type: string
          description: Workspace identifier when available.
        manifestId:
          type: string
          description: Manifest identifier.
        connectorId:
          type: string
          description: Connector identifier.
        sourceKind:
          type: string
          description: Source kind of the incoming payload.
      required:
      - companyId
      - workspaceId
      - manifestId
      - connectorId
      - sourceKind
    PostApiDatasynchLocationsImportRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        records:
          type: string
          description: Location records to import.
      required:
      - manifestId
      - records
    PostApiDatasynchMasterTablesImportRequest:
      type: object
      properties:
        companyId:
          type: string
          description: Company identifier when enforcement is enabled.
        workspaceId:
          type: string
          description: Workspace identifier when available.
        manifestId:
          type: string
          description: Manifest identifier.
        targetTable:
          type: string
          description: Target master table for the import.
        records:
          type: string
          description: Records to be imported.
      required:
      - companyId
      - workspaceId
      - manifestId
      - targetTable
      - records
    PostApiDatasynchNotificationDispatchRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        dispatchType:
          type: string
          description: Type of dispatch (e.g., email, webhook).
        payload:
          type: string
          description: Payload of the notification.
      required:
      - manifestId
      - dispatchType
      - payload
    PostApiDatasynchProcessingNormalizeRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        records:
          type: string
          description: Records to normalize.
      required:
      - manifestId
      - records
    PostApiDatasynchTelemetryEventsRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        eventTime:
          type: string
          description: Timestamp of the event.
        sourceTimestamp:
          type: string
          description: Alternative source timestamp for the event.
        eventCode:
          type: string
          description: Code representing the event type.
        eventDescription:
          type: string
          description: Description of the event.
      required:
      - manifestId
      - eventTime
      - sourceTimestamp
      - eventCode
      - eventDescription
    PostApiDatasynchXrefEvaluateRequest:
      type: object
      properties:
        manifestId:
          type: string
          description: Manifest identifier.
        records:
          type: string
          description: Records to evaluate.
        rules:
          type: string
          description: XREF rules to apply.
        profileId:
          type: string
          description: Profile identifier for rule set.
      required:
      - manifestId
      - records
      - rules
      - profileId
    PostApiImportGeojsonRequest:
      type: object
      properties:
        title:
          type: string
        geojson:
          type: object
          properties:
            type:
              type: string
            features:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  properties:
                    type: object
                    properties:
                      title:
                        type: string
                      emoji:
                        type: string
                      kind:
                        type: string
                  geometry:
                    type: object
                    properties:
                      type:
                        type: string
                      coordinates:
                        type: array
                        items:
                          type: number
    PostApiImportGeojsonResponse:
      type: object
      properties:
        ok:
          type: boolean
        routeId:
          type: string
        featureCount:
          type: integer
        message:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: Api
- name: Observations