---
title: "Publish content events"
method: POST
path: "/appwise/v2/data"
tags: ["InboundEvents"]
---

# Publish content events

`POST /appwise/v2/data`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/appwise/v2/data`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/appwise/v2/data/post.ts> (a function with typed inputs; its response is checked against the schema)

Publishes content events that contain new or changed data in referenced resources. To access this API, you must configure product-scoped OAuth2 authentication for your application.

## Request body

- ContentEvent: Descriptions of content change events, and the associated content
  - `eventMetadata` EventMetadata: Metadata for Search content
    - `id` string, required: Event ID. Required.
    - `type` 'ResourceCreated' | 'ResourceUpdated' | 'ResourceDeleted' | 'ResourceContentUpdated', required: ResourceCreated, ResourceUpdated, ResourceDeleted are used when the Search resource is created, updated, and deleted respectively. ResourceContentUpdated is used when a content item is updated or deleted.
    - `timestamp` string, required: Event timestamp. Required.
  - `key` Key, required: Identify a resource
    - `source` string, required: Application UUID. Note: Application UUID = Product UUID. Required.
    - `instance` string, required: Vendor account identifier within the application. Required.
    - `resourceId` string, required: Unique ID of the resource in the instance. Required.
    - `timestamp` integer: UTC timestamp of when the event occurred in epoch format, with millisecond precision
  - `actor` ContentEventActor: Identify the application user by identifier (accountName) and name. Required parameters: Only identifier is required to identify a user.
    - `identifier` string, required: Identifier (accountName) for the application user. Format: {user_handle}@{user_uuid}@{company_uuid}. Required.
    - `name` string: Full name of the user in the application
  - `action` Action: An action statement that can be used to describe changes that appear in feeds. The statement is constructed of a verb suffixed by text. For example: Verb (assigned) + text (a task) = action description (assigned a task). If delete boolean is true, the resource is deleted from Customer Search. Required parameters: Only Text and Verb are required in requests to create action statements. Only delete is required to delete a resource.
    - `verb` string, required: The verb that appears in the (verb+text) action statement
    - `text` string, required: The text that appears after the verb in the (verb+text) action statement
    - `delete` boolean: If true, the resource is deleted from Search
  - `changes` Changes: Changes to a resource connected to Search
    - `fields` ContentEventField[]: Field changes
      - `name` string, required: Unique field name. Required.
      - `value` string, required: Field value. Required.
      - `label` string: Field label
      - `op` 'replace' | 'remove': Defines how the field will be merged with an existing field of the same name. Optional. Default is replace.
      - `display` 'expanded' | 'hidden': Display enumeration. Hidden: Hides the field from the UI. Expanded: Displays the field in the UI.
    - `users` ContentEventUser[]: User access changes
      - `identifier` string, required: Identifier (accountName) for the application user. Format: {user_handle}@{user_uuid}@{company_uuid}. Required.
      - `name` string: Full name of the user in the application
      - `delete` boolean: If true, delete the user's application account (accountName) for the Search and Search resource (only affects Change node/ContentEventUser users array)
    - `groups` Group[]: Group access changes
      - `identifier` string, required: UUID of a user group configured in the marketplace. Required.
      - `delete` boolean: Delete resource visibility for the group
  - `contents` Content[]: Content items associated with the resource
    - `url` string, required: URL of the content. Required.
    - `previewUrl` string: URL of the content preview
    - `title` string: Title of the content
    - `searchText` string: Full text of the content
    - `mimeType` string: MIME type of the content
    - `linkedToResource` boolean: Manage duplicate search results for content associated with other resources. If true, link content to associated resources and return it as a single object. If false, content and associated resources are returned as separate objects. Example: Search terms appear in a spreadsheet that is attached to an email. If true, search returns the spreadsheet. If false, search returns the email and the spreadsheet.
    - `delete` boolean: If true, the content is removed from the resource

## Response `200`

Success

## Other responses

- `400`: Input is invalid or malformed
- `401`: Unauthorized to publish this event
- `500`: An internal error occurred during event processing

## Changes

- **2026-11-06** `1fc240f06971`: 5 breaking, 17 info
  - added the new required request property `key`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - …18 more

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appwise/v2/data/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)