{ "schemes": [], "swagger": "2.0", "info": { "description": "REST API for social media management (Buffer/Hootsuite-style).", "title": "Pebblemonk Social API", "contact": {}, "version": "1.0.0" }, "host": "", "basePath": "/", "paths": { "/v1/socialAccounts": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_accounts" ], "summary": "List social_accounts", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "account_ref", "created_at", "display_name", "id", "metadata", "provider", "scopes", "status", "tenant_id", "token_expires_at", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: provider, display_name, token_expires_at, status, account_ref", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAccountListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_accounts" ], "summary": "Create social_account", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAccountPublicCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialAccountResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialAccounts/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_accounts" ], "summary": "Get social_account", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAccountResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_accounts" ], "summary": "Update social_account", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAccountPublicUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAccountResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_accounts" ], "summary": "Delete social_account", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_accounts" ], "summary": "Patch social_account", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAccountPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAccountResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialAnalytics": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_analytics_" ], "summary": "List social_analytics_", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "created_at", "id", "metrics_json", "period_end", "period_start", "post_id", "profile_id", "provider", "status", "tenant_id", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: post_id, period_end, provider, period_start, status, profile_id", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_analytics_" ], "summary": "Create social_analytics_", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialAnalytics/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_analytics_" ], "summary": "Get social_analytics_", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_analytics_" ], "summary": "Update social_analytics_", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_analytics_" ], "summary": "Delete social_analytics_", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_analytics_" ], "summary": "Patch social_analytics_", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAnalyticsResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialAssets": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_assets" ], "summary": "List social_assets", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "created_at", "id", "metadata", "mime_type", "name", "size_bytes", "tenant_id", "thumb_url", "type", "updated_at", "url" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: name, size_bytes, type, mime_type", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAssetListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_assets" ], "summary": "Create social_asset", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAssetCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialAssetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialAssets/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_assets" ], "summary": "Get social_asset", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAssetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_assets" ], "summary": "Update social_asset", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAssetUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAssetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_assets" ], "summary": "Delete social_asset", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_assets" ], "summary": "Patch social_asset", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialAssetPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialAssetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialCampaigns": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_campaigns" ], "summary": "List social_campaigns", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "created_at", "end_at", "handle", "id", "metadata", "name", "objective", "start_at", "status", "tenant_id", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: handle, end_at, name, objective, start_at, status", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialCampaignListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_campaigns" ], "summary": "Create social_campaign", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialCampaignCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialCampaignResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialCampaigns/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_campaigns" ], "summary": "Get social_campaign", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialCampaignResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_campaigns" ], "summary": "Update social_campaign", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialCampaignUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialCampaignResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_campaigns" ], "summary": "Delete social_campaign", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_campaigns" ], "summary": "Patch social_campaign", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialCampaignPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialCampaignResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialMetrics": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_metrics" ], "summary": "List social_metrics", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "analytics_id", "captured_at", "created_at", "id", "metric_key", "metric_value", "tenant_id", "unit", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: metric_value, unit, captured_at, analytics_id, metric_key", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialMetricListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_metrics" ], "summary": "Create social_metric", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialMetricCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialMetricResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialMetrics/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_metrics" ], "summary": "Get social_metric", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialMetricResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_metrics" ], "summary": "Update social_metric", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialMetricUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialMetricResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_metrics" ], "summary": "Delete social_metric", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_metrics" ], "summary": "Patch social_metric", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialMetricPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialMetricResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialPostTags": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_post_tags" ], "summary": "List social_post_tags", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "created_at", "id", "post_id", "status", "tag_id", "tenant_id", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: tag_id, post_id, status", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTagListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_post_tags" ], "summary": "Create social_post_tag", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostTagCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialPostTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialPostTags/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_post_tags" ], "summary": "Get social_post_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_post_tags" ], "summary": "Update social_post_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostTagUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_post_tags" ], "summary": "Delete social_post_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_post_tags" ], "summary": "Patch social_post_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostTagPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialPostTargets": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_post_targets" ], "summary": "List social_post_targets", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "created_at", "error_message", "external_ref", "id", "post_id", "profile_id", "provider", "published_at", "scheduled_at", "status", "tenant_id", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: provider, scheduled_at, post_id, profile_id, status, published_at, external_ref", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTargetListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_post_targets" ], "summary": "Create social_post_target", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostTargetCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialPostTargetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialPostTargets/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_post_targets" ], "summary": "Get social_post_target", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTargetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_post_targets" ], "summary": "Update social_post_target", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostTargetUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTargetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_post_targets" ], "summary": "Delete social_post_target", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_post_targets" ], "summary": "Patch social_post_target", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostTargetPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostTargetResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialPosts": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_posts" ], "summary": "List social_posts", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "author_ref", "body", "campaign_id", "created_at", "external_post_ref", "id", "link_url", "media_json", "metadata", "published_at", "scheduled_at", "status", "tenant_id", "title", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: campaign_id, author_ref, published_at, title, body, scheduled_at, status, external_post_ref", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_posts" ], "summary": "Create social_post", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialPostResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialPosts/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_posts" ], "summary": "Get social_post", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_posts" ], "summary": "Update social_post", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_posts" ], "summary": "Delete social_post", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_posts" ], "summary": "Patch social_post", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialPostPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialPostResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialProfiles": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_profiles" ], "summary": "List social_profiles", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "account_id", "avatar_url", "created_at", "display_name", "id", "metadata", "profile_ref", "profile_url", "provider", "status", "tenant_id", "timezone", "updated_at", "username" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: provider, timezone, profile_ref, status, account_id, username, display_name", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialProfileListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_profiles" ], "summary": "Create social_profile", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialProfileCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialProfiles/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_profiles" ], "summary": "Get social_profile", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_profiles" ], "summary": "Update social_profile", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialProfileUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_profiles" ], "summary": "Delete social_profile", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_profiles" ], "summary": "Patch social_profile", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialProfilePatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialProfileResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialQueueItems": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_queue_items" ], "summary": "List social_queue_items", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "attempt_count", "created_at", "external_ref", "id", "last_attempt_at", "last_error_code", "last_error_message", "lock_expires_at", "locked_at", "locked_by", "max_attempts", "next_retry_at", "position", "post_id", "profile_id", "provider_idempotency_key", "published_at", "schedule_id", "scheduled_at", "status", "tenant_id", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: lock_expires_at, attempt_count, post_id, position, locked_at, next_retry_at, last_attempt_at, scheduled_at, published_at, max_attempts, provider_idempotency_key, external_ref, last_error_code, profile_id, schedule_id, status, locked_by", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialQueueItemListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_queue_items" ], "summary": "Create social_queue_item", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialQueueItemCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialQueueItemResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialQueueItems/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_queue_items" ], "summary": "Get social_queue_item", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialQueueItemResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_queue_items" ], "summary": "Update social_queue_item", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialQueueItemUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialQueueItemResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_queue_items" ], "summary": "Delete social_queue_item", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_queue_items" ], "summary": "Patch social_queue_item", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialQueueItemPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialQueueItemResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialSchedules": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_schedules" ], "summary": "List social_schedules", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "created_at", "days_of_week", "id", "metadata", "name", "profile_id", "status", "tenant_id", "time_of_day", "timezone", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: status, profile_id, name, timezone, time_of_day", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialScheduleListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_schedules" ], "summary": "Create social_schedule", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialScheduleCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialScheduleResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialSchedules/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_schedules" ], "summary": "Get social_schedule", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialScheduleResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_schedules" ], "summary": "Update social_schedule", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialScheduleUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialScheduleResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_schedules" ], "summary": "Delete social_schedule", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_schedules" ], "summary": "Patch social_schedule", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialSchedulePatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialScheduleResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialTags": { "get": { "description": "Query cost budget: max 100.", "produces": [ "application/json" ], "tags": [ "social_tags" ], "summary": "List social_tags", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "type": "integer", "description": "Limit", "name": "limit", "in": "query" }, { "type": "integer", "description": "Offset", "name": "offset", "in": "query" }, { "type": "string", "description": "Opaque cursor for the next page", "name": "after", "in": "query" }, { "type": "string", "description": "Opaque cursor for the previous page", "name": "before", "in": "query" }, { "type": "boolean", "description": "Include total count", "name": "count", "in": "query" }, { "type": "array", "items": { "enum": [ "color", "created_at", "id", "metadata", "name", "status", "tenant_id", "updated_at" ], "type": "string" }, "collectionFormat": "multi", "description": "Select fields", "name": "fields", "in": "query" }, { "type": "array", "items": { "type": "string" }, "collectionFormat": "multi", "description": "Simple filters. Repeat for AND. Format: field:operator:value. Operators: eq, ne, gt, gte, lt, lte, like, in, is_null, not_null. Example: filter=status:eq:ACTIVE\u0026filter=role.name:eq:ADMIN. Filterable fields: name, color, status", "name": "filter", "in": "query" }, { "type": "string", "description": "Advanced filter expression. Example: (status='ACTIVE' OR status='PENDING') AND (role.name='ADMIN' OR role.name='MANAGER')", "name": "q", "in": "query" }, { "type": "boolean", "description": "Include soft-deleted records", "name": "include_deleted", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialTagListResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_tags" ], "summary": "Create social_tag", "parameters": [ { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialTagCreateRequest" } } ], "responses": { "201": { "description": "Created", "schema": { "$ref": "#/definitions/handlers.SocialTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } }, "/v1/socialTags/{id}": { "get": { "produces": [ "application/json" ], "tags": [ "social_tags" ], "summary": "Get social_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "put": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_tags" ], "summary": "Update social_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialTagUpdateRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "delete": { "produces": [ "application/json" ], "tags": [ "social_tags" ], "summary": "Delete social_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } }, "patch": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "social_tags" ], "summary": "Patch social_tag", "parameters": [ { "type": "string", "description": "ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Tenant ID", "name": "X-TENANT-ID", "in": "header", "required": true }, { "description": "Payload", "name": "payload", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handlers.SocialTagPatchRequest" } } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/handlers.SocialTagResponse" } }, "400": { "description": "Bad Request", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "404": { "description": "Not Found", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } }, "500": { "description": "Internal Server Error", "schema": { "$ref": "#/definitions/handlers.ErrorBody" } } } } } }, "definitions": { "handlers.ErrorBody": { "type": "object", "properties": { "code": { "type": "string" }, "details": {}, "message": { "type": "string" }, "request_id": { "type": "string" } } }, "handlers.SocialAccountListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialAccountResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialAccountPatchRequest": { "type": "object", "properties": { "provider": { "type": "string" } } }, "handlers.SocialAccountPublicCreateRequest": { "type": "object", "required": [ "account_ref", "provider" ], "properties": { "account_ref": { "type": "string" }, "display_name": { "type": "string" }, "metadata": { "type": "string" }, "provider": { "type": "string" }, "scopes": { "type": "string" }, "status": { "type": "string" }, "token_expires_at": { "type": "string" } } }, "handlers.SocialAccountPublicUpdateRequest": { "type": "object", "properties": { "account_ref": { "type": "string" }, "display_name": { "type": "string" }, "metadata": { "type": "string" }, "provider": { "type": "string" }, "scopes": { "type": "string" }, "status": { "type": "string" }, "token_expires_at": { "type": "string" } } }, "handlers.SocialAccountResponse": { "type": "object", "properties": { "account_ref": { "type": "string" }, "created_at": { "type": "string" }, "display_name": { "type": "string" }, "id": { "type": "string" }, "metadata": { "type": "string" }, "provider": { "type": "string" }, "scopes": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "token_expires_at": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialAnalyticsCreateRequest": { "type": "object", "required": [ "provider" ], "properties": { "metrics_json": { "type": "string" }, "period_end": { "type": "string" }, "period_start": { "type": "string" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialAnalyticsListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialAnalyticsResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialAnalyticsPatchRequest": { "type": "object", "properties": { "provider": { "type": "string" } } }, "handlers.SocialAnalyticsResponse": { "type": "object", "properties": { "created_at": { "type": "string" }, "id": { "type": "string" }, "metrics_json": { "type": "string" }, "period_end": { "type": "string" }, "period_start": { "type": "string" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialAnalyticsUpdateRequest": { "type": "object", "properties": { "metrics_json": { "type": "string" }, "period_end": { "type": "string" }, "period_start": { "type": "string" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialAssetCreateRequest": { "type": "object", "required": [ "name", "type", "url" ], "properties": { "metadata": { "type": "string" }, "mime_type": { "type": "string" }, "name": { "type": "string" }, "size_bytes": { "type": "integer" }, "thumb_url": { "type": "string" }, "type": { "type": "string" }, "url": { "type": "string" } } }, "handlers.SocialAssetListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialAssetResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialAssetPatchRequest": { "type": "object", "properties": { "name": { "type": "string" } } }, "handlers.SocialAssetResponse": { "type": "object", "properties": { "created_at": { "type": "string" }, "id": { "type": "string" }, "metadata": { "type": "string" }, "mime_type": { "type": "string" }, "name": { "type": "string" }, "size_bytes": { "type": "integer" }, "tenant_id": { "type": "string" }, "thumb_url": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "type": "string" }, "url": { "type": "string" } } }, "handlers.SocialAssetUpdateRequest": { "type": "object", "properties": { "metadata": { "type": "string" }, "mime_type": { "type": "string" }, "name": { "type": "string" }, "size_bytes": { "type": "integer" }, "thumb_url": { "type": "string" }, "type": { "type": "string" }, "url": { "type": "string" } } }, "handlers.SocialCampaignCreateRequest": { "type": "object", "required": [ "handle", "name" ], "properties": { "end_at": { "type": "string" }, "handle": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "objective": { "type": "string" }, "start_at": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialCampaignListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialCampaignResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialCampaignPatchRequest": { "type": "object", "properties": { "name": { "type": "string" } } }, "handlers.SocialCampaignResponse": { "type": "object", "properties": { "created_at": { "type": "string" }, "end_at": { "type": "string" }, "handle": { "type": "string" }, "id": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "objective": { "type": "string" }, "start_at": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialCampaignUpdateRequest": { "type": "object", "properties": { "end_at": { "type": "string" }, "handle": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "objective": { "type": "string" }, "start_at": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialMetricCreateRequest": { "type": "object", "required": [ "analytics_id", "metric_key" ], "properties": { "analytics_id": { "type": "string" }, "captured_at": { "type": "string" }, "metric_key": { "type": "string" }, "metric_value": { "type": "number" }, "unit": { "type": "string" } } }, "handlers.SocialMetricListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialMetricResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialMetricPatchRequest": { "type": "object", "properties": { "analytics_id": { "type": "string" } } }, "handlers.SocialMetricResponse": { "type": "object", "properties": { "analytics_id": { "type": "string" }, "captured_at": { "type": "string" }, "created_at": { "type": "string" }, "id": { "type": "string" }, "metric_key": { "type": "string" }, "metric_value": { "type": "number" }, "tenant_id": { "type": "string" }, "unit": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialMetricUpdateRequest": { "type": "object", "properties": { "analytics_id": { "type": "string" }, "captured_at": { "type": "string" }, "metric_key": { "type": "string" }, "metric_value": { "type": "number" }, "unit": { "type": "string" } } }, "handlers.SocialPostCreateRequest": { "type": "object", "required": [ "body" ], "properties": { "author_ref": { "type": "string" }, "body": { "type": "string" }, "campaign_id": { "type": "string" }, "external_post_ref": { "type": "string" }, "link_url": { "type": "string" }, "media_json": { "type": "string" }, "metadata": { "type": "string" }, "published_at": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" }, "title": { "type": "string" } } }, "handlers.SocialPostListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialPostResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialPostPatchRequest": { "type": "object", "properties": { "body": { "type": "string" }, "title": { "type": "string" } } }, "handlers.SocialPostResponse": { "type": "object", "properties": { "author_ref": { "type": "string" }, "body": { "type": "string" }, "campaign_id": { "type": "string" }, "created_at": { "type": "string" }, "external_post_ref": { "type": "string" }, "id": { "type": "string" }, "link_url": { "type": "string" }, "media_json": { "type": "string" }, "metadata": { "type": "string" }, "published_at": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "title": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialPostTagCreateRequest": { "type": "object", "required": [ "post_id", "tag_id" ], "properties": { "post_id": { "type": "string" }, "status": { "type": "string" }, "tag_id": { "type": "string" } } }, "handlers.SocialPostTagListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialPostTagResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialPostTagPatchRequest": { "type": "object", "properties": { "post_id": { "type": "string" } } }, "handlers.SocialPostTagResponse": { "type": "object", "properties": { "created_at": { "type": "string" }, "id": { "type": "string" }, "post_id": { "type": "string" }, "status": { "type": "string" }, "tag_id": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialPostTagUpdateRequest": { "type": "object", "properties": { "post_id": { "type": "string" }, "status": { "type": "string" }, "tag_id": { "type": "string" } } }, "handlers.SocialPostTargetCreateRequest": { "type": "object", "required": [ "post_id", "profile_id", "provider" ], "properties": { "error_message": { "type": "string" }, "external_ref": { "type": "string" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider": { "type": "string" }, "published_at": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialPostTargetListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialPostTargetResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialPostTargetPatchRequest": { "type": "object", "properties": { "post_id": { "type": "string" } } }, "handlers.SocialPostTargetResponse": { "type": "object", "properties": { "created_at": { "type": "string" }, "error_message": { "type": "string" }, "external_ref": { "type": "string" }, "id": { "type": "string" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider": { "type": "string" }, "published_at": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialPostTargetUpdateRequest": { "type": "object", "properties": { "error_message": { "type": "string" }, "external_ref": { "type": "string" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider": { "type": "string" }, "published_at": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialPostUpdateRequest": { "type": "object", "properties": { "author_ref": { "type": "string" }, "body": { "type": "string" }, "campaign_id": { "type": "string" }, "external_post_ref": { "type": "string" }, "link_url": { "type": "string" }, "media_json": { "type": "string" }, "metadata": { "type": "string" }, "published_at": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" }, "title": { "type": "string" } } }, "handlers.SocialProfileCreateRequest": { "type": "object", "required": [ "account_id", "profile_ref", "provider" ], "properties": { "account_id": { "type": "string" }, "avatar_url": { "type": "string" }, "display_name": { "type": "string" }, "metadata": { "type": "string" }, "profile_ref": { "type": "string" }, "profile_url": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" }, "timezone": { "type": "string" }, "username": { "type": "string" } } }, "handlers.SocialProfileListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialProfileResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialProfilePatchRequest": { "type": "object", "properties": { "account_id": { "type": "string" } } }, "handlers.SocialProfileResponse": { "type": "object", "properties": { "account_id": { "type": "string" }, "avatar_url": { "type": "string" }, "created_at": { "type": "string" }, "display_name": { "type": "string" }, "id": { "type": "string" }, "metadata": { "type": "string" }, "profile_ref": { "type": "string" }, "profile_url": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "timezone": { "type": "string" }, "updated_at": { "type": "string" }, "username": { "type": "string" } } }, "handlers.SocialProfileUpdateRequest": { "type": "object", "properties": { "account_id": { "type": "string" }, "avatar_url": { "type": "string" }, "display_name": { "type": "string" }, "metadata": { "type": "string" }, "profile_ref": { "type": "string" }, "profile_url": { "type": "string" }, "provider": { "type": "string" }, "status": { "type": "string" }, "timezone": { "type": "string" }, "username": { "type": "string" } } }, "handlers.SocialQueueItemCreateRequest": { "type": "object", "required": [ "post_id", "profile_id" ], "properties": { "attempt_count": { "type": "integer" }, "external_ref": { "type": "string" }, "last_attempt_at": { "type": "string" }, "last_error_code": { "type": "string" }, "last_error_message": { "type": "string" }, "lock_expires_at": { "type": "string" }, "locked_at": { "type": "string" }, "locked_by": { "type": "string" }, "max_attempts": { "type": "integer" }, "next_retry_at": { "type": "string" }, "position": { "type": "integer" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider_idempotency_key": { "type": "string" }, "published_at": { "type": "string" }, "schedule_id": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialQueueItemListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialQueueItemResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialQueueItemPatchRequest": { "type": "object", "properties": { "profile_id": { "type": "string" } } }, "handlers.SocialQueueItemResponse": { "type": "object", "properties": { "attempt_count": { "type": "integer" }, "created_at": { "type": "string" }, "external_ref": { "type": "string" }, "id": { "type": "string" }, "last_attempt_at": { "type": "string" }, "last_error_code": { "type": "string" }, "last_error_message": { "type": "string" }, "lock_expires_at": { "type": "string" }, "locked_at": { "type": "string" }, "locked_by": { "type": "string" }, "max_attempts": { "type": "integer" }, "next_retry_at": { "type": "string" }, "position": { "type": "integer" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider_idempotency_key": { "type": "string" }, "published_at": { "type": "string" }, "schedule_id": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialQueueItemUpdateRequest": { "type": "object", "properties": { "attempt_count": { "type": "integer" }, "external_ref": { "type": "string" }, "last_attempt_at": { "type": "string" }, "last_error_code": { "type": "string" }, "last_error_message": { "type": "string" }, "lock_expires_at": { "type": "string" }, "locked_at": { "type": "string" }, "locked_by": { "type": "string" }, "max_attempts": { "type": "integer" }, "next_retry_at": { "type": "string" }, "position": { "type": "integer" }, "post_id": { "type": "string" }, "profile_id": { "type": "string" }, "provider_idempotency_key": { "type": "string" }, "published_at": { "type": "string" }, "schedule_id": { "type": "string" }, "scheduled_at": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialScheduleCreateRequest": { "type": "object", "required": [ "name", "time_of_day" ], "properties": { "days_of_week": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "profile_id": { "type": "string" }, "status": { "type": "string" }, "time_of_day": { "type": "string" }, "timezone": { "type": "string" } } }, "handlers.SocialScheduleListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialScheduleResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialSchedulePatchRequest": { "type": "object", "properties": { "name": { "type": "string" }, "profile_id": { "type": "string" } } }, "handlers.SocialScheduleResponse": { "type": "object", "properties": { "created_at": { "type": "string" }, "days_of_week": { "type": "string" }, "id": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "profile_id": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_of_day": { "type": "string" }, "timezone": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialScheduleUpdateRequest": { "type": "object", "properties": { "days_of_week": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "profile_id": { "type": "string" }, "status": { "type": "string" }, "time_of_day": { "type": "string" }, "timezone": { "type": "string" } } }, "handlers.SocialTagCreateRequest": { "type": "object", "required": [ "name" ], "properties": { "color": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" } } }, "handlers.SocialTagListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/handlers.SocialTagResponse" } }, "limit": { "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } } }, "handlers.SocialTagPatchRequest": { "type": "object", "properties": { "name": { "type": "string" } } }, "handlers.SocialTagResponse": { "type": "object", "properties": { "color": { "type": "string" }, "created_at": { "type": "string" }, "id": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "updated_at": { "type": "string" } } }, "handlers.SocialTagUpdateRequest": { "type": "object", "properties": { "color": { "type": "string" }, "metadata": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" } } } } }