# Occtoo Documentation

- [Introducing Occtoo](https://docs.occtoo.com/get-started/introduction.md)
- [Start here](https://docs.occtoo.com/get-started/overview.md)
- [Your first Occtoo experience](https://docs.occtoo.com/get-started/my-first-occtoo-experience.md)
- [Get data into Occtoo](https://docs.occtoo.com/get-started/get-data-into-occtoo.md)
- [Call a destination API](https://docs.occtoo.com/get-started/call-a-destination-api.md)
- [Occtoo MCP server](https://docs.occtoo.com/get-started/occtoo-mcp.md)
- [Multifactor authentication](https://docs.occtoo.com/get-started/multifactor-authentication.md)
- [Occtoo Start 1–2–3](https://docs.occtoo.com/get-started/occtoo-start/overview.md): A partner-led framework for activating data, creating hyper-intelligent products, and enabling scalable product processes with Occtoo.
- [Data Activation](https://docs.occtoo.com/get-started/occtoo-start/data-activation.md): How partners activate and integrate data ecosystems with Occtoo.
- [Hyper-intelligent Products](https://docs.occtoo.com/get-started/occtoo-start/hyper-intelligent-products.md): How partners help customers define master products and product intelligence in Occtoo.
- [Process & New Roles](https://docs.occtoo.com/get-started/occtoo-start/process-and-roles.md): How partners enable scalable product processes and unlock ROI with Occtoo.
- [Product Orchestration Engine](https://docs.occtoo.com/concepts/overview.md)
- [Catalog](https://docs.occtoo.com/concepts/catalog.md)
- [Card](https://docs.occtoo.com/concepts/card.md)
- [Source](https://docs.occtoo.com/concepts/source.md)
- [Segment](https://docs.occtoo.com/concepts/segment.md)
- [Destination](https://docs.occtoo.com/concepts/destination.md)
- [Destination Types](https://docs.occtoo.com/concepts/destination-types.md)
- [Applications](https://docs.occtoo.com/concepts/applications.md): Use tenant-level machine applications to obtain OAuth tokens for ingest, events, and protected destination APIs.
- [Introduction to Occtoo Studio](https://docs.occtoo.com/guides/studio/overview.md)
- [Key concepts](https://docs.occtoo.com/guides/studio/key-concepts.md)
- [The Dashboard](https://docs.occtoo.com/guides/studio/dashboard/overview.md): The landing page of Occtoo Studio: how much you have built, what you use most, and where your data is being consumed.
- [Star a block as a favorite](https://docs.occtoo.com/guides/studio/dashboard/favorites.md): Pin the sources, cards, segments and destinations you open most often to the Dashboard.
- [Track imports and exports](https://docs.occtoo.com/guides/studio/dashboard/notifications.md): The notification centre reports background import and export tasks and hands you the finished files.
- [Your profile](https://docs.occtoo.com/guides/studio/dashboard/profile.md): Edit the name colleagues see next to your changes, and sign out.
- [Switch environment](https://docs.occtoo.com/guides/studio/dashboard/switch-environments.md): Move between the Occtoo environments you have access to, and find the safe name and tenant ID an integration needs.
- [The Analytics page](https://docs.occtoo.com/guides/studio/analytics/analytics-page.md): Three boards covering traffic out of Occtoo and updates coming in.
- [CDN usage](https://docs.occtoo.com/guides/studio/analytics/cdn-usage.md): Daily hits and bandwidth across every destination, with a table view and a CSV export.
- [Source and provider updates](https://docs.occtoo.com/guides/studio/analytics/source-and-provider-updates.md): Two boards over the same ingest traffic — one grouped by the source written to, one by the provider writing.
- [What is a data source & data provider?](https://docs.occtoo.com/guides/studio/sources/data-sources-and-providers.md): The two building blocks of onboarding: where data lands, and what is allowed to write it.
- [Find sources](https://docs.occtoo.com/guides/studio/sources/find-sources.md): Sort and search the source list, and read what each source card tells you.
- [The source page](https://docs.occtoo.com/guides/studio/sources/source-page.md): What the source page shows: freshness, counts, where the data comes from and goes, and the four widgets.
- [Create a source](https://docs.occtoo.com/guides/studio/sources/add-a-data-source.md): Add a data source, and link it to the sources it shares entry IDs with.
- [Edit a source](https://docs.occtoo.com/guides/studio/sources/edit-a-source.md): Change the name, description and shared IDs of an existing source.
- [Purge a source](https://docs.occtoo.com/guides/studio/sources/purge-a-source.md): Delete every entry in a source while keeping the source and its properties.
- [Delete a source](https://docs.occtoo.com/guides/studio/sources/delete-a-data-source.md): Remove a source that is empty and no longer referenced.
- [Source properties](https://docs.occtoo.com/guides/studio/sources/source-properties.md): Read the property table on a source: columns, statuses, sections and search.
- [Add or edit a property](https://docs.occtoo.com/guides/studio/sources/add-and-edit-a-property.md): Define a source property, or change the type, capabilities and display section of an existing one.
- [Property capabilities](https://docs.occtoo.com/guides/studio/sources/property-capabilities.md): Make a property searchable, filterable, or exposable as another type on a card.
- [Display sections and order](https://docs.occtoo.com/guides/studio/sources/order-and-sections.md): Group source properties into sections and set the order they appear in.
- [Delete a property](https://docs.occtoo.com/guides/studio/sources/delete-a-property.md): Remove a source property and its values from every entry.
- [Browse and search entries](https://docs.occtoo.com/guides/studio/sources/browse-entries.md): Read the entries table, search by entry ID, and sort on entry ID, last modified or indexed properties.
- [View an entry](https://docs.occtoo.com/guides/studio/sources/view-an-entry.md): Open an entry to read every property value and its change history.
- [Delete an entry](https://docs.occtoo.com/guides/studio/sources/delete-an-entry.md): Remove a single entry and all its property values from a source.
- [Import data](https://docs.occtoo.com/guides/studio/sources/import-data.md): How a data provider onboards data into a source through the ingest API.
- [Import data from a CSV file](https://docs.occtoo.com/guides/studio/sources/manual-import.md): Upload a CSV straight into a source, review what was parsed, and save.
- [Monitor onboarding](https://docs.occtoo.com/guides/studio/sources/monitor-ingest.md): Read ingest volume, effectiveness and rate over time, and check language coverage.
- [Track usage of source data](https://docs.occtoo.com/guides/studio/sources/track-usage.md): See which providers write to a source, which cards read from it, and which properties are used where.
- [Add a data provider](https://docs.occtoo.com/guides/studio/sources/add-a-data-provider.md): Register an integration that may write to sources, and store its secret.
- [Edit a data provider](https://docs.occtoo.com/guides/studio/sources/edit-a-data-provider.md): Rename a provider or change which sources it may write to.
- [Reset a provider secret](https://docs.occtoo.com/guides/studio/sources/reset-a-client-secret.md): Issue a new secret for a data provider when the old one is lost or has to be rotated.
- [View code examples](https://docs.occtoo.com/guides/studio/sources/code-examples.md): Copy a ready-made ingest snippet, prefilled with a provider ID and source identifier.
- [Remove a data provider](https://docs.occtoo.com/guides/studio/sources/remove-a-data-provider.md): Unregister a data provider and revoke its access to every source.
- [Find cards](https://docs.occtoo.com/guides/studio/cards/find-cards.md): Sort, filter and search the cards list, and read the status on each card.
- [Create a card](https://docs.occtoo.com/guides/studio/cards/create-a-card.md): Build a card in four steps: card details, property selection, property details, and display sections.
- [Card details](https://docs.occtoo.com/guides/studio/cards/card-page.md): What the card details shows: status, usage, properties and relations.
- [Add a property to a card](https://docs.occtoo.com/guides/studio/cards/add-a-property.md): Map a data source property onto a card, or create a new source property from the card.
- [Update a property](https://docs.occtoo.com/guides/studio/cards/update-a-property.md): What can be changed on an existing card property, and what is fixed for good.
- [Remove a property](https://docs.occtoo.com/guides/studio/cards/remove-a-property.md): Take a property off a card, and why the action is sometimes blocked.
- [Display sections and display options](https://docs.occtoo.com/guides/studio/cards/display-sections-and-options.md): Group properties into sections, order them, and choose which property acts as name, description or image.
- [Pending changes](https://docs.occtoo.com/guides/studio/cards/pending-changes.md): Review, revert and activate changes made to an active card.
- [Card relations](https://docs.occtoo.com/guides/studio/cards/card-relations.md): Link two cards on a shared property, label both directions, and optionally sort the related entries.
- [Track usage of a card](https://docs.occtoo.com/guides/studio/cards/track-usage.md): See which sources a card is built on, and which segments and destinations depend on it.
- [Copy a card](https://docs.occtoo.com/guides/studio/cards/copy-a-card.md): Start a new card from an existing one, keeping its sources and property setup.
- [Archive and restore a card](https://docs.occtoo.com/guides/studio/cards/archive-and-restore-a-card.md): Take a card out of use without deleting it, and bring it back later.
- [Delete a card](https://docs.occtoo.com/guides/studio/cards/delete-a-card.md): Remove a card and all its details for good.
- [Find a segment](https://docs.occtoo.com/guides/studio/segments/find-segments.md): Search, sort and filter the segments list.
- [Create a segment](https://docs.occtoo.com/guides/studio/segments/create-a-segment.md): Build a segment in four steps: details, segment type, entry selection, and save.
- [Filter segment entries](https://docs.occtoo.com/guides/studio/segments/filter-segment-entries.md): Use the filter panel to narrow down which entries a segment contains.
- [Schedule a segment](https://docs.occtoo.com/guides/studio/segments/schedule-a-segment.md): Give a segment a start and end date to control when it is active for destinations.
- [Upload a fixed segment](https://docs.occtoo.com/guides/studio/segments/upload-a-fixed-segment.md): Create a fixed segment from a CSV list of entry IDs.
- [Create a segment category](https://docs.occtoo.com/guides/studio/segments/create-a-segment-category.md): Categories group segments that are built on the same card.
- [Manage segment categories](https://docs.occtoo.com/guides/studio/segments/manage-segment-categories.md): Rename or delete the categories that group your segments.
- [Edit a segment](https://docs.occtoo.com/guides/studio/segments/edit-a-segment.md): Change the details of a segment, or change which entries it contains.
- [Search within a segment](https://docs.occtoo.com/guides/studio/segments/search-within-a-segment.md): Find a single entry among the entries of a segment.
- [Export, copy, archive and delete a segment](https://docs.occtoo.com/guides/studio/segments/segment-actions.md): The actions available in the segment menu.
- [Track data usage of segments](https://docs.occtoo.com/guides/studio/segments/track-usage.md): See what a segment is based on, how large it is and where it is used.
- [Find entries](https://docs.occtoo.com/guides/studio/catalog/find-entries.md): Browse the entries behind one card, search them by title and sort them.
- [Filter entries](https://docs.occtoo.com/guides/studio/catalog/filter-entries.md): Narrow the entry list with the filter panel, and turn the result into a query segment.
- [Select entries](https://docs.occtoo.com/guides/studio/catalog/select-entries.md): Tick entries in the list to build a fixed segment, add them to an existing one, or export just those entries.
- [The entry page](https://docs.occtoo.com/guides/studio/catalog/entry-page.md): What the full-screen entry view holds, and how to move between entries.
- [Enrich an entry](https://docs.occtoo.com/guides/studio/catalog/enrich-an-entry.md): Edit property values on a single entry, and revert what you do not want to keep.
- [Entry relations](https://docs.occtoo.com/guides/studio/catalog/entry-relations.md): See what an entry is linked to, and add or remove links by hand.
- [Change log](https://docs.occtoo.com/guides/studio/catalog/change-log.md): See which values were enriched on an entry, by whom and when.
- [Used by](https://docs.occtoo.com/guides/studio/catalog/used-by.md): Check which segments and destinations depend on a single entry before you change it.
- [Add an entry](https://docs.occtoo.com/guides/studio/catalog/add-an-entry.md): Create a single entry by hand on a card that allows enrichment.
- [Import entries](https://docs.occtoo.com/guides/studio/catalog/import-entries.md): Add or update many entries at once from a CSV or Excel file.
- [Export entries](https://docs.occtoo.com/guides/studio/catalog/export-entries.md): Download entries as CSV or Excel, with the properties and languages you choose.
- [Upload media](https://docs.occtoo.com/guides/studio/media/upload-media.md)
- [Find destinations](https://docs.occtoo.com/guides/studio/destinations/find-destinations.md): Browse the destinations in the environment, filter them by publish status, and see what each tile tells you.
- [Create a destination](https://docs.occtoo.com/guides/studio/destinations/create-a-destination.md): Add a destination and its first API version in one dialog.
- [The destination page](https://docs.occtoo.com/guides/studio/destinations/destination-page.md): The header, the version selector and the eight tabs of a destination.
- [Create an endpoint](https://docs.occtoo.com/guides/studio/destinations/create-an-endpoint.md): Add an endpoint to a version and choose the card or segment it serves.
- [Endpoint details](https://docs.occtoo.com/guides/studio/destinations/endpoint-content.md): Choose which properties an endpoint exposes, rename them for the API, and turn them into facets.
- [Filter an endpoint with segments](https://docs.occtoo.com/guides/studio/destinations/endpoint-segments.md): Include and exclude segments to control which entries an endpoint returns.
- [Add relations to an endpoint](https://docs.occtoo.com/guides/studio/destinations/endpoint-relations.md): Nest a related card inside the response so one call returns both.
- [Delete an endpoint](https://docs.occtoo.com/guides/studio/destinations/delete-an-endpoint.md): Remove an endpoint from a version that has not been published.
- [Manage languages](https://docs.occtoo.com/guides/studio/destinations/add-languages.md): Map the language keys in your onboarded data to the language codes the API exposes.
- [Publish a destination](https://docs.occtoo.com/guides/studio/destinations/publish-a-destination.md): Take a version live, and what to do when publishing is blocked or fails.
- [Pending changes](https://docs.occtoo.com/guides/studio/destinations/pending-changes.md): Changes saved onto a published version, waiting to go live.
- [Create a version](https://docs.occtoo.com/guides/studio/destinations/create-a-version.md): Fork a published version so you can make breaking changes without disturbing consumers.
- [Delete a version](https://docs.occtoo.com/guides/studio/destinations/delete-a-version.md): Retire an old API version once consumers have moved off it.
- [See what a destination is built on](https://docs.occtoo.com/guides/studio/destinations/used-by.md): The cards and segments a version depends on, and why that matters before you change them.
- [Register an application](https://docs.occtoo.com/guides/studio/destinations/register-an-application.md): Create the client credentials a consumer needs to call a protected destination.
- [Remove an application](https://docs.occtoo.com/guides/studio/destinations/remove-an-application.md): Revoke a consumer's access to a protected destination.
- [Reset a client secret](https://docs.occtoo.com/guides/studio/destinations/reset-a-client-secret.md): Issue a new secret for a registered application when the old one is lost or has to be rotated.
- [API documentation](https://docs.occtoo.com/guides/studio/destinations/generate-documentation.md): Read the generated reference for a version, try a request, compare versions and download the spec.
- [Users and roles](https://docs.occtoo.com/guides/studio/settings/users-and-roles.md): Invite people to the tenant, and what each role is allowed to do.
- [Managed tags](https://docs.occtoo.com/guides/studio/settings/managed-tags.md): Centrally maintained lists of predefined values that card properties can draw from.
- [Partner Zone](https://docs.occtoo.com/guides/partner-zone/overview.md)
- [Navigate the Product page](https://docs.occtoo.com/guides/partner-zone/navigate-the-product-page.md)
- [Navigate the Media page](https://docs.occtoo.com/guides/partner-zone/navigate-the-media-page.md)
- [Use the cart](https://docs.occtoo.com/guides/partner-zone/use-the-cart.md)
- [Use the multi search function](https://docs.occtoo.com/guides/partner-zone/multi-search.md)
- [Use the dynamic filter](https://docs.occtoo.com/guides/partner-zone/dynamic-filters.md)
- [Handle incoming user requests](https://docs.occtoo.com/guides/partner-zone/manage/incoming-requests.md)
- [Create & remove user](https://docs.occtoo.com/guides/partner-zone/manage/users.md)
- [Export users to CSV](https://docs.occtoo.com/guides/partner-zone/manage/export-users.md)
- [Create a new partner](https://docs.occtoo.com/guides/partner-zone/manage/create-a-partner.md): Create a new partner and define its name, segment, and languages.
- [Update partner](https://docs.occtoo.com/guides/partner-zone/manage/update-a-partner.md)
- [Add partner attributes](https://docs.occtoo.com/guides/partner-zone/manage/partner-attributes.md)
- [Store partner information](https://docs.occtoo.com/guides/partner-zone/manage/partner-information.md)
- [API overview](https://docs.occtoo.com/api-reference/overview.md)
- [Request an Application access token](https://docs.occtoo.com/api-reference/authentication/application-token.md): Exchange Application or Data Provider credentials for a short-lived Occtoo access token.
- [Ingest](https://docs.occtoo.com/api-reference/ingest/overview.md)
- [Ingest typed JSON into a source](https://docs.occtoo.com/api-reference/ingest/typed-source-entries.md): Validates typed JSON values against the source property configuration and accepts the entries for asynchronous processing.
- [Verify an ingest payload](https://docs.occtoo.com/api-reference/ingest/verify-an-ingest-payload.md): Runs the same caller-access, payload, key, property and configured-size validation as ingest without enqueuing entries.
- [Start an asynchronous ingest](https://docs.occtoo.com/api-reference/ingest/start-an-asynchronous-ingest.md): Validates and accepts source entries for asynchronous processing. A `202` response means the request was queued; it does not mean every entry has finished processing.
- [Events](https://docs.occtoo.com/api-reference/events/overview.md): Consume tenant-scoped CloudEvents by pull or live stream, and inspect the retained stream's current position.
- [List public event types and schema versions](https://docs.occtoo.com/api-reference/event-discovery/list-public-event-types-and-schema-versions.md): Returns the public event catalog. Each entry identifies a stable event `type`, its current payload schema version, the immutable JSON Schema URL, and the entity-level properties accepted by the filter grammar.
- [Pull public events](https://docs.occtoo.com/api-reference/event-delivery/pull-public-events.md): Reads retained events in ascending `sequence` order. Every item is a structured CloudEvent 1.0 document.
- [Get public event stream metadata](https://docs.occtoo.com/api-reference/event-delivery/get-public-event-stream-metadata.md): Returns metadata for retained events matching the optional `filter`: the first and latest positions, their optional CloudEvent `time`, and the exact retained count.
- [Stream public events using SSE](https://docs.occtoo.com/api-reference/event-delivery/stream-public-events-using-sse.md): Opens a long-lived Server-Sent Events connection and emits the same structured CloudEvents returned by the pull endpoint.
- [Get a versioned event data schema](https://docs.occtoo.com/api-reference/event-schemas/get-a-versioned-event-data-schema.md): Returns the immutable JSON Schema for one event data payload version.
- [Event stream (SSE)](https://docs.occtoo.com/api-reference/events/streaming.md): Subscribe to a live, ordered stream of tenant events delivered as CloudEvents over Server-Sent Events.
- [Destination](https://docs.occtoo.com/api-reference/consumption/overview.md)
- [Changelog](https://docs.occtoo.com/changelog.md): New features, improvements, and fixes across the Occtoo platform

## OpenAPI Specs

- [applications](/api-reference/openapi/applications.json)
- [events](/api-reference/openapi/events.json)
- [ingest](/api-reference/openapi/ingest.json)