> ## Documentation Index > Fetch the complete documentation index at: https://docs.member.dev/llms.txt > Use this file to discover all available pages before exploring further. # Update Playlist > Partially update a playlist's metadata. Emits PlaylistUpdated when fields change. ## OpenAPI ````yaml /openapi/mio-openapi.json patch /api/v1/teams/{team_id}/playlists/{id} openapi: 3.1.0 info: description: >- Production API reference for Membership.io. Use the authored guides for workflows and the generated endpoint pages for exact parameters and schemas. title: Membership.io API version: 0.1.0 servers: - description: Production url: https://api.member.dev security: - bearerAuth: [] paths: /api/v1/teams/{team_id}/playlists/{id}: patch: tags: - media-admin summary: Update Playlist description: >- Partially update a playlist's metadata. Emits PlaylistUpdated when fields change. operationId: media_admin.patch_media_admin_patch_teams_by_team_id_playlists_by_id parameters: - in: path name: team_id required: true schema: title: Team Id type: string - in: path name: id required: true schema: title: Id type: string requestBody: content: application/vnd.api+json: schema: $ref: '#/components/schemas/PlaylistUpdateRequest' required: true responses: '200': content: application/vnd.api+json: schema: $ref: '#/components/schemas/PlaylistResponse' description: Successful Response '422': content: application/vnd.api+json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: PlaylistUpdateRequest: description: Request body for PATCH /api/teams/{team_id}/playlists/{id}. properties: data: $ref: '#/components/schemas/PlaylistUpdateData' required: - data title: PlaylistUpdateRequest type: object PlaylistResponse: description: Single-resource JSON:API response wrapping a PlaylistResource. properties: data: $ref: '#/components/schemas/JsonApiResource_PlaylistAttributes_' included: anyOf: - items: {} type: array - type: 'null' title: Included links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta required: - data title: PlaylistResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object PlaylistUpdateData: properties: attributes: $ref: '#/components/schemas/PlaylistUpdateAttributes' id: title: Id type: string type: const: playlists default: playlists title: Type type: string required: - id - attributes title: PlaylistUpdateData type: object JsonApiResource_PlaylistAttributes_: properties: attributes: $ref: '#/components/schemas/PlaylistAttributes' id: title: Id type: string links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta relationships: anyOf: - additionalProperties: true type: object - type: 'null' title: Relationships type: title: Type type: string required: - id - type - attributes title: JsonApiResource[PlaylistAttributes] type: object JsonApiLinks: properties: self: anyOf: - type: string - type: 'null' title: Self title: JsonApiLinks type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object PlaylistUpdateAttributes: description: >- PATCH fields — all optional; omit a field to keep its current value. Explicit null for `title` or `visibility` is rejected with 422 — those columns are NOT NULL in the DB and sending null would produce an IntegrityError → 500. `description` and `hub_id` are legitimately nullable so null IS accepted for them. properties: description: anyOf: - type: string - type: 'null' description: New description (null clears it). title: Description hub_id: anyOf: - type: string - type: 'null' description: New hub scope (null removes hub scope). title: Hub Id podcast_feed_enabled: anyOf: - type: boolean - type: 'null' description: Toggle podcast feed exposure. Omit to keep current value. title: Podcast Feed Enabled title: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' description: New playlist title. title: Title visibility: anyOf: - enum: - public - unlisted - private type: string - type: 'null' description: New visibility. title: Visibility title: PlaylistUpdateAttributes type: object PlaylistAttributes: description: >- Serialisable attributes of a Playlist resource (no id/type inside attributes). properties: cover_url: anyOf: - type: string - type: 'null' description: >- Signed CloudFront/imgproxy URL of the playlist cover. Null when no cover attached. title: Cover Url cover_url_expires_at: anyOf: - format: date-time type: string - type: 'null' description: >- UTC datetime when the signed playlist cover URL expires. Null when no cover is attached. title: Cover Url Expires At created_at: format: date-time title: Created At type: string description: anyOf: - type: string - type: 'null' title: Description hub_id: anyOf: - type: string - type: 'null' title: Hub Id podcast_feed_enabled: default: false description: When true, podcast_feed_url is populated with the RSS feed URL. title: Podcast Feed Enabled type: boolean podcast_feed_url: anyOf: - type: string - type: 'null' description: >- Absolute URL to the playlist's RSS feed. Computed at serialize time; null when podcast_feed_enabled is false. title: Podcast Feed Url title: title: Title type: string updated_at: format: date-time title: Updated At type: string visibility: title: Visibility type: string required: - title - visibility - created_at - updated_at title: PlaylistAttributes type: object securitySchemes: bearerAuth: bearerFormat: JWT or mio_sk API key description: >- Send platform JWTs, contact JWTs, or team API keys as `Authorization: Bearer `. scheme: bearer type: http HTTPBearer: scheme: bearer type: http ````