---
title: "Create locker room post"
method: POST
path: "/api/locker-room"
tags: ["Locker room"]
---

# Create locker room post

`POST /api/locker-room`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/locker-room`
- Auth: HTTP bearer

Create a post. content may be empty when media, poll, collectible, or lineup is present. teamId is the about-tag. authorTeamId / postAsTeamId is who the post is authored as (403 if unauthorized). lineup is persisted: { presetKey, assignments, faces }. Optional mentionedUserIds are resolved and echoed as mentions[] ({ id, handle, name?, profileUrl? }[]). A malformed mentionedUserIds is 400. The write stores tags with notifiedAt null and does not call OneSignal. GET /api/cron/locker-room-post-mentions sends SOCIAL_MENTION once the post is visible (scheduledFor null or already past), using dedupe key mention:post:{postId}:{userId}. Rejects with UGC_TERMS_REQUIRED when the caller's ugcTermsVersion is missing or not equal to the current Terms of Use version.

## Request body

- object
  - `content` string
  - `imageUrl` string
  - `teamId` string: About-tag team
  - `authorTeamId` string: Post-as-team identity
  - `postAsTeamId` string: Native alias for authorTeamId
  - `scheduledFor` string, date-time: Scheduled publish date (ISO 8601)
  - `privacy` 'public' | 'private'
  - `media` object[]
  - `poll` object
  - `collectible` object
  - `lineup` object: Formation builder attachment
    - `presetKey` string
    - `assignments` object
    - `faces` string[]
  - `mentionedUserIds` string[], nullable: User ids to tag. Self, unknown, blocked, and private non-followers are dropped. Over-cap ids past 10 are truncated. Null is treated as omit.

## Response `200`

{ success, data }

## Other responses

- `400`: Content is required (VALIDATION_ERROR), or scheduledFor is not a valid date (INVALID_SCHEDULE).
- `403`: UGC terms not accepted. Envelope: { success: false, code: UGC_TERMS_REQUIRED, error }. Native composers reopen the terms modal on this code.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - added the new optional request property `mentionedUserIds`
- **2026-09-12** `a8df6fe04343`: 1 info
  - added the non-success response with the status `403`
- **2026-08-26** `59a3c711262f`: 1 info
  - added the new optional request property `scheduledFor`
- **2026-08-17** `6a5e2c1b8022`: 9 info
  - added the new optional request property `authorTeamId`
  - added the new optional request property `collectible`
  - added the new optional request property `lineup`
  - added the new optional request property `media`
  - …5 more
- **2026-03-08** `120afc4ee72c`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - api tag `Locker room` added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/locker-room/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
