---
title: "Update content organizational metadata"
method: PATCH
path: "/v1/workspaces/{workspaceId}/content/{id}/metadata"
tags: ["Content"]
---

# Update content organizational metadata

`PATCH /v1/workspaces/{workspaceId}/content/{id}/metadata`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/content/{id}/metadata`
- Auth: HTTP bearer

Update the organizational title and planning metadata on draft, scheduled, or published content. The organizational title is internal to Maeve and never changes a provider-facing title. Omitted fields are unchanged; provided arrays replace existing assignments.

## Path parameters

- `id` string, required
- `workspaceId` string, uuid, required

## Request body

- UpdateContentMetadataDto
  - `organizationalTitle` string, nullable: Organizational title shown inside Maeve. Never sent to a social platform.
  - `labelIds` string[], nullable: Replacement workspace content label IDs.
  - `pillarIds` string[], nullable: Replacement content pillar IDs.
  - `formatIds` string[], nullable: Replacement content format IDs.
  - `assigneeIds` string[], nullable: Replacement assignee user IDs.
  - `priority` 'urgent' | 'high' | 'medium' | 'low'
  - `campaignId` string, uuid, nullable
  - `campaignPhaseId` string, uuid, nullable

## Response `200`

Content planning metadata updated

- object
  - `data` PublicContentMetadataResultDto, required
    - `id` string, uuid, required
    - `workspaceId` string, uuid, required
    - `status` 'draft' | 'pending_approval' | 'rejected' | 'scheduled' | 'sent' | 'failed' | 'cancelled', required
    - `workflowStatus` 'drafting' | 'review' | 'approved' | 'scheduled' | 'published', required
    - `organizationalTitle` string, nullable, required: Organizational title shown inside Maeve. Never published.
    - `labelIds` string[], required: Workspace label IDs attached to this content.
    - `labels` PublicContentLabelDto[], required: Workspace labels attached to this content.
      - `id` string, uuid, required
      - `name` string, required
      - `color` string, nullable, required
      - `groupId` string, uuid, nullable
      - `archivedAt` string, nullable
      - `mergedIntoLabelId` string, uuid, nullable
      - `mergedAt` string, nullable
      - `mergedByUserId` string, uuid, nullable
    - `pillarIds` string[], required: Content pillar IDs attached to this content.
    - `pillars` PublicContentPillarDto[], required: Content pillars attached to this content.
      - `id` string, uuid, required
      - `name` string, required
      - `color` string, nullable, required
      - `description` string, nullable
      - `sortOrder` number, required
      - `archivedAt` string, nullable
    - `formatIds` string[], required: Content format IDs attached to this content.
    - `formats` PublicContentFormatDto[], required: Content formats attached to this content.
      - `id` string, uuid, required
      - `name` string, required
      - `color` string, nullable, required
      - `description` string, nullable
      - `sortOrder` number, required
      - `isSeeded` boolean
      - `archivedAt` string, nullable
    - `assigneeIds` string[], required
    - `assignees` PublicContentAssigneeDto[], required
      - `id` string, uuid, required
      - `displayName` string, required
      - `email` string, required
      - `avatarUrl` string, nullable, required
    - `priority` 'urgent' | 'high' | 'medium' | 'low'
    - `campaignId` string, uuid, nullable, required
    - `campaignPhaseId` string, uuid, nullable, required
    - `updatedAt` string, required
  - `meta` unknown, required

## Other responses

- `400`: Can only update draft, scheduled, or published content metadata
- `404`: Content not found

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)