Import objects

Changed on

Import multiple objects in batch. Properties are keyed by slug. Automatically routes based on size: small batches complete synchronously and return 200 with the final ImportJob; large batches start an async job, return 202 with status: processing and a Location header, and can be polled via GET /v2/prism/{teamId}/imports/{jobId}.

post/v2/prism/{teamId}/event/import

Request

  • Base URL
    https://developers.micro.so
  • URL
    https://developers.micro.so/v2/prism/{teamId}/event/import
  • Auth
    API key in header x-api-key

Path parameters

teamIdstring uuid required

Headers

Idempotency-Keystring

A unique key (UUID or any opaque string up to 255 chars) for an authenticated POST, PUT, or PATCH request. The server retains the initial claim for 24 hours and replays a completed non-5xx response only when the method, path, and request body all match. Reusing a non-expired key with a different method, path, or body returns 409 idempotency_key_mismatch; reusing it after expiry returns 409 idempotency_key_stale, so use a new key. Replays include the idempotent-replay: true response header.

Request body

Response

Import complete (sync path for small batches). status is complete, job_id is null, and per-row outcomes are inlined under results.

job_idstring nullable required

Null for sync imports (results inlined). Set for async imports.

status'complete' | 'processing' | 'failed' required
totalinteger required

Total number of rows in the import.

processedinteger

Rows that have been attempted (succeeded + failed).

succeededinteger
failedinteger
created_atstring date-time
updated_atstring date-time
expires_atstring date-time

Changes

  • aa8d5fd72a2bRevision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      request property / list-of-types was widened by adding types array to media type application/json

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • c80d4cd98e86Revision changes
    • info

      added the new optional request property /