{"openapi":"3.0.0","paths":{"/v1/workspaces/{workspace_id}/communities":{"get":{"operationId":"CommunityController_list","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"ProductCraft workspace UUID owning the community.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"},{"name":"limit","required":false,"in":"query","description":"Page size (default 50, max 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from a prior page's `pagination.next_cursor`.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"q","required":false,"in":"query","schema":{"type":"string","maxLength":128},"description":"Case-insensitive substring matched against the community display name OR slug. `%` and `_` are matched literally. Blank means no filter; over 128 chars is a 400.","example":"onboarding"},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["active","suspended","archived"]},"description":"Exact community status filter. Blank means no filter; an unknown value is a 400.","example":"active"}],"responses":{"200":{"description":"Paginated communities.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid `status`, over-length `q`, or a malformed cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.list`, or the workspace has not enabled the `social` service.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List communities in a workspace, newest-first. Cursor-paginated as of task 008 / G13 (previously a bare array). Optional `?q=` substring search (display name OR slug) and `?status=` filter, both composable with each other and with the cursor — the ordering is fixed, so keep the same filters on every follow-up page.","tags":["communities"],"x-pc-sdk":{"resource":"communities","method":"list","bind":["workspace_id"],"paginated":true}},"post":{"operationId":"CommunityController_create","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"ProductCraft workspace UUID owning the community.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCommunityDto"}}}},"responses":{"201":{"description":"Community created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (slug shape, display_name length, malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"401":{"description":"`app_id` was supplied but no bearer/cookie was forwarded for the upstream Auth fetch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.create` or workspace has not enabled the `social` service.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"`app_id` supplied but the Auth app was not found in this workspace (opaque cross-tenant 404).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Community slug already taken in this workspace, the supplied `app_id` is already connected to a community, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Create an social community. `app_id` is optional — when supplied Social connects the community to an Auth app and refuses if the app belongs to a different workspace (cross-tenant gate) or is already connected. Omit `app_id` for a standalone community (no Auth integration; the customer manages actor identity). Pass an `Idempotency-Key` header to make retries safe.","tags":["communities"],"x-pc-sdk":{"resource":"communities","method":"create","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}":{"get":{"operationId":"CommunityController_get","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"ProductCraft workspace UUID owning the community.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"},{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Community found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace (opaque cross-tenant 404).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one community by id.","tags":["communities"],"x-pc-sdk":{"resource":"communities","method":"retrieve","bind":["workspace_id"],"paginated":false}},"patch":{"operationId":"CommunityController_update","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"ProductCraft workspace UUID owning the community.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"},{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCommunityDto"}}}},"responses":{"200":{"description":"Community updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure or invalid status value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update community display name, description, settings, or status. Status transitions are unrestricted (active ↔ suspended; archived is terminal in v1).","tags":["communities"],"x-pc-sdk":{"resource":"communities","method":"update","bind":["workspace_id"],"paginated":false}},"delete":{"operationId":"CommunityController_delete","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"ProductCraft workspace UUID owning the community.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"},{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Community deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete a community. Cascades to every actor, post, comment, edge, flag, and notification it owns. Not reversible.","tags":["communities"],"x-pc-sdk":{"resource":"communities","method":"delete","bind":["workspace_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/batch":{"post":{"operationId":"ActorController_batchUpsert","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpsertActorsDto"}}}},"responses":{"201":{"description":"Per-item results, request order. `succeeded` + `failed` summarise the batch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchActorsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Envelope validation failure: `actors` missing, empty, over 200 items, or an item shape invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create` for this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in the PAK's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Bulk actor upsert (max 200 per call) — the import lane. Each item runs the exact single-upsert path; results come back per item with partial success (`201` even when some items fail — inspect `success` / `error` per entry). No wrapping transaction.","tags":["actors"],"x-pc-sdk":{"resource":"actors","method":"batch","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/by-external/batch":{"post":{"operationId":"ActorController_batchGetByExternal","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchExternalIdsDto"}}}},"responses":{"200":{"description":"Actors found (request order, de-duplicated) plus the `missing[]` external_ids.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorsByExternalBatchResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`external_ids` missing, empty, over 200 items, or an entry exceeding 256 chars.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in the PAK's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Batch-resolve external_ids to actors (max 200 per call). POST-only — external_ids are up to 256 chars and can't ride a querystring. Unknown ids come back in `missing[]` instead of failing the call.","tags":["actors"],"x-pc-sdk":{"resource":"actors.byExternal","method":"batch","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors":{"post":{"operationId":"ActorController_upsert","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertActorDto"}}}},"responses":{"201":{"description":"Created (`created: true`) or upserted (`created: false`); the actor row is returned in both cases.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertActorResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (external_id, display_name, avatar_url length).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create` for this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in the PAK's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Upsert an actor by external_id. Creates on first call, updates on subsequent calls with the same external_id. Idempotent on `(community, external_id)`. Note: omitted fields on a follow-up call are overwritten with the new body — pass every field you want to keep on each call.","tags":["actors"],"x-pc-sdk":{"resource":"actors","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"ActorController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size; capped at 200. Ignored when `ids` is passed.","example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from the previous page's `pagination.next_cursor`. Ignored when `ids` is passed.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"ids","required":false,"in":"query","schema":{"type":"string"},"description":"Comma-separated actor UUIDs (max 100, de-duplicated) to batch-fetch. Returns matching actors in request order; unknown ids are silently omitted.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f,0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}],"responses":{"200":{"description":"Page of actors with `next_cursor` + `has_more` (batch-fetch responses always report `has_more: false`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorPageResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or invalid `ids` (`INVALID_ID_LIST` — empty / non-UUID entry; `TOO_MANY_IDS` — over 100).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR","INVALID_ID_LIST","TOO_MANY_IDS"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in the PAK's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List actors in a community. 50 per page by default (max 200) — paginate with the cursor returned in `pagination.next_cursor` while `pagination.has_more` is true. Pass `?ids=<uuid,uuid,…>` (max 100) to batch-fetch specific actors instead — one hydration call for a screenful of ids; unknown ids are silently omitted and `pagination` is the exhausted shape (`next_cursor: null`).","tags":["actors"],"x-pc-sdk":{"resource":"actors","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/by-external/{external_id}":{"get":{"operationId":"ActorController_getByExternal","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"external_id","required":true,"in":"path","description":"Customer-supplied identifier for the user (the `external_id` you upserted with).","schema":{"example":"user_abc123","type":"string"},"example":"user_42"}],"responses":{"200":{"description":"Actor row.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No actor with that external_id in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Look up an actor by the customer-supplied external_id.","tags":["actors"],"x-pc-sdk":{"resource":"actors.byExternal","method":"retrieve","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}":{"get":{"operationId":"ActorController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (the id returned by upsert).","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Actor row.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Actor not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get an actor by its UUID.","tags":["actors"],"x-pc-sdk":{"resource":"actors","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"ActorController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateActorDto"}}}},"responses":{"200":{"description":"Actor updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure or invalid status value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Actor not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update actor profile fields. Pass only the fields you want to change.","tags":["actors"],"x-pc-sdk":{"resource":"actors","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"ActorController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Actor deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Actor not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete an actor. Hard delete — cascades to every post, comment, edge, flag, and notification it owns.","tags":["actors"],"x-pc-sdk":{"resource":"actors","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts":{"post":{"operationId":"PostController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePostDto"}}}},"responses":{"201":{"description":"Post created. Defaults: `kind=text`, `visibility=public`, `status=published`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp; malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`, or actor is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, actor, or quote source post not found in the PAK's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"`IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Quote rules: `CANNOT_QUOTE_SELF` (kind='quote' with your own post as source) or `CANNOT_QUOTE_PRIVATE` (source post is private).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY","CANNOT_QUOTE_SELF","CANNOT_QUOTE_PRIVATE"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Create a post on behalf of an actor. Pass an `Idempotency-Key` header to make retries safe — replays return the original response with `Idempotent-Replay: true` for 24h.","tags":["posts"],"x-pc-sdk":{"resource":"posts","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"PostController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from `pagination.next_cursor`.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"author_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Limit results to this actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Page of posts (only `published`, non-expired, public-visibility unless filtered by author).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List posts. Pass `author_id` to filter to a single author. 50/page (max 200), cursor-paginated.","tags":["posts"],"x-pc-sdk":{"resource":"posts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}":{"get":{"description":"Without `actor_id`, only `public` posts return. With one, `followers` / `close_friends` / the requester's own `private` posts surface per the visibility matrix. Returns 404 (opacity) when the requester is not allowed to read the post — never 403.","operationId":"PostController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Social actor UUID of the viewer. Surfaces non-public posts they are entitled to see.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Post.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post not found, removed, expired, or not visible to the requester.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get a post by id. Visibility-aware: pass `actor_id` for non-public posts.","tags":["posts"],"x-pc-sdk":{"resource":"posts","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"PostController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePostDto"}}}},"responses":{"200":{"description":"Post updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure or invalid status / visibility / timestamp.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"422":{"description":"`EDIT_WINDOW_EXPIRED` (content edit after the community's edit window), or `scheduled_for` passed while the post is not `status='scheduled'`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY","EDIT_WINDOW_EXPIRED"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update post fields. `pinned` is the highlights toggle for stories; status transitions to `hidden`/`removed` should usually go through the moderation lane.","tags":["posts"],"x-pc-sdk":{"resource":"posts","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"PostController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Post soft-deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Soft-delete a post. The row is marked `removed`; viewers see 404. Comments and reactions are kept for moderation audit.","tags":["posts"],"x-pc-sdk":{"resource":"posts","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/revisions":{"get":{"description":"Each entry is a snapshot of body/title/attributes from BEFORE the edit landed. The post row itself carries the current state plus `edited_at` + `edit_count`. Drafts are not snapshotted — only published posts incur revisions.","operationId":"PostController_listRevisions","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of revisions, newest first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostRevisionListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List a post's edit history. Cursor-paginated by revision_n desc (newest edit first).","tags":["posts"],"x-pc-sdk":{"resource":"posts.revisions","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/quotes":{"get":{"description":"Cursor-paginated by `(created_at DESC, id DESC)`. Each entry is the full quote post row — body, attributes, the quoter's actor_id, the source_post_id back-reference. Filters to status=published.","operationId":"PostController_listQuotes","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Source post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of quote posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or source post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the quote posts of a source post (X-style \"show quotes\" link).","tags":["posts"],"x-pc-sdk":{"resource":"posts.quotes","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/impressions":{"post":{"operationId":"PostController_recordImpressions","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordViewsDto"}}}},"responses":{"204":{"description":"Impressions recorded (or no-op if every id was missing).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Empty `post_ids`, more than 200 ids, or a non-UUID in the list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.view` on the community URN.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Batch-increment impression (`view_count`) counters on a list of posts. Client-side debounced; missing post ids are silently skipped (so a deleted post mid-batch doesn’t fail the rest). Renamed from `POST /posts/views` (task 008 / G14) to disambiguate from the story-side per-post `/posts/:post_id/views` route.","tags":["posts"],"x-pc-sdk":{"resource":"posts","method":"recordImpressions","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/drafts":{"get":{"description":"Drafts are visible only via this endpoint — they're stripped from public feeds, lists, and `getById`. The PAK lane has no end-user principal, so the customer's backend is responsible for ensuring `actor_id` matches the end-user behind the request before exposing the response.","operationId":"DraftController_listDrafts","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID whose drafts to list.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from `pagination.next_cursor`.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of draft posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's drafts (status='draft'). Cursor-paginated newest-first.","tags":["drafts"],"x-pc-sdk":{"resource":"actors.drafts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/scheduled-posts":{"get":{"description":"Scheduled posts are invisible to everyone except the author until the per-minute PostSchedulerCron promotes them. Same end-user authorization rules as drafts: the PAK lane trusts the customer-backend to gate the caller.","operationId":"DraftController_listScheduledPosts","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID whose scheduled posts to list.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of scheduled posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's scheduled posts (status='scheduled'), ordered soonest-to-publish first. Cursor-paginated.","tags":["drafts"],"x-pc-sdk":{"resource":"actors.scheduledPosts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/archived":{"get":{"description":"Archived posts keep their engagement (reaction / comment counts intact) but fall out of every public surface, and `getById` treats them as author-only. Restore one with PATCH `{ status: 'published' }`. Same end-user authorization rules as drafts: the PAK lane trusts the customer-backend to gate the caller.","operationId":"DraftController_listArchived","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID whose archived posts to list.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of archived posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's archived posts (status='archived'), newest-first. Cursor-paginated.","tags":["drafts"],"x-pc-sdk":{"resource":"actors.archived","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/repost":{"post":{"description":"Visibility is inherited from the source. The reposter must be allowed to read the source (else 404). Self-repost 422; private-source repost 422. Bumps `source.repost_count` and the reposter's `post_count`. Fires a `repost` notification to the source author (subject to per-kind preferences from task 021).","operationId":"RepostController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Source post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRepostDto"}}}},"responses":{"201":{"description":"Repost created (or returned via idempotent retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRepostResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / source / actor not found, or source invisible to the actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"422":{"description":"CANNOT_REPOST_SELF (reposting your own post) or CANNOT_REPOST_PRIVATE (source is visibility='private').","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Repost a source post on behalf of an actor. Idempotent — returns the existing repost row with `created: false` on retry.","tags":["reposts"],"x-pc-sdk":{"resource":"posts","method":"repost","bind":["community_id"],"paginated":false}},"delete":{"operationId":"RepostController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Source post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Acting actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Repost soft-deleted (or was never present).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing/invalid actor_id).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / source / actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Undo my repost of a source post. Idempotent — 204 either way. Pass the actor via `?actor_id=`.","tags":["reposts"],"x-pc-sdk":{"resource":"posts","method":"unrepost","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/reposts":{"get":{"operationId":"RepostController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Source post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of repost rows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepostListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or source not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actors who have reposted a source post. Cursor-paginated newest-first. Useful for \"X reposted this\" UI.","tags":["reposts"],"x-pc-sdk":{"resource":"posts.reposts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/assets":{"post":{"operationId":"AssetController_upload","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Makes retries safe.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"PNG / JPEG / WEBP, ≤10 MB — image path (multipart) only."},"actor_id":{"type":"string","format":"uuid","description":"The acting actor, who owns the upload. Send it, or the deprecated `owner_actor_id`; one of the two is required."},"owner_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`."},"kind":{"type":"string","enum":["image","video"],"default":"image","description":"Pass 'video' (JSON body) for the presigned-PUT flow."},"content_type":{"type":"string","enum":["video/mp4","video/quicktime","video/webm"],"description":"Video path: declared container type."},"byte_size":{"type":"integer","minimum":1,"maximum":536870912,"description":"Video path: declared size in bytes (≤512 MB)."}}}},"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"PNG / JPEG / WEBP, ≤10 MB — image path (multipart) only."},"actor_id":{"type":"string","format":"uuid","description":"The acting actor, who owns the upload. Send it, or the deprecated `owner_actor_id`; one of the two is required."},"owner_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`."},"kind":{"type":"string","enum":["image","video"],"default":"image","description":"Pass 'video' (JSON body) for the presigned-PUT flow."},"content_type":{"type":"string","enum":["video/mp4","video/quicktime","video/webm"],"description":"Video path: declared container type."},"byte_size":{"type":"integer","minimum":1,"maximum":536870912,"description":"Video path: declared size in bytes (≤512 MB)."}}}}}},"responses":{"201":{"description":"Image stored and ready, or video created in `uploading` with `upload` instructions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadAssetResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/oversize/wrong-type file or declaration, or the bytes do not match the declared image type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.assets.write`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or owner actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The image could not be decoded/processed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"`TOO_MANY_ACTIVE_UPLOADS` — the community already has the max videos uploading/processing. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED","TOO_MANY_ACTIVE_UPLOADS"]}},"security":[{"bearer":[]}],"summary":"Upload media. Images (multipart): processed synchronously, returns ready. Videos (JSON, kind:'video' + declared content_type/byte_size): returns an `uploading` asset with a presigned PUT — upload the bytes, then POST /assets/:id/complete.","tags":["assets"],"x-pc-sdk":{"resource":"assets","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/assets/{asset_id}/complete":{"post":{"operationId":"AssetController_complete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"asset_id","required":true,"in":"path","description":"Video asset UUID (status `uploading`).","schema":{"example":"eeeeeeee-0000-0000-0000-000000000001","type":"string"},"example":"eeeeeeee-0000-0000-0000-000000000001"},{"name":"Idempotency-Key","in":"header","description":"Makes retries safe.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Finalized (`processing`) — or the current status on replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadAssetResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.assets.write`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Asset not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"`ASSET_UPLOAD_INCOMPLETE` (no object / size mismatch — still retryable), `ASSET_TOO_LARGE` or `ASSET_INVALID_CONTAINER` (upload failed + object deleted), or `ASSET_NOT_VIDEO`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY","ASSET_UPLOAD_INCOMPLETE","ASSET_TOO_LARGE","ASSET_INVALID_CONTAINER","ASSET_NOT_VIDEO"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Finalize a presigned-PUT video upload. Verifies the stored object (existence, size, container magic bytes) and enqueues the transcode. Replaying on a finalized asset returns its current status without re-enqueueing.","tags":["assets"],"x-pc-sdk":{"resource":"assets","method":"complete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/assets/{asset_id}":{"get":{"operationId":"AssetController_get","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"asset_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the asset.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"The asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.assets.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Asset not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Fetch one asset with freshly-minted presigned rendition URLs.","tags":["assets"],"x-pc-sdk":{"resource":"assets","method":"retrieve","bind":["community_id"],"paginated":false}},"delete":{"operationId":"AssetController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"asset_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the asset.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Asset deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.assets.write`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Asset not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete an asset — removes every stored rendition object, then the row.","tags":["assets"],"x-pc-sdk":{"resource":"assets","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/assets":{"get":{"operationId":"AssetController_listByActor","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Owner actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of the actor's assets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.assets.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List an actor's uploaded assets — the \"your uploads\" surface + GDPR export walk. 50/page (max 200), cursor-paginated newest-first.","tags":["assets"],"x-pc-sdk":{"resource":"actors.assets","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/counters":{"get":{"operationId":"CounterController_getBatchCounters","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_ids","required":true,"in":"query","schema":{"type":"string"},"description":"Comma-separated actor UUIDs (max 100, de-duplicated).","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f,0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}],"responses":{"200":{"description":"Counters for each actor found plus the `missing[]` ids.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchCountersResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`actor_ids` missing or empty, a non-UUID entry (`INVALID_ID_LIST`), or over 100 ids (`TOO_MANY_IDS`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_ID_LIST","TOO_MANY_IDS"]},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in the PAK's workspace. (Unknown actors land in `missing[]`, not a 404.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Batch counters (max 100 actors per call) — render a member list with follower badges from ONE call instead of one per actor. Unknown actor_ids come back in `missing[]` instead of failing the read.","tags":["counters"],"x-pc-sdk":{"resource":"counters","method":"list","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/counters":{"get":{"operationId":"CounterController_getCounters","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Counters for the actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorCountersResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Not found (or belongs to a different community / workspace).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Denormalised counters for one actor (followers, following, posts, comments, blocks).","tags":["counters"],"x-pc-sdk":{"resource":"actors","method":"counters","bind":["community_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/analytics":{"get":{"operationId":"AnalyticsController_getCommunityAnalytics","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"ProductCraft workspace UUID.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"},{"name":"community_id","required":true,"in":"path","description":"Social community UUID owned by the workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Computed analytics rollup.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityAnalyticsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.analytics.read`, or the workspace has not enabled the `social` service.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace (opaque cross-tenant 404).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Community-level analytics rollup: total active actors, published posts, published comments, open flags, and last-7-day windows for each.","tags":["analytics"],"x-pc-sdk":{"resource":"communities","method":"analytics","bind":["workspace_id"],"paginated":false}}},"/v1/communities/{community_id}/follows/batch":{"post":{"operationId":"EdgeController_batchFollows","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFollowsDto"}}}},"responses":{"201":{"description":"Per-item results, request order. `succeeded` + `failed` summarise the batch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFollowsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Envelope validation failure: `follows` missing, empty, over 200 items, or an item shape invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in the PAK's workspace. (Unknown actors fail per item, not the whole call.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Bulk follow creation (max 200 per call) — the graph-import lane. Each item runs the exact single-follow path (block checks, counters, idempotency), so a blocked pair fails ITS item with a 409 in `error` while the rest of the batch proceeds. `201` even with failures — inspect per-item results. Set `suppress_notifications: true` when importing an existing graph.","tags":["edges"],"x-pc-sdk":{"resource":"follows","method":"batch","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/follows":{"post":{"operationId":"EdgeController_follow","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorEdgeDto"}}}},"responses":{"201":{"description":"Follow edge created / exists (`status: followed`), or a follow request created (`status: pending`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowResultDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing / invalid src_actor_id / dst_actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or one of the actors not found in the PAK's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"A block exists between the pair (in either direction). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Cannot follow yourself.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Follow another actor. Idempotent. If the destination is private (task 014), a follow request is created instead and the response is `{ status: \"pending\", edge: null }`; approve/decline it via the follow-request routes. Refused if either side has a block.","tags":["edges"],"x-pc-sdk":{"resource":"follows","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/follow-requests/{dst_actor_id}/{src_actor_id}/approve":{"post":{"operationId":"EdgeController_approveFollowRequest","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"The private actor being followed (approver).","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"The requesting actor.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"201":{"description":"Request approved; follow edge created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEdgeResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"No pending request for this pair.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Approve a pending follow request (task 014). The destination (private) actor approves the requesting actor; a follow edge is created.","tags":["edges"],"x-pc-sdk":{"resource":"followRequests","method":"approve","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/follow-requests/{dst_actor_id}/{src_actor_id}":{"delete":{"operationId":"EdgeController_declineFollowRequest","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"The private actor (decliner).","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"The requesting actor.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Request declined.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"No pending request for this pair.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Decline a pending follow request (task 014). Deletes the request; no edge, no notification.","tags":["edges"],"x-pc-sdk":{"resource":"followRequests","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/follow-requests":{"get":{"operationId":"EdgeController_listIncomingRequests","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"The private actor whose incoming requests to list.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of incoming follow requests.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowRequestListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List incoming follow requests for a (private) actor, newest-first (task 014).","tags":["edges"],"x-pc-sdk":{"resource":"actors.followRequests","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/follows/{src_actor_id}/{dst_actor_id}":{"delete":{"operationId":"EdgeController_unfollow","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Follower actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"Followee actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000002","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Unfollowed (or no edge to remove).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unfollow. Idempotent — 204 even if the follow didn't exist.","tags":["edges"],"x-pc-sdk":{"resource":"follows","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/following":{"get":{"operationId":"EdgeController_listFollowing","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"expand","required":false,"in":"query","schema":{"type":"string","enum":["dst_actor"]},"description":"Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`.","example":"dst_actor"}],"responses":{"200":{"description":"Page of follow edges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundEdgeListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR","INVALID_EXPAND"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actors this actor follows. Pass `?expand=dst_actor` to nest each followee's full actor row on the edge (no N+1 hydration).","tags":["edges"],"x-pc-sdk":{"resource":"actors.following","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/followers":{"get":{"operationId":"EdgeController_listFollowers","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"expand","required":false,"in":"query","schema":{"type":"string","enum":["src_actor"]},"description":"Stripe-style expansion. Pass the response field to expand (supported here: `src_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`.","example":"src_actor"}],"responses":{"200":{"description":"Page of follow edges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowerEdgeListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR","INVALID_EXPAND"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actors who follow this actor. Pass `?expand=src_actor` to nest each follower's full actor row on the edge — a followers screen renders from this one call.","tags":["edges"],"x-pc-sdk":{"resource":"actors.followers","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/mutes":{"post":{"operationId":"EdgeController_mute","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorEdgeDto"}}}},"responses":{"201":{"description":"Mute edge created (or returned via idempotent retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEdgeResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing / invalid src_actor_id / dst_actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actors not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block exists between the pair. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Cannot mute yourself.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Mute another actor. One-directional and silent — the muted actor isn't notified. Hides their content from the muter's feed.","tags":["edges"],"x-pc-sdk":{"resource":"mutes","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/mutes/{src_actor_id}/{dst_actor_id}":{"delete":{"operationId":"EdgeController_unmute","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Muter actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"Mutee actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Unmuted (or no edge to remove).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unmute. Idempotent — 204 either way.","tags":["edges"],"x-pc-sdk":{"resource":"mutes","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/mutes":{"get":{"operationId":"EdgeController_listMutes","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"expand","required":false,"in":"query","schema":{"type":"string","enum":["dst_actor"]},"description":"Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`.","example":"dst_actor"}],"responses":{"200":{"description":"Page of mute edges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundEdgeListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR","INVALID_EXPAND"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List actors this actor has muted. Pass `?expand=dst_actor` to nest each muted actor's full row on the edge.","tags":["edges"],"x-pc-sdk":{"resource":"actors.mutes","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/hides":{"post":{"operationId":"EdgeController_hidePost","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HidePostDto"}}}},"responses":{"201":{"description":"Post hidden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HideResultDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Community, actor, or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Hide a post from the actor's feeds (\"not interested\"). Idempotent. A hard filter — the post drops out of home + discover for that actor only.","tags":["edges"],"x-pc-sdk":{"resource":"hides","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/hides/{src_actor_id}/{post_id}":{"delete":{"operationId":"EdgeController_unhidePost","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"The actor who hid the post.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"The hidden post UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Un-hidden (or no-op).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Un-hide a post. Idempotent — 204 either way.","tags":["edges"],"x-pc-sdk":{"resource":"hides","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/hides":{"get":{"operationId":"EdgeController_listHides","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of hidden posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HideListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the posts an actor has hidden, newest-first.","tags":["edges"],"x-pc-sdk":{"resource":"actors.hides","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/dismissed-suggestions":{"post":{"operationId":"EdgeController_dismissSuggestion","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorEdgeDto"}}}},"responses":{"201":{"description":"Suggestion dismissed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEdgeResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"Cannot dismiss yourself.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Dismiss an actor from your follow suggestions (\"don't suggest\"). Idempotent. The actor never re-appears in your suggestions.","tags":["edges"],"x-pc-sdk":{"resource":"dismissedSuggestions","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/dismissed-suggestions/{src_actor_id}/{dst_actor_id}":{"delete":{"operationId":"EdgeController_undismissSuggestion","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"The dismissing actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"The dismissed actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Un-dismissed (or no-op).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Un-dismiss a suggestion. Idempotent — 204 either way. The actor becomes eligible for suggestions again.","tags":["edges"],"x-pc-sdk":{"resource":"dismissedSuggestions","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/dismissed-suggestions":{"get":{"operationId":"EdgeController_listDismissedSuggestions","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"expand","required":false,"in":"query","schema":{"type":"string","enum":["dst_actor"]},"description":"Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`.","example":"dst_actor"}],"responses":{"200":{"description":"Page of dismissed-suggestion edges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundEdgeListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List actors this actor has dismissed from suggestions. Pass `?expand=dst_actor` to nest each actor's full row.","tags":["edges"],"x-pc-sdk":{"resource":"actors.dismissedSuggestions","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/blocks":{"post":{"operationId":"EdgeController_block","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorEdgeDto"}}}},"responses":{"201":{"description":"Block edge created (or returned via idempotent retry); follows + mutes between the pair are torn down in the same transaction.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEdgeResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing / invalid src_actor_id / dst_actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actors not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"Cannot block yourself.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Block another actor. Removes any existing follows/mutes between the two in either direction (one transaction).","tags":["edges"],"x-pc-sdk":{"resource":"blocks","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/blocks/{src_actor_id}/{dst_actor_id}":{"delete":{"operationId":"EdgeController_unblock","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Blocker actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"Blockee actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Unblocked (or no edge to remove).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unblock. Idempotent — 204 either way. Does NOT restore prior follows / mutes (the block tear-down is one-way).","tags":["edges"],"x-pc-sdk":{"resource":"blocks","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/blocks":{"get":{"operationId":"EdgeController_listBlocks","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"expand","required":false,"in":"query","schema":{"type":"string","enum":["dst_actor"]},"description":"Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`.","example":"dst_actor"}],"responses":{"200":{"description":"Page of block edges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundEdgeListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR","INVALID_EXPAND"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List actors this actor has blocked. Pass `?expand=dst_actor` to nest each blocked actor's full row on the edge.","tags":["edges"],"x-pc-sdk":{"resource":"actors.blocks","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/restricts":{"post":{"operationId":"EdgeController_restrict","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorEdgeDto"}}}},"responses":{"201":{"description":"Restrict edge created (or returned via idempotent retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEdgeResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing / invalid src_actor_id / dst_actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actors not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block exists between the pair. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Cannot restrict yourself.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Restrict another actor (Instagram-style). One-directional. Restricted actors can still see content, but new comments by them are pre-moderated as `pending_approval` until the post-author approves.","tags":["edges"],"x-pc-sdk":{"resource":"restricts","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/restricts/{src_actor_id}/{dst_actor_id}":{"delete":{"operationId":"EdgeController_unrestrict","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Restrictor actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","description":"Restricted actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Unrestricted (or no edge to remove).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unrestrict. Idempotent — 204 either way.","tags":["edges"],"x-pc-sdk":{"resource":"restricts","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/restricts":{"get":{"operationId":"EdgeController_listRestricts","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"expand","required":false,"in":"query","schema":{"type":"string","enum":["dst_actor"]},"description":"Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`.","example":"dst_actor"}],"responses":{"200":{"description":"Page of restrict edges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundEdgeListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR","INVALID_EXPAND"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List actors this actor has restricted. Pass `?expand=dst_actor` to nest each restricted actor's full row on the edge.","tags":["edges"],"x-pc-sdk":{"resource":"actors.restricts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{src_actor_id}/relationships":{"get":{"description":"One query resolves the seven pairwise flags for a whole profile header or member list — no paging of full edge lists, and `blocked_by` is visible without attempting a write and handling the 409. Unknown or cross-community ids resolve to all-false flags; the id list is de-duplicated preserving request order. Bounded input (max 100 ids), so the response has no pagination envelope.","operationId":"EdgeController_relationships","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Source actor UUID — the perspective all flags are computed from.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"with","required":true,"in":"query","schema":{"type":"string"},"description":"Comma-separated destination actor UUIDs (1-100).","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}],"responses":{"200":{"description":"One relationship entry per requested id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationshipListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing `with`, more than 100 ids, or a non-UUID value in the list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or source actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Batched pairwise relationship lookup: does this actor follow / mute / block / restrict each of up to 100 others (and is it followed / blocked back)?","tags":["edges"],"x-pc-sdk":{"resource":"actors.relationships","method":"list","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/connections":{"post":{"operationId":"ConnectionController_request","parameters":[{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionRequestDto"}}}},"responses":{"201":{"description":"`pending` (request created / already open) or `connected` (both edges in place).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResultDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing / invalid src_actor_id / dst_actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"A block exists between the pair. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Cannot connect with yourself.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Request a connection (mutual follow). Runs the standard follow path: a private destination yields `pending` (accept via the accept route); a public destination connects immediately — the reverse edge is created in the same call. Idempotent; refused on blocks (409) and self-connection (422) exactly like a follow.","tags":["connections"],"x-pc-sdk":{"resource":"connections","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/connections/{dst_actor_id}/{src_actor_id}/accept":{"post":{"operationId":"ConnectionController_accept","parameters":[{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"dst_actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the dst actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the src actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"201":{"description":"Connected — both follow edges exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResultDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Malformed actor id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community/actor not found, or no request to accept and src does not follow dst.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Accept `src_actor_id`'s connection request as `dst_actor_id`: approves the follow request AND creates the reverse follow edge, so both directions exist afterwards. Convergent on retry — if the request was already consumed by a partially-completed accept (src already follows dst) the reverse edge is still ensured.","tags":["connections"],"x-pc-sdk":{"resource":"connections","method":"accept","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/connections/{actor_id}/{other_actor_id}":{"delete":{"operationId":"ConnectionController_sever","parameters":[{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"other_actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the other actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Severed (or nothing to sever).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Malformed actor id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Sever a connection COMPLETELY: deletes the follow edges in both directions and withdraws any pending requests either way. There is no one-sided removal — this is the connections invariant. 204 whether or not anything existed.","tags":["connections"],"x-pc-sdk":{"resource":"connections","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/hashtags":{"get":{"operationId":"HashtagController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"order","required":false,"in":"query","schema":{"type":"string","enum":["recent","trending"],"default":"recent"},"description":"`recent` (default) = newest tags first; `trending` = most posts in the window.","example":"recent"},{"name":"window","required":false,"in":"query","schema":{"type":"string","enum":["24h","7d"],"default":"24h"},"description":"Trending window (only meaningful with `order=trending`).","example":"24h"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of hashtags.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid order / window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List hashtags in this community. Default order is `first_used_at` desc; `order=trending` ranks by windowed post count (task 023) — pass `window=24h|7d`. `window_post_count` is populated only when trending.","tags":["hashtags"],"x-pc-sdk":{"resource":"hashtags","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/hashtags/{tag}":{"get":{"operationId":"HashtagController_getOne","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"tag","required":true,"in":"path","description":"Lowercase tag (without `#`).","schema":{"example":"storymode","type":"string"},"example":"launch"}],"responses":{"200":{"description":"Hashtag detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagDetailResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Tag fails the lowercase + alphanum + underscore + 1..32 rule.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or tag not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get a single hashtag with its current published post count.","tags":["hashtags"],"x-pc-sdk":{"resource":"hashtags","method":"retrieve","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/search/hashtags":{"get":{"description":"Backed by a `text_pattern_ops` partial index — sub-100ms for any prefix length up to communities with millions of tags. Results are alphabetically ordered.","operationId":"HashtagController_autocomplete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"q","required":true,"in":"query","schema":{"type":"string"},"description":"Lowercase prefix (1..32 chars).","example":"onboarding"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-50, default 20).","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"example":20}],"responses":{"200":{"description":"Matching hashtags.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagAutocompleteResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"q is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Prefix-search hashtags for autocomplete.","tags":["hashtags","search"],"x-pc-sdk":{"resource":"search.hashtags","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/hashtag-follows":{"post":{"operationId":"HashtagFollowController_follow","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID who is following.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateHashtagFollowDto"}}}},"responses":{"201":{"description":"Follow created (or refreshed).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagFollowResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Tag fails the lowercase + alphanum + underscore + 1..32 rule.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, actor, or hashtag not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Follow a hashtag on behalf of an actor. Idempotent — re-follow refreshes the followed_at timestamp but doesn't error.","tags":["hashtag-follows"],"x-pc-sdk":{"resource":"actors.hashtagFollows","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"HashtagFollowController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of followed hashtags.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagFollowListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the hashtags an actor follows. Cursor-paginated newest-first by followed_at.","tags":["hashtag-follows"],"x-pc-sdk":{"resource":"actors.hashtagFollows","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/hashtag-follows/{tag}":{"delete":{"operationId":"HashtagFollowController_unfollow","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"tag","required":true,"in":"path","description":"Lowercase tag.","schema":{"example":"storymode","type":"string"},"example":"launch"}],"responses":{"204":{"description":"Unfollowed (or was never followed).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Tag malformed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unfollow a hashtag. Idempotent — 204 either way.","tags":["hashtag-follows"],"x-pc-sdk":{"resource":"actors.hashtagFollows","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/insights":{"get":{"operationId":"InsightsController_postInsights","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the post.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"from","required":false,"in":"query","schema":{"type":"string","format":"date"},"description":"Window start (YYYY-MM-DD).","example":"2026-10-01"},{"name":"to","required":false,"in":"query","schema":{"type":"string","format":"date"},"description":"Window end (YYYY-MM-DD).","example":"2026-10-31"}],"responses":{"200":{"description":"Post insights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostInsightsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid window (inverted or > 366 days).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.analytics.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Aggregate insights for a post: total views, unique reach, engagement counts, and a daily views/reach series over ?from/?to (default trailing 30 days).","tags":["insights"],"x-pc-sdk":{"resource":"posts","method":"insights","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/insights":{"get":{"operationId":"InsightsController_actorInsights","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"from","required":false,"in":"query","description":"Window start (YYYY-MM-DD, UTC). Default 30 days before `to`.","schema":{"type":"string","format":"date"},"example":"2026-10-01"},{"name":"to","required":false,"in":"query","description":"Window end (YYYY-MM-DD, UTC), inclusive. Default today.","schema":{"type":"string","format":"date"},"example":"2026-10-31"}],"responses":{"200":{"description":"Actor insights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorInsightsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.analytics.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Actor not found in this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"An actor's follower time series: live follower_count plus a nightly-snapshot daily series over ?from/?to (default trailing 30 days).","tags":["insights"],"x-pc-sdk":{"resource":"actors","method":"insights","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/tags/{tagged_actor_id}/approve":{"post":{"description":"The tagged actor accepts being tagged; the tag flips `pending → approved` and the post starts surfacing on their `/tagged` listing. 403 if the acting actor is not the tagged actor. 409 if the tag was already removed.","operationId":"PostTagController_approve","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"tagged_actor_id","required":true,"in":"path","description":"Tagged actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActingActorDto"}}}},"responses":{"201":{"description":"Tag approved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTagResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Acting actor is not the tagged actor.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"404":{"description":"Post or tag not found.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Tag already removed.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Approve a pending tag (tagged actor only).","tags":["tags"],"x-pc-sdk":{"resource":"posts.tags","method":"approve","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/tags/{tagged_actor_id}/remove":{"post":{"description":"Flips the tag to `removed`. Removable by either the tagged actor or the post author (403 otherwise). Idempotent on an already-removed tag.","operationId":"PostTagController_remove","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"tagged_actor_id","required":true,"in":"path","description":"Tagged actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActingActorDto"}}}},"responses":{"201":{"description":"Tag removed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTagResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Acting actor is neither the tagged actor nor the post author.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"404":{"description":"Post or tag not found.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a tag (tagged actor or post author).","tags":["tags"],"x-pc-sdk":{"resource":"posts.tags","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{tagged_actor_id}/tagged":{"get":{"description":"Approved tags only, on published + unexpired posts, newest-tag-first. Visibility- and block-aware: pass the viewer via `actor_id` to surface followers / close-friends posts they may read; without it only public posts appear. Pages may be short (post-visibility filtering) but never skip or duplicate.","operationId":"PostTagController_listTagged","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"tagged_actor_id","required":true,"in":"path","description":"The tagged actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID for visibility resolution.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"requester_id","required":false,"in":"query","deprecated":true,"schema":{"type":"string","format":"uuid"},"description":"Deprecated alias for `actor_id`, kept working because this route never offered any other spelling. `actor_id` wins when both are sent. Will be removed in a future major.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Page of tagged posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaggedPostsResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`actor_id` / `requester_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"404":{"description":"Community or actor not found.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List posts an actor is tagged in.","tags":["tags"],"x-pc-sdk":{"resource":"actors.tagged","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/comments":{"post":{"operationId":"CommentController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCommentDto"}}}},"responses":{"201":{"description":"Comment created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing actor_id, empty body, body too long, malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, post, or parent comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block exists between commenter and post author, depth exceeds community.settings.max_comment_depth, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a comment on a post. Pass `parent_id` to reply; the depth is computed and capped by the community config. Pass an `Idempotency-Key` header to make retries safe.","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"CommentController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"parent_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"List replies of this parent comment instead of top-level.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID — surfaces author_only replies they're entitled to see.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Page of comments.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List comments on a post. Default returns top-level comments newest-first; pass `parent_id` to expand a thread (oldest-first). Pass `actor_id` so DM-style `author_only` replies surface only to the post-author and the comment-author pair.","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}":{"get":{"operationId":"CommentController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Social comment UUID.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Comment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Comment not found, removed, or not visible to the requester.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get a single comment by id.","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"CommentController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Social comment UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCommentDto"}}}},"responses":{"200":{"description":"Comment updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure or invalid status / visibility.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update a comment's body, status, or visibility.","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"CommentController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Social comment UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Comment soft-deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Soft-delete a comment.","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}/approve":{"post":{"operationId":"CommentController_approve","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Social comment UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveCommentDto"}}}},"responses":{"200":{"description":"Comment approved (now published).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing or invalid approver_actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not the post-author.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Comment is in a status that cannot be approved (hidden / removed).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Approve a pending_approval comment (restricted-actor pre-moderation). Reserved to the post-author. No-op if already published.","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"approve","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}/pin":{"post":{"description":"Pins a published top-level comment so it leads the top-level listing. Reserved to the post author (403 otherwise). 409 on a reply, a non-published comment, or when the per-post pin cap (community.settings.max_pinned_comments, default 3) is reached. Idempotent.","operationId":"CommentController_pin","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Social comment UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinCommentDto"}}}},"responses":{"201":{"description":"Comment pinned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the post-author.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post or comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Reply / non-published comment, or pin cap reached (`PIN_CAP_REACHED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","PIN_CAP_REACHED"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Pin a top-level comment (post-author only).","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"pin","bind":["community_id"],"paginated":false}},"delete":{"description":"Clears the pin; the comment returns to its chronological position. Reserved to the post author (403). Idempotent. Pass the acting actor via the request body.","operationId":"CommentController_unpin","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID the comments thread under.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Social comment UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinCommentDto"}}}},"responses":{"200":{"description":"Comment unpinned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the post-author.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post or comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unpin a comment (post-author only).","tags":["comments"],"x-pc-sdk":{"resource":"posts.comments","method":"unpin","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}/reactions":{"post":{"operationId":"CommentReactionController_add","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Parent post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Comment UUID.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCommentReactionDto"}}}},"responses":{"201":{"description":"Reaction added; response carries live `reaction_counts`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCommentReactionResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing actor_id; empty / overlong type).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / post / comment / actor not found, or comment is invisible to the actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block exists between actor and comment author. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"React to a comment. Idempotent: re-posting the same `(actor, type)` returns the existing row with `created: false`. Multiple reactions per `(actor, comment)` are allowed (different `type` values count separately).","tags":["comment-reactions"],"x-pc-sdk":{"resource":"posts.comments.reactions","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"CommentReactionController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Parent post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Comment UUID.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of reactions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentReactionListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / post / comment not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List reactions on a comment, newest-first. Cursor encodes `(created_at, actor_id, type)` so multi-reaction-from-same-actor stays stable.","tags":["comment-reactions"],"x-pc-sdk":{"resource":"posts.comments.reactions","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}/reactions/{src_actor_id}/{type}":{"delete":{"operationId":"CommentReactionController_remove","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Parent post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"comment_id","required":true,"in":"path","description":"Comment UUID.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Reactor actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":true,"in":"path","description":"Reaction type label (matches the value passed at create time).","schema":{"example":"like","type":"string"},"example":"like"}],"responses":{"200":{"description":"Reaction removed (or already absent); response carries live `reaction_counts`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentReactionCountsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing path parameter `type`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / post / comment / actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unreact. Idempotent: returns 200 with current `reaction_counts` even if there was nothing to remove.","tags":["comment-reactions"],"x-pc-sdk":{"resource":"posts.comments.reactions","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/muted-terms":{"post":{"operationId":"MutedTermController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMutedTermDto"}}}},"responses":{"201":{"description":"Muted term applied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutedTermResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add (or refresh) a muted term for the actor. Re-posting the same `term` updates the scope + expires_at.","tags":["muted-terms"],"x-pc-sdk":{"resource":"actors.mutedTerms","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"MutedTermController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Page size (default 50, max 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from a prior page's `pagination.next_cursor`.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Active muted terms, paginated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutedTermListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's currently-active muted terms, newest-first. Cursor-paginated (task 008 / G13 — previously an unbounded bare array).","tags":["muted-terms"],"x-pc-sdk":{"resource":"actors.mutedTerms","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/muted-terms/{term}":{"delete":{"operationId":"MutedTermController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"term","required":true,"in":"path","description":"URL-encoded term.","schema":{"type":"string"},"example":"spoiler"}],"responses":{"204":{"description":"Muted term removed.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a muted term. Idempotent — 204 either way.","tags":["muted-terms"],"x-pc-sdk":{"resource":"actors.mutedTerms","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/feed":{"get":{"operationId":"FeedController_getFeed","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Viewer social actor UUID — feed is candidate-pooled to their follow-graph.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor; not interchangeable between `ranked` and `chronological` modes.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"order","required":false,"in":"query","description":"`ranked` scores posts by engagement and recency; `chronological` is newest first.","schema":{"type":"string","enum":["ranked","chronological"],"default":"ranked"},"example":"ranked"}],"responses":{"200":{"description":"Page of posts (only `published`, non-expired, visibility-filtered).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"INVALID_ORDER (unknown `order` value) or INVALID_CURSOR (cursor shape mismatch).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Feed for an actor: their own posts + posts from actors they follow, with blocks excluded. Default order is `ranked` (recency + engagement + follow-graph signals); pass `order=chronological` to get the time-ordered feed. 50/page (max 200). The cursor shape differs between orders — passing a chronological cursor with `order=ranked` returns 400 INVALID_CURSOR.","tags":["feed"],"x-pc-sdk":{"resource":"actors.feed","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/discover-feed":{"get":{"operationId":"FeedController_getDiscoverFeed","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque ranked cursor; encodes (score, id).","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"kind","required":false,"in":"query","schema":{"type":"string","example":"image"},"description":"Optional post-kind filter (task 023) — e.g. `image`, `link`. Restricts discovery to that kind.","example":"image"}],"responses":{"200":{"description":"Page of posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or viewer actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Discover / explore feed (task 019). Ranked surface over every public post in the community — Instagram Explore / X \"For You without follow constraint\". Optional `actor_id` filters the viewer's blocks and applies a small self-boost; without one, the result is the global discovery slice.","tags":["feed"],"x-pc-sdk":{"resource":"discoverFeed","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/lists/{list_id}/feed":{"get":{"operationId":"FeedController_getListFeed","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer — required for visibility checks + block-filter.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor; differs in shape between ranked and chronological.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"order","required":false,"in":"query","description":"`ranked` scores posts by engagement and recency; `chronological` is newest first.","schema":{"type":"string","enum":["ranked","chronological"],"default":"chronological"},"example":"ranked"}],"responses":{"200":{"description":"Page of posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id, INVALID_ORDER, or INVALID_CURSOR.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List not found, or private and viewer is not owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List-scoped feed (task 018). Returns posts authored by members of the list, filtered by what the viewer can see. Default order is `chronological`; pass `order=ranked` for the same engagement-blended scoring used by the actor feed.","tags":["feed"],"x-pc-sdk":{"resource":"lists.feed","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/lists":{"post":{"operationId":"ActorListController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateActorListDto"}}}},"responses":{"201":{"description":"List created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (including malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`, or owner is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or owner not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"`IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Create a new list. Default visibility `private`. List creation has no natural key (an owner can hold many same-named lists), so pass an `Idempotency-Key` header to make retries safe.","tags":["lists"],"x-pc-sdk":{"resource":"lists","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"ActorListController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID — surfaces the viewer's own private lists alongside the public catalog.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"owner_actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter to lists owned by this actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of lists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorListListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List discoverable lists in this community. Public lists are visible to anyone; private lists surface only when `actor_id` is their owner.","tags":["lists"],"x-pc-sdk":{"resource":"lists","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/lists/{list_id}":{"get":{"operationId":"ActorListController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID — required to see a private list (must equal owner).","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"List.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List not found, or private and viewer is not owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one list by id.","tags":["lists"],"x-pc-sdk":{"resource":"lists","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"ActorListController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateActorListDto"}}}},"responses":{"200":{"description":"List updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not the owner, or PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update list name / description / visibility. Owner-only.","tags":["lists"],"x-pc-sdk":{"resource":"lists","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"ActorListController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Caller social actor UUID (must equal the list owner).","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"List deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete a list. Owner-only. Pass the caller via `?actor_id=`.","tags":["lists"],"x-pc-sdk":{"resource":"lists","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/lists/{list_id}/members":{"post":{"operationId":"ActorListController_addMember","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddListMemberDto"}}}},"responses":{"201":{"description":"Member added (or returned via idempotent retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorListMemberResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"A block exists between owner and member. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a member to a list. Owner-only.","tags":["lists"],"x-pc-sdk":{"resource":"lists.members","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"ActorListController_listMembers","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of members.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorListMemberListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List members of a list. Public lists are visible to anyone; private lists surface only when `actor_id` is the owner.","tags":["lists"],"x-pc-sdk":{"resource":"lists.members","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/lists/{list_id}/members/{member_actor_id}":{"delete":{"operationId":"ActorListController_removeMember","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"list_id","required":true,"in":"path","description":"List UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"member_actor_id","required":true,"in":"path","description":"Member — social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Caller social actor UUID (must equal the list owner).","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Member removed.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"List not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a member from a list. Owner-only. Idempotent — 204 either way. Pass the caller via `?actor_id=`.","tags":["lists"],"x-pc-sdk":{"resource":"lists.members","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/flags":{"post":{"operationId":"FlagController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFlagDto"}}}},"responses":{"201":{"description":"Flag created (or de-duplicated to existing open flag). `auto_hidden` reports whether the auto-hide threshold tripped.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFlagResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (bad reporter / target / reason).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.flag` for this community, or reporter actor is suspended/deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, reporter actor, or target object not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"The target post/comment is already removed; nothing to flag. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Cannot flag your own content.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"File a moderation report against a post or comment. Idempotent per (reporter, target) while open.","tags":["flags"],"x-pc-sdk":{"resource":"flags","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"FlagController_listMine","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The acting actor: the reporter whose flags to list. Required unless the deprecated `reporter_actor_id` is sent.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"reporter_actor_id","required":false,"in":"query","deprecated":true,"schema":{"type":"string","format":"uuid"},"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"status","required":false,"in":"query","description":"Only reports with this status.","schema":{"type":"string","enum":["open","dismissed","actioned"]},"example":"open"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of the reporter's flags.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlagListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing actor_id or invalid status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List a reporter's own flags (task 017). Requires `actor_id` (the reporter) — the customer lane sees only that reporter's reports (\"was my report reviewed?\"), never other reporters' flags. Cursor-paginated newest-first.","tags":["flags"],"x-pc-sdk":{"resource":"flags","method":"list","bind":["community_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/flags":{"get":{"operationId":"ModerationAdminController_listFlags","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["open","dismissed","actioned"]},"description":"Only reports with this status.","example":"open"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Maximum number of items to return (1-200, default 50).","example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of flags with next-cursor and has-more.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlagListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid status filter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.moderation.queue.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List flags in this community. Filter by ?status=open|dismissed|actioned. 50/page (max 200), cursor-paginated.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.flags","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/flags/{flag_id}/actions":{"post":{"operationId":"ModerationAdminController_act","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"flag_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the flag.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationActionDto"}}}},"responses":{"201":{"description":"Action recorded; target status updated where applicable. Returns the updated flag and the audit row.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActOnFlagResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid action or notes, or malformed Idempotency-Key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.moderate`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or flag not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"FLAG_ALREADY_CLOSED — the flag is already actioned/dismissed and the requested action is punitive (hide/remove/warn/ban); reversals (unhide/restore/dismiss) stay legal on a closed flag. Also `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Apply a moderation action to a flag. Records an audit entry and updates the target post/comment status. Pass an `Idempotency-Key` header so a retried request records ONE audit entry, not two.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.flags","method":"resolve","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/actions":{"post":{"operationId":"ModerationAdminController_actDirect","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string used to deduplicate retries within a 24h window. Replays return the original response; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectModerationActionDto"}}}},"responses":{"201":{"description":"Action recorded (flag_id=null audit row); side-effect applied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationActionResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid target_kind / action / notes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.moderate`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or target not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Apply a moderation action directly, without a preceding flag (task 017). Acts on any target — post/comment (status), direct_message (moderator soft-delete), or actor (ban=suspend / restore=reinstate). Writes a flag_id=null audit row.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.actions","method":"create","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/audit":{"get":{"operationId":"ModerationAdminController_listAudit","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size (default 50, max 200).","example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from a prior page's `pagination.next_cursor`.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"action","required":false,"in":"query","schema":{"type":"string","enum":["hide","remove","warn","ban","dismiss","unhide","restore"]},"description":"Exact moderation-action filter. Blank means no filter; an unknown action is a 400.","example":"hide"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Exact moderator filter — the platform account UUID recorded as `moderator_account_id`. Named to match the users-api app-audit filter. A non-UUID value is a 400.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"since","required":false,"in":"query","schema":{"type":"string","format":"date-time"},"description":"INCLUSIVE lower bound on `created_at` (ISO-8601). Unparseable input is a 400.","example":"eyJpZCI6IjNmMGMzYzFlIn0"},{"name":"until","required":false,"in":"query","schema":{"type":"string","format":"date-time"},"description":"EXCLUSIVE upper bound on `created_at` (ISO-8601), so adjacent windows tile without repeating the boundary row. Unparseable input is a 400.","example":"2026-12-01T00:00:00Z"}],"responses":{"200":{"description":"Page of audit entries with next-cursor and has-more.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid `action`, `actor_id`, `since`/`until`, or a malformed cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.audit.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Append-only audit of moderator actions in this community. 50/page (max 200), cursor-paginated. Filter by `?action=`, `?actor_id=` (the moderator), and/or the `?since=` / `?until=` window — all optional and composable. The ordering is fixed newest-first, so keep the same filters on every follow-up page.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.audit","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/actors/{actor_id}/shadow-ban":{"post":{"operationId":"ModerationAdminController_shadowBan","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyShadowBanDto"}}}},"responses":{"200":{"description":"Shadow ban applied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationActorResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid duration_hours or reason, or malformed Idempotency-Key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.moderate`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"`IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Apply a shadow ban to an actor. The actor sees their own content normally; everyone else sees nothing from them. Pass `duration_hours` for a timed ban or omit for indefinite. Pass an `Idempotency-Key` header so a retried timed ban doesn't restart the clock.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.actors","method":"shadowBan","bind":["workspace_id"],"paginated":false}},"delete":{"operationId":"ModerationAdminController_unshadow","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the actor.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Shadow ban cleared.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationActorResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.moderate`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a shadow ban. No-op if not currently shadow-banned.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.actors","method":"unshadowBan","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/shadow-banned":{"get":{"operationId":"ModerationAdminController_listShadowBanned","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size (default 50, max 200).","example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from a prior page's `pagination.next_cursor`.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"q","required":false,"in":"query","schema":{"type":"string","maxLength":128},"description":"Case-insensitive substring matched against the actor display name OR external id. `%` and `_` are matched literally. Blank means no filter; over 128 chars is a 400.","example":"onboarding"}],"responses":{"200":{"description":"Page of shadow-banned actors.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationActorListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Over-length `q` or a malformed cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.audit.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List currently shadow-banned actors in this community. 50/page (max 200), cursor-paginated newest-ban first. Optional `?q=` substring search over display name OR external id, composable with the cursor.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.shadowBanned","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/blocked-terms":{"post":{"operationId":"ModerationAdminController_addBlockedTerm","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBlockedTermDto"}}}},"responses":{"201":{"description":"Blocked term added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockedTermResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Empty or over-length term.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.config.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a hidden word to the community lexicon. A comment whose body contains the term is routed to `action`: `hide` → lands hidden; `pending_approval` → lands in the approve lane. Re-adding a term updates its action. Case-insensitive.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.blockedTerms","method":"create","bind":["workspace_id"],"paginated":false}},"get":{"operationId":"ModerationAdminController_listBlockedTerms","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"q","required":false,"in":"query","schema":{"type":"string","maxLength":128},"description":"Case-insensitive substring matched against the blocked term. `%` and `_` are matched literally. Blank means no filter; over 128 chars is a 400.","example":"onboarding"}],"responses":{"200":{"description":"Page of blocked terms.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockedTermListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Over-length `q` or a malformed cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.config.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the community hidden-words lexicon, newest-first. Cursor-paginated (50/page, max 200). Optional `?q=` substring search over the term, composable with the cursor.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.blockedTerms","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/blocked-terms/{term}":{"delete":{"operationId":"ModerationAdminController_removeBlockedTerm","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"term","required":true,"in":"path","description":"The blocked term to remove (case-insensitive).","schema":{"type":"string"},"example":"spoiler"}],"responses":{"204":{"description":"Removed (or no-op).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.config.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a hidden word. Idempotent — 204 whether or not it existed.","tags":["moderation-admin"],"x-pc-sdk":{"resource":"communities.moderation.blockedTerms","method":"delete","bind":["workspace_id"],"paginated":false}}},"/v1/communities/{community_id}/conversations/unread-count":{"get":{"operationId":"ConversationController_unreadCount","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The viewer actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Unread count.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnreadCountResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Global unread message count for the caller across every conversation in this community.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"unreadCount","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/conversations":{"post":{"operationId":"ConversationController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Mostly useful for `kind=\"group\"` (direct conversations are get-or-create by participant pair anyway). Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversationDto"}}}},"responses":{"201":{"description":"Conversation created or (1-on-1 only) returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing recipient for direct, missing actor_ids for group, two equal actor ids, malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`, or a participant is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"A block exists, the group exceeds `community.settings.max_group_conversation_size`, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Open a conversation. Default `kind=\"direct\"` is the naturally-idempotent 1-on-1 path (get-or-create by participant pair). Pass `kind=\"group\"` with `actor_ids` for a multi-participant chat — group creates always insert a new row, so pass an `Idempotency-Key` header to make group-create retries safe.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"ConversationController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The viewer actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["inbox","requests","all"],"default":"inbox"},"description":"Filter slice. `inbox` (default) excludes conversations whose other participant the viewer has restricted; `requests` shows only those; `all` merges both.","example":"inbox"}],"responses":{"200":{"description":"Page of conversations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the caller's conversations in this community, most-recent-activity first.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/conversations/{conversation_id}/members":{"post":{"operationId":"ConversationController_addMember","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMemberDto"}}}},"responses":{"201":{"description":"Member added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not an admin, or PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Already a member, group full, or block exists with an existing participant. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a member to a group conversation. Admin-only. Refuses if the new member has a block with any existing participant.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.members","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/conversations/{conversation_id}/members/{member_actor_id}":{"patch":{"operationId":"ConversationController_updateMember","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"member_actor_id","required":true,"in":"path","description":"Target participant — social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberDto"}}}},"responses":{"200":{"description":"Participant updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Not an admin (role) or not the target (self-only fields).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation or participant not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Attempting to demote the last admin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update a participant (task 025). Field-level authz: `role` is admin-only; `muted` / `muted_until` / `pinned` are self-only (the caller must be the path actor). The canonical home for participant state.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.members","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"ConversationController_removeMember","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"member_actor_id","required":true,"in":"path","description":"Target participant — social actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Acting actor UUID (equal to the target for self-leave).","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Participant removed.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not an admin and not the target.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation or participant not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Attempting to remove the last admin (or self-leave when last admin in a non-empty group).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a participant. Admin-only unless the acting `?actor_id=` equals the target (self-leave).","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.members","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/conversations/{conversation_id}":{"get":{"operationId":"ConversationController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The viewer actor UUID — must be a participant.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Conversation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation not found or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get a single conversation by id.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"ConversationController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateConversationDto"}}}},"responses":{"200":{"description":"Conversation after update (with the caller's unread_count).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Not an admin (rename), or PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation not found or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Rename on a non-group conversation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Conversation-level update (task 025). Pass `name` to rename a group (admin-only) — the canonical rename home. Participant state (muted / muted_until / pinned) lives on PATCH /:id/members/:member_actor_id.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"ConversationController_leave","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The leaving participant — social actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Caller removed from the conversation.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation not found or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Leave the conversation. Drops the caller's participant row; the conversation is hard-deleted when the last participant leaves. Pass the actor via `?actor_id=`.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/conversations/{conversation_id}/messages":{"post":{"operationId":"ConversationController_send","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageDto"}}}},"responses":{"201":{"description":"Message sent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (empty body for text, body too long, malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation, reply target, or sender not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"A block exists between the sender and another participant, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a message in the conversation. Pass an `Idempotency-Key` header to make retries safe — a retried send never delivers the message twice.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.messages","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"ConversationController_listMessages","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The viewer actor UUID — must be a participant.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"since","required":false,"in":"query","schema":{"type":"string"},"description":"Polling cursor — encoded last-seen message id; returns newer messages in ascending order.","example":"eyJpZCI6IjNmMGMzYzFlIn0"}],"responses":{"200":{"description":"Page of messages.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation not found or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List messages in the conversation. Default newest-first cursor. Pass `since` (encoded cursor of the last-seen message) to poll for newer messages instead.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.messages","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/conversations/{conversation_id}/messages/{message_id}":{"get":{"operationId":"ConversationController_getMessage","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"message_id","required":true,"in":"path","description":"Message UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The viewer actor UUID — must be a participant.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"The message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation/message not found, or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Fetch a single message (task 024) — resolves a reply target without paging the whole thread. Participant-gated.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.messages","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"ConversationController_editMessage","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"message_id","required":true,"in":"path","description":"Direct message UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMessageDto"}}}},"responses":{"200":{"description":"Message updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (empty body, body too long).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not the sender, or PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation or message not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Edit window expired (5 minutes after send).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Edit a message body. Allowed within 5 minutes of send and only by the sender.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.messages","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"ConversationController_deleteMessage","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"message_id","required":true,"in":"path","description":"Direct message UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The sender — must match the message's sender_id.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Message soft-deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller is not the sender, or PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation or message not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Soft-delete a message. Reserved to the sender; the row stays so the conversation timeline doesn't orphan replies. Reads return body `\"(deleted)\"`. Pass the sender via `?actor_id=`.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations.messages","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/conversations/{conversation_id}/read":{"post":{"operationId":"ConversationController_markRead","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkConversationReadDto"}}}},"responses":{"204":{"description":"Read marker updated.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (read_through not ISO).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation not found or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Mark messages as read up to a given timestamp (default: now()). Sets the caller's `last_read_at`.","tags":["conversations"],"x-pc-sdk":{"resource":"conversations","method":"markRead","bind":["community_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/conversations":{"get":{"operationId":"ConversationModerationController_listConversations","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of conversations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationAdminListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.audit.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List every conversation in the community, most-recent-activity first. Moderation-only.","tags":["conversations-admin"],"x-pc-sdk":{"resource":"communities.moderation.conversations","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/moderation/conversations/{conversation_id}/messages":{"get":{"operationId":"ConversationModerationController_listMessages","parameters":[{"name":"workspace_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the workspace.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"community_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the community.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of messages.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageAdminListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.audit.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or conversation not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List every message in a conversation. Moderation-only.","tags":["conversations-admin"],"x-pc-sdk":{"resource":"communities.moderation.conversations.messages","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/communities/{community_id}/conversations/{conversation_id}/messages/{message_id}/reactions":{"post":{"operationId":"DirectMessageReactionController_add","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"example":"11111111-2222-3333-4444-555555555555","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"message_id","required":true,"in":"path","description":"Direct message UUID.","schema":{"example":"mmmmmmmm-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDirectMessageReactionDto"}}}},"responses":{"201":{"description":"Reaction applied (created or pre-existing).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageReactionCreatedResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`, or reactor is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation, message, or actor not found, or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block exists between reactor and sender. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a reaction to a direct message. Idempotent — re-posting the same (actor, type) is a no-op.","tags":["dm-reactions"],"x-pc-sdk":{"resource":"conversations.messages.reactions","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"DirectMessageReactionController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"example":"11111111-2222-3333-4444-555555555555","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"message_id","required":true,"in":"path","description":"Direct message UUID.","schema":{"example":"mmmmmmmm-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The viewer — must be a participant.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of reactions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageReactionListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation or message not found, or caller not a participant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the reactions on a direct message. Cursor-paginated, newest-first.","tags":["dm-reactions"],"x-pc-sdk":{"resource":"conversations.messages.reactions","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/conversations/{conversation_id}/messages/{message_id}/reactions/{actor_id}/{type}":{"delete":{"operationId":"DirectMessageReactionController_remove","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"conversation_id","required":true,"in":"path","description":"Conversation UUID.","schema":{"example":"11111111-2222-3333-4444-555555555555","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"message_id","required":true,"in":"path","description":"Direct message UUID.","schema":{"example":"mmmmmmmm-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Reactor actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":true,"in":"path","description":"Reaction type to remove.","schema":{"example":"like","type":"string"},"example":"like"}],"responses":{"200":{"description":"Reaction removed (or already absent).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectMessageReactionRemovedResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Conversation, message, or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove the (actor, type) reaction. Idempotent — calling on a missing reaction returns the current counts.","tags":["dm-reactions"],"x-pc-sdk":{"resource":"conversations.messages.reactions","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/notifications":{"get":{"description":"Reverse-chronological inbox. Pass `unread_only=true` to filter to unread rows only. Cursor encodes `(created_at, id)` and round-trips through the response. Default page size 50, max 200. Suppression of self-actions and blocked-actor pairs happens at write time, so every row returned here has already passed those filters.","operationId":"NotificationController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Items per page (1..200, default 50).","example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque base64url cursor returned by the prior page.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"unread_only","required":false,"in":"query","schema":{"type":"boolean","default":false},"description":"When `true`, returns only rows where `read_at IS NULL`.","example":false},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["inbox","requests","all"],"default":"inbox"},"description":"Filter slice. `inbox` (default) hides suppressed rows; `requests` shows only suppressed rows (notifications from actors the viewer has restricted); `all` merges both.","example":"inbox"}],"responses":{"200":{"description":"Page of notifications.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationListResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.notify.read` for this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (also returned for cross-workspace probes).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List notifications for an actor (newest first).","tags":["notifications"],"x-pc-sdk":{"resource":"actors.notifications","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/notifications/unread-count":{"get":{"description":"Cheap badge endpoint backed by a partial index — safe to poll at the cadence of an in-product notification bell.","operationId":"NotificationController_unreadCount","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Count of unread rows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnreadCountResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.notify.read` for this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Count unread notifications for an actor.","tags":["notifications"],"x-pc-sdk":{"resource":"actors.notifications","method":"unreadCount","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/notifications/{notification_id}":{"patch":{"description":"Idempotent: marking an already-read row read again is a no-op 204. Returns 404 if the notification belongs to a different actor.","operationId":"NotificationController_markRead","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"notification_id","required":true,"in":"path","description":"Notification UUID returned from the list endpoint.","schema":{"example":"11111111-1111-1111-1111-111111111111","type":"string"},"example":"11111111-1111-1111-1111-111111111111"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNotificationDto"}}}},"responses":{"204":{"description":"Read state updated.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Body validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.notify.update` for this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Notification not found, or belongs to a different actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Mark a single notification as read or unread.","tags":["notifications"],"x-pc-sdk":{"resource":"actors.notifications","method":"update","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/notifications/read-all":{"post":{"description":"Single bulk write. Optional `before` ISO timestamp scopes to rows older than that — useful for \"mark all older than today as read\" UX. Returns the number of rows that flipped.","operationId":"NotificationController_markAllRead","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkAllReadDto"}}}},"responses":{"200":{"description":"Bulk update applied; `updated` is the row count.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkAllReadResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`before` is not a valid ISO timestamp.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.notify.update` for this community.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Mark every unread notification for the actor as read.","tags":["notifications"],"x-pc-sdk":{"resource":"actors.notifications","method":"markAllRead","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/notification-prefs":{"get":{"description":"Returns one row per known NotificationKind so the client UI can render every toggle without a separate catalogue lookup. Synthesised rows carry an epoch `updated_at`; explicit rows carry the real timestamp.","operationId":"NotificationPrefController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Per-kind preferences.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPrefListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.notify.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's per-kind notification preferences. Synthesises `enabled=true` defaults for kinds the actor has not explicitly toggled.","tags":["notification-preferences"],"x-pc-sdk":{"resource":"actors.notificationPrefs","method":"list","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/notification-prefs/{kind}":{"patch":{"description":"Idempotent upsert. Pass `{ enabled: false }` to mute, `{ enabled: true }` to re-enable. Cache is invalidated on write so the next NotificationService.tryEmit picks up the change immediately. Returns the resulting preference row.","operationId":"NotificationPrefController_set","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"kind","required":true,"in":"path","description":"NotificationKind label.","schema":{"enum":["follow","reaction","comment_on_post","reply_to_comment","mention","vote","repost","quote_post","dm_new_message","dm_added_to_group","dm_role_changed","dm_reaction","tag","follow_request","follow_request_approved"],"type":"string"},"example":"follow"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNotificationPrefDto"}}}},"responses":{"200":{"description":"Preference upserted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPrefResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Body validation failed, or `kind` is not a known NotificationKind.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.notify.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Set a single notification-kind preference for the actor.","tags":["notification-preferences"],"x-pc-sdk":{"resource":"actors.notificationPrefs","method":"update","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/suggested-follows":{"get":{"description":"Friend-of-a-friend signal first (people the requester's followees also follow), with a cold-start fallback to top actors in the community by follower count when FoF underfills the limit. Excludes self, existing follows / mutes / blocks, and actors who have blocked the requester. Cached 1h per (actor, limit).","operationId":"SuggestionController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID for whom to compute suggestions.","schema":{"example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"Items to return; capped at 50.","example":20}],"responses":{"200":{"description":"Ordered candidates.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestedFollowsListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Suggested follows for an actor.","tags":["suggestions"],"x-pc-sdk":{"resource":"actors.suggestedFollows","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/bookmark":{"post":{"description":"Visibility-aware: the actor must be allowed to read the post. If they can't, returns 404 (opaque), matching the read-path opacity rule used everywhere else in Social.","operationId":"BookmarkController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBookmarkDto"}}}},"responses":{"201":{"description":"Bookmark created (or returned via idempotent retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookmarkToggleResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing/invalid actor_id).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, post, or actor not found, or the post is invisible to the actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Bookmark a post on behalf of an actor. Idempotent — returns the existing row with `created: false` on retry.","tags":["bookmarks"],"x-pc-sdk":{"resource":"posts","method":"bookmark","bind":["community_id"],"paginated":false}},"delete":{"operationId":"BookmarkController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Acting actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Bookmark removed (or was already absent).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (missing/invalid actor_id).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, post, or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a bookmark on behalf of an actor. Idempotent — 204 either way. Pass the actor via `?actor_id=`.","tags":["bookmarks"],"x-pc-sdk":{"resource":"posts","method":"unbookmark","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/bookmarks":{"get":{"description":"Bookmarks are private — only the bookmarker should see their own list. The PAK lane has no end-user principal; the customer's backend must scope this call to the right end-user before exposing the response. Bookmarks against posts whose visibility has narrowed since (or which have been deleted) stay in the list — we don't cross-check post visibility on read of bookmarks.","operationId":"BookmarkController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from `pagination.next_cursor`.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of bookmarks.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookmarkListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's bookmarks. Cursor-paginated newest-first.","tags":["bookmarks"],"x-pc-sdk":{"resource":"actors.bookmarks","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/collections":{"post":{"operationId":"CollectionController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client string; replays return the original response.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCollectionDto"}}}},"responses":{"201":{"description":"Collection created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`, owner suspended, or cover asset not owned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, owner, or cover asset not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"Cover asset is not ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Create a collection. Default kind `bookmark`, visibility `private`. Pass an Idempotency-Key so retries are safe.","tags":["collections"],"x-pc-sdk":{"resource":"collections","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"CollectionController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer actor — surfaces their own private collections.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"owner_actor_id","required":false,"in":"query","description":"Only collections owned by this actor.","schema":{"type":"string","format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"kind","required":false,"in":"query","description":"Only collections of this kind.","schema":{"type":"string","enum":["bookmark","highlight"]},"example":"bookmark"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of collections.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List collections. Public ones are visible to anyone; private ones surface only to their owner via actor_id. Filter by owner_actor_id / kind.","tags":["collections"],"x-pc-sdk":{"resource":"collections","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/collections/{collection_id}":{"get":{"operationId":"CollectionController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","description":"The acting actor (the viewer); private collections are visible to their owner only.","schema":{"type":"string","format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"The collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Not found (or private and not the owner).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Fetch one collection. Private collections resolve only for their owner (via actor_id).","tags":["collections"],"x-pc-sdk":{"resource":"collections","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"operationId":"CollectionController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCollectionDto"}}}},"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the owner, or PAK lacks `social.update`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"422":{"description":"Cover asset is not ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update a collection (owner only) — rename, cover, visibility, reorder position.","tags":["collections"],"x-pc-sdk":{"resource":"collections","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"CollectionController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The acting actor; must be the collection owner. Required unless the request sends the deprecated JSON body `{ caller_actor_id }`.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteWithCallerDto"}}}},"responses":{"204":{"description":"Deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete a collection (owner only). Items cascade; the posts themselves are untouched.","tags":["collections"],"x-pc-sdk":{"resource":"collections","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/collections/{collection_id}/items":{"post":{"operationId":"CollectionController_addItem","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddItemDto"}}}},"responses":{"201":{"description":"Item added (or already present).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionItemResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Collection or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a post to a collection (owner only). Idempotent per (collection, post).","tags":["collections"],"x-pc-sdk":{"resource":"collections.items","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"CollectionController_listItems","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","description":"The acting actor (the viewer); private collections are visible to their owner only.","schema":{"type":"string","format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of items.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionItemListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Not found (or private and not the owner).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List a collection's posts in curator order. Highlight collections bypass story expiry; bookmark collections drop expired posts. 50/page (max 200).","tags":["collections"],"x-pc-sdk":{"resource":"collections.items","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/collections/{collection_id}/items/{post_id}":{"patch":{"operationId":"CollectionController_reorderItem","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the post.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReorderItemDto"}}}},"responses":{"200":{"description":"Item repositioned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionItemResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Collection or item not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Reorder a post within a collection (owner only).","tags":["collections"],"x-pc-sdk":{"resource":"collections.items","method":"update","bind":["community_id"],"paginated":false}},"delete":{"operationId":"CollectionController_removeItem","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"collection_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the collection.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the post.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"The acting actor; must be the collection owner. Required unless the request sends the deprecated JSON body `{ caller_actor_id }`.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteWithCallerDto"}}}},"responses":{"204":{"description":"Item removed.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller is not the owner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a post from a collection (owner only).","tags":["collections"],"x-pc-sdk":{"resource":"collections.items","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/mentions":{"get":{"description":"Cursor-paginated, newest-first. Interleaves post + comment mentions in a single feed; the `source` field discriminates which surface each row came from. The `post_id` field is always set so the client can deep-link, even for comment mentions.","operationId":"MentionController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID whose mentions to list.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque cursor from `pagination.next_cursor`.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of mention entries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MentionListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List every place this actor has been @-mentioned (posts + comments).","tags":["mentions"],"x-pc-sdk":{"resource":"actors.mentions","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/search/actors":{"get":{"description":"Postgres FTS over a generated tsvector column (display_name A + external_id B + bio C, `simple` locale). Returns up to `limit` (default 20, max 50) hits ordered by `ts_rank`. Pass `actor_id` to filter out actors the requester has muted or blocked, and actors who have blocked the requester. Trigram fuzzy matching is intentionally out of scope — that's a follow-up.","operationId":"SearchController_searchActors","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"q","required":true,"in":"query","schema":{"type":"string","minLength":1,"maxLength":120},"description":"Free-text query (1..120 chars).","example":"onboarding"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"Max hits to return.","example":20},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer social actor UUID — filters out blocked / muted actors.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque pagination cursor from a prior response. Valid only for the same `q` (task 022).","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Ranked actor hits, cursor-paginated by (rank, id).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorSearchResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"q missing or out of bounds (1..120 chars).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found (or belongs to a different community).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Search actors by display name, external_id (username), and bio.","tags":["search"],"x-pc-sdk":{"resource":"search.actors","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/search/posts":{"get":{"description":"Postgres FTS over a generated tsvector column on the post table (title A + body B, simple locale). `order='relevance'` (default) ranks by ts_rank; `order='recent'` keeps the FTS filter but orders by created_at desc. Filters out drafts / removed / hidden / expired posts. Pass `actor_id` to drop posts authored by anyone the requester has muted / blocked, or who has blocked the requester. Without `actor_id`, only posts with `visibility='public'` surface.","operationId":"SearchController_searchPosts","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"q","required":true,"in":"query","description":"Search text.","schema":{"type":"string","minLength":1,"maxLength":120},"example":"onboarding"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-50, default 20).","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"example":20},{"name":"order","required":false,"in":"query","description":"`relevance` (best match first) or `recent` (newest first).","schema":{"type":"string","enum":["relevance","recent"],"default":"relevance"},"example":"relevance"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Viewer social actor UUID.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Opaque pagination cursor from a prior response. Valid only for the same `(q, order)` pair (task 022).","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Ranked post hits, cursor-paginated by (rank, id) for relevance or (created_at, id) for recent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostSearchResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"q missing / overlong, or invalid `order` value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Search post content (title + body) by full-text.","tags":["search"],"x-pc-sdk":{"resource":"search.posts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{actor_id}/story-tray":{"get":{"description":"Includes the requester themselves and every actor they follow. Ordered by latest story timestamp. Capped at 200 entries (no cursor in v1; tray is bounded by follow-graph in normal usage). Returns `has_unviewed=true` when the requester has not recorded a `view` edge against the author's most recent story.","operationId":"StoryController_getTray","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Social actor UUID (returned from POST /actors).","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Story tray entries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryTrayResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Story tray for an actor — one entry per author with at least one unexpired or pinned story.","tags":["stories"],"x-pc-sdk":{"resource":"actors.storyTray","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/actors/{owner_actor_id}/highlights":{"get":{"description":"Pinned posts appear here regardless of their `expires_at`. Visibility still applies — pass `actor_id` to surface non-public pinned posts the requester is allowed to see. Without that param, only `public` pinned rows are returned (legacy-safe default). Cursor-paginated on `(created_at DESC, id DESC)`.","operationId":"StoryController_getHighlights","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"owner_actor_id","required":true,"in":"path","description":"Social actor UUID whose highlights to list.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"aaaaaaaa-0000-0000-0000-000000000001"},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Items per page.","example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Cursor from the prior page.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"actor_id","required":false,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Requester social actor UUID. Without it, only public pinned posts surface.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Page of highlights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HighlightsResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the actor's pinned posts (highlights).","tags":["stories"],"x-pc-sdk":{"resource":"actors.highlights","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/views":{"post":{"description":"Idempotent on `(community, viewer, post)`. 204 on success or no-op duplicate. 422 on self-view (you cannot view your own story). 404 if the post is hidden by visibility, expired, removed, or if a block exists between viewer and author. Does NOT fire a notification — the author sees views via the viewers endpoint instead.","operationId":"StoryController_recordView","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Story (post) UUID.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordViewDto"}}}},"responses":{"204":{"description":"View recorded (or already existed).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Body validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.view`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / post / viewer not found, or the post is invisible to the viewer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"422":{"description":"Cannot view your own story.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Record a view of a post (idempotent).","tags":["stories"],"x-pc-sdk":{"resource":"posts","method":"recordView","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/viewers":{"get":{"description":"Only the post author can list viewers. The PAK passes `actor_id`; if that resolves to an actor whose id != post.actor_id, returns 403. Viewers are ordered by view timestamp, newest-first.","operationId":"StoryController_listViewers","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Story (post) UUID.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Requester social actor UUID — must resolve to the post author.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Cursor from the prior page.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of viewers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryViewersResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id (author-only endpoint).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list` OR requester is not the post author.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List viewers of a post (author-only).","tags":["stories"],"x-pc-sdk":{"resource":"posts.viewers","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/close-friends":{"post":{"description":"Idempotent on `(community, owner, member)`. 422 on self-add. 409 if a block exists between the pair in either direction. Visibility-`close_friends` posts authored by `owner` become visible to `member` after this call.","operationId":"StoryController_addCloseFriend","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCloseFriendDto"}}}},"responses":{"204":{"description":"Member added (or already present).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Body validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.close-friend.manage`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / owner / member not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block in place between owner and member. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Cannot add yourself as a close friend.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a member to an actor's close-friends list.","tags":["stories"],"x-pc-sdk":{"resource":"closeFriends","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/close-friends/{owner_actor_id}/{member_actor_id}":{"delete":{"description":"Idempotent: 204 whether or not the edge exists. After removal, `close_friends`-visibility posts by `owner` no longer surface to `member`.","operationId":"StoryController_removeCloseFriend","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"owner_actor_id","required":true,"in":"path","description":"Owner social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"aaaaaaaa-0000-0000-0000-000000000001"},{"name":"member_actor_id","required":true,"in":"path","description":"Member social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000002","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Removed (or was not in the list).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.close-friend.manage`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Remove a member from an actor's close-friends list.","tags":["stories"],"x-pc-sdk":{"resource":"closeFriends","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/close-friends":{"get":{"description":"Returns the actors on `external_id`'s close-friends list, with denormalised actor metadata. Cursor paginated.","operationId":"StoryController_listCloseFriends","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Owner social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of close friends.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseFriendsListResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","INVALID_CURSOR"]},"403":{"description":"PAK lacks `social.close-friend.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the close-friends members of an actor.","tags":["stories"],"x-pc-sdk":{"resource":"actors.closeFriends","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/votes":{"post":{"description":"Last-vote-wins: an actor changing their vote replaces the prior one. 422 if the post has no poll, if `option_index` is out of range, or on self-vote of own poll. 409 if a block exists between voter and post author. Fires a `vote` notification to the post author.","operationId":"StoryController_castVote","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID containing the poll.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CastVoteDto"}}}},"responses":{"204":{"description":"Vote recorded or replaced.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Body validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.vote`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community / post / voter not found, or post invisible.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block in place between voter and poll author. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"Self-vote / no poll / option_index out of range / `POLL_CLOSED` (past the poll `closes_at`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY","POLL_CLOSED"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Cast or change a vote on a poll.","tags":["stories"],"x-pc-sdk":{"resource":"posts.votes","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/poll-results":{"get":{"description":"Returns counts per option, zero-filling options that received no votes, plus `total_votes`. The `question` and option `label` strings are echoed from `post.attributes.poll`.","operationId":"StoryController_getPollResults","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID containing the poll.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"Aggregated poll results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollResultsResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"422":{"description":"Post does not contain a poll.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Aggregate poll results for a post.","tags":["stories"],"x-pc-sdk":{"resource":"posts","method":"pollResults","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/votes/{actor_id}":{"get":{"description":"Returns the actor's chosen `option_index` and when it was cast. 404 when the post is gone or the actor has not voted. Naturally idempotent — no Idempotency-Key.","operationId":"StoryController_getVote","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID containing the poll.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Voter social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000002","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"The actor's vote.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollVoteResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post not found, or the actor has not voted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Read an actor's vote on a poll.","tags":["stories"],"x-pc-sdk":{"resource":"posts.votes","method":"retrieve","bind":["community_id"],"paginated":false}},"delete":{"description":"Deletes the vote edge. Idempotent — 204 whether or not a vote existed. No tally decrement: results are computed from surviving votes.","operationId":"StoryController_deleteVote","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID containing the poll.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Voter social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000002","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Vote retracted (or no-op).","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"PAK lacks `social.vote`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Retract an actor's vote on a poll.","tags":["stories"],"x-pc-sdk":{"resource":"posts.votes","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/posts/{post_id}/voters":{"get":{"description":"Only the poll author can list voters. Pass the author via `actor_id`; a requester whose id != post.actor_id gets 403. Each entry carries the voter and their `option_index`. Optionally filter to a single option with `option`. Ordered newest-first.","operationId":"StoryController_listVoters","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Post UUID containing the poll.","schema":{"example":"bbbbbbbb-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"query","schema":{"type":"string","format":"uuid"},"description":"Requester social actor UUID — must resolve to the poll author.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"option","required":false,"in":"query","schema":{"type":"integer","minimum":0},"description":"Filter to voters who chose this option index.","example":0},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Cursor from the prior page.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of voters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollVotersResponse"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing/invalid actor_id (author-only endpoint).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list` OR requester is not the poll author.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List voters of a poll (author-only).","tags":["stories"],"x-pc-sdk":{"resource":"posts.voters","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/reactions":{"post":{"operationId":"PostReactionController_react","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReactionDto"}}}},"responses":{"201":{"description":"Reaction added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community, post, or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Block exists between actor and post author. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"React to a post. Idempotent: re-posting the same (actor, type) returns the existing edge with `created: false`.","tags":["post-reactions"],"x-pc-sdk":{"resource":"posts.reactions","method":"create","bind":["community_id"],"paginated":false}},"get":{"operationId":"PostReactionController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":false,"in":"query","schema":{"type":"string","maxLength":64,"example":"like"},"description":"Filter to a single reaction type label.","example":"like"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of reactions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostReactionListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Overlong `type` filter (max 64 chars).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found (or post removed).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List reactions on a post, newest-first. Cursor encodes `(created_at, actor_id, type)` so multi-reaction-from-same-actor stays stable. Pass `type` to narrow to one reaction type.","tags":["post-reactions"],"x-pc-sdk":{"resource":"posts.reactions","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/posts/{post_id}/reactions/{src_actor_id}/{type}":{"delete":{"operationId":"PostReactionController_unreact","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"post_id","required":true,"in":"path","description":"Social post UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"src_actor_id","required":true,"in":"path","description":"Reactor actor UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":true,"in":"path","description":"Reaction type label.","schema":{"example":"like","type":"string"},"example":"like"}],"responses":{"200":{"description":"Reaction removed (or already absent).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReactionCountsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Missing path parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.delete`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or post not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Unreact. Idempotent: returns 200 with current `reaction_counts` even if there was nothing to remove.","tags":["post-reactions"],"x-pc-sdk":{"resource":"posts.reactions","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/actors/{actor_id}/post-state":{"post":{"description":"Read-over-POST (the id list is too large for a query string) — no side effects, no Idempotency-Key needed. Renders a whole feed page's \"liked by you\" / saved / reposted / voted state with one request on top of the feed call.","operationId":"ViewerStateController_postState","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the PAK's workspace.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"Viewer actor UUID — the perspective all state is computed from.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostStateRequestDto"}}}},"responses":{"200":{"description":"One state entry per requested post id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostStateResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Empty `post_ids`, more than 200 ids, or a non-UUID in the list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or actor not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Batch viewer-state hydration: the actor's reactions, bookmark, repost, and poll-vote state for up to 200 posts in one call.","tags":["viewer-state"],"x-pc-sdk":{"resource":"actors","method":"postState","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/hashtags/{tag}/posts":{"get":{"operationId":"HashtagFeedController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Community UUID.","schema":{"type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"tag","required":true,"in":"path","description":"Lowercase tag (without `#`).","schema":{"type":"string"},"example":"launch"},{"name":"order","required":false,"in":"query","description":"`chronological` is newest first; `ranked` scores posts by engagement and recency.","schema":{"type":"string","enum":["chronological","ranked"],"default":"chronological"},"example":"chronological"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"},"description":"Chronological pages on (created_at, id); ranked on (score, id). A cursor is not portable across orders.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of posts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashtagPostListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid tag or order value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.list`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community or tag not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List posts using a hashtag. `order=chronological` (default) or `order=ranked` (task 023) — ranked reuses the discover recency+engagement scoring, paginated on a (score, id) cursor. Same wire shape as the regular post list.","tags":["hashtag-posts"],"x-pc-sdk":{"resource":"hashtags.posts","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/webhooks/event-types":{"get":{"description":"Each type with a plain description, its group and an example `data` object (what \"Send test\" delivers).","operationId":"WebhooksController_social_community_listEventTypes","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEventTypesResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the events an endpoint can subscribe to.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.eventTypes","method":"list","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks/endpoints":{"get":{"description":"At most 10, so this is always one page. Signing secrets are never returned here, only their last 4 characters.","operationId":"WebhooksController_social_community_listEndpoints","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEndpointsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"The scope id in the path is malformed.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List webhook endpoints, oldest first.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"list","bind":["community_id"],"paginated":true}},"post":{"description":"Deliveries are signed with the Standard Webhooks headers `webhook-id`, `webhook-timestamp` and `webhook-signature` (`v1,<base64 HMAC-SHA256 of \"<id>.<timestamp>.<body>\">`); the returned `whsec_…` secret works unchanged with any Standard Webhooks library. Failed deliveries are retried after 1 min, 5 min, 30 min, 2 h, 6 h and 24 h.","operationId":"WebhooksController_social_community_createEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpointDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecretDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure: URL not https with a public host, or an unknown event type (`WEBHOOK_EVENT_TYPE_UNKNOWN`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","WEBHOOK_EVENT_TYPE_UNKNOWN"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","WEBHOOK_ENDPOINT_LIMIT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The URL points at a private, loopback or internal address.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a webhook endpoint. Returns its signing secret once.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"create","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks/endpoints/{endpoint_id}":{"get":{"description":"The endpoint's URL, subscription, on/off state, failure streak and the last 4 characters of its signing secret. The full secret is only returned when the endpoint is created or its secret is rotated.","operationId":"WebhooksController_social_community_getEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one webhook endpoint (without its secret).","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"retrieve","bind":["community_id"],"paginated":false}},"patch":{"description":"Only the fields sent change. `enabled: true` (or a new URL) also clears an automatic disable. Switching off cancels queued retries. The secret is unchanged; rotate it with `POST …/rotate-secret`.","operationId":"WebhooksController_social_community_updateEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpointDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The new URL points at a private, loopback or internal address.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Change a webhook endpoint: URL, description, events, on/off.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"update","bind":["community_id"],"paginated":false}},"delete":{"description":"Queued retries are dropped. Its past attempts stay in the event log until the events expire.","operationId":"WebhooksController_social_community_deleteEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete a webhook endpoint.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"delete","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks/endpoints/{endpoint_id}/rotate-secret":{"post":{"description":"For `grace_hours` (default 24) the previous secret keeps signing too: `webhook-signature` then lists one `v1,` signature per secret, so receivers can switch over without dropping a delivery.","operationId":"WebhooksController_social_community_rotateSecret","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateWebhookSecretDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecretDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`grace_hours` out of range, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Rotate the signing secret. The new one is returned once.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"rotateSecret","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks/endpoints/{endpoint_id}/test":{"post":{"description":"Delivers the catalogue example of `event_type`, signed like any delivery, with `\"test\": true` in the body. Works while the endpoint is switched off or not subscribed to that type, is logged in the event log, and is never retried or counted toward an automatic disable. Waits up to 15 s for your receiver.","operationId":"WebhooksController_social_community_sendTest","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendWebhookTestDto"}}}},"responses":{"200":{"description":"The attempt, successful or not.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryAttemptDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Unknown `event_type`, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a test event to this endpoint now and return the result.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"test","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks/events":{"get":{"description":"Every event logged while at least one endpoint existed, with the latest state per endpoint and when the next retry is due.","operationId":"WebhooksController_social_community_listEvents","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":false,"in":"query","description":"Only these types. Repeat the parameter or comma-separate.","schema":{"type":"array","items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"example":["post.created"]},{"name":"endpoint_id","required":false,"in":"query","description":"Only events sent (or queued) to this endpoint.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"status","required":false,"in":"query","description":"Only events in this delivery status.","schema":{"$ref":"#/components/schemas/WebhookEventStatus"},"example":"pending"},{"name":"created_after","required":false,"in":"query","description":"Only events created at or after this instant.","schema":{"format":"date-time","type":"string"},"example":"2026-11-01T00:00:00Z"},{"name":"created_before","required":false,"in":"query","description":"Only events created before this instant.","schema":{"format":"date-time","type":"string"},"example":"2026-12-01T00:00:00Z"},{"name":"limit","required":false,"in":"query","description":"Page size.","schema":{"minimum":1,"maximum":100,"default":20,"type":"integer"},"example":20},{"name":"cursor","required":false,"in":"query","description":"The previous page's `pagination.next_cursor`.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEventsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid filter value or cursor.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List webhook events, newest first (kept for 30 days).","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.events","method":"list","bind":["community_id"],"paginated":true}}},"/v1/communities/{community_id}/webhooks/events/{event_id}":{"get":{"description":"The event as it was sent (`type`, `data`) and every delivery attempt to every endpoint, with its trigger, HTTP status, error and the start of the response body. Use it to debug a receiver, then `replay` to send it again.","operationId":"WebhooksController_social_community_getEvent","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"event_id","required":true,"in":"path","description":"The event id, `evt_<uuid>`.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventDetailDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`event_id` is not `evt_<uuid>`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_EVENT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one webhook event with every delivery attempt.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.events","method":"retrieve","bind":["community_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks/events/{event_id}/replay":{"post":{"description":"Same body and `webhook-id`, freshly signed, to every switched-on endpoint that receives this event type now, or only to `endpoint_id`. Waits for the receivers (up to 15 s each) and returns the attempts. A success cancels a retry still queued for that endpoint.","operationId":"WebhooksController_social_community_replay","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. Must belong to the caller's workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"event_id","required":true,"in":"path","description":"The event id, `evt_<uuid>`.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":false,"in":"query","description":"Send to this endpoint only.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayWebhookEventResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`event_id` is not `evt_<uuid>`, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days. Or No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_EVENT_NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"`endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","WEBHOOK_ENDPOINT_NOT_SUBSCRIBED","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a logged event again, to its endpoints or to one endpoint.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.events","method":"replay","bind":["community_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/event-types":{"get":{"description":"Each type with a plain description, its group and an example `data` object (what \"Send test\" delivers).","operationId":"WebhooksController_social_workspace_community_listEventTypes","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEventTypesResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the events an endpoint can subscribe to.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.eventTypes","method":"list","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/endpoints":{"get":{"description":"At most 10, so this is always one page. Signing secrets are never returned here, only their last 4 characters.","operationId":"WebhooksController_social_workspace_community_listEndpoints","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEndpointsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"The scope id in the path is malformed.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List webhook endpoints, oldest first.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"list","bind":["workspace_id"],"paginated":true,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}},"post":{"description":"Deliveries are signed with the Standard Webhooks headers `webhook-id`, `webhook-timestamp` and `webhook-signature` (`v1,<base64 HMAC-SHA256 of \"<id>.<timestamp>.<body>\">`); the returned `whsec_…` secret works unchanged with any Standard Webhooks library. Failed deliveries are retried after 1 min, 5 min, 30 min, 2 h, 6 h and 24 h.","operationId":"WebhooksController_social_workspace_community_createEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpointDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecretDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure: URL not https with a public host, or an unknown event type (`WEBHOOK_EVENT_TYPE_UNKNOWN`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","WEBHOOK_EVENT_TYPE_UNKNOWN"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","WEBHOOK_ENDPOINT_LIMIT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The URL points at a private, loopback or internal address.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a webhook endpoint. Returns its signing secret once.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"create","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/endpoints/{endpoint_id}":{"get":{"description":"The endpoint's URL, subscription, on/off state, failure streak and the last 4 characters of its signing secret. The full secret is only returned when the endpoint is created or its secret is rotated.","operationId":"WebhooksController_social_workspace_community_getEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one webhook endpoint (without its secret).","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"retrieve","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}},"patch":{"description":"Only the fields sent change. `enabled: true` (or a new URL) also clears an automatic disable. Switching off cancels queued retries. The secret is unchanged; rotate it with `POST …/rotate-secret`.","operationId":"WebhooksController_social_workspace_community_updateEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpointDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The new URL points at a private, loopback or internal address.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Change a webhook endpoint: URL, description, events, on/off.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"update","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}},"delete":{"description":"Queued retries are dropped. Its past attempts stay in the event log until the events expire.","operationId":"WebhooksController_social_workspace_community_deleteEndpoint","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete a webhook endpoint.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"delete","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/endpoints/{endpoint_id}/rotate-secret":{"post":{"description":"For `grace_hours` (default 24) the previous secret keeps signing too: `webhook-signature` then lists one `v1,` signature per secret, so receivers can switch over without dropping a delivery.","operationId":"WebhooksController_social_workspace_community_rotateSecret","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateWebhookSecretDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecretDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`grace_hours` out of range, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Rotate the signing secret. The new one is returned once.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"rotateSecret","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/endpoints/{endpoint_id}/test":{"post":{"description":"Delivers the catalogue example of `event_type`, signed like any delivery, with `\"test\": true` in the body. Works while the endpoint is switched off or not subscribed to that type, is logged in the event log, and is never retried or counted toward an automatic disable. Waits up to 15 s for your receiver.","operationId":"WebhooksController_social_workspace_community_sendTest","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendWebhookTestDto"}}}},"responses":{"200":{"description":"The attempt, successful or not.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryAttemptDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Unknown `event_type`, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a test event to this endpoint now and return the result.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.endpoints","method":"test","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/events":{"get":{"description":"Every event logged while at least one endpoint existed, with the latest state per endpoint and when the next retry is due.","operationId":"WebhooksController_social_workspace_community_listEvents","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":false,"in":"query","description":"Only these types. Repeat the parameter or comma-separate.","schema":{"type":"array","items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"example":["post.created"]},{"name":"endpoint_id","required":false,"in":"query","description":"Only events sent (or queued) to this endpoint.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"status","required":false,"in":"query","description":"Only events in this delivery status.","schema":{"$ref":"#/components/schemas/WebhookEventStatus"},"example":"pending"},{"name":"created_after","required":false,"in":"query","description":"Only events created at or after this instant.","schema":{"format":"date-time","type":"string"},"example":"2026-11-01T00:00:00Z"},{"name":"created_before","required":false,"in":"query","description":"Only events created before this instant.","schema":{"format":"date-time","type":"string"},"example":"2026-12-01T00:00:00Z"},{"name":"limit","required":false,"in":"query","description":"Page size.","schema":{"minimum":1,"maximum":100,"default":20,"type":"integer"},"example":20},{"name":"cursor","required":false,"in":"query","description":"The previous page's `pagination.next_cursor`.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEventsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid filter value or cursor.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Community not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List webhook events, newest first (kept for 30 days).","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.events","method":"list","bind":["workspace_id"],"paginated":true,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/events/{event_id}":{"get":{"description":"The event as it was sent (`type`, `data`) and every delivery attempt to every endpoint, with its trigger, HTTP status, error and the start of the response body. Use it to debug a receiver, then `replay` to send it again.","operationId":"WebhooksController_social_workspace_community_getEvent","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"event_id","required":true,"in":"path","description":"The event id, `evt_<uuid>`.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventDetailDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`event_id` is not `evt_<uuid>`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_EVENT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one webhook event with every delivery attempt.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.events","method":"retrieve","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/webhooks/events/{event_id}/replay":{"post":{"description":"Same body and `webhook-id`, freshly signed, to every switched-on endpoint that receives this event type now, or only to `endpoint_id`. Waits for the receivers (up to 15 s each) and returns the attempts. A success cancels a retry still queued for that endpoint.","operationId":"WebhooksController_social_workspace_community_replay","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID. The same endpoints as `/v1/communities/{community_id}/webhooks`; this path also accepts a console session.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"event_id","required":true,"in":"path","description":"The event id, `evt_<uuid>`.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":false,"in":"query","description":"Send to this endpoint only.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}},{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID the community belongs to.","schema":{"format":"uuid"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayWebhookEventResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`event_id` is not `evt_<uuid>`, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days. Or No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_EVENT_NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"`endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","WEBHOOK_ENDPOINT_NOT_SUBSCRIBED","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a logged event again, to its endpoints or to one endpoint.","tags":["webhooks"],"x-pc-sdk":{"resource":"communities.webhooks.events","method":"replay","bind":["workspace_id"],"paginated":false,"deprecated":"The same call as on `/v1/communities/{community_id}/webhooks` (in the SDKs: `community(communityId).webhooks`), which SDK code should use. This route exists for signed-in console sessions."}}},"/v1/workspaces/{workspace_id}/webhooks/event-types":{"get":{"description":"Each type with a plain description, its group and an example `data` object (what \"Send test\" delivers).","operationId":"WebhooksController_social_workspace_listEventTypes","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEventTypesResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Workspace not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the events an endpoint can subscribe to.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.eventTypes","method":"list","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/webhooks/endpoints":{"get":{"description":"At most 10, so this is always one page. Signing secrets are never returned here, only their last 4 characters.","operationId":"WebhooksController_social_workspace_listEndpoints","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEndpointsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"The scope id in the path is malformed.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Workspace not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List webhook endpoints, oldest first.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"list","bind":["workspace_id"],"paginated":true}},"post":{"description":"Deliveries are signed with the Standard Webhooks headers `webhook-id`, `webhook-timestamp` and `webhook-signature` (`v1,<base64 HMAC-SHA256 of \"<id>.<timestamp>.<body>\">`); the returned `whsec_…` secret works unchanged with any Standard Webhooks library. Failed deliveries are retried after 1 min, 5 min, 30 min, 2 h, 6 h and 24 h.","operationId":"WebhooksController_social_workspace_createEndpoint","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpointDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecretDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure: URL not https with a public host, or an unknown event type (`WEBHOOK_EVENT_TYPE_UNKNOWN`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR","WEBHOOK_EVENT_TYPE_UNKNOWN"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Workspace not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","WEBHOOK_ENDPOINT_LIMIT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The URL points at a private, loopback or internal address.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Add a webhook endpoint. Returns its signing secret once.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"create","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}":{"get":{"description":"The endpoint's URL, subscription, on/off state, failure streak and the last 4 characters of its signing secret. The full secret is only returned when the endpoint is created or its secret is rotated.","operationId":"WebhooksController_social_workspace_getEndpoint","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one webhook endpoint (without its secret).","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"retrieve","bind":["workspace_id"],"paginated":false}},"patch":{"description":"Only the fields sent change. `enabled: true` (or a new URL) also clears an automatic disable. Switching off cancels queued retries. The secret is unchanged; rotate it with `POST …/rotate-secret`.","operationId":"WebhooksController_social_workspace_updateEndpoint","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpointDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"422":{"description":"The new URL points at a private, loopback or internal address.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Change a webhook endpoint: URL, description, events, on/off.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"update","bind":["workspace_id"],"paginated":false}},"delete":{"description":"Queued retries are dropped. Its past attempts stay in the event log until the events expire.","operationId":"WebhooksController_social_workspace_deleteEndpoint","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"204":{"description":"Deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete a webhook endpoint.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"delete","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}/rotate-secret":{"post":{"description":"For `grace_hours` (default 24) the previous secret keeps signing too: `webhook-signature` then lists one `v1,` signature per secret, so receivers can switch over without dropping a delivery.","operationId":"WebhooksController_social_workspace_rotateSecret","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateWebhookSecretDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecretDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`grace_hours` out of range, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Rotate the signing secret. The new one is returned once.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"rotateSecret","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}/test":{"post":{"description":"Delivers the catalogue example of `event_type`, signed like any delivery, with `\"test\": true` in the body. Works while the endpoint is switched off or not subscribed to that type, is logged in the event log, and is never retried or counted toward an automatic disable. Waits up to 15 s for your receiver.","operationId":"WebhooksController_social_workspace_sendTest","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":true,"in":"path","schema":{"format":"uuid","type":"string"},"description":"Id of the endpoint.","example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendWebhookTestDto"}}}},"responses":{"200":{"description":"The attempt, successful or not.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryAttemptDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Unknown `event_type`, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a test event to this endpoint now and return the result.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.endpoints","method":"test","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/webhooks/events":{"get":{"description":"Every event logged while at least one endpoint existed, with the latest state per endpoint and when the next retry is due.","operationId":"WebhooksController_social_workspace_listEvents","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"type","required":false,"in":"query","description":"Only these types. Repeat the parameter or comma-separate.","schema":{"type":"array","items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"example":["post.created"]},{"name":"endpoint_id","required":false,"in":"query","description":"Only events sent (or queued) to this endpoint.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"status","required":false,"in":"query","description":"Only events in this delivery status.","schema":{"$ref":"#/components/schemas/WebhookEventStatus"},"example":"pending"},{"name":"created_after","required":false,"in":"query","description":"Only events created at or after this instant.","schema":{"format":"date-time","type":"string"},"example":"2026-11-01T00:00:00Z"},{"name":"created_before","required":false,"in":"query","description":"Only events created before this instant.","schema":{"format":"date-time","type":"string"},"example":"2026-12-01T00:00:00Z"},{"name":"limit","required":false,"in":"query","description":"Page size.","schema":{"minimum":1,"maximum":100,"default":20,"type":"integer"},"example":20},{"name":"cursor","required":false,"in":"query","description":"The previous page's `pagination.next_cursor`.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookEventsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Invalid filter value or cursor.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Workspace not found, not visible to the caller, or the endpoint / event is not in it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List webhook events, newest first (kept for 30 days).","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.events","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/webhooks/events/{event_id}":{"get":{"description":"The event as it was sent (`type`, `data`) and every delivery attempt to every endpoint, with its trigger, HTTP status, error and the start of the response body. Use it to debug a receiver, then `replay` to send it again.","operationId":"WebhooksController_social_workspace_getEvent","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"event_id","required":true,"in":"path","description":"The event id, `evt_<uuid>`.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventDetailDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`event_id` is not `evt_<uuid>`.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_EVENT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Get one webhook event with every delivery attempt.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.events","method":"retrieve","bind":["workspace_id"],"paginated":false}}},"/v1/workspaces/{workspace_id}/webhooks/events/{event_id}/replay":{"post":{"description":"Same body and `webhook-id`, freshly signed, to every switched-on endpoint that receives this event type now, or only to `endpoint_id`. Waits for the receivers (up to 15 s each) and returns the attempts. A success cancels a retry still queued for that endpoint.","operationId":"WebhooksController_social_workspace_replay","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID. Endpoints here receive the events of every community in the workspace.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"event_id","required":true,"in":"path","description":"The event id, `evt_<uuid>`.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"endpoint_id","required":false,"in":"query","description":"Send to this endpoint only.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry of this request safe for 24 hours. The same key with a different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayWebhookEventResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`event_id` is not `evt_<uuid>`, or `endpoint_id` is not a UUID.","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"401":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNAUTHORIZED"]},"403":{"description":"Caller lacks `social.read` (reads) or `social.update` (changes, Send test, replay), or Social is not enabled for the workspace (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days. Or No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND","WEBHOOK_EVENT_NOT_FOUND","WEBHOOK_ENDPOINT_NOT_FOUND"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"`endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","WEBHOOK_ENDPOINT_NOT_SUBSCRIBED","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a logged event again, to its endpoints or to one endpoint.","tags":["webhooks"],"x-pc-sdk":{"resource":"webhooks.events","method":"replay","bind":["workspace_id"],"paginated":false}}},"/v1/communities/{community_id}/webhooks":{"post":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_create","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. The signing secret is returned exactly once; a replay returns the original response (including the secret) with `Idempotent-Replay: true`. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookDto"}}}},"responses":{"201":{"description":"Webhook created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedWebhookResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure (bad url, empty or unknown event_types — the message names the valid set; malformed Idempotency-Key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"PAK lacks `social.create`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Webhook cap reached (10 per community), or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"422":{"description":"The URL points at a private, loopback or internal address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Create a community webhook. Multiple subscribers per community are supported (cap 10). Returns the signing secret ONCE — store it. Pass an `Idempotency-Key` header so a retried create replays the SAME secret instead of minting a duplicate subscriber.","tags":["webhooks"],"x-pc-sdk":false},"get":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_list","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"}],"responses":{"200":{"description":"All webhooks on the community (no pagination — capped at 10 rows).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Community not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List the community's webhooks — disabled rows included, so an auto-disabled subscriber stays discoverable.","tags":["webhooks"],"x-pc-sdk":false}},"/v1/communities/{community_id}/webhooks/{webhook_id}":{"get":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_getById","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}}],"responses":{"200":{"description":"Webhook.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Webhook not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Read a single webhook by id.","tags":["webhooks"],"x-pc-sdk":false},"patch":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_update","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookDto"}}}},"responses":{"200":{"description":"Webhook updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Validation failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"404":{"description":"Webhook not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"422":{"description":"The URL points at a private, loopback or internal address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["UNPROCESSABLE_ENTITY"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Update webhook url, subscribed event types, or disabled state. `{ \"disabled\": false }` is the re-enable path after an auto-disable — no secret rotation required.","tags":["webhooks"],"x-pc-sdk":false},"delete":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_delete","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}}],"responses":{"204":{"description":"Webhook deleted.","headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Webhook not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Delete the webhook.","tags":["webhooks"],"x-pc-sdk":false}},"/v1/communities/{community_id}/webhooks/{webhook_id}/test":{"post":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_testPing","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}}],"responses":{"202":{"description":"Test sent; the outcome is in `status`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryJobResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Webhook not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Webhook is disabled — re-enable it first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a test delivery now: the example of the first event type the webhook subscribes to, signed exactly like a real event. The answer (202, kept for compatibility) already carries the outcome: `status` is `succeeded` or `exhausted` (never retried), with `last_error`.","tags":["webhooks"],"x-pc-sdk":false}},"/v1/communities/{community_id}/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliver":{"post":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_redeliver","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}},{"name":"delivery_id","required":true,"in":"path","description":"Delivery row UUID (from GET …/deliveries).","schema":{"type":"string"}}],"responses":{"202":{"description":"Sent again; the outcome is in `status`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryJobResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Webhook or delivery not found, or the event is older than 30 days.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"Webhook is disabled (re-enable it first), or it no longer subscribes to that event type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Send a past delivery's event again, now, with its original body (same event id, so subscriber-side event-id dedupe treats it as a redelivery). The answer (202, kept for compatibility) carries the outcome in `status`.","tags":["webhooks"],"x-pc-sdk":false}},"/v1/communities/{community_id}/webhooks/{webhook_id}/rotate-secret":{"post":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_rotateSecret","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","description":"Opaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. A replay returns the original response (including the new secret) with `Idempotent-Replay: true`; a retry WITHOUT the header rotates the secret again, invalidating the previous one. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"New secret.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedWebhookResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"Idempotent-Replay":{"description":"`true` when this response is a replay of an earlier request with the same `Idempotency-Key`.","schema":{"type":"string","enum":["true"]}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"Malformed Idempotency-Key header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"404":{"description":"Webhook not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"409":{"description":"`IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying with the same key (sent with `IDEMPOTENCY_IN_PROGRESS`).","schema":{"type":"integer"}},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["CONFLICT","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_IN_PROGRESS"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Rotate the signing secret; the old one stops at once. Also switches a disabled webhook back on. Returns the new secret ONCE. Pass an `Idempotency-Key` header so a retried rotate replays the SAME new secret instead of rotating twice.","tags":["webhooks"],"x-pc-sdk":false}},"/v1/communities/{community_id}/webhooks/{webhook_id}/deliveries":{"get":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookController_deliveries","parameters":[{"name":"community_id","required":true,"in":"path","description":"Social community UUID.","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook_id","required":true,"in":"path","description":"Webhook UUID.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of deliveries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryListResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"404":{"description":"Webhook not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"List delivery attempts (newest first).","tags":["webhooks"],"x-pc-sdk":false}},"/v1/webhook-event-types":{"get":{"deprecated":true,"description":"Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.","operationId":"WebhookEventTypesController_list","parameters":[],"responses":{"200":{"description":"The full event-type catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventTypesResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"summary":"List the webhook event-type names. Static metadata, no auth required. `GET /v1/communities/{community_id}/webhooks/event-types` returns the same types with a description, a group and an example each.","tags":["webhooks"],"x-pc-sdk":false}},"/v1/workspaces/{workspace_id}/communities/{community_id}/actors/{actor_id}/comments":{"get":{"operationId":"ExportController_comments","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID.","schema":{"example":"wwwwwwww-wwww-wwww-wwww-wwwwwwwwwwww","type":"string"},"example":"wwwwwwww-wwww-wwww-wwww-wwwwwwwwwwww"},{"name":"community_id","required":true,"in":"path","description":"Community UUID (must belong to the workspace).","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"The data subject — social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of the actor's comments.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorCommentsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.audit.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Every comment an actor authored, all statuses (published / hidden / removed) — the GDPR-export view. 50/page (max 200), cursor-paginated newest-first.","tags":["export"],"x-pc-sdk":{"resource":"communities.actors.comments","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/communities/{community_id}/actors/{actor_id}/reactions":{"get":{"operationId":"ExportController_reactions","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace UUID.","schema":{"example":"wwwwwwww-wwww-wwww-wwww-wwwwwwwwwwww","type":"string"},"example":"wwwwwwww-wwww-wwww-wwww-wwwwwwwwwwww"},{"name":"community_id","required":true,"in":"path","description":"Community UUID (must belong to the workspace).","schema":{"example":"cccccccc-cccc-cccc-cccc-cccccccccccc","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"actor_id","required":true,"in":"path","description":"The data subject — social actor UUID.","schema":{"example":"aaaaaaaa-0000-0000-0000-000000000001","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"limit","required":false,"in":"query","description":"Maximum number of items to return (1-200, default 50).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"example":50},{"name":"cursor","required":false,"in":"query","description":"Opaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.","schema":{"type":"string"},"example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMS0wMVQwMDowMDowMFoifQ"}],"responses":{"200":{"description":"Page of the actor's reactions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorReactionsResponseDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"403":{"description":"Caller lacks `social.audit.read`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN"]},"404":{"description":"Community not found in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Every reaction an actor has given — post reactions and comment reactions unified into one stream, discriminated by `target_type`. The GDPR-export view. 50/page (max 200), cursor-paginated newest-first.","tags":["export"],"x-pc-sdk":{"resource":"communities.actors.reactions","method":"list","bind":["workspace_id"],"paginated":true}}},"/v1/workspaces/{workspace_id}/stats":{"get":{"description":"Community count, published posts, active members, posts, comments and reactions in the window, the most recent activity and a daily active-members series, across every community in the workspace.\n\n**Active** means the member published a post, published a comment or reacted.\n\nDays are UTC. Counts only: no member ids, handles or author lists. Cached for up to 60 seconds (`generated_at`).","operationId":"WorkspaceStatsController_get","parameters":[{"name":"workspace_id","required":true,"in":"path","description":"Workspace id.","schema":{"format":"uuid","type":"string"},"example":"3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"window","required":false,"in":"query","description":"Window for `in_window` and the length of `series`, in UTC days ending today.","schema":{"default":"30d","example":"30d","enum":["1d","7d","30d"],"type":"string"},"example":"30d"}],"responses":{"200":{"description":"Social stats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialWorkspaceStatsDto"}}},"headers":{"X-RateLimit-Limit-short":{"$ref":"#/components/headers/X-RateLimit-Limit-short"},"X-RateLimit-Remaining-short":{"$ref":"#/components/headers/X-RateLimit-Remaining-short"},"X-RateLimit-Reset-short":{"$ref":"#/components/headers/X-RateLimit-Reset-short"},"X-RateLimit-Limit-long":{"$ref":"#/components/headers/X-RateLimit-Limit-long"},"X-RateLimit-Remaining-long":{"$ref":"#/components/headers/X-RateLimit-Remaining-long"},"X-RateLimit-Reset-long":{"$ref":"#/components/headers/X-RateLimit-Reset-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}}},"400":{"description":"`window` is not one of 1d, 7d, 30d.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["BAD_REQUEST","VALIDATION_ERROR"]},"403":{"description":"Caller lacks `social.analytics.read` on the workspace, or Social is not enabled on it (`SERVICE_NOT_ENABLED`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["FORBIDDEN","SERVICE_NOT_ENABLED"]},"404":{"description":"Workspace not found: the id is unknown, is not a UUID, or is not visible to the caller. Same answer as the service's other workspace routes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}},"headers":{"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["NOT_FOUND"]},"429":{"description":"More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"Retry-After-short":{"$ref":"#/components/headers/Retry-After-short"},"Retry-After-long":{"$ref":"#/components/headers/Retry-After-long"},"X-Request-Id":{"$ref":"#/components/headers/RequestId"}},"x-pc-error-codes":["RATE_LIMITED"],"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}}},"security":[{"bearer":[]}],"summary":"Social stats for a workspace","tags":["stats"],"x-pc-sdk":{"resource":"stats","method":"retrieve","bind":["workspace_id"],"paginated":false}}}},"info":{"title":"Social API","description":"Social-as-a-Service backend: actors, posts, comments, edges (follow/mute/block/restrict), feeds, stories, DMs, moderation. Two lanes. Customer lane: your backend calls /v1/communities/{community_id}/* with a workspace API key (`Authorization: Bearer pcft_live_...`) and asserts the acting end-user via the standardized `actor_id` (body field or `?actor_id=` query parameter). Admin lane: /v1/workspaces/{workspace_id}/* accepts an API key bearer, a platform user bearer, or the `auth_token` session cookie, and covers community CRUD, moderation, and analytics.\n\n## Rate limits\n\nEvery `/v1` route is limited per client IP to 20 requests per second and 600 per minute. Each response carries `X-RateLimit-Limit-short`, `X-RateLimit-Remaining-short`, `X-RateLimit-Reset-short` (the one-second window) and the same three with `-long` (the one-minute window). Over either limit the response is `429` with code `RATE_LIMITED` and a `Retry-After` header in seconds.","version":"0.1.0","contact":{}},"tags":[{"name":"actors","description":"Members of a community (actors): create or upsert them from your own user ids, read, update, and delete them."},{"name":"analytics","description":"Workspace analytics across communities: totals and a daily activity series."},{"name":"assets","description":"Image and video uploads: request an upload URL, finalize, read and delete assets you attach to posts."},{"name":"bookmarks","description":"Posts a member saved for later."},{"name":"collections","description":"Named, ordered collections of posts a member curates."},{"name":"comment-reactions","description":"Reactions (like and the other reaction types) on comments."},{"name":"comments","description":"Comments and threaded replies on posts: create, read, edit, delete, and the moderation queue for comments awaiting approval."},{"name":"communities","description":"Communities in a workspace: create, read, update, delete, and the per-community settings."},{"name":"connections","description":"Integrations that connect a community to another ProductCraft product."},{"name":"conversations","description":"Direct messages: one-to-one and group conversations, their members and messages."},{"name":"conversations-admin","description":"Workspace-admin view of direct-message conversations, for moderation."},{"name":"counters","description":"Cached counts (followers, posts, reactions) for a member or a post."},{"name":"dm-reactions","description":"Reactions on direct messages."},{"name":"drafts","description":"A member's draft and scheduled posts."},{"name":"edges","description":"The social graph: follow, mute, block and restrict between members, follow requests for private members, and the lists that read them."},{"name":"export","description":"Data export: everything a member created, as one JSON document (data portability)."},{"name":"feed","description":"Feeds: a member's home timeline, a member's own posts, and the community-wide feeds."},{"name":"flags","description":"Reports: members flag posts, comments or other members for moderation."},{"name":"hashtag-follows","description":"Hashtags a member follows."},{"name":"hashtag-posts","description":"Posts carrying a hashtag."},{"name":"hashtags","description":"Hashtags used in a community: trending and lookup."},{"name":"insights","description":"Per-post and per-member engagement insights."},{"name":"lists","description":"Member lists: named lists of members a member curates, and their members."},{"name":"mentions","description":"Posts and comments that mention a member."},{"name":"moderation-admin","description":"The moderator's lane: the report queue, actions on content and members (remove, mute, suspend, ban), shadow bans and the audit log."},{"name":"muted-terms","description":"Words and phrases a member mutes from their feeds, messages and mentions."},{"name":"notification-preferences","description":"Which notifications a member receives."},{"name":"notifications","description":"A member's in-app notifications: list, mark read, unread count."},{"name":"post-reactions","description":"Reactions (like and the other reaction types) on posts."},{"name":"posts","description":"Posts: create, read, edit, delete, schedule, pin, quote, and read their reactions and reposts."},{"name":"reposts","description":"Reposts of a post."},{"name":"search","description":"Search posts, members and hashtags in a community."},{"name":"stats","description":"Social totals and a daily series for the workspace dashboard."},{"name":"stories","description":"Stories: short-lived posts that expire after 24 hours, and who viewed them."},{"name":"suggestions","description":"Suggested members to follow."},{"name":"tags","description":"Tags of members in posts, which the tagged member approves or removes."},{"name":"viewer-state","description":"The calling member's relationship to posts and members (liked, bookmarked, following) in one call."},{"name":"webhooks","description":"Webhook endpoints that receive post, comment, follow, moderation, message and media events, their delivery log and replays, at the workspace or for one community. The legacy per-community webhook routes are deprecated."}],"servers":[{"url":"https://social.productcraft.co","description":"Social API"}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"CommunityRankingWeightsDto":{"type":"object","properties":{"recency":{"type":"number","description":"Recency signal weight (exponential decay). Non-negative finite number; anything else falls back to the default.","example":1,"default":1},"engagement":{"type":"number","description":"Engagement signal weight (log-scaled comments + reactions). Non-negative finite number.","example":0.6,"default":0.6},"follow_bias":{"type":"number","description":"Follow-graph bias weight. Non-negative finite number.","example":0.4,"default":0.4},"self_boost":{"type":"number","description":"Self-author boost weight (keeps the viewer's own posts visible). Non-negative finite number.","example":0.2,"default":0.2}},"required":["recency","engagement","follow_bias","self_boost"],"x-pc-sdk-model":"CommunityRankingWeights"},"CommunityRankingSettingsDto":{"type":"object","properties":{"weights":{"description":"Per-signal weights for the ranked feed. Each key falls back to its default independently.","allOf":[{"$ref":"#/components/schemas/CommunityRankingWeightsDto"}]},"half_life_hours":{"type":"number","description":"Recency half-life in hours for the ranked feed. Strictly positive finite number.","example":24,"default":24},"candidate_window_days":{"type":"number","description":"Ranked-feed candidate window in days — posts older than this are not scored. Strictly positive finite number.","example":30,"default":30}},"required":["weights","half_life_hours","candidate_window_days"],"x-pc-sdk-model":"CommunityRankingSettings"},"CommunitySettingsDto":{"type":"object","properties":{"ranking":{"description":"Ranked-feed tuning (weights, half-life, candidate window). Read at query time by the actor feed, list feeds, and the discover feed.","allOf":[{"$ref":"#/components/schemas/CommunityRankingSettingsDto"}]},"max_comment_depth":{"type":"number","description":"Maximum comment thread depth (0 = flat). Integer 0..10; floored; out-of-bounds falls back to the default. Replying past the cap returns 409.","example":3,"default":3,"minimum":0,"maximum":10},"auto_hide_flag_threshold":{"type":"number","description":"Distinct-reporter count at which a flagged post/comment is auto-hidden. Integer 0..1000; floored. Read by the moderation flag pipeline.","example":3,"default":3,"minimum":0,"maximum":1000},"edit_window_minutes":{"type":"number","description":"Minutes after publication during which a post body/title may still be edited (`EDIT_WINDOW_EXPIRED` afterwards). Strictly positive finite number. Drafts edit freely.","example":30,"default":30},"max_group_conversation_size":{"type":"number","description":"Maximum participants in a group conversation. Integer 2..200; floored. Exceeding it returns 409 on create / member add.","example":50,"default":50,"minimum":2,"maximum":200},"max_pinned_comments":{"type":"number","description":"Maximum pinned top-level comments per post (task 012). Integer 0..100; floored. Exceeding it returns 409 `PIN_CAP_REACHED`.","example":3,"default":3,"minimum":0,"maximum":100}},"required":["ranking","max_comment_depth","auto_hide_flag_threshold","edit_window_minutes","max_group_conversation_size","max_pinned_comments"],"x-pc-sdk-model":"CommunitySettings"},"CommunityStatus":{"type":"string","enum":["active","suspended","archived"]},"CommunityResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"workspace_id":{"type":"string","format":"uuid","description":"Owning workspace UUID.","example":"11111111-1111-1111-1111-111111111111"},"app_id":{"type":"string","format":"uuid","description":"Auth app UUID this community wraps; `null` for standalone communities.","example":"33333333-3333-3333-3333-333333333333","nullable":true},"slug":{"type":"string","description":"URL-friendly community slug.","example":"my-product-community"},"display_name":{"type":"string","description":"Display name.","example":"My Product Community"},"description":{"type":"string","description":"Optional human-readable description.","example":null,"nullable":true},"settings":{"description":"Per-community settings: every key the service reads, with its default when it was never set. Unrecognized keys you stored are returned unchanged but not consumed.","example":{"max_comment_depth":3},"allOf":[{"$ref":"#/components/schemas/CommunitySettingsDto"}]},"status":{"description":"Lifecycle status.","example":"active","allOf":[{"$ref":"#/components/schemas/CommunityStatus"}]},"created_by":{"type":"string","description":"Account UUID of the creator.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","workspace_id","app_id","slug","display_name","description","settings","status","created_by","created_at","updated_at"],"x-pc-sdk-model":"Community"},"PaginationResponseDto":{"type":"object","properties":{"next_cursor":{"type":"string","description":"Opaque base64url cursor for the next page; `null` when no further pages.","example":"eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMC4wMDBaIiwiaWQiOiJiYmJiIn0","nullable":true},"has_more":{"type":"boolean","description":"`true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor. A short or empty `data` array does NOT imply the end of the list when a lane post-filters — always page until this is `false`.","example":true}},"required":["next_cursor","has_more"],"x-pc-sdk-model":"Pagination"},"CommunityListResponseDto":{"type":"object","properties":{"data":{"description":"The communities on this page.","type":"array","items":{"$ref":"#/components/schemas/CommunityResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"CommunityList"},"ErrorParamDto":{"type":"object","properties":{"param":{"type":"string","description":"Wire path of the invalid field: `email`, `items.0.display_name`.","example":"email"},"message":{"type":"string","description":"What is wrong with it; the same text as the field's entry in an array `message`.","example":"email must be an email"},"code":{"type":"string","description":"The failed rule (class-validator constraint name, e.g. `isEmail`, `isUuid`, `whitelistValidation` for a field the operation does not declare), or `invalid`.","example":"isEmail"}},"required":["param","message","code"]},"ErrorResponseDto":{"type":"object","properties":{"status_code":{"type":"number","description":"HTTP status code, same as the response status.","example":404},"statusCode":{"type":"number","description":"Deprecated alias of `status_code`, same value. Kept so existing clients keep working; read `status_code`. Error responses carry `Deprecation: true` while it is sent.","example":404,"deprecated":true},"message":{"description":"Human-readable error message. A string, or on a `VALIDATION_ERROR` an array with one message per invalid field (the same texts as `errors[].message`). Branch on `code`, not on this.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"example":"Domain not found"},"code":{"description":"Stable, machine-readable error code; branch on this, not on `message`. Always present. A route-specific code when the route defines one, otherwise the generic code for the status (`NOT_FOUND`, `VALIDATION_ERROR`, `RATE_LIMITED`, ...). Open set: accept codes you do not know. Each code is documented at https://productcraft.co/docs/errors#<code>.","example":"NOT_FOUND","allOf":[{"$ref":"#/components/schemas/SocialErrorCode"}]},"request_id":{"type":"string","description":"The request's id, same as the `X-Request-Id` response header. Quote it when contacting support.","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"req_6f1c2a9d4b7e4f0a8c3d2e1f0a9b8c7d"},"errors":{"description":"One entry per invalid request field on a `VALIDATION_ERROR`; empty on every other error.","type":"array","items":{"$ref":"#/components/schemas/ErrorParamDto"}},"details":{"type":"object","description":"Structured context for errors a client has to act on, keyed in snake_case and specific to the code (e.g. `{ fqdn, reason }` on `from_domain_not_verified`). Absent on most errors.","additionalProperties":true,"example":{"fqdn":"mail.example.com","reason":"not_verified"}}},"required":["status_code","message","code","request_id","errors"]},"CommunityRankingWeightsInputDto":{"type":"object","properties":{"recency":{"type":"number","description":"Recency signal weight (exponential decay). Non-negative finite number; anything else falls back to the default.","example":1,"default":1},"engagement":{"type":"number","description":"Engagement signal weight (log-scaled comments + reactions). Non-negative finite number.","example":0.6,"default":0.6},"follow_bias":{"type":"number","description":"Follow-graph bias weight. Non-negative finite number.","example":0.4,"default":0.4},"self_boost":{"type":"number","description":"Self-author boost weight (keeps the viewer's own posts visible). Non-negative finite number.","example":0.2,"default":0.2}}},"CommunityRankingSettingsInputDto":{"type":"object","properties":{"weights":{"description":"Per-signal weights for the ranked feed. Each key falls back to its default independently.","allOf":[{"$ref":"#/components/schemas/CommunityRankingWeightsInputDto"}]},"half_life_hours":{"type":"number","description":"Recency half-life in hours for the ranked feed. Strictly positive finite number.","example":24,"default":24},"candidate_window_days":{"type":"number","description":"Ranked-feed candidate window in days — posts older than this are not scored. Strictly positive finite number.","example":30,"default":30}}},"CommunitySettingsInputDto":{"type":"object","properties":{"ranking":{"description":"Ranked-feed tuning (weights, half-life, candidate window). Read at query time by the actor feed, list feeds, and the discover feed.","allOf":[{"$ref":"#/components/schemas/CommunityRankingSettingsInputDto"}]},"max_comment_depth":{"type":"number","description":"Maximum comment thread depth (0 = flat). Integer 0..10; floored; out-of-bounds falls back to the default. Replying past the cap returns 409.","example":3,"default":3,"minimum":0,"maximum":10},"auto_hide_flag_threshold":{"type":"number","description":"Distinct-reporter count at which a flagged post/comment is auto-hidden. Integer 0..1000; floored. Read by the moderation flag pipeline.","example":3,"default":3,"minimum":0,"maximum":1000},"edit_window_minutes":{"type":"number","description":"Minutes after publication during which a post body/title may still be edited (`EDIT_WINDOW_EXPIRED` afterwards). Strictly positive finite number. Drafts edit freely.","example":30,"default":30},"max_group_conversation_size":{"type":"number","description":"Maximum participants in a group conversation. Integer 2..200; floored. Exceeding it returns 409 on create / member add.","example":50,"default":50,"minimum":2,"maximum":200},"max_pinned_comments":{"type":"number","description":"Maximum pinned top-level comments per post (task 012). Integer 0..100; floored. Exceeding it returns 409 `PIN_CAP_REACHED`.","example":3,"default":3,"minimum":0,"maximum":100}}},"CreateCommunityDto":{"type":"object","properties":{"app_id":{"type":"string","format":"uuid","description":"Optional Auth App UUID this community wraps. When supplied, the app must be owned by the calling workspace (cross-tenant gate). Omit to create a standalone community with no Auth integration — actor identity is then managed entirely by the customer.","example":"33333333-3333-3333-3333-333333333333"},"slug":{"type":"string","description":"URL-friendly community slug. Lowercase letters, digits, and hyphens (3-64 chars).","example":"my-product-community","minLength":3,"maxLength":64},"display_name":{"type":"string","description":"Display name shown in the console and on responses.","example":"My Product Community","minLength":1,"maxLength":120},"description":{"type":"string","description":"Optional human-readable description (up to 500 chars).","example":"Where our customers post stories and threads.","maxLength":500},"settings":{"description":"Per-community settings blob. Supported keys are typed on CommunitySettingsDto; unrecognized keys are stored verbatim but not consumed.","allOf":[{"$ref":"#/components/schemas/CommunitySettingsInputDto"}]}},"required":["slug","display_name"]},"UpdateCommunityDto":{"type":"object","properties":{"display_name":{"type":"string","description":"New display name.","minLength":1,"maxLength":120},"description":{"type":"string","description":"New description; null clears it.","nullable":true,"maxLength":500},"settings":{"description":"Replaces the settings blob. Supported keys are typed on CommunitySettingsDto; unrecognized keys are stored verbatim but not consumed.","allOf":[{"$ref":"#/components/schemas/CommunitySettingsInputDto"}]},"status":{"type":"string","description":"New status. `suspended` blocks writes; `archived` makes the community read-only.","enum":["active","suspended","archived"]}}},"UpsertActorDto":{"type":"object","properties":{"external_id":{"type":"string","description":"Customer-side identifier (your user id). Idempotency key for upsert; unique per community.","example":"user_abc123","minLength":1,"maxLength":256},"display_name":{"type":"string","description":"Display name shown in feeds / mentions.","example":"Ada Lovelace","nullable":true,"maxLength":120},"avatar_url":{"type":"string","description":"Avatar URL.","example":"https://cdn.example.com/avatars/ada.png","nullable":true,"maxLength":2048},"metadata":{"type":"object","additionalProperties":true,"description":"Free-form metadata blob (e.g. plan tier, internal flags).","example":{"tier":"pro"}}},"required":["external_id"]},"BatchUpsertActorsDto":{"type":"object","properties":{"actors":{"description":"Actors to upsert, in order. 1–200 items; each item follows the single-upsert body exactly.","type":"array","items":{"$ref":"#/components/schemas/UpsertActorDto"}}},"required":["actors"]},"ActorStatus":{"type":"string","enum":["active","suspended","deleted"]},"ActorResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Social actor UUID.","example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"external_id":{"type":"string","description":"Customer-supplied stable identifier (your user id).","example":"user_abc123"},"display_name":{"type":"string","description":"Display name.","example":"Ada Lovelace","nullable":true},"avatar_url":{"type":"string","description":"Avatar URL.","example":"https://cdn.example.com/avatars/ada.png","nullable":true},"metadata":{"type":"object","additionalProperties":true,"description":"Free-form metadata blob.","example":{"tier":"pro"}},"status":{"description":"Lifecycle status. `suspended` is moderator-applied via PATCH `status=suspended`; `deleted` is soft-deletion. Shadow-banning is a separate moderation mechanism that does not change `status`.","example":"active","allOf":[{"$ref":"#/components/schemas/ActorStatus"}]},"is_private":{"type":"boolean","description":"When true, the actor is private (task 014): effective post visibility is capped at `followers` and following requires an approved follow request.","example":false},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","external_id","display_name","avatar_url","metadata","status","is_private","created_at","updated_at"],"x-pc-sdk-model":"Actor"},"BatchItemErrorDto":{"type":"object","properties":{"status_code":{"type":"number","description":"HTTP status the item would have returned standalone.","example":404},"statusCode":{"type":"number","description":"Deprecated alias of `status_code`, same value. Kept so existing clients keep working; read `status_code`. Error responses carry `Deprecation: true` while it is sent.","example":404,"deprecated":true},"message":{"type":"string","description":"Human-readable error message.","example":"Actor not found"},"code":{"type":"string","description":"Stable, machine-readable error code, when the error has one.","example":"NOT_FOUND"}},"required":["status_code","message"],"x-pc-sdk-model":"BatchItemError"},"BatchActorResultDto":{"type":"object","properties":{"index":{"type":"number","description":"Position of this result in the request array.","example":0},"success":{"type":"boolean","description":"`true` when this item was upserted; `false` when it failed (see `error`).","example":true},"actor":{"description":"The upserted actor — present on success.","allOf":[{"$ref":"#/components/schemas/ActorResponseDto"}]},"created":{"type":"boolean","description":"`true` if this item inserted a new row, `false` on an update of an existing external_id. Present on success.","example":true},"error":{"description":"The error this item would have returned as a standalone call — present on failure.","allOf":[{"$ref":"#/components/schemas/BatchItemErrorDto"}]}},"required":["index","success"],"x-pc-sdk-model":"BatchActorResult"},"BatchActorsResponseDto":{"type":"object","properties":{"data":{"description":"One result per input item, same order.","type":"array","items":{"$ref":"#/components/schemas/BatchActorResultDto"}},"succeeded":{"type":"number","description":"Count of successful items.","example":199},"failed":{"type":"number","description":"Count of failed items.","example":1}},"required":["data","succeeded","failed"],"x-pc-sdk-model":"BatchActors"},"BatchExternalIdsDto":{"type":"object","properties":{"external_ids":{"description":"external_ids to resolve, 1–200 items (POST body — 256-char ids can't ride a querystring). Duplicates are de-duplicated.","example":["user_abc123","user_def456"],"type":"array","items":{"type":"string"}}},"required":["external_ids"]},"ActorsByExternalBatchResponseDto":{"type":"object","properties":{"data":{"description":"Actors found, in request order (after de-duplication).","type":"array","items":{"$ref":"#/components/schemas/ActorResponseDto"}},"missing":{"description":"external_ids with no actor in this community.","example":["user_ghost"],"type":"array","items":{"type":"string"}}},"required":["data","missing"],"x-pc-sdk-model":"ActorsByExternalBatch"},"UpsertActorResponseDto":{"type":"object","properties":{"actor":{"$ref":"#/components/schemas/ActorResponseDto"},"created":{"type":"boolean","description":"`true` on first call (row was inserted), `false` on subsequent upserts that updated an existing row.","example":true}},"required":["actor","created"],"x-pc-sdk-model":"UpsertActor"},"ActorPageResponseDto":{"type":"object","properties":{"data":{"description":"The actors on this page.","type":"array","items":{"$ref":"#/components/schemas/ActorResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ActorPage"},"UpdateActorDto":{"type":"object","properties":{"display_name":{"type":"string","description":"New display name; null clears it.","nullable":true,"maxLength":120},"avatar_url":{"type":"string","description":"New avatar URL; null clears it.","nullable":true,"maxLength":2048},"metadata":{"type":"object","additionalProperties":true,"description":"Your own key/value data for the actor. Replaces the stored object; keys are kept exactly as sent."},"status":{"type":"string","description":"New status.","enum":["active","suspended","deleted"]},"is_private":{"type":"boolean","description":"Make the actor private (task 014). Caps effective post visibility at `followers`; following requires an approved request. Flipping back to public auto-approves pending requests."}}},"PostSettingsInputDto":{"type":"object","properties":{"comments":{"type":"string","description":"Who may comment. `everyone` (default), `followers`, `mentioned`, or `off` (author only).","enum":["everyone","followers","mentioned","off"]},"hide_reaction_counts":{"type":"boolean","description":"Suppress reaction_counts for everyone except the author. Default false."},"allow_repost":{"type":"boolean","description":"Allow this post to be reposted. Default true."},"allow_quote":{"type":"boolean","description":"Allow this post to be quoted. Default true."}}},"AssetAttachmentInputDto":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","description":"An uploaded asset UUID (status must be `ready`).","example":"eeeeeeee-0000-0000-0000-000000000001"},"alt_text":{"type":"string","description":"Per-attachment alt text (≤1000 chars).","maxLength":1000}},"required":["asset_id"]},"CreatePostDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID who authors the post (returned from POST /actors).","example":"aaaaaaaa-0000-0000-0000-000000000001"},"kind":{"type":"string","description":"Post kind. Free-form short label; common values: text, link, image, story.","example":"text","maxLength":64},"title":{"type":"string","description":"Optional title (1-240 chars).","example":"Shipping Phase 8","nullable":true,"maxLength":240},"body":{"type":"string","description":"Body markdown / plain text (up to 50000 chars).","example":"Stories are live!","nullable":true,"maxLength":50000},"url":{"type":"string","description":"Optional URL (for link / image kinds).","example":"https://cdn.example.com/img.png","nullable":true,"maxLength":2048},"attributes":{"type":"object","additionalProperties":true,"description":"Free-form attributes blob. Polls live here at `attributes.poll`.","example":{"media_url":"https://cdn.example.com/stories/1.jpg"}},"visibility":{"type":"string","description":"Visibility scope. Defaults to `public`.","enum":["public","followers","close_friends","private"],"example":"public"},"expires_at":{"type":"string","format":"date-time","description":"ISO-8601 expiry timestamp. Used by stories (24h disappearing).","example":"2026-05-02T12:00:00Z","nullable":true},"status":{"type":"string","description":"Initial status. Defaults to `published`. Pass `draft` to save unpublished; pass `scheduled` with a future `scheduled_for` to defer publication. Scheduled posts are invisible to everyone except the author until the per-minute scheduler promotes them.","enum":["published","draft","scheduled"]},"scheduled_for":{"type":"string","description":"Required when status='scheduled'. ISO timestamp at least 30 seconds in the future. The PostSchedulerCron promotes scheduled posts to published once now() >= scheduled_for.","nullable":true},"source_post_id":{"type":"string","format":"uuid","description":"For `kind='quote'` ONLY: the source post being quoted. Reposts use the dedicated POST /posts/:post_id/repost route instead. Validation: when `kind='quote'`, both `source_post_id` and a non-empty `body` are required.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"settings":{"description":"Per-post interaction settings (comment policy, hide reaction counts, allow repost/quote). Omitted keys default to the open shape. Enforced server-side.","allOf":[{"$ref":"#/components/schemas/PostSettingsInputDto"}]},"tags":{"description":"Actor UUIDs to tag in the post (task 011). Each lands as a pending tag the actor approves. Non-actors and blocked pairs are skipped. Max 30.","example":["aaaaaaaa-0000-0000-0000-000000000002"],"type":"array","items":{"type":"string"}},"assets":{"description":"Ordered image attachments (task 019). Each references a `ready` asset in this community owned by the author. Max 20.","type":"array","items":{"$ref":"#/components/schemas/AssetAttachmentInputDto"}}},"required":["actor_id"],"oneOf":[{"title":"Title","description":"A post with a title (a body and a url are optional).","type":"object","properties":{"title":{"type":"string","minLength":1}},"required":["title"]},{"title":"Body","description":"A post without a title, with a body (a url is optional).","type":"object","properties":{"title":{"type":"string","nullable":true,"enum":[null]},"body":{"type":"string","minLength":1}},"required":["body"]},{"title":"URL","description":"A post with only a url.","type":"object","properties":{"title":{"type":"string","nullable":true,"enum":[null]},"body":{"type":"string","nullable":true,"enum":[null]},"url":{"type":"string","minLength":1}},"required":["url"]}]},"PostVisibility":{"type":"string","enum":["public","followers","close_friends","private"]},"PostStatus":{"type":"string","enum":["published","hidden","removed","draft","scheduled","archived"]},"CommentPolicy":{"type":"string","enum":["everyone","followers","mentioned","off"]},"PostSettingsDto":{"type":"object","properties":{"comments":{"description":"Who may comment. `everyone` (default), `followers`, `mentioned` (actors mentioned in the post body), or `off` (author only). Enforced server-side on comment create.","example":"everyone","allOf":[{"$ref":"#/components/schemas/CommentPolicy"}]},"hide_reaction_counts":{"type":"boolean","description":"When true, `reaction_counts` is suppressed (emitted as `{}`) for everyone except the post author, on every read surface.","example":false},"allow_repost":{"type":"boolean","description":"When false, reposting this post is refused (422 REPOST_NOT_ALLOWED).","example":true},"allow_quote":{"type":"boolean","description":"When false, quoting this post (kind='quote') is refused (422 QUOTE_NOT_ALLOWED).","example":true}},"required":["comments","hide_reaction_counts","allow_repost","allow_quote"],"x-pc-sdk-model":"PostSettings"},"AssetAttachmentDto":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","description":"The attached asset UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"alt_text":{"type":"string","description":"Per-attachment alt text for accessibility; null when unset.","nullable":true,"example":"A golden retriever on a beach"}},"required":["asset_id","alt_text"],"x-pc-sdk-model":"AssetAttachment"},"PostResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Post UUID.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"actor_id":{"type":"string","format":"uuid","description":"Author actor UUID.","example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"},"kind":{"type":"string","description":"Free-form post kind. Common: text, link, image, story, repost, quote.","example":"text"},"title":{"type":"string","description":"Optional title (1-240 chars).","example":"Shipping Phase 8","nullable":true},"body":{"type":"string","description":"Body markdown / plain text (up to 50000 chars).","example":"Stories are live!","nullable":true},"url":{"type":"string","description":"Optional URL.","example":"https://cdn.example.com/img.png","nullable":true},"attributes":{"type":"object","additionalProperties":true,"description":"Free-form attributes blob (polls live at `attributes.poll`).","example":{}},"visibility":{"description":"Visibility scope.","example":"public","allOf":[{"$ref":"#/components/schemas/PostVisibility"}]},"status":{"description":"Lifecycle status. Public list/feed surfaces only return `published`; `draft`, `scheduled`, and `archived` rows surface exclusively on their author-scoped listings and author reads. `removed` rows are hidden from reads. `archived` keeps engagement but is author-only.","example":"published","allOf":[{"$ref":"#/components/schemas/PostStatus"}]},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Map of reaction type to count, denormalised on the post row for cheap feed reads.","example":{"like":12,"fire":3}},"comment_count":{"type":"number","description":"Comment count, denormalised on the post row.","example":4},"source_post_id":{"type":"string","format":"uuid","description":"For kind='repost' / 'quote': the source post UUID.","example":null,"nullable":true},"repost_count":{"type":"number","description":"Denormalised count of currently-published reposts.","example":0},"quote_count":{"type":"number","description":"Denormalised count of currently-published quote posts.","example":0},"edited_at":{"type":"string","format":"date-time","description":"ISO timestamp of the most recent edit (body/title/attributes change). Null when never edited.","example":null,"nullable":true},"edit_count":{"type":"number","description":"Number of edits applied; equals the count of post_revision rows.","example":0},"view_count":{"type":"number","description":"Denormalised impression count, bumped via the batch POST /posts/views endpoint.","example":0},"expires_at":{"type":"string","format":"date-time","description":"ISO timestamp; `null` = no expiry. Stories typically set this 24h ahead.","example":null,"nullable":true},"pinned":{"type":"boolean","description":"When `true`, surfaces in the author's highlights endpoint regardless of expiry.","example":false},"settings":{"description":"Typed per-post interaction settings (comment policy, count hiding, repost/quote permission). Enforced server-side.","allOf":[{"$ref":"#/components/schemas/PostSettingsDto"}]},"scheduled_for":{"type":"string","description":"ISO publish-at timestamp, set while status='scheduled'. The scheduler cron promotes the post to published and clears this field; a manual PATCH promotion leaves the last value in place unless the caller also passes scheduled_for: null.","example":null,"nullable":true},"assets":{"description":"Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id.","type":"array","items":{"$ref":"#/components/schemas/AssetAttachmentDto"}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","actor_id","kind","title","body","url","attributes","visibility","status","reaction_counts","comment_count","source_post_id","repost_count","quote_count","edited_at","edit_count","view_count","expires_at","pinned","settings","scheduled_for","assets","created_at","updated_at"],"x-pc-sdk-model":"Post"},"PostListResponseDto":{"type":"object","properties":{"data":{"description":"The posts on this page.","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"PostList"},"UpdatePostDto":{"type":"object","properties":{"title":{"type":"string","description":"Updated title.","nullable":true,"maxLength":240},"body":{"type":"string","description":"Updated body.","nullable":true,"maxLength":50000},"url":{"type":"string","description":"Updated URL.","nullable":true,"maxLength":2048},"attributes":{"type":"object","additionalProperties":true,"description":"Replaces the attributes blob entirely."},"visibility":{"type":"string","description":"Who can see the post.","enum":["public","followers","close_friends","private"]},"status":{"type":"string","description":"Direct status transition. Pass `published` to promote a `draft`/`scheduled` or restore an `archived` post; pass `archived` to hide-without-deleting (engagement kept). Prefer the moderation lane for `hidden`/`removed`.","enum":["published","hidden","removed","draft","scheduled","archived"]},"expires_at":{"type":"string","format":"date-time","description":"ISO-8601 expiry timestamp; pass null to clear.","nullable":true},"scheduled_for":{"type":"string","description":"ISO-8601 publish-at timestamp. Updating only valid while the post is `status=\"scheduled\"`. Pass null to clear (typically only the scheduler does this on promotion).","nullable":true},"pinned":{"type":"boolean","description":"Toggle pinned status (used by highlights / stories)."},"settings":{"description":"Partial update of the per-post interaction settings. Only the keys you pass change; the rest keep their current value.","allOf":[{"$ref":"#/components/schemas/PostSettingsInputDto"}]},"tags":{"description":"Additional actor UUIDs to tag (task 011). Additive — creates new pending tags; never resets existing approved/removed tags. Max 30.","example":["aaaaaaaa-0000-0000-0000-000000000002"],"type":"array","items":{"type":"string"}}}},"PostRevisionResponseDto":{"type":"object","properties":{"post_id":{"type":"string","format":"uuid","description":"Post UUID this revision belongs to.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"revision_n":{"type":"number","description":"Revision sequence number (1 = first edit).","example":1},"body":{"type":"string","description":"Body text BEFORE this edit landed.","example":"shipping today.","nullable":true},"title":{"type":"string","description":"Title BEFORE this edit landed.","example":"Phase 8","nullable":true},"attributes":{"type":"object","additionalProperties":true,"description":"Attributes BEFORE this edit landed.","example":{}},"edited_at":{"type":"string","format":"date-time","description":"ISO timestamp the edit landed.","example":"2026-05-01T12:15:00.000Z"}},"required":["post_id","revision_n","body","title","attributes","edited_at"],"x-pc-sdk-model":"PostRevision"},"PostRevisionListResponseDto":{"type":"object","properties":{"data":{"description":"The post's earlier revisions on this page, newest first.","type":"array","items":{"$ref":"#/components/schemas/PostRevisionResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"PostRevisionList"},"RecordViewsDto":{"type":"object","properties":{"post_ids":{"description":"UUIDs of posts that became visible to the viewer in this batch. Capped at 200 to keep the payload sensible — the server will silently skip ids that aren't in the community or have been removed.","example":["bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","cccccccc-cccc-cccc-cccc-cccccccccccc"],"type":"array","items":{"type":"string"}},"actor_id":{"type":"string","format":"uuid","description":"The acting actor (the viewer). When present, the impressions count toward the post's unique reach (deduped per viewer per day); omit for anonymous views, which count total views but not reach.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"viewer_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"}},"required":["post_ids"]},"DraftListResponseDto":{"type":"object","properties":{"data":{"description":"Draft post rows — status is always 'draft' on this endpoint.","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"DraftList"},"CreateRepostDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Reposting actor UUID — the customer-backend supplies the end-user identity here.","example":"aaaaaaaa-0000-0000-0000-000000000001"}},"required":["actor_id"]},"CreateRepostResponseDto":{"type":"object","properties":{"repost":{"description":"The newly-created (or existing) repost post row.","allOf":[{"$ref":"#/components/schemas/PostResponseDto"}]},"source":{"description":"The source post, with refreshed `repost_count`.","allOf":[{"$ref":"#/components/schemas/PostResponseDto"}]},"created":{"type":"boolean","description":"`true` on first call; `false` on idempotent retry of an existing repost.","example":true}},"required":["repost","source","created"],"x-pc-sdk-model":"CreateRepost"},"RepostListResponseDto":{"type":"object","properties":{"data":{"description":"Page of repost post rows, each carrying the reposting actor_id.","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"RepostList"},"AssetStatus":{"type":"string","enum":["uploading","processing","ready","failed"]},"AssetUploadMethod":{"type":"string","enum":["PUT"]},"AssetUploadDto":{"type":"object","properties":{"url":{"type":"string","description":"Presigned PUT URL — upload the raw bytes here.","example":"https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…"},"method":{"description":"The HTTP method to upload with.","example":"PUT","allOf":[{"$ref":"#/components/schemas/AssetUploadMethod"}]},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Headers the PUT must carry — they are bound into the signature. Keys arrive lowercase (HTTP header names are case-insensitive).","example":{"content-type":"video/mp4","content-length":"10485760"}},"expires_at":{"type":"string","format":"date-time","description":"Signature expiry — finish the PUT before this.","example":"2026-05-01T12:15:00.000Z"}},"required":["url","method","headers","expires_at"],"x-pc-sdk-model":"AssetUpload"},"UploadAssetResponseDto":{"type":"object","properties":{"id":{"type":"string","description":"Id of the new asset; attach it to posts, comments or messages once it is `ready`.","format":"uuid","example":"eeeeeeee-0000-0000-0000-000000000001"},"status":{"description":"`ready` when the bytes were sent inline; `uploading` until you PUT the bytes to `upload.url` (then call complete); `processing` while a video transcodes; `failed` on error.","example":"ready","allOf":[{"$ref":"#/components/schemas/AssetStatus"}]},"upload":{"description":"Present only on video creation — PUT the bytes here, then POST /assets/:id/complete.","allOf":[{"$ref":"#/components/schemas/AssetUploadDto"}]}},"required":["id","status"],"x-pc-sdk-model":"UploadAsset"},"AssetKind":{"type":"string","enum":["image","video"]},"AssetRenditionName":{"type":"string","enum":["original","medium","thumb","video","poster"]},"AssetRenditionDto":{"type":"object","properties":{"name":{"description":"Ladder rung — original/medium/thumb for images, original/video/poster for videos.","example":"medium","allOf":[{"$ref":"#/components/schemas/AssetRenditionName"}]},"url":{"type":"string","description":"Short-lived presigned GET URL (re-minted each read).","example":"https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…"},"content_type":{"type":"string","description":"MIME type of this rendition.","example":"image/jpeg"},"width":{"type":"number","nullable":true,"description":"Null on the un-probed video original.","example":1280},"height":{"type":"number","nullable":true,"description":"Null on the un-probed video original.","example":960},"byte_size":{"type":"number","description":"Size of this rendition in bytes.","example":184320}},"required":["name","url","content_type","width","height","byte_size"],"x-pc-sdk-model":"AssetRendition"},"AssetResponseDto":{"type":"object","properties":{"id":{"type":"string","description":"Id of the asset.","format":"uuid","example":"eeeeeeee-0000-0000-0000-000000000001"},"community_id":{"type":"string","description":"Id of the community the asset belongs to.","format":"uuid","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"owner_actor_id":{"type":"string","description":"The actor that uploaded the asset (only they can attach it).","format":"uuid","example":"aaaaaaaa-0000-0000-0000-000000000001"},"kind":{"description":"`image` or `video`.","example":"image","allOf":[{"$ref":"#/components/schemas/AssetKind"}]},"status":{"description":"Videos: uploading → processing → ready | failed. Images never enter 'uploading'.","example":"ready","allOf":[{"$ref":"#/components/schemas/AssetStatus"}]},"content_type":{"type":"string","description":"MIME type of the original upload.","example":"image/jpeg"},"byte_size":{"type":"number","description":"Size of the original upload in bytes.","example":512000},"width":{"type":"number","description":"Width of the original in pixels; null until a video is probed.","nullable":true,"example":3024},"height":{"type":"number","description":"Height of the original in pixels; null until a video is probed.","nullable":true,"example":4032},"duration_s":{"type":"number","nullable":true,"description":"Output duration in seconds — ready videos only.","example":12.48},"failure_reason":{"type":"string","nullable":true,"description":"Stable code when status='failed' — ASSET_TOO_LARGE, ASSET_INVALID_CONTAINER, ASSET_DURATION_EXCEEDED, ASSET_TRANSCODE_FAILED, ASSET_PROCESSING_FAILED.","example":null},"renditions":{"description":"The sizes you can display, each with a short-lived URL. Empty until the asset is `ready`.","type":"array","items":{"$ref":"#/components/schemas/AssetRenditionDto"}},"created_at":{"type":"string","description":"When the asset was created.","format":"date-time","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","description":"When the asset last changed (status or renditions).","format":"date-time","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","owner_actor_id","kind","status","content_type","byte_size","width","height","duration_s","failure_reason","renditions","created_at","updated_at"],"x-pc-sdk-model":"Asset"},"AssetListResponseDto":{"type":"object","properties":{"data":{"description":"The assets on this page, newest first.","type":"array","items":{"$ref":"#/components/schemas/AssetResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"AssetList"},"ActorCountersResponseDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Actor UUID.","example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"follower_count":{"type":"number","description":"How many actors follow this actor.","example":42},"following_count":{"type":"number","description":"How many actors this actor follows.","example":17},"post_count":{"type":"number","description":"Published posts authored by this actor.","example":5},"comment_count":{"type":"number","description":"Published comments authored by this actor.","example":12},"blocks_count":{"type":"number","description":"Actors this actor has blocked.","example":0},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last counter update.","example":"2026-05-01T12:00:00.000Z"}},"required":["actor_id","community_id","follower_count","following_count","post_count","comment_count","blocks_count","updated_at"],"x-pc-sdk-model":"ActorCounters"},"BatchCountersResponseDto":{"type":"object","properties":{"data":{"description":"Counters for each actor found, in `actor_ids` order (after de-duplication).","type":"array","items":{"$ref":"#/components/schemas/ActorCountersResponseDto"}},"missing":{"description":"actor_ids with no actor in this community.","example":[],"type":"array","items":{"type":"string"}}},"required":["data","missing"],"x-pc-sdk-model":"BatchCounters"},"CommunityAnalyticsResponseDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"Community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"total_actors":{"type":"number","description":"Active actor rows count.","example":1234},"total_posts":{"type":"number","description":"Posts where status='published'.","example":5678},"total_comments":{"type":"number","description":"Comments where status='published'.","example":9876},"total_open_flags":{"type":"number","description":"Flags where status='open'.","example":3},"posts_last_7d":{"type":"number","description":"Posts created in the last 7 days (any status).","example":42},"comments_last_7d":{"type":"number","description":"Comments created in the last 7 days (any status).","example":88},"actors_last_7d":{"type":"number","description":"Actors created in the last 7 days.","example":12},"computed_at":{"type":"string","format":"date-time","description":"ISO timestamp this rollup was computed at.","example":"2026-05-01T12:00:00.000Z"}},"required":["community_id","total_actors","total_posts","total_comments","total_open_flags","posts_last_7d","comments_last_7d","actors_last_7d","computed_at"],"x-pc-sdk-model":"CommunityAnalytics"},"ActorEdgeDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Acting social actor UUID (the one performing the follow / mute / block / restrict). Standardized name (task 008 / G11).","example":"aaaaaaaa-0000-0000-0000-000000000001"},"dst_actor_id":{"type":"string","format":"uuid","description":"Destination social actor UUID (the one being followed / muted / blocked / restricted).","example":"aaaaaaaa-0000-0000-0000-000000000002"},"payload":{"type":"object","additionalProperties":true,"description":"Optional free-form payload stored on the edge (e.g. mute reason)."}},"required":["actor_id","dst_actor_id"]},"BatchFollowsDto":{"type":"object","properties":{"follows":{"description":"Follow edges to create, in order. 1–200 items; each item follows the single-follow body exactly.","type":"array","items":{"$ref":"#/components/schemas/ActorEdgeDto"}},"suppress_notifications":{"type":"boolean","description":"Import lane: when `true`, the per-item `edge.follow.created` fan-out (follow notifications AND webhooks) is skipped for this batch. Follower/following counters still update. Use when importing an existing graph so long-standing followers don't get \"X followed you\" notifications.","default":false,"example":true}},"required":["follows"]},"EdgeKind":{"type":"string","enum":["follow","mute","block","restrict"]},"EdgeResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Edge UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"kind":{"description":"Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.","example":"follow","allOf":[{"$ref":"#/components/schemas/EdgeKind"}]},"src_actor_id":{"type":"string","format":"uuid","description":"Source actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"dst_actor_id":{"type":"string","format":"uuid","description":"Destination actor UUID (for actor edges).","example":"aaaaaaaa-0000-0000-0000-000000000002","nullable":true},"dst_post_id":{"type":"string","format":"uuid","description":"Destination post UUID (for reaction / save edges).","example":null,"nullable":true},"payload":{"type":"object","additionalProperties":true,"description":"Free-form payload stored on the edge (e.g. mute reason).","example":{}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the edge was created.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","kind","src_actor_id","dst_actor_id","dst_post_id","payload","created_at"],"x-pc-sdk-model":"Edge"},"BatchFollowResultDto":{"type":"object","properties":{"index":{"type":"number","description":"Position of this result in the request array.","example":0},"success":{"type":"boolean","description":"`true` when this follow was created (or already existed); `false` when it failed (see `error`).","example":true},"edge":{"description":"The follow edge — present on success.","allOf":[{"$ref":"#/components/schemas/EdgeResponseDto"}]},"created":{"type":"boolean","description":"`true` if this item created a new edge, `false` on an idempotent retry of an existing follow. Present on success.","example":true},"error":{"description":"The error this item would have returned as a standalone call (e.g. 409 block in place, 422 self-follow, 404 unknown actor) — present on failure.","allOf":[{"$ref":"#/components/schemas/BatchItemErrorDto"}]}},"required":["index","success"],"x-pc-sdk-model":"BatchFollowResult"},"BatchFollowsResponseDto":{"type":"object","properties":{"data":{"description":"One result per input item, same order.","type":"array","items":{"$ref":"#/components/schemas/BatchFollowResultDto"}},"succeeded":{"type":"number","description":"Count of successful items.","example":4999},"failed":{"type":"number","description":"Count of failed items.","example":1}},"required":["data","succeeded","failed"],"x-pc-sdk-model":"BatchFollows"},"FollowStatus":{"type":"string","enum":["followed","pending"]},"FollowResultDto":{"type":"object","properties":{"status":{"description":"`followed` = an edge exists; `pending` = a follow request was created (private dst).","example":"followed","allOf":[{"$ref":"#/components/schemas/FollowStatus"}]},"edge":{"nullable":true,"description":"The follow edge when `status=followed`; null when `pending`.","allOf":[{"$ref":"#/components/schemas/EdgeResponseDto"}]},"created":{"type":"boolean","description":"`true` if the edge / request was created on this call; `false` on idempotent retry.","example":true}},"required":["status","edge","created"],"x-pc-sdk-model":"FollowResult"},"CreateEdgeResponseDto":{"type":"object","properties":{"edge":{"$ref":"#/components/schemas/EdgeResponseDto"},"created":{"type":"boolean","description":"`true` if the edge was created on this call; `false` on idempotent retry of an existing edge.","example":true}},"required":["edge","created"],"x-pc-sdk-model":"CreateEdge"},"FollowRequestEntryDto":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid","description":"Follow request UUID.","example":"ffffffff-1111-0000-0000-000000000001"},"src_actor_id":{"type":"string","format":"uuid","description":"Requesting actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"src_external_id":{"type":"string","description":"Requesting actor's external_id.","example":"bob"},"src_display_name":{"type":"string","description":"Requesting actor display name.","example":"Bob","nullable":true},"src_avatar_url":{"type":"string","description":"Requesting actor avatar URL.","example":null,"nullable":true},"created_at":{"type":"string","format":"date-time","description":"When the request was created.","example":"2026-05-01T12:00:00.000Z"}},"required":["request_id","src_actor_id","src_external_id","src_display_name","src_avatar_url","created_at"],"x-pc-sdk-model":"FollowRequestEntry"},"FollowRequestListResponseDto":{"type":"object","properties":{"data":{"description":"The pending follow requests on this page.","type":"array","items":{"$ref":"#/components/schemas/FollowRequestEntryDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"FollowRequestList"},"OutboundEdgeResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Edge UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"kind":{"description":"Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.","example":"follow","allOf":[{"$ref":"#/components/schemas/EdgeKind"}]},"src_actor_id":{"type":"string","format":"uuid","description":"Source actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"dst_actor_id":{"type":"string","format":"uuid","description":"Destination actor UUID (for actor edges).","example":"aaaaaaaa-0000-0000-0000-000000000002","nullable":true},"dst_post_id":{"type":"string","format":"uuid","description":"Destination post UUID (for reaction / save edges).","example":null,"nullable":true},"payload":{"type":"object","additionalProperties":true,"description":"Free-form payload stored on the edge (e.g. mute reason).","example":{}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the edge was created.","example":"2026-05-01T12:00:00.000Z"},"dst_actor":{"description":"The destination actor's full row. Present only when requested via `?expand=dst_actor`.","allOf":[{"$ref":"#/components/schemas/ActorResponseDto"}]}},"required":["id","community_id","kind","src_actor_id","dst_actor_id","dst_post_id","payload","created_at"],"x-pc-sdk-model":"OutboundEdge"},"OutboundEdgeListResponseDto":{"type":"object","properties":{"data":{"description":"The actors this actor follows, mutes, blocks or restricts, on this page.","type":"array","items":{"$ref":"#/components/schemas/OutboundEdgeResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"OutboundEdgeList"},"FollowerEdgeResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Edge UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"kind":{"description":"Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.","example":"follow","allOf":[{"$ref":"#/components/schemas/EdgeKind"}]},"src_actor_id":{"type":"string","format":"uuid","description":"Source actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"dst_actor_id":{"type":"string","format":"uuid","description":"Destination actor UUID (for actor edges).","example":"aaaaaaaa-0000-0000-0000-000000000002","nullable":true},"dst_post_id":{"type":"string","format":"uuid","description":"Destination post UUID (for reaction / save edges).","example":null,"nullable":true},"payload":{"type":"object","additionalProperties":true,"description":"Free-form payload stored on the edge (e.g. mute reason).","example":{}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the edge was created.","example":"2026-05-01T12:00:00.000Z"},"src_actor":{"description":"The follower's full actor row. Present only when requested via `?expand=src_actor`.","allOf":[{"$ref":"#/components/schemas/ActorResponseDto"}]}},"required":["id","community_id","kind","src_actor_id","dst_actor_id","dst_post_id","payload","created_at"],"x-pc-sdk-model":"FollowerEdge"},"FollowerEdgeListResponseDto":{"type":"object","properties":{"data":{"description":"The actors following this actor, on this page.","type":"array","items":{"$ref":"#/components/schemas/FollowerEdgeResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"FollowerEdgeList"},"HidePostDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The actor hiding the post.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"post_id":{"type":"string","format":"uuid","description":"The post to hide.","example":"bbbbbbbb-0000-0000-0000-000000000001"}},"required":["actor_id","post_id"]},"HideResultDto":{"type":"object","properties":{"created":{"type":"boolean","description":"`true` if the hide was created on this call; `false` on idempotent retry.","example":true}},"required":["created"],"x-pc-sdk-model":"HideResult"},"HideEntryDto":{"type":"object","properties":{"post_id":{"type":"string","format":"uuid","description":"The hidden post UUID.","example":"bbbbbbbb-0000-0000-0000-000000000001"},"created_at":{"type":"string","format":"date-time","description":"When the post was hidden.","example":"2026-05-01T12:00:00.000Z"}},"required":["post_id","created_at"],"x-pc-sdk-model":"HideEntry"},"HideListResponseDto":{"type":"object","properties":{"data":{"description":"The posts this actor has hidden, on this page.","type":"array","items":{"$ref":"#/components/schemas/HideEntryDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"HideList"},"RelationshipEntryDto":{"type":"object","properties":{"dst_actor_id":{"type":"string","format":"uuid","description":"Destination actor UUID this entry describes.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"following":{"type":"boolean","description":"The source actor follows this actor.","example":true},"followed_by":{"type":"boolean","description":"This actor follows the source actor.","example":false},"muting":{"type":"boolean","description":"The source actor has muted this actor.","example":false},"blocking":{"type":"boolean","description":"The source actor has blocked this actor.","example":false},"blocked_by":{"type":"boolean","description":"This actor has blocked the source actor — surface it BEFORE attempting a follow/react write instead of handling the 409.","example":false},"restricting":{"type":"boolean","description":"The source actor has restricted this actor.","example":false},"close_friend":{"type":"boolean","description":"This actor is on the source actor's close-friend list.","example":false},"follow_pending":{"type":"boolean","description":"The source actor has a pending follow request against this (private) actor (task 014).","example":false}},"required":["dst_actor_id","following","followed_by","muting","blocking","blocked_by","restricting","close_friend","follow_pending"],"x-pc-sdk-model":"RelationshipEntry"},"RelationshipListResponseDto":{"type":"object","properties":{"data":{"description":"One entry per requested id (de-duplicated, request order). Unknown ids resolve to all-false flags.","type":"array","items":{"$ref":"#/components/schemas/RelationshipEntryDto"}}},"required":["data"],"x-pc-sdk-model":"RelationshipList"},"ConnectionRequestDto":{"type":"object","properties":{"src_actor_id":{"type":"string","format":"uuid","description":"Requesting actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"dst_actor_id":{"type":"string","format":"uuid","description":"Actor being invited to connect.","example":"aaaaaaaa-0000-0000-0000-000000000002"}},"required":["src_actor_id","dst_actor_id"]},"ConnectionStatus":{"type":"string","enum":["pending","connected"]},"ConnectionResultDto":{"type":"object","properties":{"status":{"description":"'pending' — a connection request now awaits the destination's accept. 'connected' — both follow edges exist.","allOf":[{"$ref":"#/components/schemas/ConnectionStatus"}]},"created":{"type":"boolean","description":"False when the call was an idempotent replay."}},"required":["status","created"],"x-pc-sdk-model":"ConnectionResult"},"HashtagResponseDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"tag":{"type":"string","description":"Lowercase tag (1..32 chars from [a-z0-9_]).","example":"storymode"},"first_used_at":{"type":"string","format":"date-time","description":"ISO timestamp the tag first appeared in this community.","example":"2026-05-01T12:00:00.000Z"},"window_post_count":{"type":"number","description":"Published posts using the tag inside the trending window; non-null only when `order=trending` (task 023).","nullable":true,"example":null}},"required":["community_id","tag","first_used_at","window_post_count"],"x-pc-sdk-model":"Hashtag"},"HashtagListResponseDto":{"type":"object","properties":{"data":{"description":"The hashtags on this page.","type":"array","items":{"$ref":"#/components/schemas/HashtagResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"HashtagList"},"HashtagDetailResponseDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"tag":{"type":"string","description":"Lowercase tag (1..32 chars from [a-z0-9_]).","example":"storymode"},"first_used_at":{"type":"string","format":"date-time","description":"ISO timestamp the tag first appeared in this community.","example":"2026-05-01T12:00:00.000Z"},"window_post_count":{"type":"number","description":"Published posts using the tag inside the trending window; non-null only when `order=trending` (task 023).","nullable":true,"example":null},"post_count":{"type":"number","description":"Number of currently-published posts using the tag.","example":17}},"required":["community_id","tag","first_used_at","window_post_count","post_count"],"x-pc-sdk-model":"HashtagDetail"},"HashtagAutocompleteResponseDto":{"type":"object","properties":{"data":{"description":"Hashtags starting with the prefix, most used first.","type":"array","items":{"$ref":"#/components/schemas/HashtagResponseDto"}},"pagination":{"nullable":true,"description":"Always `null` — autocomplete returns a single bounded, ranked page (no cursor). Present for envelope consistency (task 008 / G13).","allOf":[{"$ref":"#/components/schemas/PaginationResponseDto"}]}},"required":["data","pagination"],"x-pc-sdk-model":"HashtagAutocomplete"},"CreateHashtagFollowDto":{"type":"object","properties":{"tag":{"type":"string","description":"Lowercase tag (without `#`). Must already exist in the community directory.","example":"storymode","minLength":1,"maxLength":32}},"required":["tag"]},"HashtagFollowResponseDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"tag":{"type":"string","description":"Lowercase tag (without `#`).","example":"storymode"},"followed_at":{"type":"string","format":"date-time","description":"ISO timestamp the follow was created.","example":"2026-05-01T12:00:00.000Z"}},"required":["actor_id","community_id","tag","followed_at"],"x-pc-sdk-model":"HashtagFollow"},"HashtagFollowListResponseDto":{"type":"object","properties":{"data":{"description":"The hashtags this actor follows, on this page.","type":"array","items":{"$ref":"#/components/schemas/HashtagFollowResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"HashtagFollowList"},"InsightsDailyBucketDto":{"type":"object","properties":{"day":{"type":"string","format":"date","description":"ISO date (YYYY-MM-DD).","example":"2026-05-01"},"views":{"type":"number","description":"Total impressions that day (repeats + anonymous).","example":340},"reach":{"type":"number","description":"Distinct viewers that day.","example":210}},"required":["day","views","reach"],"x-pc-sdk-model":"InsightsDailyBucket"},"PostInsightsResponseDto":{"type":"object","properties":{"post_id":{"type":"string","description":"Id of the post.","format":"uuid","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"community_id":{"type":"string","description":"Id of the community the post belongs to.","format":"uuid","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"views":{"type":"number","description":"All-time total impressions.","example":4820},"unique_reach":{"type":"number","description":"All-time distinct viewers.","example":3110},"reaction_count":{"type":"number","description":"All-time reactions on the post.","example":128},"comment_count":{"type":"number","description":"All-time published comments on the post.","example":34},"repost_count":{"type":"number","description":"All-time reposts of the post.","example":9},"quote_count":{"type":"number","description":"All-time quote posts of the post.","example":4},"daily":{"description":"Per-day counts in the requested window, oldest first.","type":"array","items":{"$ref":"#/components/schemas/InsightsDailyBucketDto"}}},"required":["post_id","community_id","views","unique_reach","reaction_count","comment_count","repost_count","quote_count","daily"],"x-pc-sdk-model":"PostInsights"},"ActorFollowerPointDto":{"type":"object","properties":{"day":{"type":"string","description":"The UTC day.","format":"date","example":"2026-05-01"},"follower_count":{"type":"number","description":"Followers at the end of that day.","example":1240}},"required":["day","follower_count"],"x-pc-sdk-model":"ActorFollowerPoint"},"ActorInsightsResponseDto":{"type":"object","properties":{"actor_id":{"type":"string","description":"Id of the actor.","format":"uuid","example":"aaaaaaaa-0000-0000-0000-000000000001"},"community_id":{"type":"string","description":"Id of the community the actor belongs to.","format":"uuid","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"follower_count":{"type":"number","description":"Live follower count.","example":1240},"daily":{"description":"Follower count per day in the requested window, oldest first.","type":"array","items":{"$ref":"#/components/schemas/ActorFollowerPointDto"}}},"required":["actor_id","community_id","follower_count","daily"],"x-pc-sdk-model":"ActorInsights"},"ActingActorDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The actor performing the action (approve: the tagged actor; remove: the tagged actor or the post author).","example":"aaaaaaaa-0000-0000-0000-000000000002"}},"required":["actor_id"]},"PostTagState":{"type":"string","enum":["pending","approved","removed"]},"PostTagResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Tag UUID.","example":"ffffffff-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"post_id":{"type":"string","format":"uuid","description":"Tagged post UUID.","example":"bbbbbbbb-0000-0000-0000-000000000001"},"tagged_actor_id":{"type":"string","format":"uuid","description":"Tagged actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"state":{"description":"Lifecycle state.","example":"approved","allOf":[{"$ref":"#/components/schemas/PostTagState"}]},"metadata":{"type":"object","additionalProperties":true,"description":"Opaque customer-defined metadata blob.","nullable":true,"example":null},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the tag was created.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last state change.","example":"2026-05-01T12:05:00.000Z"}},"required":["id","community_id","post_id","tagged_actor_id","state","metadata","created_at","updated_at"],"x-pc-sdk-model":"PostTag"},"TaggedPostsResponse":{"type":"object","properties":{"data":{"description":"The posts this actor is tagged in, on this page.","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"TaggedPostsResponse"},"CreateCommentDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID who authors the comment.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"body":{"type":"string","description":"Comment body (1-10000 chars after trim).","example":"Looks great, shipping today.","minLength":1,"maxLength":10000},"parent_id":{"type":"string","format":"uuid","description":"Parent comment UUID for replies. Omit for a top-level comment.","example":"bbbbbbbb-0000-0000-0000-000000000001","nullable":true},"visibility":{"type":"string","description":"Visibility scope. `author_only` = DM-style (post author + comment author only).","enum":["public","author_only"],"example":"public"},"assets":{"description":"Ordered image attachments (task 019). Each references a `ready` asset in this community owned by the author. Max 20.","type":"array","items":{"$ref":"#/components/schemas/AssetAttachmentInputDto"}}},"required":["actor_id","body"]},"CommentStatus":{"type":"string","enum":["published","hidden","removed","pending_approval"]},"CommentVisibility":{"type":"string","enum":["public","author_only"]},"CommentResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment UUID.","example":"bbbbbbbb-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"post_id":{"type":"string","format":"uuid","description":"Post the comment threads under.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"parent_id":{"type":"string","format":"uuid","description":"Parent comment UUID for replies; `null` for top-level.","example":null,"nullable":true},"actor_id":{"type":"string","format":"uuid","description":"Comment author actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"body":{"type":"string","description":"Comment body.","example":"Looks great, shipping today."},"depth":{"type":"number","description":"Thread depth — 0 for top-level, 1 for first reply, etc. Capped per community.","example":0},"status":{"description":"Lifecycle status. `pending_approval` = held by restricted-commenter pre-moderation; list endpoints surface these rows only to the comment author and the post-author (who publishes them via POST :commentId/approve). `removed` rows are hidden from public reads.","example":"published","allOf":[{"$ref":"#/components/schemas/CommentStatus"}]},"visibility":{"description":"`public` (default) is visible to anyone who can read the post; `author_only` is DM-style (post-author + comment-author only).","example":"public","allOf":[{"$ref":"#/components/schemas/CommentVisibility"}]},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Map of reaction type to count, denormalised on the comment row in lock-step with the comment-reaction writes.","example":{"like":2}},"pinned":{"type":"boolean","description":"True when the post author has pinned this top-level comment (task 012). Pinned comments lead the top-level listing.","example":false},"pinned_at":{"type":"string","format":"date-time","description":"ISO timestamp the comment was pinned; null when not pinned.","example":null,"nullable":true},"assets":{"description":"Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id.","type":"array","items":{"$ref":"#/components/schemas/AssetAttachmentDto"}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","post_id","parent_id","actor_id","body","depth","status","visibility","reaction_counts","pinned","pinned_at","assets","created_at","updated_at"],"x-pc-sdk-model":"Comment"},"CommentListResponseDto":{"type":"object","properties":{"data":{"description":"The comments on this page.","type":"array","items":{"$ref":"#/components/schemas/CommentResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"CommentList"},"UpdateCommentDto":{"type":"object","properties":{"body":{"type":"string","description":"Updated body.","minLength":1,"maxLength":10000},"status":{"type":"string","description":"Direct status transition. Prefer the moderation lane for `hidden`/`removed`.","enum":["published","hidden","removed"]},"visibility":{"type":"string","description":"`public`, or `author_only` to hide it from everyone but its author.","enum":["public","author_only"]}}},"ApproveCommentDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor; must be the post author. Send it, or the deprecated `approver_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"approver_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"}}},"PinCommentDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor — must equal the post.actor_id (task 012).","example":"aaaaaaaa-0000-0000-0000-000000000001"}},"required":["actor_id"]},"CreateCommentReactionDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Reactor actor UUID. Standardized name (task 008 / G11).","example":"aaaaaaaa-0000-0000-0000-000000000001"},"type":{"type":"string","description":"Reaction type (free-form short label, e.g. `like`, `fire`, `heart`).","example":"like","minLength":1,"maxLength":64}},"required":["actor_id","type"]},"CommentReactionEntryDto":{"type":"object","properties":{"comment_id":{"type":"string","format":"uuid","description":"Comment UUID.","example":"bbbbbbbb-0000-0000-0000-000000000001"},"actor_id":{"type":"string","format":"uuid","description":"Reactor actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"type":{"type":"string","description":"Reaction type label.","example":"like"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["comment_id","actor_id","community_id","type","created_at"],"x-pc-sdk-model":"CommentReactionEntry"},"AddCommentReactionResponseDto":{"type":"object","properties":{"reaction":{"$ref":"#/components/schemas/CommentReactionEntryDto"},"created":{"type":"boolean","description":"`true` on first call; `false` on idempotent retry.","example":true},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Live denormalised counts on the comment after this write.","example":{"like":4}}},"required":["reaction","created","reaction_counts"],"x-pc-sdk-model":"AddCommentReaction"},"CommentReactionCountsResponseDto":{"type":"object","properties":{"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Live denormalised counts after the delete (or current counts if the reaction was already absent).","example":{"like":3}}},"required":["reaction_counts"],"x-pc-sdk-model":"CommentReactionCounts"},"CommentReactionListResponseDto":{"type":"object","properties":{"data":{"description":"The reactions on this page.","type":"array","items":{"$ref":"#/components/schemas/CommentReactionEntryDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"CommentReactionList"},"CreateMutedTermDto":{"type":"object","properties":{"term":{"type":"string","description":"Term to mute. 1..200 chars after trim.","minLength":1,"maxLength":200,"example":"spoiler"},"scope":{"type":"string","description":"Default `all`.","enum":["feed","dm","mention","all"]},"action":{"type":"string","description":"What matching does. `mute` (default) or `pending_approval` (task 015).","enum":["mute","pending_approval"]},"expires_at":{"type":"string","format":"date-time","description":"Optional expiry (ISO timestamp in the future).","nullable":true}},"required":["term"]},"MutedTermScope":{"type":"string","enum":["feed","dm","mention","all"]},"MutedTermAction":{"type":"string","enum":["mute","pending_approval"]},"MutedTermResponseDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Owning actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"term":{"type":"string","description":"Case-insensitive substring.","example":"spoiler"},"scope":{"description":"Where the mute applies.","example":"all","allOf":[{"$ref":"#/components/schemas/MutedTermScope"}]},"action":{"description":"What matching does (task 015). `mute` = feed-filter only; `pending_approval` = hold a stranger's comment on your post for review.","example":"mute","allOf":[{"$ref":"#/components/schemas/MutedTermAction"}]},"expires_at":{"type":"string","format":"date-time","description":"ISO timestamp; null = never expires.","example":null,"nullable":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["actor_id","community_id","term","scope","action","expires_at","created_at"],"x-pc-sdk-model":"MutedTerm"},"MutedTermListResponseDto":{"type":"object","properties":{"data":{"description":"The muted terms on this page.","type":"array","items":{"$ref":"#/components/schemas/MutedTermResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"MutedTermList"},"FeedResponseDto":{"type":"object","properties":{"data":{"description":"The feed's posts on this page.","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"description":"Cursor encodes `(score, id)` for `ranked` feeds and `(created_at, id)` for `chronological` feeds. Cursors are NOT interchangeable between modes.","allOf":[{"$ref":"#/components/schemas/PaginationResponseDto"}]}},"required":["data","pagination"],"x-pc-sdk-model":"Feed"},"CreateActorListDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor, who owns the new list. Send it, or the deprecated `owner_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"owner_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"Display name (1..200).","minLength":1,"maxLength":200,"example":"Tech news"},"description":{"type":"string","description":"Optional description (0..2000).","maxLength":2000,"nullable":true},"visibility":{"type":"string","description":"Default `private`.","enum":["public","private"],"example":"public"}},"required":["name"]},"ActorListVisibility":{"type":"string","enum":["public","private"]},"ActorListResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"List UUID.","example":"11111111-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"owner_id":{"type":"string","format":"uuid","description":"List owner — social actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"List display name.","example":"Tech news"},"description":{"type":"string","description":"Optional description.","example":"Curated tech accounts I follow.","nullable":true},"visibility":{"description":"public = discoverable; private = owner-only.","example":"public","allOf":[{"$ref":"#/components/schemas/ActorListVisibility"}]},"member_count":{"type":"number","description":"Current member count.","example":12},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","owner_id","name","description","visibility","member_count","created_at","updated_at"],"x-pc-sdk-model":"ActorList"},"ActorListListResponseDto":{"type":"object","properties":{"data":{"description":"The member lists on this page.","type":"array","items":{"$ref":"#/components/schemas/ActorListResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ActorListList"},"UpdateActorListDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor; must be the list owner. Send it, or the deprecated `caller_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"New name.","minLength":1,"maxLength":200},"description":{"type":"string","description":"New description.","maxLength":2000,"nullable":true},"visibility":{"type":"string","description":"New visibility.","enum":["public","private"]}}},"AddListMemberDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor (the list owner). In the deprecated shape that sends `caller_actor_id`, this is the actor being added.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"member_actor_id":{"type":"string","format":"uuid","description":"The actor being added. Required unless you send the deprecated `caller_actor_id` shape.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated: the caller in the old shape (`caller_actor_id` + `actor_id` as the member). Send `actor_id` + `member_actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"}},"required":["actor_id"]},"ActorListMemberResponseDto":{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","description":"Owning list UUID.","example":"11111111-0000-0000-0000-000000000001"},"actor_id":{"type":"string","format":"uuid","description":"Member actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"added_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["list_id","actor_id","community_id","added_at"],"x-pc-sdk-model":"ActorListMember"},"ActorListMemberListResponseDto":{"type":"object","properties":{"data":{"description":"The list's members on this page.","type":"array","items":{"$ref":"#/components/schemas/ActorListMemberResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ActorListMemberList"},"CreateFlagDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor, who is reporting the content. Send it, or the deprecated `reporter_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"reporter_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"target_kind":{"type":"string","description":"What kind of object is being flagged (task 017 adds actor + direct_message). A direct_message flag requires the reporter to be a participant in the conversation.","enum":["post","comment","actor","direct_message"],"example":"post"},"target_id":{"type":"string","format":"uuid","description":"UUID of the target (post / comment / actor / message id per target_kind).","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"reason":{"type":"string","description":"Optional free-form reason (up to 1000 chars).","example":"Spam — same link posted 6 times in 5 minutes.","maxLength":1000}},"required":["target_kind","target_id"]},"ModerationTargetKind":{"type":"string","enum":["post","comment","actor","direct_message"]},"ActorSummaryDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Social actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"display_name":{"type":"string","description":"Actor display name. Null when the actor never set one — render the id, not an empty string.","nullable":true,"example":"Alice Nguyen"},"avatar_url":{"type":"string","description":"Avatar URL. May be a presigned URL that expires (~15 min), so treat a load failure as normal and fall back to initials.","nullable":true,"example":"https://cdn.productcraft.co/actors/aaaa.png"},"status":{"type":"string","description":"Actor lifecycle status.","example":"active"}},"required":["id","display_name","avatar_url","status"],"x-pc-sdk-model":"ActorSummary"},"FlagStatus":{"type":"string","enum":["open","dismissed","actioned"]},"FlagResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Flag UUID.","example":"ffffffff-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"target_kind":{"description":"What kind of object is being flagged.","example":"post","allOf":[{"$ref":"#/components/schemas/ModerationTargetKind"}]},"target_id":{"type":"string","format":"uuid","description":"UUID of the post or comment being flagged.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"reporter_actor_id":{"type":"string","format":"uuid","description":"Social actor UUID who reported.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"reporter_actor":{"description":"Identity of the reporting actor, joined server-side so a moderation queue can show a person rather than a UUID. Null when that actor has since been deleted — the flag outlives the account that raised it.","nullable":true,"allOf":[{"$ref":"#/components/schemas/ActorSummaryDto"}]},"reason":{"type":"string","description":"Free-text reason; empty string when none provided.","example":"Spam — same link posted 6 times in 5 minutes."},"status":{"description":"Lifecycle. `open` is in the queue; admins close to `dismissed` or `actioned`.","example":"open","allOf":[{"$ref":"#/components/schemas/FlagStatus"}]},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","target_kind","target_id","reporter_actor_id","reporter_actor","reason","status","created_at","updated_at"],"x-pc-sdk-model":"Flag"},"CreateFlagResponseDto":{"type":"object","properties":{"flag":{"description":"The flag row (existing open flag on de-duplicated retry).","allOf":[{"$ref":"#/components/schemas/FlagResponseDto"}]},"created":{"type":"boolean","description":"`true` when this call inserted a new flag; `false` when de-duplicated to an existing open flag from the same reporter on the same target.","example":true},"auto_hidden":{"type":"boolean","description":"`true` when this flag pushed the target over the community's `auto_hide_flag_threshold` and the target was auto-hidden as a side effect.","example":false}},"required":["flag","created","auto_hidden"],"x-pc-sdk-model":"CreateFlag"},"FlagListResponseDto":{"type":"object","properties":{"data":{"description":"The reports on this page.","type":"array","items":{"$ref":"#/components/schemas/FlagResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"FlagList"},"ModerationActionDto":{"type":"object","properties":{"action":{"type":"string","description":"Action to apply. `hide`/`remove` transition target status; `unhide`/`restore` reverse them. `warn`/`ban` are audit-only — they record the decision without touching the target; for actor-level enforcement use PATCH `/actors/:actor_id` with `status=suspended` or the shadow-ban endpoints on this controller. `dismiss` closes the flag with no target change.","enum":["hide","remove","warn","ban","dismiss","unhide","restore"],"example":"hide"},"notes":{"type":"string","description":"Optional moderator notes attached to the audit row (up to 2000 chars).","example":"Spam confirmed by manual review.","maxLength":2000}},"required":["action"]},"ModerationActionType":{"type":"string","enum":["hide","remove","warn","ban","dismiss","unhide","restore"]},"ModerationActionResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Action UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"flag_id":{"type":"string","format":"uuid","description":"Flag UUID this action was applied to.","example":"ffffffff-0000-0000-0000-000000000001","nullable":true},"target_kind":{"description":"What the action targeted.","example":"post","allOf":[{"$ref":"#/components/schemas/ModerationTargetKind"}]},"target_id":{"type":"string","format":"uuid","description":"UUID of the post, comment, actor or message acted on. Null when that target has since been deleted — the record of a moderator's decision outlives the content it was about.","nullable":true,"example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"moderator_account_id":{"type":"string","format":"uuid","description":"PlatformUser account UUID of the moderator.","example":"99999999-0000-0000-0000-000000000001"},"action":{"description":"Action applied.","example":"hide","allOf":[{"$ref":"#/components/schemas/ModerationActionType"}]},"notes":{"type":"string","description":"Optional moderator notes.","example":"Spam confirmed.","nullable":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the action was recorded.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","flag_id","target_kind","target_id","moderator_account_id","action","notes","created_at"],"x-pc-sdk-model":"ModerationAction"},"ActOnFlagResponseDto":{"type":"object","properties":{"flag":{"description":"The flag after the action (status flipped to actioned/dismissed for punitive/dismiss actions; reversals re-resolve it too).","allOf":[{"$ref":"#/components/schemas/FlagResponseDto"}]},"moderation_action":{"description":"The audit row this action recorded.","allOf":[{"$ref":"#/components/schemas/ModerationActionResponseDto"}]}},"required":["flag","moderation_action"],"x-pc-sdk-model":"ActOnFlag"},"DirectModerationActionDto":{"type":"object","properties":{"target_kind":{"type":"string","description":"What the action targets (task 017). post/comment → status transition; direct_message → moderator soft-delete; actor → ban=suspend / restore=reinstate.","enum":["post","comment","actor","direct_message"],"example":"direct_message"},"target_id":{"type":"string","format":"uuid","description":"The target UUID (post/comment/actor/message id per target_kind).","example":"bbbbbbbb-0000-0000-0000-000000000001"},"action":{"type":"string","description":"Action. hide/remove act on the target; ban/restore suspend/reinstate an actor; warn is audit-only. The audit row has flag_id=null (unsolicited action).","enum":["hide","remove","warn","ban","dismiss","unhide","restore"],"example":"remove"},"notes":{"type":"string","description":"Optional moderator notes (up to 2000 chars).","maxLength":2000}},"required":["target_kind","target_id","action"]},"AuditListResponseDto":{"type":"object","properties":{"data":{"description":"The moderation actions on this page, newest first.","type":"array","items":{"$ref":"#/components/schemas/ModerationActionResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"AuditList"},"ApplyShadowBanDto":{"type":"object","properties":{"duration_hours":{"type":"number","description":"Hours until auto-restore. Omit for indefinite.","nullable":true,"example":168},"reason":{"type":"string","description":"Moderator note (1..1000 chars).","nullable":true,"maxLength":1000}}},"ModerationActorResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Social actor UUID.","example":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"external_id":{"type":"string","description":"Customer-supplied stable identifier (your user id).","example":"user_abc123"},"display_name":{"type":"string","description":"Display name.","example":"Ada Lovelace","nullable":true},"avatar_url":{"type":"string","description":"Avatar URL.","example":"https://cdn.example.com/avatars/ada.png","nullable":true},"metadata":{"type":"object","additionalProperties":true,"description":"Free-form metadata blob.","example":{"tier":"pro"}},"status":{"description":"Lifecycle status. `suspended` is moderator-applied via PATCH `status=suspended`; `deleted` is soft-deletion. Shadow-banning is a separate moderation mechanism that does not change `status`.","example":"active","allOf":[{"$ref":"#/components/schemas/ActorStatus"}]},"is_private":{"type":"boolean","description":"When true, the actor is private (task 014): effective post visibility is capped at `followers` and following requires an approved follow request.","example":false},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update.","example":"2026-05-01T12:00:00.000Z"},"shadow_banned_at":{"type":"string","format":"date-time","description":"ISO timestamp the shadow ban was applied, or null.","nullable":true},"shadow_banned_until":{"type":"string","description":"ISO timestamp the shadow ban auto-expires, or null for indefinite.","nullable":true},"shadow_banned_reason":{"type":"string","description":"Moderator note attached to the ban.","nullable":true}},"required":["id","community_id","external_id","display_name","avatar_url","metadata","status","is_private","created_at","updated_at","shadow_banned_at","shadow_banned_until","shadow_banned_reason"],"x-pc-sdk-model":"ModerationActor"},"ModerationActorListResponseDto":{"type":"object","properties":{"data":{"description":"The actors on this page.","type":"array","items":{"$ref":"#/components/schemas/ModerationActorResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ModerationActorList"},"CreateBlockedTermDto":{"type":"object","properties":{"term":{"type":"string","description":"The word/phrase to block (case-insensitive substring). Max 128 chars.","example":"spoiler"},"action":{"type":"string","description":"What a match does. Default `hide`.","enum":["hide","pending_approval"],"example":"hide"}},"required":["term"]},"BlockedTermAction":{"type":"string","enum":["hide","pending_approval"]},"BlockedTermResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Blocked term UUID.","example":"ffffffff-2222-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"term":{"type":"string","description":"The blocked term (lowercased).","example":"spoiler"},"action":{"description":"What a match does.","example":"hide","allOf":[{"$ref":"#/components/schemas/BlockedTermAction"}]},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the term was added.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","term","action","created_at"],"x-pc-sdk-model":"BlockedTerm"},"BlockedTermListResponseDto":{"type":"object","properties":{"data":{"description":"The blocked terms on this page.","type":"array","items":{"$ref":"#/components/schemas/BlockedTermResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"BlockedTermList"},"UnreadCountResponseDto":{"type":"object","properties":{"count":{"type":"number","description":"Number of unread incoming messages across every conversation the actor participates in.","example":7}},"required":["count"],"x-pc-sdk-model":"UnreadCount"},"CreateConversationDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID opening the conversation.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"kind":{"type":"string","description":"Conversation shape. Default `direct`.","enum":["direct","group"],"example":"direct"},"recipient_actor_id":{"type":"string","format":"uuid","description":"For 1-on-1 (`kind=\"direct\"`): the other participant — social actor UUID. Required when kind=direct.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"actor_ids":{"description":"For groups (`kind=\"group\"`): initial members (excluding the creator). Required when kind=group. Capped by `community.settings.max_group_conversation_size` (default 50).","example":["aaaaaaaa-0000-0000-0000-000000000002","aaaaaaaa-0000-0000-0000-000000000003"],"type":"array","items":{"type":"string"}},"name":{"type":"string","description":"Optional group display name. Ignored for 1-on-1.","maxLength":200}},"required":["actor_id"]},"ConversationKind":{"type":"string","enum":["direct","group"]},"ConversationRole":{"type":"string","enum":["member","admin"]},"ConversationParticipantDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Participant actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"joined_at":{"type":"string","format":"date-time","description":"ISO timestamp the actor joined.","example":"2026-05-01T12:00:00.000Z"},"last_read_at":{"type":"string","format":"date-time","description":"ISO timestamp of the participant's last read marker; `null` until first /read.","example":null,"nullable":true},"muted":{"type":"boolean","description":"When true, dm_new_message notifications are suppressed indefinitely for this participant.","example":false},"muted_until":{"type":"string","description":"Timed mute (task 024): dm_new_message is suppressed while this is in the future. Additive beside `muted`; a past value is inert. Null when no timed mute.","example":null,"nullable":true},"pinned":{"type":"boolean","description":"When true, the thread is pinned to the top of this actor's inbox (task 024).","example":false},"role":{"description":"Role on this conversation. `admin` for groups can add / remove members and rename.","example":"member","allOf":[{"$ref":"#/components/schemas/ConversationRole"}]}},"required":["actor_id","joined_at","last_read_at","muted","muted_until","pinned","role"],"x-pc-sdk-model":"ConversationParticipant"},"ConversationResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Conversation UUID.","example":"11111111-2222-3333-4444-555555555555"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"kind":{"description":"Conversation shape — 1-on-1 (`direct`) or multi-participant (`group`).","example":"direct","allOf":[{"$ref":"#/components/schemas/ConversationKind"}]},"name":{"type":"string","description":"Group display name; null for 1-on-1.","example":null,"nullable":true},"created_by":{"type":"string","description":"Social actor UUID of the group founder; null for legacy / 1-on-1.","example":null,"nullable":true},"participants":{"description":"Participants, joined-at ascending.","type":"array","items":{"$ref":"#/components/schemas/ConversationParticipantDto"}},"unread_count":{"type":"number","description":"Unread messages for the requesting actor (task 024) — messages from others created after the requester's last_read_at. Embedded on list + single GET for inbox badges.","example":0},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"last_message_at":{"type":"string","format":"date-time","description":"ISO timestamp of the most recent message (or conversation create when no messages yet).","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","kind","name","created_by","participants","unread_count","created_at","updated_at","last_message_at"],"x-pc-sdk-model":"Conversation"},"AddMemberDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor (a group admin). In the deprecated shape that sends `caller_actor_id`, this is the actor being added.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"member_actor_id":{"type":"string","format":"uuid","description":"The actor being added. Required unless you send the deprecated `caller_actor_id` shape.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated: the caller in the old shape (`caller_actor_id` + `actor_id` as the member). Send `actor_id` + `member_actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"role":{"type":"string","description":"Default `member`.","enum":["member","admin"],"example":"member"}},"required":["actor_id"]},"UpdateMemberDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor making the change. Send it, or the deprecated `caller_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"role":{"type":"string","description":"Target role (admin-only). Omit to leave unchanged.","enum":["member","admin"],"example":"admin"},"muted":{"type":"boolean","description":"Mute the thread indefinitely (self-only — caller must be the path actor). Task 024/025.","example":true},"muted_until":{"type":"string","description":"Timed mute until this ISO timestamp (self-only). Pass null to clear.","nullable":true,"example":"2026-05-02T12:00:00Z"},"pinned":{"type":"boolean","description":"Pin / unpin the thread in the caller's inbox (self-only).","example":true}}},"ConversationListResponseDto":{"type":"object","properties":{"data":{"description":"The conversations on this page, most recent message first.","type":"array","items":{"$ref":"#/components/schemas/ConversationResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ConversationList"},"UpdateConversationDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The participant whose row is being updated.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"Rename a group conversation (task 025) — group-only, admin-only. The canonical rename home.","nullable":true,"maxLength":200,"example":"Weekend plans"}},"required":["actor_id"]},"DirectMessageAttachmentDto":{"type":"object","properties":{"kind":{"type":"string","description":"Attachment kind discriminator.","example":"image"},"url":{"type":"string","description":"Attachment URL.","example":"https://cdn.example/attachments/abc.png"}},"required":["kind","url"],"x-pc-sdk-model":"DirectMessageAttachment"},"SendMessageDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The sender — social actor UUID. Standardized name (task 008 / G11); the persisted `sender_id` is set from it.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"body":{"type":"string","description":"Message body. Required when `kind=\"text\"`. 1..10000 chars after trim.","maxLength":10000,"example":"Hey!"},"kind":{"type":"string","description":"Message type. Default `text`.","enum":["text","image","video","audio","system"],"example":"text"},"attachments":{"description":"Legacy URL attachments. Prefer `assets`.","type":"array","items":{"$ref":"#/components/schemas/DirectMessageAttachmentDto"}},"assets":{"description":"Ordered image attachments (task 019). Each references a `ready` asset in this community owned by the sender. Max 20.","type":"array","items":{"$ref":"#/components/schemas/AssetAttachmentInputDto"}},"reply_to_id":{"type":"string","format":"uuid","description":"Threaded inline reply target.","nullable":true}},"required":["actor_id"]},"DirectMessageKind":{"type":"string","enum":["text","image","video","audio","system"]},"DirectMessageResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Message UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"conversation_id":{"type":"string","format":"uuid","description":"Conversation UUID.","example":"11111111-2222-3333-4444-555555555555"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"sender_id":{"type":"string","format":"uuid","description":"Sender actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"kind":{"description":"Message type. `system` messages are written by the service (member added, role changed).","example":"text","allOf":[{"$ref":"#/components/schemas/DirectMessageKind"}]},"body":{"type":"string","description":"Message body. Returns `\"(deleted)\"` when soft-deleted.","example":"Hey there."},"attachments":{"description":"Legacy URL attachments. New messages attach assets (`assets`).","type":"array","items":{"$ref":"#/components/schemas/DirectMessageAttachmentDto"}},"assets":{"description":"Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id.","type":"array","items":{"$ref":"#/components/schemas/AssetAttachmentDto"}},"reply_to_id":{"type":"string","format":"uuid","description":"Threaded inline reply target.","example":null,"nullable":true},"edited_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last edit; `null` for never-edited.","example":null,"nullable":true},"deleted_at":{"type":"string","format":"date-time","description":"ISO timestamp when soft-deleted; `null` until then.","example":null,"nullable":true},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Map of reaction type to count, denormalised on the message row in lock-step with the DM-reaction writes.","example":{"like":1}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","conversation_id","community_id","sender_id","kind","body","attachments","assets","reply_to_id","edited_at","deleted_at","reaction_counts","created_at"],"x-pc-sdk-model":"DirectMessage"},"DirectMessageListResponseDto":{"type":"object","properties":{"data":{"description":"The messages on this page.","type":"array","items":{"$ref":"#/components/schemas/DirectMessageResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"DirectMessageList"},"UpdateMessageDto":{"type":"object","properties":{"body":{"type":"string","description":"Updated body.","minLength":1,"maxLength":10000,"example":"edited"},"actor_id":{"type":"string","format":"uuid","description":"The sender — must match the message's sender_id. Standardized name (task 008 / G11).","example":"aaaaaaaa-0000-0000-0000-000000000001"}},"required":["body","actor_id"]},"MarkConversationReadDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The reader — social actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"read_through":{"type":"string","description":"ISO timestamp. Messages with `created_at <= read_through` count as read. Omit to mark every message up to now().","example":"2026-05-01T12:00:00.000Z"}},"required":["actor_id"]},"ParticipantSummaryDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Participant actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"joined_at":{"type":"string","format":"date-time","description":"ISO timestamp the actor joined.","example":"2026-05-01T12:00:00.000Z"},"last_read_at":{"type":"string","format":"date-time","description":"ISO timestamp of the participant's last read marker.","example":null,"nullable":true},"muted":{"type":"boolean","description":"When true, dm_new_message notifications are suppressed for this participant.","example":false},"display_name":{"type":"string","description":"Participant display name, joined server-side so a conversation row can be labelled with people rather than UUIDs. Null when the actor set none or has been deleted.","nullable":true,"example":"Alice Nguyen"},"avatar_url":{"type":"string","description":"Participant avatar URL. May be presigned and short-lived; a load failure is normal, fall back to initials.","nullable":true,"example":"https://cdn.productcraft.co/actors/aaaa.png"}},"required":["actor_id","joined_at","last_read_at","muted","display_name","avatar_url"],"x-pc-sdk-model":"ParticipantSummary"},"ConversationAdminResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Conversation UUID.","example":"11111111-2222-3333-4444-555555555555"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"kind":{"description":"`direct` (two members) or `group`.","example":"direct","allOf":[{"$ref":"#/components/schemas/ConversationKind"}]},"name":{"type":"string","description":"Group title. Null for `direct` conversations and for untitled groups — the console labelled every group \"Group conversation\" because this was not exposed.","nullable":true,"example":"Release crew"},"participants":{"description":"The conversation's members.","type":"array","items":{"$ref":"#/components/schemas/ParticipantSummaryDto"}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"last_message_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","kind","name","participants","created_at","updated_at","last_message_at"],"x-pc-sdk-model":"ConversationAdmin"},"ConversationAdminListResponseDto":{"type":"object","properties":{"data":{"description":"The conversations on this page.","type":"array","items":{"$ref":"#/components/schemas/ConversationAdminResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ConversationAdminList"},"DirectMessageAdminResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Message UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"conversation_id":{"type":"string","format":"uuid","description":"Conversation UUID.","example":"11111111-2222-3333-4444-555555555555"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"sender_id":{"type":"string","format":"uuid","description":"Sender actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"sender":{"description":"Identity of the sending actor, joined server-side so a moderated timeline shows a person rather than a truncated UUID. Null when the actor has been deleted — the message outlives the account.","nullable":true,"allOf":[{"$ref":"#/components/schemas/ActorSummaryDto"}]},"kind":{"description":"Message type. `system` messages are written by the service.","example":"text","allOf":[{"$ref":"#/components/schemas/DirectMessageKind"}]},"body":{"type":"string","description":"Message body. Returns `\"(deleted)\"` when soft-deleted.","example":"Hey there."},"attachments":{"type":"object","additionalProperties":true,"description":"Attachments.","example":[]},"assets":{"type":"object","additionalProperties":true,"description":"Ordered image attachments (task 019); ref-only.","example":[]},"reply_to_id":{"type":"string","format":"uuid","description":"Threaded inline reply target.","example":null,"nullable":true},"edited_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last edit; `null` for never-edited.","example":null,"nullable":true},"deleted_at":{"type":"string","format":"date-time","description":"ISO timestamp when soft-deleted; `null` until then.","example":null,"nullable":true},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Map of reaction type to count, denormalised on the message row in lock-step with the DM-reaction writes.","example":{"like":1}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","conversation_id","community_id","sender_id","sender","kind","body","attachments","assets","reply_to_id","edited_at","deleted_at","reaction_counts","created_at"],"x-pc-sdk-model":"DirectMessageAdmin"},"DirectMessageAdminListResponseDto":{"type":"object","properties":{"data":{"description":"The messages on this page, removed ones included.","type":"array","items":{"$ref":"#/components/schemas/DirectMessageAdminResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"DirectMessageAdminList"},"CreateDirectMessageReactionDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The reactor — social actor UUID. Standardized name (task 008 / G11).","example":"aaaaaaaa-0000-0000-0000-000000000001"},"type":{"type":"string","description":"Reaction type (emoji or label, 1..64 chars).","minLength":1,"maxLength":64,"example":"heart"}},"required":["actor_id","type"]},"DirectMessageReactionResponseDto":{"type":"object","properties":{"message_id":{"type":"string","format":"uuid","description":"Reacted message UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"actor_id":{"type":"string","format":"uuid","description":"Reactor actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"type":{"type":"string","description":"Reaction type (emoji or label, 1..64 chars).","example":"heart"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["message_id","actor_id","community_id","type","created_at"],"x-pc-sdk-model":"DirectMessageReaction"},"DirectMessageReactionCreatedResponseDto":{"type":"object","properties":{"reaction":{"$ref":"#/components/schemas/DirectMessageReactionResponseDto"},"created":{"type":"boolean","description":"True when this call inserted the row; false on idempotent retry.","example":true},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Denormalised map of reaction type → count after the change.","example":{"heart":3,"laugh":1}}},"required":["reaction","created","reaction_counts"],"x-pc-sdk-model":"DirectMessageReactionCreated"},"DirectMessageReactionRemovedResponseDto":{"type":"object","properties":{"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Denormalised map of reaction type → count after the change.","example":{"heart":2}}},"required":["reaction_counts"],"x-pc-sdk-model":"DirectMessageReactionRemoved"},"DirectMessageReactionListResponseDto":{"type":"object","properties":{"data":{"description":"The reactions on this page.","type":"array","items":{"$ref":"#/components/schemas/DirectMessageReactionResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"DirectMessageReactionList"},"NotificationKind":{"type":"string","enum":["follow","reaction","comment_on_post","reply_to_comment","mention","vote","repost","quote_post","dm_new_message","dm_added_to_group","dm_role_changed","dm_reaction","tag","follow_request","follow_request_approved"]},"NotificationTargetKind":{"type":"string","enum":["actor","post","comment","direct_message"]},"NotificationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Notification UUID.","example":"11111111-1111-1111-1111-111111111111"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"recipient_actor_id":{"type":"string","format":"uuid","description":"Actor whose inbox this row lives in.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"kind":{"description":"What happened. Content kinds (`follow`, `reaction`, `comment_on_post`, `reply_to_comment`, `mention`, `vote`, `repost`, `quote_post`) plus the DM kinds (`dm_new_message`, `dm_added_to_group`, `dm_role_changed`, `dm_reaction`).","example":"reaction","allOf":[{"$ref":"#/components/schemas/NotificationKind"}]},"actor_id":{"type":"string","format":"uuid","description":"Actor who triggered the event. Never equals `recipient_actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"target_kind":{"description":"Switches what `target_id` references. `actor` for follow; `post` for vote / repost / quote_post / comment_on_post and post-targeted reactions/mentions; `comment` for reply_to_comment and comment-targeted reactions/mentions; `direct_message` for the dm_* kinds.","example":"post","allOf":[{"$ref":"#/components/schemas/NotificationTargetKind"}]},"target_id":{"type":"string","format":"uuid","description":"id of the actor / post / comment the event happened on.","example":"bbbbbbbb-0000-0000-0000-000000000001"},"payload":{"type":"object","additionalProperties":true,"description":"Kind-specific extras. `reaction`: `{type}` (+ `{post_id}` when the target is a comment). `comment_on_post` / `reply_to_comment`: `{comment_id}`. `mention`: `{post_id}` (+ `{comment_id}` for comment mentions).","example":{"type":"like"}},"suppressed":{"type":"boolean","description":"When `true`, the recipient has restricted the triggering actor — the row is hidden from the default `inbox` slice and surfaces on `?status=requests` (or `all`).","example":false},"read_at":{"type":"string","format":"date-time","description":"ISO timestamp; null while the row is unread.","example":null,"nullable":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the row was inserted.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","recipient_actor_id","kind","actor_id","target_kind","target_id","payload","suppressed","read_at","created_at"],"x-pc-sdk-model":"NotificationResponse"},"NotificationListResponse":{"type":"object","properties":{"data":{"description":"Page of notifications, newest first.","type":"array","items":{"$ref":"#/components/schemas/NotificationResponse"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"NotificationListResponse"},"UnreadCountResponse":{"type":"object","properties":{"count":{"type":"number","description":"Number of unread notifications for the actor.","example":7}},"required":["count"],"x-pc-sdk-model":"UnreadCountResponse"},"UpdateNotificationDto":{"type":"object","properties":{"read":{"type":"boolean","description":"`true` to mark read, `false` to mark unread.","example":true}},"required":["read"]},"MarkAllReadDto":{"type":"object","properties":{"before":{"type":"string","description":"Optional ISO timestamp; only flips rows older than this. Omit to flip all unread.","example":"2026-05-01T00:00:00.000Z"}}},"MarkAllReadResponse":{"type":"object","properties":{"updated":{"type":"number","description":"Number of rows whose `read_at` flipped from null to now().","example":12}},"required":["updated"],"x-pc-sdk-model":"MarkAllReadResponse"},"NotificationPrefResponseDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"kind":{"description":"NotificationKind this row applies to.","example":"follow","allOf":[{"$ref":"#/components/schemas/NotificationKind"}]},"enabled":{"type":"boolean","description":"When `false`, the producer silently skips notifications of this kind for this actor. Default `true`.","example":true},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp of the last update. Synthesised entries (no explicit row) report epoch.","example":"2026-05-01T12:00:00.000Z"}},"required":["actor_id","kind","enabled","updated_at"],"x-pc-sdk-model":"NotificationPref"},"NotificationPrefListResponseDto":{"type":"object","properties":{"data":{"description":"One row per known NotificationKind. Kinds the actor has not explicitly toggled report `enabled=true` and an epoch `updated_at`, so the client always sees the full catalogue with effective state.","type":"array","items":{"$ref":"#/components/schemas/NotificationPrefResponseDto"}}},"required":["data"],"x-pc-sdk-model":"NotificationPrefList"},"UpdateNotificationPrefDto":{"type":"object","properties":{"enabled":{"type":"boolean","description":"`true` to receive notifications of this kind, `false` to mute. Default behaviour (no row) is `true`.","example":false}},"required":["enabled"]},"SuggestionReason":{"type":"string","enum":["followed_by_friends","top_in_community"]},"SuggestedFollowResponseDto":{"type":"object","properties":{"actor":{"$ref":"#/components/schemas/ActorResponseDto"},"score":{"type":"number","description":"For `followed_by_friends`: number of the requester's followees who follow this candidate. For `top_in_community`: the candidate's `follower_count`.","example":4},"reason":{"description":"Why this candidate surfaced. `followed_by_friends` is the friend-of-a-friend signal; `top_in_community` is the cold-start fallback used when FoF doesn't fill the requested limit.","example":"followed_by_friends","allOf":[{"$ref":"#/components/schemas/SuggestionReason"}]}},"required":["actor","score","reason"],"x-pc-sdk-model":"SuggestedFollow"},"SuggestedFollowsListResponseDto":{"type":"object","properties":{"data":{"description":"Ordered candidates. FoF candidates are returned first (highest count first); cold-start fallbacks fill any remaining slots up to the requested limit.","type":"array","items":{"$ref":"#/components/schemas/SuggestedFollowResponseDto"}},"pagination":{"nullable":true,"description":"Always `null` — suggestions are a single bounded, scored page (no cursor in v1). Present for envelope consistency (task 008 / G13).","allOf":[{"$ref":"#/components/schemas/PaginationResponseDto"}]}},"required":["data","pagination"],"x-pc-sdk-model":"SuggestedFollowsList"},"CreateBookmarkDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID who is bookmarking — the customer-backend supplies the end-user identity here.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"collection_ids":{"description":"Optional collection UUIDs (task 020) to file this post into alongside the flat bookmark. Only the actor's own collections are written; unknown/other-owner ids are silently skipped. Max 20.","example":["99999999-0000-0000-0000-000000000001"],"type":"array","items":{"type":"string"}}},"required":["actor_id"]},"BookmarkResponseDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Social actor UUID who saved the post.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"post_id":{"type":"string","format":"uuid","description":"Saved post UUID.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the bookmark was created.","example":"2026-05-01T12:00:00.000Z"}},"required":["actor_id","post_id","community_id","created_at"],"x-pc-sdk-model":"Bookmark"},"BookmarkToggleResponseDto":{"type":"object","properties":{"bookmark":{"$ref":"#/components/schemas/BookmarkResponseDto"},"created":{"type":"boolean","description":"`true` on first call (row inserted); `false` on idempotent retry of an existing bookmark.","example":true}},"required":["bookmark","created"],"x-pc-sdk-model":"BookmarkToggle"},"BookmarkListResponseDto":{"type":"object","properties":{"data":{"description":"The bookmarks on this page, newest first.","type":"array","items":{"$ref":"#/components/schemas/BookmarkResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"BookmarkList"},"CreateCollectionDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor, who owns the new collection. Send it, or the deprecated `owner_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"owner_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"Collection name (1-200 chars).","example":"Travel"},"kind":{"type":"string","enum":["bookmark","highlight"],"description":"Default `bookmark` (owner-scoped). `highlight` is profile-public and bypasses story expiry."},"cover_asset_id":{"type":"string","description":"Cover image — a ready asset (task 019) owned by the collection owner.","format":"uuid"},"cover_url":{"type":"string","description":"Cover image URL (alternative to cover_asset_id).","maxLength":2048},"visibility":{"type":"string","enum":["public","private"],"description":"Default `private`."},"position":{"type":"number","description":"Owner-defined ordering position.","minimum":0}},"required":["name"]},"CollectionKind":{"type":"string","enum":["bookmark","highlight"]},"CollectionVisibility":{"type":"string","enum":["public","private"]},"CollectionResponseDto":{"type":"object","properties":{"id":{"type":"string","description":"Id of the collection.","format":"uuid","example":"99999999-0000-0000-0000-000000000001"},"community_id":{"type":"string","description":"Id of the community the collection belongs to.","format":"uuid","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"owner_actor_id":{"type":"string","description":"The actor that owns the collection.","format":"uuid","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"Display name.","example":"Travel"},"kind":{"description":"`bookmark` (a private folder of saved posts) or `highlight` (shown on the owner's profile; its stories never expire).","example":"bookmark","allOf":[{"$ref":"#/components/schemas/CollectionKind"}]},"cover_asset_id":{"type":"string","description":"Asset used as the cover image, if any.","format":"uuid","nullable":true,"example":null},"cover_url":{"type":"string","description":"Cover image URL, if set instead of an asset.","nullable":true,"example":null},"visibility":{"description":"`public` or `private` (owner only).","example":"private","allOf":[{"$ref":"#/components/schemas/CollectionVisibility"}]},"position":{"type":"number","description":"Owner-defined ordering position.","example":0},"item_count":{"type":"number","description":"Number of posts in the collection.","example":12},"created_at":{"type":"string","description":"When the collection was created.","format":"date-time","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","description":"When the collection last changed.","format":"date-time","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","owner_actor_id","name","kind","cover_asset_id","cover_url","visibility","position","item_count","created_at","updated_at"],"x-pc-sdk-model":"Collection"},"CollectionListResponseDto":{"type":"object","properties":{"data":{"description":"The collections on this page.","type":"array","items":{"$ref":"#/components/schemas/CollectionResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"CollectionList"},"UpdateCollectionDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor; must be the collection owner. Send it, or the deprecated `caller_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"name":{"type":"string","description":"New name (1-200 chars).","maxLength":200},"cover_asset_id":{"type":"string","description":"Asset to use as the cover image; null clears it.","format":"uuid","nullable":true},"cover_url":{"type":"string","description":"Cover image URL (alternative to cover_asset_id); null clears it.","maxLength":2048,"nullable":true},"visibility":{"type":"string","description":"`public` or `private`.","enum":["public","private"]},"position":{"type":"number","description":"New ordering position among the owner's collections.","minimum":0}}},"DeleteWithCallerDto":{"type":"object","properties":{"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated: pass `?actor_id=` instead. The caller, who must be the owner.","example":"aaaaaaaa-0000-0000-0000-000000000001"}}},"AddItemDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor; must be the collection owner. Send it, or the deprecated `caller_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"post_id":{"type":"string","format":"uuid","description":"The post to add.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"position":{"type":"number","description":"Curator ordering position.","minimum":0}},"required":["post_id"]},"CollectionItemResponseDto":{"type":"object","properties":{"collection_id":{"type":"string","description":"Id of the collection.","format":"uuid","example":"99999999-0000-0000-0000-000000000001"},"post_id":{"type":"string","description":"Id of the post in the collection.","format":"uuid","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"community_id":{"type":"string","description":"Id of the community.","format":"uuid","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"position":{"type":"number","description":"Owner-defined ordering position.","example":0},"added_at":{"type":"string","description":"When the post was added.","format":"date-time","example":"2026-05-01T12:00:00.000Z"}},"required":["collection_id","post_id","community_id","position","added_at"],"x-pc-sdk-model":"CollectionItem"},"ReorderItemDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor; must be the collection owner. Send it, or the deprecated `caller_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"caller_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"position":{"type":"number","description":"New curator position.","minimum":0,"example":3}},"required":["position"]},"CollectionItemListResponseDto":{"type":"object","properties":{"data":{"description":"The collection's posts on this page, in position order.","type":"array","items":{"$ref":"#/components/schemas/CollectionItemResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"CollectionItemList"},"MentionSource":{"type":"string","enum":["post","comment"]},"MentionEntryResponseDto":{"type":"object","properties":{"source":{"description":"Where the mention happened.","example":"post","allOf":[{"$ref":"#/components/schemas/MentionSource"}]},"source_id":{"type":"string","format":"uuid","description":"UUID of the source row — post id when source=post, comment id when source=comment.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"post_id":{"type":"string","format":"uuid","description":"Parent post UUID. Always set, including for comment mentions, so the client can deep-link.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"mentioned_id":{"type":"string","format":"uuid","description":"The actor that was mentioned.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the source row was created.","example":"2026-05-01T12:00:00.000Z"}},"required":["source","source_id","post_id","mentioned_id","created_at"],"x-pc-sdk-model":"MentionEntry"},"MentionListResponseDto":{"type":"object","properties":{"data":{"description":"Interleaved post + comment mentions, newest-first. Cursor is opaque base64url(JSON({created_at, source, source_id})).","type":"array","items":{"$ref":"#/components/schemas/MentionEntryResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"MentionList"},"ActorSearchHitDto":{"type":"object","properties":{"actor":{"$ref":"#/components/schemas/ActorResponseDto"},"rank":{"type":"number","description":"PG `ts_rank` score on the (display_name A, external_id B, bio C) tsvector. Higher = more relevant.","example":0.6079}},"required":["actor","rank"],"x-pc-sdk-model":"ActorSearchHit"},"ActorSearchResponseDto":{"type":"object","properties":{"data":{"description":"Up to `limit` (default 20, max 50) ranked hits. Not paginated in v1; results are bounded by `limit`.","type":"array","items":{"$ref":"#/components/schemas/ActorSearchHitDto"}},"pagination":{"nullable":true,"description":"Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency.","allOf":[{"$ref":"#/components/schemas/PaginationResponseDto"}]}},"required":["data","pagination"],"x-pc-sdk-model":"ActorSearch"},"PostSearchHitDto":{"type":"object","properties":{"post":{"$ref":"#/components/schemas/PostResponseDto"},"rank":{"type":"number","description":"PG ts_rank score on the (title A, body B) tsvector. Higher = more relevant. Returned even when order='recent' so clients can render a relevance badge.","example":0.6079}},"required":["post","rank"],"x-pc-sdk-model":"PostSearchHit"},"PostSearchResponseDto":{"type":"object","properties":{"data":{"description":"Up to `limit` (default 20, max 50) hits. Not paginated in v1.","type":"array","items":{"$ref":"#/components/schemas/PostSearchHitDto"}},"pagination":{"nullable":true,"description":"Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency.","allOf":[{"$ref":"#/components/schemas/PaginationResponseDto"}]}},"required":["data","pagination"],"x-pc-sdk-model":"PostSearch"},"StoryTrayEntryResponse":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Author actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"actor_external_id":{"type":"string","description":"Author's external_id.","example":"alice"},"actor_display_name":{"type":"string","description":"Author display name.","example":"Alice","nullable":true},"actor_avatar_url":{"type":"string","description":"Author avatar URL.","example":"https://...","nullable":true},"latest_story_created_at":{"type":"string","format":"date-time","description":"When the most recent unexpired-or-pinned story was created.","example":"2026-05-01T11:00:00.000Z"},"story_count":{"type":"number","description":"Total unexpired-or-pinned stories from this author.","example":3},"has_unviewed":{"type":"boolean","description":"True when the requester has not viewed the latest story.","example":true}},"required":["actor_id","actor_external_id","actor_display_name","actor_avatar_url","latest_story_created_at","story_count","has_unviewed"],"x-pc-sdk-model":"StoryTrayEntryResponse"},"StoryTrayResponse":{"type":"object","properties":{"data":{"description":"One entry per actor with live stories, on this page.","type":"array","items":{"$ref":"#/components/schemas/StoryTrayEntryResponse"}},"pagination":{"nullable":true,"description":"Always `null` — the tray is a single bounded page (≤200 entries, no cursor in v1). The key is present for envelope consistency with cursor-paginated lists (task 008 / G13).","allOf":[{"$ref":"#/components/schemas/PaginationResponseDto"}]}},"required":["data","pagination"],"x-pc-sdk-model":"StoryTrayResponse"},"HighlightsResponse":{"type":"object","properties":{"data":{"description":"Page of pinned posts (full post rows; expiry is bypassed for pinned rows).","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"HighlightsResponse"},"RecordViewDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Viewer social actor UUID. Standardized name (task 008 / G11).","example":"aaaaaaaa-0000-0000-0000-000000000002"}},"required":["actor_id"]},"StoryViewerResponse":{"type":"object","properties":{"viewer_actor_id":{"type":"string","format":"uuid","description":"Viewer actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"viewer_external_id":{"type":"string","description":"Viewer's external_id.","example":"bob"},"viewer_display_name":{"type":"string","description":"Viewer display name.","example":"Bob","nullable":true},"viewer_avatar_url":{"type":"string","description":"Viewer avatar URL.","example":"https://...","nullable":true},"viewed_at":{"type":"string","format":"date-time","description":"When the view was recorded.","example":"2026-05-01T11:30:00.000Z"}},"required":["viewer_actor_id","viewer_external_id","viewer_display_name","viewer_avatar_url","viewed_at"],"x-pc-sdk-model":"StoryViewerResponse"},"StoryViewersResponse":{"type":"object","properties":{"data":{"description":"The actors who viewed the story, on this page.","type":"array","items":{"$ref":"#/components/schemas/StoryViewerResponse"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"StoryViewersResponse"},"CreateCloseFriendDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"The acting actor, whose close-friends list this is. Send it, or the deprecated `owner_actor_id`; one of the two is required.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"owner_actor_id":{"type":"string","format":"uuid","deprecated":true,"description":"Deprecated alias of `actor_id`; send `actor_id`.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"member_actor_id":{"type":"string","format":"uuid","description":"Member social actor UUID (the actor being added).","example":"aaaaaaaa-0000-0000-0000-000000000002"}},"required":["member_actor_id"]},"CloseFriendResponse":{"type":"object","properties":{"owner_actor_id":{"type":"string","format":"uuid","description":"Owner actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"member_actor_id":{"type":"string","format":"uuid","description":"Member actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"member_external_id":{"type":"string","description":"Member's external_id.","example":"bob"},"member_display_name":{"type":"string","description":"Member display name.","example":"Bob","nullable":true},"member_avatar_url":{"type":"string","description":"Member avatar URL.","example":"https://...","nullable":true},"created_at":{"type":"string","format":"date-time","description":"When the close-friend edge was created.","example":"2026-05-01T11:00:00.000Z"}},"required":["owner_actor_id","member_actor_id","member_external_id","member_display_name","member_avatar_url","created_at"],"x-pc-sdk-model":"CloseFriendResponse"},"CloseFriendsListResponse":{"type":"object","properties":{"data":{"description":"The actor's close friends on this page.","type":"array","items":{"$ref":"#/components/schemas/CloseFriendResponse"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"CloseFriendsListResponse"},"CastVoteDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Voter social actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"option_index":{"type":"number","description":"Zero-based index into post.attributes.poll.options.","example":1}},"required":["actor_id","option_index"]},"PollResultOptionResponse":{"type":"object","properties":{"index":{"type":"number","description":"Zero-based index into the original options list.","example":0},"label":{"type":"string","description":"Option label as supplied at post creation.","example":"VS Code"},"count":{"type":"number","description":"Number of votes recorded for this option.","example":42}},"required":["index","label","count"],"x-pc-sdk-model":"PollResultOptionResponse"},"PollResultsResponse":{"type":"object","properties":{"post_id":{"type":"string","format":"uuid","description":"Post UUID the poll lives on.","example":"bbbbbbbb-0000-0000-0000-000000000001"},"question":{"type":"string","description":"Poll question, copied from post.attributes.poll.question.","example":"Best dev tool?"},"options":{"description":"Each option with its vote count.","type":"array","items":{"$ref":"#/components/schemas/PollResultOptionResponse"}},"total_votes":{"type":"number","description":"Sum of counts across every option.","example":67}},"required":["post_id","question","options","total_votes"],"x-pc-sdk-model":"PollResultsResponse"},"PollVoteResponse":{"type":"object","properties":{"option_index":{"type":"number","description":"Zero-based index of the option the actor voted for.","example":1},"created_at":{"type":"string","format":"date-time","description":"When the vote was cast (or last changed).","example":"2026-05-01T11:30:00.000Z"}},"required":["option_index","created_at"],"x-pc-sdk-model":"PollVoteResponse"},"PollVoterResponse":{"type":"object","properties":{"voter_actor_id":{"type":"string","format":"uuid","description":"Voter actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000002"},"voter_external_id":{"type":"string","description":"Voter's external_id.","example":"bob"},"voter_display_name":{"type":"string","description":"Voter display name.","example":"Bob","nullable":true},"voter_avatar_url":{"type":"string","description":"Voter avatar URL.","example":"https://...","nullable":true},"option_index":{"type":"number","description":"The option this voter chose.","example":1},"voted_at":{"type":"string","format":"date-time","description":"When the vote was cast.","example":"2026-05-01T11:30:00.000Z"}},"required":["voter_actor_id","voter_external_id","voter_display_name","voter_avatar_url","option_index","voted_at"],"x-pc-sdk-model":"PollVoterResponse"},"PollVotersResponse":{"type":"object","properties":{"data":{"description":"The voters on this page.","type":"array","items":{"$ref":"#/components/schemas/PollVoterResponse"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"PollVotersResponse"},"CreateReactionDto":{"type":"object","properties":{"actor_id":{"type":"string","format":"uuid","description":"Reactor — social actor UUID. Standardized name (task 008 / G11).","example":"aaaaaaaa-0000-0000-0000-000000000001"},"type":{"type":"string","description":"Reaction type (1..64 chars).","minLength":1,"maxLength":64,"example":"like"}},"required":["actor_id","type"]},"ReactionEdgeResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Edge UUID.","example":"eeeeeeee-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"kind":{"type":"string","description":"Edge kind (`reaction:<type>`).","example":"reaction:like"},"src_actor_id":{"type":"string","format":"uuid","description":"Reactor actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"dst_actor_id":{"type":"string","format":"uuid","description":"Destination actor UUID — always `null` for post reactions (the target is `dst_post_id`).","example":null,"nullable":true},"dst_post_id":{"type":"string","format":"uuid","description":"Target post UUID.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"payload":{"type":"object","additionalProperties":true,"description":"Free-form payload.","example":{}},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","kind","src_actor_id","dst_actor_id","dst_post_id","payload","created_at"],"x-pc-sdk-model":"ReactionEdge"},"ReactionResponseDto":{"type":"object","properties":{"edge":{"$ref":"#/components/schemas/ReactionEdgeResponseDto"},"created":{"type":"boolean","description":"`true` on first call; `false` on idempotent retry.","example":true},"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Denormalised reaction counts after the write.","example":{"like":13,"fire":3}}},"required":["edge","created","reaction_counts"],"x-pc-sdk-model":"Reaction"},"ReactionCountsResponseDto":{"type":"object","properties":{"reaction_counts":{"type":"object","additionalProperties":{"type":"integer"},"description":"Denormalised reaction counts after the write.","example":{"like":12}}},"required":["reaction_counts"],"x-pc-sdk-model":"ReactionCounts"},"PostReactionEntryDto":{"type":"object","properties":{"post_id":{"type":"string","format":"uuid","description":"Post UUID.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"actor_id":{"type":"string","format":"uuid","description":"Reactor actor UUID.","example":"aaaaaaaa-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"type":{"type":"string","description":"Reaction type label.","example":"like"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["post_id","actor_id","community_id","type","created_at"],"x-pc-sdk-model":"PostReactionEntry"},"PostReactionListResponseDto":{"type":"object","properties":{"data":{"description":"The reactions on this page.","type":"array","items":{"$ref":"#/components/schemas/PostReactionEntryDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"PostReactionList"},"PostStateRequestDto":{"type":"object","properties":{"post_ids":{"description":"UUIDs of the posts to hydrate viewer state for. Capped at 200 (matches the batch-views precedent); ids that are unknown, removed, or from another community resolve to the empty state instead of failing the batch.","example":["bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","cccccccc-cccc-cccc-cccc-cccccccccccc"],"type":"array","items":{"type":"string"}}},"required":["post_ids"]},"PostViewerStateEntryDto":{"type":"object","properties":{"post_id":{"type":"string","format":"uuid","description":"Post UUID this entry describes.","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"reacted_types":{"description":"Reaction types the viewer currently has on the post, sorted ascending. Empty when the viewer has not reacted.","example":["fire","like"],"type":"array","items":{"type":"string"}},"bookmarked":{"type":"boolean","description":"The viewer has bookmarked the post.","example":true},"reposted":{"type":"boolean","description":"The viewer has a currently-published repost of the post.","example":false},"voted_option":{"type":"number","description":"Poll option index the viewer voted for; `null` when the viewer has not voted (or the post has no poll).","example":null,"nullable":true}},"required":["post_id","reacted_types","bookmarked","reposted","voted_option"],"x-pc-sdk-model":"PostViewerStateEntry"},"PostStateResponseDto":{"type":"object","properties":{"data":{"description":"One entry per requested post id (de-duplicated, request order). Unknown / cross-community ids resolve to the empty state.","type":"array","items":{"$ref":"#/components/schemas/PostViewerStateEntryDto"}}},"required":["data"],"x-pc-sdk-model":"PostState"},"HashtagPostListResponseDto":{"type":"object","properties":{"data":{"description":"The posts carrying the hashtag, on this page.","type":"array","items":{"$ref":"#/components/schemas/PostResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"HashtagPostList"},"PostCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"post_id":{"type":"string","format":"uuid","description":"The new post.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The author.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"body":{"type":"string","description":"The post body, trimmed; null for a post without text.","nullable":true,"example":"Shipping the new onboarding today."},"source_post_id":{"type":"string","format":"uuid","nullable":true,"description":"For a quote post, the quoted post; otherwise null.","example":null},"source_post_actor_id":{"type":"string","format":"uuid","nullable":true,"description":"The quoted post's author; null when not a quote.","example":null},"status":{"description":"Status at publish time: `published`, `draft` or `scheduled`.","example":"published","allOf":[{"$ref":"#/components/schemas/PostStatus"}]},"attributes":{"type":"object","additionalProperties":true,"description":"The post's `attributes`, keys exactly as stored.","example":{"imageUrl":"https://cdn.example.com/onboarding.png"}}},"required":["community_id","post_id","actor_id","body","source_post_id","source_post_actor_id","status","attributes"],"x-pc-sdk-model":"PostCreatedEventData"},"PostUpdatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"post_id":{"type":"string","format":"uuid","description":"The edited post.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The author.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"body":{"type":"string","description":"The body after the edit; null for a post without text.","nullable":true,"example":"Shipping the new onboarding today (now with screenshots)."},"attributes":{"type":"object","additionalProperties":true,"description":"The post's `attributes` after the edit, keys exactly as stored.","example":{"imageUrl":"https://cdn.example.com/onboarding.png"}}},"required":["community_id","post_id","actor_id","body","attributes"],"x-pc-sdk-model":"PostUpdatedEventData"},"PostDeletedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"post_id":{"type":"string","format":"uuid","description":"The deleted post.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The author.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"kind":{"type":"string","description":"What was deleted: `post` or `repost`.","example":"post"},"source_post_id":{"type":"string","format":"uuid","nullable":true,"description":"For a repost, the original post; otherwise null.","example":null}},"required":["community_id","post_id","actor_id","kind","source_post_id"],"x-pc-sdk-model":"PostDeletedEventData"},"PostReactionCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"post_id":{"type":"string","format":"uuid","description":"The post reacted to.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The member who reacted.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"post_actor_id":{"type":"string","format":"uuid","description":"The post's author.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"type":{"type":"string","description":"The reaction type, e.g. `like`.","example":"like"}},"required":["community_id","post_id","actor_id","post_actor_id","type"],"x-pc-sdk-model":"PostReactionCreatedEventData"},"RepostCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"post_id":{"type":"string","format":"uuid","description":"The repost.","example":"4f506172-8394-4eaf-8c0b-2c3d4e5f6071"},"actor_id":{"type":"string","format":"uuid","description":"The member who reposted.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"source_post_id":{"type":"string","format":"uuid","description":"The original post.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"source_post_actor_id":{"type":"string","format":"uuid","description":"The original post's author.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"required":["community_id","post_id","actor_id","source_post_id","source_post_actor_id"],"x-pc-sdk-model":"RepostCreatedEventData"},"CommentCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"comment_id":{"type":"string","format":"uuid","description":"The new comment.","example":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60"},"post_id":{"type":"string","format":"uuid","description":"The post commented on.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The commenter.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"body":{"type":"string","description":"The comment body.","example":"Congrats on the launch!"},"parent_id":{"type":"string","format":"uuid","nullable":true,"description":"The comment replied to; null for a top-level comment.","example":null},"post_actor_id":{"type":"string","format":"uuid","description":"The post's author.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"parent_actor_id":{"type":"string","format":"uuid","nullable":true,"description":"The parent comment's author; null for a top-level comment.","example":null},"status":{"description":"Status at creation: `published`, or `pending_approval` when held for the post author.","example":"published","allOf":[{"$ref":"#/components/schemas/CommentStatus"}]}},"required":["community_id","comment_id","post_id","actor_id","body","parent_id","post_actor_id","parent_actor_id","status"],"x-pc-sdk-model":"CommentCreatedEventData"},"CommentUpdatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"comment_id":{"type":"string","format":"uuid","description":"The edited comment.","example":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60"},"post_id":{"type":"string","format":"uuid","description":"The post the comment is on.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The commenter.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"body":{"type":"string","description":"The body after the edit.","example":"Congrats on the launch! Great work."}},"required":["community_id","comment_id","post_id","actor_id","body"],"x-pc-sdk-model":"CommentUpdatedEventData"},"CommentDeletedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"comment_id":{"type":"string","format":"uuid","description":"The removed comment.","example":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60"},"post_id":{"type":"string","format":"uuid","description":"The post the comment was on.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The commenter.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"}},"required":["community_id","comment_id","post_id","actor_id"],"x-pc-sdk-model":"CommentDeletedEventData"},"CommentReactionCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"comment_id":{"type":"string","format":"uuid","description":"The comment reacted to.","example":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60"},"post_id":{"type":"string","format":"uuid","description":"The post the comment is on.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The member who reacted.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"comment_actor_id":{"type":"string","format":"uuid","description":"The comment's author.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"type":{"type":"string","description":"The reaction type, e.g. `like`.","example":"like"}},"required":["community_id","comment_id","post_id","actor_id","comment_actor_id","type"],"x-pc-sdk-model":"CommentReactionCreatedEventData"},"EdgeFollowCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"src_actor_id":{"type":"string","format":"uuid","description":"The follower.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"dst_actor_id":{"type":"string","format":"uuid","description":"The member followed.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"required":["community_id","src_actor_id","dst_actor_id"],"x-pc-sdk-model":"EdgeFollowCreatedEventData"},"EdgeFollowDeletedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"src_actor_id":{"type":"string","format":"uuid","description":"The member who unfollowed.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"dst_actor_id":{"type":"string","format":"uuid","description":"The member unfollowed.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"required":["community_id","src_actor_id","dst_actor_id"],"x-pc-sdk-model":"EdgeFollowDeletedEventData"},"EdgeFollowRequestedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"src_actor_id":{"type":"string","format":"uuid","description":"The member asking to follow.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"dst_actor_id":{"type":"string","format":"uuid","description":"The private member asked.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"required":["community_id","src_actor_id","dst_actor_id"],"x-pc-sdk-model":"EdgeFollowRequestedEventData"},"EdgeFollowRequestApprovedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"src_actor_id":{"type":"string","format":"uuid","description":"The member whose request was approved.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"dst_actor_id":{"type":"string","format":"uuid","description":"The private member who approved it.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"required":["community_id","src_actor_id","dst_actor_id"],"x-pc-sdk-model":"EdgeFollowRequestApprovedEventData"},"FlagCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"flag_id":{"type":"string","format":"uuid","description":"The new report.","example":"5061728a-94a5-4fb0-9d1c-3d4e5f607182"},"reporter_actor_id":{"type":"string","format":"uuid","description":"The member who reported.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"},"target_kind":{"description":"What was reported.","example":"post","allOf":[{"$ref":"#/components/schemas/ModerationTargetKind"}]},"target_id":{"type":"string","format":"uuid","description":"The reported post, comment, member or message.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"reason":{"type":"string","description":"The reason given, e.g. `spam`.","example":"spam"},"auto_hidden":{"type":"boolean","description":"True when this report tripped the auto-hide threshold and hid the content.","example":false}},"required":["community_id","flag_id","reporter_actor_id","target_kind","target_id","reason","auto_hidden"],"x-pc-sdk-model":"FlagCreatedEventData"},"FlagUpdatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"flag_id":{"type":"string","format":"uuid","description":"The report.","example":"5061728a-94a5-4fb0-9d1c-3d4e5f607182"},"status":{"description":"The new status: `actioned` or `dismissed`.","example":"actioned","allOf":[{"$ref":"#/components/schemas/FlagStatus"}]},"action":{"type":"string","description":"The moderation action that closed it; null when dismissed.","nullable":true,"example":"remove"}},"required":["community_id","flag_id","status","action"],"x-pc-sdk-model":"FlagUpdatedEventData"},"ModerationActionAppliedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"action_id":{"type":"string","format":"uuid","description":"The moderation action (an audit-log row).","example":"61728394-a5b6-40c1-ae2d-4e5f60718293"},"flag_id":{"type":"string","format":"uuid","nullable":true,"description":"The report it resolved; null for a direct action.","example":"5061728a-94a5-4fb0-9d1c-3d4e5f607182"},"action":{"description":"What the moderator did.","example":"remove","allOf":[{"$ref":"#/components/schemas/ModerationActionType"}]},"target_kind":{"description":"What the action targeted.","example":"post","allOf":[{"$ref":"#/components/schemas/ModerationTargetKind"}]},"target_id":{"type":"string","format":"uuid","description":"The post, comment, member or message.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"moderator_account_id":{"type":"string","format":"uuid","description":"The platform account of the moderator.","example":"7283a4b5-c6d7-41e2-bf3e-5f6071829304"}},"required":["community_id","action_id","flag_id","action","target_kind","target_id","moderator_account_id"],"x-pc-sdk-model":"ModerationActionAppliedEventData"},"ActorUpdatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"actor_id":{"type":"string","format":"uuid","description":"The member whose profile changed.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"external_id":{"type":"string","description":"Your own id for the member.","example":"user_42"}},"required":["community_id","actor_id","external_id"],"x-pc-sdk-model":"ActorUpdatedEventData"},"DmMessageCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"conversation_id":{"type":"string","format":"uuid","description":"The conversation.","example":"8394b5c6-d7e8-42f3-8a4f-60718293a4b5"},"message_id":{"type":"string","format":"uuid","description":"The new message.","example":"94a5c6d7-e8f9-4304-9b50-718293a4b5c6"},"sender_id":{"type":"string","format":"uuid","description":"The sender.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"kind":{"description":"Message type.","example":"text","allOf":[{"$ref":"#/components/schemas/DirectMessageKind"}]},"body":{"type":"string","description":"The message text; null for an attachment-only message.","nullable":true,"example":"See you at the meetup?"},"reply_to_id":{"type":"string","format":"uuid","nullable":true,"description":"The message replied to; null when not a reply.","example":null},"recipient_actor_ids":{"description":"Every other member of the conversation at send time, for push notifications.","example":["1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"],"type":"array","items":{"type":"string","format":"uuid"}}},"required":["community_id","conversation_id","message_id","sender_id","kind","body","reply_to_id","recipient_actor_ids"],"x-pc-sdk-model":"DmMessageCreatedEventData"},"TagCreatedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"post_id":{"type":"string","format":"uuid","description":"The post the member was tagged in.","example":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f"},"actor_id":{"type":"string","format":"uuid","description":"The post author who tagged them.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"tagged_actor_id":{"type":"string","format":"uuid","description":"The tagged member.","example":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"}},"required":["community_id","post_id","actor_id","tagged_actor_id"],"x-pc-sdk-model":"TagCreatedEventData"},"AssetReadyEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"asset_id":{"type":"string","format":"uuid","description":"The asset.","example":"a5b6d7e8-f90a-4415-8c61-8293a4b5c6d7"},"owner_actor_id":{"type":"string","format":"uuid","description":"The member who uploaded it.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"status":{"description":"The asset status after the event.","example":"ready","allOf":[{"$ref":"#/components/schemas/AssetStatus"}]},"kind":{"description":"`image` or `video`.","example":"video","allOf":[{"$ref":"#/components/schemas/AssetKind"}]}},"required":["community_id","asset_id","owner_actor_id","status","kind"],"x-pc-sdk-model":"AssetReadyEventData"},"AssetFailedEventDataDto":{"type":"object","properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in.","example":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c"},"asset_id":{"type":"string","format":"uuid","description":"The asset.","example":"a5b6d7e8-f90a-4415-8c61-8293a4b5c6d7"},"owner_actor_id":{"type":"string","format":"uuid","description":"The member who uploaded it.","example":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"},"status":{"description":"The asset status after the event.","example":"failed","allOf":[{"$ref":"#/components/schemas/AssetStatus"}]},"kind":{"description":"`image` or `video`.","example":"video","allOf":[{"$ref":"#/components/schemas/AssetKind"}]},"failure_reason":{"type":"string","description":"Why it failed (an error code such as `ASSET_TRANSCODE_FAILED`); null when unknown.","nullable":true,"example":"ASSET_TRANSCODE_FAILED"}},"required":["community_id","asset_id","owner_actor_id","status","kind","failure_reason"],"x-pc-sdk-model":"AssetFailedEventData"},"WebhookEventType":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"],"description":"Every event type this product sends; `x-webhooks` maps each to its payload schema. New types can be added, so treat it as open."},"WebhookEventTypeDto":{"type":"object","properties":{"type":{"example":"post.created","description":"The event type (one of this product's catalogue).","allOf":[{"$ref":"#/components/schemas/WebhookEventType"}]},"description":{"type":"string","example":"A user signed up or was created by an admin.","description":"When this event is sent."},"category":{"type":"string","example":"Users","description":"Group shown in the event picker."},"example":{"type":"object","additionalProperties":true,"description":"An example `data` object; \"Send test\" delivers exactly this."}},"x-pc-sdk-model":"WebhookEventTypeInfo","required":["type","description","category","example"]},"ListWebhookEventTypesResponseDto":{"type":"object","properties":{"data":{"description":"Every event type this product sends.","type":"array","items":{"$ref":"#/components/schemas/WebhookEventTypeDto"}}},"x-pc-sdk-model":"WebhookEventTypeList","x-pc-sdk-model-aliases":["ListWebhookEventTypes"],"required":["data"]},"WebhookEndpointStatus":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"WebhookEndpointDisabledReason":{"type":"string","enum":["manual","failing"]},"WebhookEndpointDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The endpoint's id."},"scope_type":{"type":"string","example":"workspace","description":"What owns the endpoint: `workspace`, `app` or `community`."},"scope_id":{"type":"string","description":"Id of the owning workspace, app or community."},"url":{"type":"string","format":"uri","example":"https://api.acme.com/webhooks","description":"Where events are sent."},"description":{"type":"string","nullable":true,"example":"Production receiver","description":"A label for people; null when unset."},"event_types":{"description":"Subscribed event types. Empty means every event, including types added later.","example":[],"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean","description":"The on/off switch (`PATCH … { enabled }`)."},"status":{"description":"`enabled` receives events. `disabled` was switched off. `auto_disabled` was switched off after 20 failed deliveries in a row or 24 hours of failures; `PATCH { enabled: true }` turns it back on.","allOf":[{"$ref":"#/components/schemas/WebhookEndpointStatus"}]},"disabled_at":{"type":"string","format":"date-time","nullable":true,"description":"When it was switched off; null while enabled."},"disabled_reason":{"nullable":true,"description":"`manual`: switched off by a caller. `failing`: switched off automatically after failed deliveries. Null while enabled.","allOf":[{"$ref":"#/components/schemas/WebhookEndpointDisabledReason"}]},"consecutive_failures":{"type":"number","description":"Failed automatic deliveries in a row; a success resets it."},"first_failure_at":{"type":"string","format":"date-time","nullable":true,"description":"Start of the current failure streak."},"signing_secret_hint":{"type":"string","description":"Last 4 characters of the signing secret.","example":"x9Q="},"prev_signing_secret_active":{"type":"boolean","description":"True while the previous secret still signs too (after a rotation, for its grace period)."},"prev_signing_secret_expires_at":{"type":"string","format":"date-time","nullable":true,"description":"Until then the previous secret signs too (after a rotation)."},"legacy_signature":{"type":"boolean","description":"True for endpoints carried over from the product's previous webhook system: they also receive the old signature header until its sunset date."},"created_at":{"type":"string","format":"date-time","description":"When the endpoint was created."},"updated_at":{"type":"string","format":"date-time","description":"When the endpoint last changed."}},"required":["id","scope_type","scope_id","url","description","event_types","enabled","status","disabled_at","disabled_reason","consecutive_failures","first_failure_at","signing_secret_hint","prev_signing_secret_active","prev_signing_secret_expires_at","legacy_signature","created_at","updated_at"],"x-pc-sdk-model":"WebhookEndpoint"},"WebhookPaginationDto":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true,"description":"Pass as `cursor` to get the next page; null on the last page."},"has_more":{"type":"boolean","description":"Whether another page follows."}},"required":["next_cursor","has_more"],"x-pc-sdk-model":"WebhookPagination"},"ListWebhookEndpointsResponseDto":{"type":"object","properties":{"data":{"description":"The endpoints, newest first.","type":"array","items":{"$ref":"#/components/schemas/WebhookEndpointDto"}},"pagination":{"description":"Always one page (an endpoint limit applies).","allOf":[{"$ref":"#/components/schemas/WebhookPaginationDto"}]}},"x-pc-sdk-model":"WebhookEndpointList","x-pc-sdk-model-aliases":["ListWebhookEndpoints"],"required":["data","pagination"]},"CreateWebhookEndpointDto":{"type":"object","properties":{"url":{"type":"string","description":"Where to send events: an absolute https:// URL on a public host.","example":"https://api.acme.com/webhooks","maxLength":2048,"format":"uri"},"description":{"type":"string","nullable":true,"maxLength":200,"example":"Production receiver","description":"A label for people."},"event_types":{"type":"array","description":"Event types from `GET …/webhooks/event-types`. Empty or omitted means every event, including types added later.","example":["post.created","post.updated"],"items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"enabled":{"type":"boolean","default":true,"example":true,"description":"Send `false` to create it switched off."}},"required":["url"]},"WebhookEndpointWithSecretDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The endpoint's id."},"scope_type":{"type":"string","example":"workspace","description":"What owns the endpoint: `workspace`, `app` or `community`."},"scope_id":{"type":"string","description":"Id of the owning workspace, app or community."},"url":{"type":"string","format":"uri","example":"https://api.acme.com/webhooks","description":"Where events are sent."},"description":{"type":"string","nullable":true,"example":"Production receiver","description":"A label for people; null when unset."},"event_types":{"description":"Subscribed event types. Empty means every event, including types added later.","example":[],"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean","description":"The on/off switch (`PATCH … { enabled }`)."},"status":{"description":"`enabled` receives events. `disabled` was switched off. `auto_disabled` was switched off after 20 failed deliveries in a row or 24 hours of failures; `PATCH { enabled: true }` turns it back on.","allOf":[{"$ref":"#/components/schemas/WebhookEndpointStatus"}]},"disabled_at":{"type":"string","format":"date-time","nullable":true,"description":"When it was switched off; null while enabled."},"disabled_reason":{"nullable":true,"description":"`manual`: switched off by a caller. `failing`: switched off automatically after failed deliveries. Null while enabled.","allOf":[{"$ref":"#/components/schemas/WebhookEndpointDisabledReason"}]},"consecutive_failures":{"type":"number","description":"Failed automatic deliveries in a row; a success resets it."},"first_failure_at":{"type":"string","format":"date-time","nullable":true,"description":"Start of the current failure streak."},"signing_secret_hint":{"type":"string","description":"Last 4 characters of the signing secret.","example":"x9Q="},"prev_signing_secret_active":{"type":"boolean","description":"True while the previous secret still signs too (after a rotation, for its grace period)."},"prev_signing_secret_expires_at":{"type":"string","format":"date-time","nullable":true,"description":"Until then the previous secret signs too (after a rotation)."},"legacy_signature":{"type":"boolean","description":"True for endpoints carried over from the product's previous webhook system: they also receive the old signature header until its sunset date."},"created_at":{"type":"string","format":"date-time","description":"When the endpoint was created."},"updated_at":{"type":"string","format":"date-time","description":"When the endpoint last changed."},"signing_secret":{"type":"string","description":"The signing secret, shown once: pass it unchanged to any Standard Webhooks verifier. Store it now; it cannot be shown again.","example":"whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"}},"required":["id","scope_type","scope_id","url","description","event_types","enabled","status","disabled_at","disabled_reason","consecutive_failures","first_failure_at","signing_secret_hint","prev_signing_secret_active","prev_signing_secret_expires_at","legacy_signature","created_at","updated_at","signing_secret"],"x-pc-sdk-model":"WebhookEndpointWithSecret"},"UpdateWebhookEndpointDto":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri","example":"https://api.acme.com/webhooks","description":"A new absolute https:// URL on a public host."},"description":{"type":"string","nullable":true,"maxLength":200,"example":"Production receiver","description":"A new label; null clears it."},"event_types":{"type":"array","description":"Replaces the subscription. Event types from `GET …/webhooks/event-types`. Empty or omitted means every event, including types added later.","example":["post.created","post.updated"],"items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"enabled":{"type":"boolean","description":"Switch it on or off. Switching on also clears an automatic disable.","example":true}}},"RotateWebhookSecretDto":{"type":"object","properties":{"grace_hours":{"type":"number","default":24,"minimum":0,"maximum":168,"description":"Hours the previous secret keeps signing too (0 ends it now).","example":24}}},"SendWebhookTestDto":{"type":"object","properties":{"event_type":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"],"description":"Which event to send; its catalogue example is the `data`.","example":"post.created"}},"required":["event_type"]},"WebhookAttemptTrigger":{"type":"string","enum":["automatic","replay","test"]},"WebhookDeliveryAttemptDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The attempt's id."},"event_id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event that was delivered."},"endpoint_id":{"type":"string","format":"uuid","description":"The endpoint it was delivered to."},"event_type":{"type":"string","example":"user.created","description":"The event's type."},"attempt_number":{"type":"number","description":"1 for the first delivery; retries and replays count up."},"trigger":{"description":"`automatic` (first delivery or a retry), `replay` or `test`.","allOf":[{"$ref":"#/components/schemas/WebhookAttemptTrigger"}]},"url":{"type":"string","format":"uri","description":"Where it was sent."},"status_code":{"type":"number","nullable":true,"description":"HTTP status; null when no response came back."},"succeeded":{"type":"boolean","description":"True for a 2xx response."},"error_message":{"type":"string","nullable":true,"example":"request timed out","description":"Why the attempt failed when no 2xx came back; null on success."},"response_body":{"type":"string","nullable":true,"description":"The first 1 KiB of the response body."},"latency_ms":{"type":"number","nullable":true,"description":"Milliseconds until the response; null when none came back."},"attempted_at":{"type":"string","format":"date-time","description":"When the attempt was made."}},"required":["id","event_id","endpoint_id","event_type","attempt_number","trigger","url","status_code","succeeded","error_message","response_body","latency_ms","attempted_at"],"x-pc-sdk-model":"WebhookDeliveryAttempt"},"WebhookEventStatus":{"type":"string","enum":["pending","delivered","failed","not_sent"]},"WebhookEventDeliveryDto":{"type":"object","properties":{"endpoint_id":{"type":"string","format":"uuid","description":"The endpoint."},"attempt_number":{"type":"number","description":"Number of the latest attempt; retries and replays count up."},"status_code":{"type":"number","nullable":true,"description":"HTTP status of the latest attempt; null when no response came back."},"succeeded":{"type":"boolean","description":"True when the latest attempt got a 2xx."},"attempted_at":{"type":"string","format":"date-time","description":"When the latest attempt was made."},"next_attempt_at":{"type":"string","format":"date-time","nullable":true,"description":"When the next automatic attempt is due; null when none is queued."}},"required":["endpoint_id","attempt_number","status_code","succeeded","attempted_at","next_attempt_at"],"x-pc-sdk-model":"WebhookEventDelivery"},"WebhookEventDto":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"Sent as `webhook-id`; the same on every retry and replay."},"type":{"example":"post.created","description":"The event type (one of this product's catalogue).","allOf":[{"$ref":"#/components/schemas/WebhookEventType"}]},"created_at":{"type":"string","format":"date-time","description":"When the event happened."},"test":{"type":"boolean","description":"Made by \"Send test\"."},"status":{"description":"`pending`: a delivery is queued. `failed`: the latest attempt to some endpoint failed and none is queued. `delivered`: every endpoint answered 2xx. `not_sent`: no endpoint subscribed.","allOf":[{"$ref":"#/components/schemas/WebhookEventStatus"}]},"payload":{"type":"object","additionalProperties":true,"description":"The JSON body exactly as sent."},"deliveries":{"description":"Latest attempt per endpoint (an endpoint whose first attempt is still queued is not listed yet).","type":"array","items":{"$ref":"#/components/schemas/WebhookEventDeliveryDto"}}},"required":["id","type","created_at","test","status","payload","deliveries"],"x-pc-sdk-model":"WebhookEvent"},"ListWebhookEventsResponseDto":{"type":"object","properties":{"data":{"description":"The events, newest first.","type":"array","items":{"$ref":"#/components/schemas/WebhookEventDto"}},"pagination":{"description":"The cursor for the next page.","allOf":[{"$ref":"#/components/schemas/WebhookPaginationDto"}]}},"x-pc-sdk-model":"WebhookEventList","x-pc-sdk-model-aliases":["ListWebhookEvents"],"required":["data","pagination"]},"WebhookEventDetailDto":{"type":"object","properties":{"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"Sent as `webhook-id`; the same on every retry and replay."},"type":{"example":"post.created","description":"The event type (one of this product's catalogue).","allOf":[{"$ref":"#/components/schemas/WebhookEventType"}]},"created_at":{"type":"string","format":"date-time","description":"When the event happened."},"test":{"type":"boolean","description":"Made by \"Send test\"."},"status":{"description":"`pending`: a delivery is queued. `failed`: the latest attempt to some endpoint failed and none is queued. `delivered`: every endpoint answered 2xx. `not_sent`: no endpoint subscribed.","allOf":[{"$ref":"#/components/schemas/WebhookEventStatus"}]},"payload":{"type":"object","additionalProperties":true,"description":"The JSON body exactly as sent."},"deliveries":{"description":"Latest attempt per endpoint (an endpoint whose first attempt is still queued is not listed yet).","type":"array","items":{"$ref":"#/components/schemas/WebhookEventDeliveryDto"}},"attempts":{"description":"Every attempt, newest first.","type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveryAttemptDto"}}},"required":["id","type","created_at","test","status","payload","deliveries","attempts"],"x-pc-sdk-model":"WebhookEventDetail"},"ReplayWebhookEventResponseDto":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","description":"The replayed event (the same id as the original)."},"attempts":{"description":"One attempt per endpoint it was sent to.","type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveryAttemptDto"}}},"x-pc-sdk-model":"WebhookEventReplay","x-pc-sdk-model-aliases":["ReplayWebhookEvent"],"required":["event_id","attempts"]},"WebhookResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Webhook UUID.","example":"dddddddd-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"url":{"type":"string","description":"Subscriber URL.","example":"https://example.com/webhooks/social"},"event_types":{"type":"array","description":"Subscribed event types. Each item is one of the social event names — see GET /v1/webhook-event-types for the live catalog.","example":["post.created","comment.created"],"items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"signing_secret_hint":{"type":"string","description":"Last 4 chars of the signing secret. Use the full secret returned by create / rotate to verify the Standard Webhooks `webhook-signature` header (or, until the sunset, the X-Pcft-Signature header).","example":"abcd"},"disabled_at":{"type":"string","format":"date-time","description":"ISO timestamp when the webhook was auto-disabled (or null if active).","example":null,"nullable":true},"disabled_reason":{"type":"string","description":"Why the webhook is off: `manual` (switched off) or `failing` (switched off automatically after 20 failures in a row or 24 h of failures). Null while it is on.","example":null,"nullable":true},"consecutive_failures":{"type":"number","description":"Consecutive failed attempts since the last success.","example":0},"last_success_at":{"type":"string","format":"date-time","description":"ISO timestamp of the most recent 2xx response.","example":null,"nullable":true},"last_failure_at":{"type":"string","format":"date-time","description":"ISO timestamp of the most recent non-2xx response.","example":null,"nullable":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","community_id","url","event_types","signing_secret_hint","disabled_at","disabled_reason","consecutive_failures","last_success_at","last_failure_at","created_at","updated_at"]},"CreateWebhookDto":{"type":"object","properties":{"url":{"type":"string","description":"Subscriber URL. Must be `https://`.","example":"https://example.com/webhooks/social"},"event_types":{"type":"array","description":"Event types to subscribe to. Unknown values are rejected with a 400 naming the valid set — see GET /v1/webhook-event-types.","example":["post.created","comment.created"],"items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}}},"required":["url","event_types"]},"CreatedWebhookResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Webhook UUID.","example":"dddddddd-0000-0000-0000-000000000001"},"community_id":{"type":"string","format":"uuid","description":"Owning community UUID.","example":"cccccccc-cccc-cccc-cccc-cccccccccccc"},"url":{"type":"string","description":"Subscriber URL.","example":"https://example.com/webhooks/social"},"event_types":{"type":"array","description":"Subscribed event types. Each item is one of the social event names — see GET /v1/webhook-event-types for the live catalog.","example":["post.created","comment.created"],"items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"signing_secret_hint":{"type":"string","description":"Last 4 chars of the signing secret. Use the full secret returned by create / rotate to verify the Standard Webhooks `webhook-signature` header (or, until the sunset, the X-Pcft-Signature header).","example":"abcd"},"disabled_at":{"type":"string","format":"date-time","description":"ISO timestamp when the webhook was auto-disabled (or null if active).","example":null,"nullable":true},"disabled_reason":{"type":"string","description":"Why the webhook is off: `manual` (switched off) or `failing` (switched off automatically after 20 failures in a row or 24 h of failures). Null while it is on.","example":null,"nullable":true},"consecutive_failures":{"type":"number","description":"Consecutive failed attempts since the last success.","example":0},"last_success_at":{"type":"string","format":"date-time","description":"ISO timestamp of the most recent 2xx response.","example":null,"nullable":true},"last_failure_at":{"type":"string","format":"date-time","description":"ISO timestamp of the most recent non-2xx response.","example":null,"nullable":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"signing_secret":{"type":"string","description":"Full plaintext HMAC signing secret. Returned ONCE — store it; subsequent reads only expose the last-4 hint.","example":"abc...xyz"}},"required":["id","community_id","url","event_types","signing_secret_hint","disabled_at","disabled_reason","consecutive_failures","last_success_at","last_failure_at","created_at","updated_at","signing_secret"]},"WebhookListResponseDto":{"type":"object","properties":{"data":{"description":"Every webhook on the community — disabled rows included, so auto-disabled subscribers stay discoverable.","type":"array","items":{"$ref":"#/components/schemas/WebhookResponseDto"}}},"required":["data"]},"UpdateWebhookDto":{"type":"object","properties":{"url":{"type":"string","description":"New subscriber URL."},"event_types":{"type":"array","description":"New subscription set. Unknown values are rejected with a 400 naming the valid set.","items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}},"disabled":{"type":"boolean","description":"Set `false` to re-enable a disabled webhook (clears the auto-disable state and resets the failure streak — no secret rotation required). Set `true` to disable it manually.","example":false}}},"DeliveryJobResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Id of the delivery attempt (shows in the deliveries list)."},"webhook_id":{"type":"string","format":"uuid","description":"Webhook UUID the job targets."},"event_id":{"type":"string","description":"Stable event id (carried in the request body as `id`; stable across retries and redelivers).","example":"evt_…"},"event_type":{"type":"string","description":"Event type that was sent.","example":"post.created"},"status":{"type":"string","description":"Job state.","enum":["pending","delivering","succeeded","exhausted","canceled"],"example":"pending"},"attempt_count":{"type":"number","description":"Delivery attempts made so far.","example":0},"next_attempt_at":{"type":"string","format":"date-time","description":"ISO timestamp of the next scheduled attempt (backoff: 1m, 5m, 30m, 2h, 6h, 24h).","example":"2026-05-01T12:00:00.000Z"},"last_error":{"type":"string","description":"Error from the most recent failed attempt. Null before the first failure.","example":null,"nullable":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","webhook_id","event_id","event_type","status","attempt_count","next_attempt_at","last_error","created_at","updated_at"]},"DeliveryResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Delivery row UUID."},"webhook_id":{"type":"string","format":"uuid","description":"Webhook UUID."},"event_id":{"type":"string","description":"Stable event id (carried in the request body as `id`).","example":"evt_…"},"event_type":{"type":"string","description":"Event type for this attempt.","example":"post.created"},"attempt_number":{"type":"number","description":"Attempt number, 1-based. Increments per retry along the backoff schedule (1m, 5m, 30m, 2h, 6h, 24h — 7 attempts total).","example":1},"request_body":{"type":"object","additionalProperties":true,"description":"Signed request body that was sent.","example":{}},"response_status":{"type":"number","description":"HTTP status code (null on transport / SSRF failure).","example":200,"nullable":true},"response_body":{"type":"string","description":"Truncated response body (≤1024 bytes).","example":"OK","nullable":true},"error_message":{"type":"string","description":"Free-form error string. Null on success.","example":null,"nullable":true},"latency_ms":{"type":"number","description":"Total round-trip time in ms. Null on transport-level failure.","example":67,"nullable":true},"succeeded":{"type":"boolean","description":"Whether the delivery returned 2xx.","example":true},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp.","example":"2026-05-01T12:00:00.000Z"}},"required":["id","webhook_id","event_id","event_type","attempt_number","request_body","response_status","response_body","error_message","latency_ms","succeeded","created_at"]},"DeliveryListResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"]},"WebhookEventTypesResponseDto":{"type":"object","properties":{"data":{"type":"array","description":"Every event type a webhook can subscribe to, in catalog order.","example":["post.created","post.deleted","comment.created"],"items":{"type":"string","enum":["post.created","post.updated","post.deleted","post.reaction.created","repost.created","comment.created","comment.updated","comment.deleted","comment.reaction.created","edge.follow.created","edge.follow.deleted","edge.follow.requested","edge.follow.request_approved","flag.created","flag.updated","moderation.action.applied","actor.updated","dm.message.created","tag.created","asset.ready","asset.failed"]}}},"required":["data"]},"ActorCommentsResponseDto":{"type":"object","properties":{"data":{"description":"The actor's comments on this page.","type":"array","items":{"$ref":"#/components/schemas/CommentResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ActorComments"},"ReactionTargetType":{"type":"string","enum":["post","comment"]},"ActorReactionEntryDto":{"type":"object","properties":{"target_type":{"description":"What the reaction is on.","example":"post","allOf":[{"$ref":"#/components/schemas/ReactionTargetType"}]},"target_id":{"type":"string","format":"uuid","description":"UUID of the reacted-to post or comment (per `target_type`).","example":"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"},"type":{"type":"string","description":"Reaction type (e.g. `like`).","example":"like"},"created_at":{"type":"string","format":"date-time","description":"ISO timestamp the reaction was recorded.","example":"2026-05-01T12:00:00.000Z"}},"required":["target_type","target_id","type","created_at"],"x-pc-sdk-model":"ActorReactionEntry"},"ActorReactionsResponseDto":{"type":"object","properties":{"data":{"description":"The actor's reactions on this page.","type":"array","items":{"$ref":"#/components/schemas/ActorReactionEntryDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"}},"required":["data","pagination"],"x-pc-sdk-model":"ActorReactions"},"StatsWindow":{"type":"string","enum":["1d","7d","30d"]},"SocialStatsTotalsDto":{"type":"object","properties":{"communities":{"type":"number","description":"Communities in the workspace, in any status.","example":3},"published_posts":{"type":"number","description":"Posts currently published across those communities, all time.","example":1280}},"required":["communities","published_posts"],"x-pc-sdk-model":"SocialStatsTotals"},"SocialStatsInWindowDto":{"type":"object","properties":{"active_members":{"type":"number","description":"Distinct members (actors) who published a post, published a comment or reacted in the window. A member active on several days counts once; actors belong to one community, so a person active in two communities counts in each.","example":57},"posts":{"type":"number","description":"Posts published in the window.","example":112},"comments":{"type":"number","description":"Comments published in the window.","example":430},"reactions":{"type":"number","description":"Reactions to posts and comments in the window.","example":1904}},"required":["active_members","posts","comments","reactions"],"x-pc-sdk-model":"SocialStatsInWindow"},"SocialStatsMetric":{"type":"string","enum":["active_members"]},"StatsGranularity":{"type":"string","enum":["day"]},"SocialStatsSeriesPointDto":{"type":"object","properties":{"date":{"type":"string","description":"UTC calendar day.","format":"date","example":"2026-10-07"},"value":{"type":"number","description":"Value for that day.","example":4}},"required":["date","value"],"x-pc-sdk-model":"SocialStatsSeriesPoint"},"SocialStatsSeriesDto":{"type":"object","properties":{"metric":{"description":"Distinct members who published a post, published a comment or reacted, per UTC day, across every community in the workspace.","example":"active_members","allOf":[{"$ref":"#/components/schemas/SocialStatsMetric"}]},"granularity":{"description":"Bucket width.","example":"day","allOf":[{"$ref":"#/components/schemas/StatsGranularity"}]},"points":{"description":"Dense and zero-filled: one point per UTC day in the window, oldest first, ending today.","type":"array","items":{"$ref":"#/components/schemas/SocialStatsSeriesPointDto"}}},"required":["metric","granularity","points"],"x-pc-sdk-model":"SocialStatsSeries"},"SocialWorkspaceStatsDto":{"type":"object","properties":{"window":{"description":"Window the counts cover.","example":"30d","allOf":[{"$ref":"#/components/schemas/StatsWindow"}]},"generated_at":{"type":"string","format":"date-time","description":"When these numbers were computed. Responses are cached for up to 60 seconds.","example":"2026-10-07T09:00:00.000Z"},"last_activity_at":{"type":"string","format":"date-time","nullable":true,"description":"Most recent post, comment or reaction in any of the workspace's communities (activity is kept for 400 days). Null when there has been none.","example":"2026-10-07T08:41:12.000Z"},"totals":{"description":"All-time counts.","allOf":[{"$ref":"#/components/schemas/SocialStatsTotalsDto"}]},"in_window":{"description":"Counts for the window.","allOf":[{"$ref":"#/components/schemas/SocialStatsInWindowDto"}]},"series":{"description":"Daily active members.","allOf":[{"$ref":"#/components/schemas/SocialStatsSeriesDto"}]}},"required":["window","generated_at","last_activity_at","totals","in_window","series"],"x-pc-sdk-model":"SocialWorkspaceStats"},"PostCreatedEvent":{"type":"object","title":"PostCreatedEvent","description":"A member published a post, a quote or a story. Drafts and scheduled posts arrive with their status.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["post.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/PostCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"post.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","body":"Shipping the new onboarding today.","source_post_id":null,"source_post_actor_id":null,"status":"published","attributes":{"imageUrl":"https://cdn.example.com/onboarding.png"}}},"x-pc-sdk-model":"PostCreatedEvent"},"PostUpdatedEvent":{"type":"object","title":"PostUpdatedEvent","description":"A member edited a post.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["post.updated"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/PostUpdatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"post.updated","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","body":"Shipping the new onboarding today (now with screenshots).","attributes":{"imageUrl":"https://cdn.example.com/onboarding.png"}}},"x-pc-sdk-model":"PostUpdatedEvent"},"PostDeletedEvent":{"type":"object","title":"PostDeletedEvent","description":"A post or repost was deleted, by its author or by a moderator.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["post.deleted"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/PostDeletedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"post.deleted","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","kind":"post","source_post_id":null}},"x-pc-sdk-model":"PostDeletedEvent"},"PostReactionCreatedEvent":{"type":"object","title":"PostReactionCreatedEvent","description":"A member reacted to a post.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["post.reaction.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/PostReactionCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"post.reaction.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","post_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","type":"like"}},"x-pc-sdk-model":"PostReactionCreatedEvent"},"RepostCreatedEvent":{"type":"object","title":"RepostCreatedEvent","description":"A member reposted someone else's post.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["repost.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/RepostCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"repost.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","post_id":"4f506172-8394-4eaf-8c0b-2c3d4e5f6071","actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","source_post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","source_post_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"x-pc-sdk-model":"RepostCreatedEvent"},"CommentCreatedEvent":{"type":"object","title":"CommentCreatedEvent","description":"A member commented on a post or replied to a comment. Comments held for approval arrive with status pending_approval.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["comment.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/CommentCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"comment.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","comment_id":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","body":"Looks great!","parent_id":null,"post_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","parent_actor_id":null,"status":"published"}},"x-pc-sdk-model":"CommentCreatedEvent"},"CommentUpdatedEvent":{"type":"object","title":"CommentUpdatedEvent","description":"A member edited a comment.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["comment.updated"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/CommentUpdatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"comment.updated","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","comment_id":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","body":"Looks great! Congrats to the team."}},"x-pc-sdk-model":"CommentUpdatedEvent"},"CommentDeletedEvent":{"type":"object","title":"CommentDeletedEvent","description":"A comment was removed, by its author or by a moderator.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["comment.deleted"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/CommentDeletedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"comment.deleted","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","comment_id":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"}},"x-pc-sdk-model":"CommentDeletedEvent"},"CommentReactionCreatedEvent":{"type":"object","title":"CommentReactionCreatedEvent","description":"A member reacted to a comment.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["comment.reaction.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/CommentReactionCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"comment.reaction.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","comment_id":"3e4f5061-7283-4d9e-bf0a-1b2c3d4e5f60","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","comment_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","type":"like"}},"x-pc-sdk-model":"CommentReactionCreatedEvent"},"EdgeFollowCreatedEvent":{"type":"object","title":"EdgeFollowCreatedEvent","description":"A member started following another member.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["edge.follow.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/EdgeFollowCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"edge.follow.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","src_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","dst_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"x-pc-sdk-model":"EdgeFollowCreatedEvent"},"EdgeFollowDeletedEvent":{"type":"object","title":"EdgeFollowDeletedEvent","description":"A member stopped following another member.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["edge.follow.deleted"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/EdgeFollowDeletedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"edge.follow.deleted","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","src_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","dst_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"x-pc-sdk-model":"EdgeFollowDeletedEvent"},"EdgeFollowRequestedEvent":{"type":"object","title":"EdgeFollowRequestedEvent","description":"A member asked to follow a private member and is waiting for approval.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["edge.follow.requested"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/EdgeFollowRequestedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"edge.follow.requested","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","src_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","dst_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"x-pc-sdk-model":"EdgeFollowRequestedEvent"},"EdgeFollowRequestApprovedEvent":{"type":"object","title":"EdgeFollowRequestApprovedEvent","description":"A private member approved a follow request. The follow itself arrives as edge.follow.created.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["edge.follow.request_approved"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/EdgeFollowRequestApprovedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"edge.follow.request_approved","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","src_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","dst_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d"}},"x-pc-sdk-model":"EdgeFollowRequestApprovedEvent"},"FlagCreatedEvent":{"type":"object","title":"FlagCreatedEvent","description":"A member reported a post, comment or member. auto_hidden is true when this report hid the content.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["flag.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/FlagCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"flag.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","flag_id":"5061728a-94a5-4fb0-9d1c-3d4e5f607182","reporter_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e","target_kind":"post","target_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","reason":"spam","auto_hidden":false}},"x-pc-sdk-model":"FlagCreatedEvent"},"FlagUpdatedEvent":{"type":"object","title":"FlagUpdatedEvent","description":"A moderator acted on a report or dismissed it.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["flag.updated"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/FlagUpdatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"flag.updated","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","flag_id":"5061728a-94a5-4fb0-9d1c-3d4e5f607182","status":"actioned","action":"remove"}},"x-pc-sdk-model":"FlagUpdatedEvent"},"ModerationActionAppliedEvent":{"type":"object","title":"ModerationActionAppliedEvent","description":"A moderator removed content, or muted, suspended or banned a member.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["moderation.action.applied"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/ModerationActionAppliedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"moderation.action.applied","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","action_id":"61728394-a5b6-40c1-ae2d-4e5f60718293","flag_id":"5061728a-94a5-4fb0-9d1c-3d4e5f607182","action":"remove","target_kind":"post","target_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","moderator_account_id":"7283a4b5-c6d7-41e2-bf3e-5f6071829304"}},"x-pc-sdk-model":"ModerationActionAppliedEvent"},"ActorUpdatedEvent":{"type":"object","title":"ActorUpdatedEvent","description":"A member's profile changed (display name, avatar, bio or other fields).","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["actor.updated"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/ActorUpdatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"actor.updated","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","external_id":"user_42"}},"x-pc-sdk-model":"ActorUpdatedEvent"},"DmMessageCreatedEvent":{"type":"object","title":"DmMessageCreatedEvent","description":"A member sent a direct message. recipient_actor_ids lists everyone else in the conversation, for push notifications.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["dm.message.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/DmMessageCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"dm.message.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","conversation_id":"8394b5c6-d7e8-42f3-8a4f-60718293a4b5","message_id":"94a5c6d7-e8f9-4304-9b50-718293a4b5c6","sender_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","kind":"text","body":"See you at the meetup?","reply_to_id":null,"recipient_actor_ids":["1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"]}},"x-pc-sdk-model":"DmMessageCreatedEvent"},"TagCreatedEvent":{"type":"object","title":"TagCreatedEvent","description":"A post author tagged a member in a post. Sent once per tagged member.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["tag.created"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/TagCreatedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"tag.created","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","post_id":"2d3e4f50-6172-4c8d-ae9f-0a1b2c3d4e5f","actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","tagged_actor_id":"1c2d3e4f-5061-4b7c-9d8e-9f0a1b2c3d4e"}},"x-pc-sdk-model":"TagCreatedEvent"},"AssetReadyEvent":{"type":"object","title":"AssetReadyEvent","description":"An uploaded image or video finished processing and can be attached to a post.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["asset.ready"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/AssetReadyEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"asset.ready","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","asset_id":"a5b6d7e8-f90a-4415-8c61-8293a4b5c6d7","owner_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","status":"ready","kind":"video"}},"x-pc-sdk-model":"AssetReadyEvent"},"AssetFailedEvent":{"type":"object","title":"AssetFailedEvent","description":"An uploaded image or video could not be processed. The reason is in failure_reason.","required":["id","type","created_at","data"],"properties":{"community_id":{"type":"string","format":"uuid","description":"The community the event happened in (also in `data.community_id`). Absent on \"Send test\" deliveries."},"workspace_id":{"type":"string","format":"uuid","description":"The workspace that owns the community, so a workspace-level endpoint can route without opening `data`. Absent on \"Send test\" deliveries."},"id":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$","example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","description":"The event id, also sent as `webhook-id`; the same on every retry and replay."},"type":{"type":"string","enum":["asset.failed"],"description":"The event type. Switch on it to narrow the event."},"created_at":{"type":"string","format":"date-time","example":"2026-11-05T09:00:00.000Z","description":"When the event happened (the same on every retry)."},"test":{"type":"boolean","description":"Present and true only on a delivery made by \"Send test\"; its `data` is the catalogue example."},"data":{"$ref":"#/components/schemas/AssetFailedEventDataDto"}},"example":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","workspace_id":"9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b","id":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f","type":"asset.failed","created_at":"2026-11-05T09:00:00.000Z","data":{"community_id":"6f1d2c3b-4a5e-4f60-8b7c-9d0e1f2a3b4c","asset_id":"a5b6d7e8-f90a-4415-8c61-8293a4b5c6d7","owner_actor_id":"0b1c2d3e-4f50-4a6b-8c7d-8e9f0a1b2c3d","status":"failed","kind":"video","failure_reason":"ASSET_TRANSCODE_FAILED"}},"x-pc-sdk-model":"AssetFailedEvent"},"SocialErrorCode":{"description":"Error codes this API returns (open set: a client must accept codes it does not know; new codes are not a breaking change). Each is documented at https://productcraft.co/docs/errors#<code>.","anyOf":[{"type":"string","enum":["BAD_REQUEST","VALIDATION_ERROR","UNAUTHORIZED","PAYMENT_REQUIRED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","NOT_ACCEPTABLE","REQUEST_TIMEOUT","CONFLICT","GONE","PRECONDITION_FAILED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","UNPROCESSABLE_ENTITY","PRECONDITION_REQUIRED","RATE_LIMITED","INTERNAL_SERVER_ERROR","NOT_IMPLEMENTED","BAD_GATEWAY","SERVICE_UNAVAILABLE","GATEWAY_TIMEOUT","SERVICE_NOT_ENABLED","INVALID_CREDENTIALS","SESSION_REVOKED","MCP_NOT_PERMITTED","MCP_WORKSPACE_MISMATCH","PAK_NOT_PERMITTED","ACTIONS_NOT_GRANTABLE","IDEMPOTENCY_KEY_REUSE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_IN_PROGRESS","WEBHOOK_ENDPOINT_LIMIT","WEBHOOK_ENDPOINT_NOT_FOUND","WEBHOOK_ENDPOINT_NOT_SUBSCRIBED","WEBHOOK_EVENT_NOT_FOUND","WEBHOOK_EVENT_TYPE_UNKNOWN","ASSET_INVALID_CONTAINER","ASSET_INVALID_SIZE","ASSET_INVALID_TYPE","ASSET_MAGIC_MISMATCH","ASSET_NOT_OWNED","ASSET_NOT_READY","ASSET_NOT_VIDEO","ASSET_PROCESSING_FAILED","ASSET_TOO_LARGE","ASSET_TRANSCODE_FAILED","ASSET_UPLOAD_INCOMPLETE","CANNOT_QUOTE_PRIVATE","CANNOT_QUOTE_SELF","CANNOT_REPOST_PRIVATE","CANNOT_REPOST_SELF","COMMENTS_DISABLED","COMMENTS_FOLLOWERS_ONLY","COMMENTS_MENTIONED_ONLY","EDIT_WINDOW_EXPIRED","INVALID_CURSOR","INVALID_DATE_FILTER","INVALID_EXPAND","INVALID_IDENTIFIER","INVALID_ID_LIST","INVALID_NOTIFICATION_KIND","INVALID_ORDER","INVALID_SEARCH_QUERY","PIN_CAP_REACHED","POLL_CLOSED","QUOTE_NOT_ALLOWED","QUOTE_REQUIRES_BODY","QUOTE_REQUIRES_SOURCE","REPOST_NOT_ALLOWED","SOURCE_POST_ID_REQUIRES_QUOTE","TOO_MANY_ACTIVE_UPLOADS","TOO_MANY_ATTACHMENTS","TOO_MANY_IDS"]},{"type":"string","description":"A code added after this document was published."}],"x-pc-open-enum":true,"x-pc-error-docs":"https://productcraft.co/docs/errors#{code}","x-enum-descriptions":{"BAD_REQUEST":"The request is malformed (not valid JSON, a bad header, an unusable parameter).","VALIDATION_ERROR":"One or more request fields are invalid; `errors` lists each field (`param`, `message`, `code`).","UNAUTHORIZED":"No credentials, or the token or API key is invalid, expired or revoked.","PAYMENT_REQUIRED":"The workspace has no credit or plan for this operation.","FORBIDDEN":"The caller is authenticated but not allowed to do this.","NOT_FOUND":"The resource does not exist, or belongs to another workspace or app.","METHOD_NOT_ALLOWED":"The route does not accept this HTTP method.","NOT_ACCEPTABLE":"The route cannot produce the requested content type.","REQUEST_TIMEOUT":"The request took too long to arrive.","CONFLICT":"The request conflicts with the current state of the resource.","GONE":"The resource existed but has been removed for good.","PRECONDITION_FAILED":"A precondition header did not match.","PAYLOAD_TOO_LARGE":"The request body is over the size limit.","UNSUPPORTED_MEDIA_TYPE":"The request body is not in a content type the route accepts.","UNPROCESSABLE_ENTITY":"The request is well-formed but cannot be carried out.","PRECONDITION_REQUIRED":"The route requires a precondition header.","RATE_LIMITED":"Too many requests; retry after the `Retry-After` header.","INTERNAL_SERVER_ERROR":"An unexpected server error. Retrying is safe for idempotent requests; quote `request_id` to support.","NOT_IMPLEMENTED":"The server does not support this operation.","BAD_GATEWAY":"An upstream service returned an invalid response.","SERVICE_UNAVAILABLE":"The service or one of its dependencies is temporarily unavailable; retry.","GATEWAY_TIMEOUT":"An upstream service did not answer in time; retry.","SERVICE_NOT_ENABLED":"The workspace has not enabled this product.","INVALID_CREDENTIALS":"The credentials were not accepted.","SESSION_REVOKED":"The session behind this token was signed out or revoked.","MCP_NOT_PERMITTED":"An MCP (agent) token cannot call this route.","MCP_WORKSPACE_MISMATCH":"The MCP token was issued for a different workspace.","PAK_NOT_PERMITTED":"A workspace API key cannot call this route.","ACTIONS_NOT_GRANTABLE":"The policy grants actions the caller does not hold.","IDEMPOTENCY_KEY_REUSE":"The `Idempotency-Key` was already used with a different body or route.","IDEMPOTENCY_KEY_REQUIRED":"This operation requires an `Idempotency-Key` header.","IDEMPOTENCY_IN_PROGRESS":"A request with the same `Idempotency-Key` is still running. Retry after `Retry-After` seconds with the same key to get its response.","WEBHOOK_ENDPOINT_LIMIT":"The workspace has the maximum number of webhook endpoints.","WEBHOOK_ENDPOINT_NOT_FOUND":"No webhook endpoint with this id in this workspace.","WEBHOOK_ENDPOINT_NOT_SUBSCRIBED":"The endpoint is not subscribed to this event type.","WEBHOOK_EVENT_NOT_FOUND":"No webhook event with this id in this workspace.","WEBHOOK_EVENT_TYPE_UNKNOWN":"The event type is not one this product sends.","ASSET_INVALID_CONTAINER":"Uploaded bytes are not an MP4/MOV/WebM container.","ASSET_INVALID_SIZE":"Video must declare a positive integer byte_size.","ASSET_INVALID_TYPE":"The asset file type is not supported.","ASSET_MAGIC_MISMATCH":"Asset file content does not match declared type.","ASSET_NOT_OWNED":"The asset belongs to another actor.","ASSET_NOT_READY":"The asset is still processing.","ASSET_NOT_VIDEO":"Only video assets are finalized explicitly.","ASSET_PROCESSING_FAILED":"Asset could not be processed.","ASSET_TOO_LARGE":"The asset is over the size limit.","ASSET_TRANSCODE_FAILED":"The video could not be transcoded.","ASSET_UPLOAD_INCOMPLETE":"No uploaded file was found for the asset.","CANNOT_QUOTE_PRIVATE":"Cannot quote a private post.","CANNOT_QUOTE_SELF":"Cannot quote your own post.","CANNOT_REPOST_PRIVATE":"Cannot repost a private post.","CANNOT_REPOST_SELF":"Cannot repost your own post.","COMMENTS_DISABLED":"Comments are turned off for this post.","COMMENTS_FOLLOWERS_ONLY":"Only followers can comment on this post.","COMMENTS_MENTIONED_ONLY":"Only actors mentioned in this post can comment.","EDIT_WINDOW_EXPIRED":"The post can no longer be edited.","INVALID_CURSOR":"The cursor is invalid; restart from the first page.","INVALID_DATE_FILTER":"A date filter is not valid ISO 8601.","INVALID_EXPAND":"Unsupported expand value.","INVALID_IDENTIFIER":"An id in the path or query is not a valid UUID.","INVALID_ID_LIST":"An id list is malformed.","INVALID_NOTIFICATION_KIND":"Unknown notification kind.","INVALID_ORDER":"The `order` value is not supported.","INVALID_SEARCH_QUERY":"The search query is invalid.","PIN_CAP_REACHED":"The post has the maximum number of pinned comments.","POLL_CLOSED":"This poll is closed.","QUOTE_NOT_ALLOWED":"The author has disabled quoting this post.","QUOTE_REQUIRES_BODY":"A quote post needs a body.","QUOTE_REQUIRES_SOURCE":"A quote post needs `source_post_id`.","REPOST_NOT_ALLOWED":"The author has disabled reposting this post.","SOURCE_POST_ID_REQUIRES_QUOTE":"`source_post_id` is only valid on a quote post.","TOO_MANY_ACTIVE_UPLOADS":"The community has the maximum number of videos uploading or processing.","TOO_MANY_ATTACHMENTS":"The post has too many attachments.","TOO_MANY_IDS":"Too many ids in one request."}}},"headers":{"X-RateLimit-Limit-short":{"description":"Requests allowed per second from this client IP (20).","schema":{"type":"integer"}},"X-RateLimit-Remaining-short":{"description":"Requests left in the current one-second window.","schema":{"type":"integer"}},"X-RateLimit-Reset-short":{"description":"Seconds until the one-second window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit-long":{"description":"Requests allowed per minute from this client IP (600).","schema":{"type":"integer"}},"X-RateLimit-Remaining-long":{"description":"Requests left in the current one-minute window.","schema":{"type":"integer"}},"X-RateLimit-Reset-long":{"description":"Seconds until the one-minute window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying. Sent on every 429.","schema":{"type":"integer"}},"Retry-After-short":{"description":"Deprecated: read `Retry-After`. Seconds to wait, when the per-second IP limit tripped.","deprecated":true,"schema":{"type":"integer"}},"Retry-After-long":{"description":"Deprecated: read `Retry-After`. Seconds to wait, when the per-minute IP limit tripped.","deprecated":true,"schema":{"type":"integer"}},"RequestId":{"description":"The request's id: the inbound `X-Request-Id` when it is 1 to 128 characters of `A-Z a-z 0-9 . _ : -`, otherwise a fresh `req_...` id. Error bodies repeat it as `request_id`. Quote it when contacting support.","schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","example":"req_6f1c2a9d4b7e4f0a8c3d2e1f0a9b8c7d"}}}},"x-webhooks":{"post.created":{"post":{"summary":"A member published a post, a quote or a story. Drafts and scheduled posts arrive with their status.","description":"A `post.created` event (Posts), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Posts","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `post.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"post.updated":{"post":{"summary":"A member edited a post.","description":"A `post.updated` event (Posts), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Posts","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `post.updated` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostUpdatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"post.deleted":{"post":{"summary":"A post or repost was deleted, by its author or by a moderator.","description":"A `post.deleted` event (Posts), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Posts","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `post.deleted` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostDeletedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"post.reaction.created":{"post":{"summary":"A member reacted to a post.","description":"A `post.reaction.created` event (Posts), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Posts","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `post.reaction.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostReactionCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"repost.created":{"post":{"summary":"A member reposted someone else's post.","description":"A `repost.created` event (Posts), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Posts","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `repost.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepostCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"comment.created":{"post":{"summary":"A member commented on a post or replied to a comment. Comments held for approval arrive with status pending_approval.","description":"A `comment.created` event (Comments), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Comments","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `comment.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"comment.updated":{"post":{"summary":"A member edited a comment.","description":"A `comment.updated` event (Comments), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Comments","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `comment.updated` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentUpdatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"comment.deleted":{"post":{"summary":"A comment was removed, by its author or by a moderator.","description":"A `comment.deleted` event (Comments), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Comments","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `comment.deleted` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentDeletedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"comment.reaction.created":{"post":{"summary":"A member reacted to a comment.","description":"A `comment.reaction.created` event (Comments), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Comments","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `comment.reaction.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentReactionCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"edge.follow.created":{"post":{"summary":"A member started following another member.","description":"A `edge.follow.created` event (Follows), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Follows","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `edge.follow.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EdgeFollowCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"edge.follow.deleted":{"post":{"summary":"A member stopped following another member.","description":"A `edge.follow.deleted` event (Follows), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Follows","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `edge.follow.deleted` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EdgeFollowDeletedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"edge.follow.requested":{"post":{"summary":"A member asked to follow a private member and is waiting for approval.","description":"A `edge.follow.requested` event (Follows), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Follows","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `edge.follow.requested` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EdgeFollowRequestedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"edge.follow.request_approved":{"post":{"summary":"A private member approved a follow request. The follow itself arrives as edge.follow.created.","description":"A `edge.follow.request_approved` event (Follows), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Follows","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `edge.follow.request_approved` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EdgeFollowRequestApprovedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"flag.created":{"post":{"summary":"A member reported a post, comment or member. auto_hidden is true when this report hid the content.","description":"A `flag.created` event (Moderation), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Moderation","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `flag.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlagCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"flag.updated":{"post":{"summary":"A moderator acted on a report or dismissed it.","description":"A `flag.updated` event (Moderation), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Moderation","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `flag.updated` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlagUpdatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"moderation.action.applied":{"post":{"summary":"A moderator removed content, or muted, suspended or banned a member.","description":"A `moderation.action.applied` event (Moderation), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Moderation","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `moderation.action.applied` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationActionAppliedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"actor.updated":{"post":{"summary":"A member's profile changed (display name, avatar, bio or other fields).","description":"A `actor.updated` event (Members), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Members","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `actor.updated` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorUpdatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"dm.message.created":{"post":{"summary":"A member sent a direct message. recipient_actor_ids lists everyone else in the conversation, for push notifications.","description":"A `dm.message.created` event (Direct messages), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Direct messages","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `dm.message.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DmMessageCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"tag.created":{"post":{"summary":"A post author tagged a member in a post. Sent once per tagged member.","description":"A `tag.created` event (Posts), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Posts","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `tag.created` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagCreatedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"asset.ready":{"post":{"summary":"An uploaded image or video finished processing and can be attached to a post.","description":"A `asset.ready` event (Media), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Media","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `asset.ready` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetReadyEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}},"asset.failed":{"post":{"summary":"An uploaded image or video could not be processed. The reason is in failure_reason.","description":"A `asset.failed` event (Media), POSTed as JSON to every enabled endpoint subscribed to it and signed with the Standard Webhooks headers. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h.","tags":["webhooks"],"x-pc-webhook-category":"Media","parameters":[{"name":"webhook-id","in":"header","required":true,"description":"The event id: the same on every retry and replay, so dedupe on it. Part of the signed content.","schema":{"type":"string","pattern":"^evt_[0-9a-f-]{36}$"},"example":"evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f"},{"name":"webhook-timestamp","in":"header","required":true,"description":"Unix seconds of this attempt. Part of the signed content; reject a delivery more than 5 minutes from your clock.","schema":{"type":"string","pattern":"^\\d+$"},"example":"1793869200"},{"name":"webhook-signature","in":"header","required":true,"description":"`v1,<base64 HMAC-SHA256 of \"<webhook-id>.<webhook-timestamp>.<raw body>\">`, keyed with the base64-decoded part of the endpoint's `whsec_` secret. During a secret rotation it carries one space-separated `v1,` entry per active secret; accept the delivery when any entry matches.","schema":{"type":"string"},"example":"v1,lkO4DTG3zOoxV5QD2PC5B41Sc8nqZNoh50NPrwnhJ5I="},{"name":"x-pcft-signature","in":"header","required":false,"deprecated":true,"description":"Only to endpoints carried over from the previous webhook system (`legacy_signature: true`), until its sunset: `t=<unix>,v1=<hex HMAC-SHA256 of \"<unix>.<raw body>\">`, keyed with the UTF-8 bytes of the whole secret string. Verify `webhook-signature` instead.","schema":{"type":"string","pattern":"^t=\\d+,v1=[0-9a-f]{64}$"}}],"requestBody":{"required":true,"description":"The `asset.failed` event. Verify the signature over the raw body before parsing it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetFailedEvent"}}}},"responses":{"200":{"description":"Any 2xx acknowledges the event. Answer with any 2xx within 15 s to acknowledge it; anything else, or no answer, is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 24 h."}}}}},"x-pc-webhook-signing":{"scheme":"standard-webhooks","spec_url":"https://www.standardwebhooks.com","algorithm":"HMAC-SHA256","headers":{"id":"webhook-id","timestamp":"webhook-timestamp","signature":"webhook-signature"},"signed_content":"{webhook-id}.{webhook-timestamp}.{body}","signature_format":"v1,<base64>","secret_prefix":"whsec_","secret_key":"base64 decode of the part after `whsec_`; a secret without the prefix (minted before it) is used as its UTF-8 bytes","tolerance_seconds":300,"rotation":"space-separated `v1,` entries, one per active secret, current first","legacy":{"header":"x-pcft-signature","format":"t=<unix>,v1=<hex>","signed_content":"{t}.{body}","secret_key":"UTF-8 bytes of the whole secret string","deprecated":true}}}