# 4D OS Developer Docs

> Public developer documentation for the 4D OS partner platform

## Docs

- [Issue a publishable tracking key](https://docs.fourdos.dev/api-reference/engagement/issue-a-publishable-tracking-key.md)
- [List the organization's tracking keys](https://docs.fourdos.dev/api-reference/engagement/list-the-organizations-tracking-keys.md)
- [Revoke a tracking key (idempotent)](https://docs.fourdos.dev/api-reference/engagement/revoke-a-tracking-key-idempotent.md)
- [Track engagement events (public, publishable tracking key)](https://docs.fourdos.dev/api-reference/engagement/track-engagement-events-public-publishable-tracking-key.md): Public CORS-enabled receptor for browser engagement events. Authenticates with a publishable `ek_live_…` tracking key sent as `?key=` or the body `key` field - partner bearer keys are not accepted here. Accepts a batch (`events: [...]`, max 20) or a single event spread at the top level. Events are a…
- [Commit a validated job, or start validation with `dry_run: false` on a `staging` job](https://docs.fourdos.dev/api-reference/imports/commit-a-validated-job-or-start-validation-with-`dry_run:-false`-on-a-`staging`-job.md)
- [Create a bulk import job (starts in `staging`)](https://docs.fourdos.dev/api-reference/imports/create-a-bulk-import-job-starts-in-`staging`.md)
- [Download the invalid+failed rows as CSV (also the console's download URL, cookie auth)](https://docs.fourdos.dev/api-reference/imports/download-the-invalid+failed-rows-as-csv-also-the-consoles-download-url-cookie-auth.md)
- [Fetch an import job's status and counts](https://docs.fourdos.dev/api-reference/imports/fetch-an-import-jobs-status-and-counts.md)
- [Page a job's per-row outcomes, optionally filtered by state](https://docs.fourdos.dev/api-reference/imports/page-a-jobs-per-row-outcomes-optionally-filtered-by-state.md)
- [Seal staging and start async dry-run validation](https://docs.fourdos.dev/api-reference/imports/seal-staging-and-start-async-dry-run-validation.md)
- [Stage a chunk of rows onto a job (≤5k rows/request, job must be `staging`)](https://docs.fourdos.dev/api-reference/imports/stage-a-chunk-of-rows-onto-a-job-≤5k-rowsrequest-job-must-be-`staging`.md)
- [API reference overview](https://docs.fourdos.dev/api-reference/overview.md): Base URL, conventions, and how this reference is generated
- [Create or attach a user (idempotent via Idempotency-Key)](https://docs.fourdos.dev/api-reference/users/create-or-attach-a-user-idempotent-via-idempotency-key.md)
- [Fetch a user within the caller's organization](https://docs.fourdos.dev/api-reference/users/fetch-a-user-within-the-callers-organization.md)
- [Lock the caller-org membership for a user](https://docs.fourdos.dev/api-reference/users/lock-the-caller-org-membership-for-a-user.md)
- [Remove (soft-delete) the caller-org membership for a user](https://docs.fourdos.dev/api-reference/users/remove-soft-delete-the-caller-org-membership-for-a-user.md)
- [Unlock the caller-org membership for a user](https://docs.fourdos.dev/api-reference/users/unlock-the-caller-org-membership-for-a-user.md)
- [Update a user's profile fields](https://docs.fourdos.dev/api-reference/users/update-a-users-profile-fields.md)
- [Authentication](https://docs.fourdos.dev/authentication.md): Organization API keys, publishable tracking keys, and how requests are scoped
- [Consent](https://docs.fourdos.dev/concepts/consent.md): Append-only consent evidence that actually gates what the platform does with member data
- [Events](https://docs.fourdos.dev/concepts/events.md): How engagement flows into 4D, and what happens to it once it's there
- [Tenants and members](https://docs.fourdos.dev/concepts/tenants-and-members.md): One person, one 4D identity - a member of each organization they engage with
- [XP](https://docs.fourdos.dev/concepts/xp.md): A double-entry loyalty ledger: rules turn events into awards, tiers rank members, balances settle on-chain
- [What is 4D OS?](https://docs.fourdos.dev/index.md)
- [Quickstart](https://docs.fourdos.dev/quickstart.md): From API key to your first member in five minutes
- [Engagement SDK](https://docs.fourdos.dev/sdk/engagement-sdk.md): A gtag-style TypeScript client for POST /v1/track - batching, retries, and beacon drain built in
- [Create a user](https://docs.fourdos.dev/walkthroughs/create-a-user.md): Add a member to your organization - idempotently, with safe retries
- [Get user details](https://docs.fourdos.dev/walkthroughs/get-user-details.md): Read a member's profile, update it, and manage typed attributes
- [Migrate an existing member base](https://docs.fourdos.dev/walkthroughs/migrate-existing-members.md): The canonical import schema, a worked example, and the partner API sequence for bulk migration
- [Trigger an event](https://docs.fourdos.dev/walkthroughs/trigger-an-event.md): Issue a publishable tracking key and send engagement events from a browser

## OpenAPI Specs

- [partner](https://api.develop.fourdos.dev/openapi/partner.json)