---
title: "Create a workspace label for media"
method: POST
path: "/v1/workspaces/{workspaceId}/media/labels"
tags: ["Media"]
---

# Create a workspace label for media

`POST /v1/workspaces/{workspaceId}/media/labels`

## 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}/media/labels`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- CreateLabelDto
  - `name` string, required
  - `color` string, nullable
  - `groupId` string, uuid, nullable
  - `source` 'labels' | 'media_room' | 'workbench' | 'strategy' | 'picker' | 'inspiration' | 'hashtags' | 'public_api' | 'mcp' | 'unknown', nullable

## Response `201`

Workspace label created

- object
  - `data` PublicMediaLabelDto, required
    - `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
    - `createdAt` string, required
    - `updatedAt` string, required
  - `meta` unknown, required

---

[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)