{ "components": { "schemas": { "DeveloperErrorResponse": { "properties": { "code": { "title": "Code", "type": "string" }, "detail": { "title": "Detail", "type": "string" }, "request_id": { "title": "Request Id", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" } }, "required": [ "detail", "code", "retryable", "request_id" ], "title": "DeveloperErrorResponse", "type": "object" }, "DeveloperTokenResponse": { "properties": { "access_token": { "title": "Access Token", "type": "string" }, "expires_in": { "title": "Expires In", "type": "integer" }, "scope": { "title": "Scope", "type": "string" }, "token_type": { "title": "Token Type", "type": "string" } }, "required": [ "access_token", "token_type", "expires_in", "scope" ], "title": "DeveloperTokenResponse", "type": "object" }, "PublicAggregate": { "properties": { "as_of": { "title": "As Of", "type": "string" }, "metric": { "title": "Metric", "type": "string" }, "purpose": { "title": "Purpose", "type": "string" }, "region": { "title": "Region", "type": "string" }, "value": { "title": "Value", "type": "number" } }, "required": [ "metric", "value", "as_of", "purpose", "region" ], "title": "PublicAggregate", "type": "object" }, "PublicAttributionEventRequest": { "additionalProperties": false, "properties": { "campaign_id": { "maxLength": 160, "minLength": 1, "title": "Campaign Id", "type": "string" }, "consent_ref": { "maxLength": 160, "minLength": 1, "title": "Consent Ref", "type": "string" }, "creative_id": { "maxLength": 160, "minLength": 1, "title": "Creative Id", "type": "string" }, "occurred_at": { "maxLength": 40, "minLength": 1, "title": "Occurred At", "type": "string" }, "placement_id": { "maxLength": 160, "minLength": 1, "title": "Placement Id", "type": "string" }, "request_key": { "maxLength": 160, "minLength": 1, "title": "Request Key", "type": "string" }, "source": { "maxLength": 160, "minLength": 1, "title": "Source", "type": "string" }, "tenant_id": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" }, "touchpoint": { "enum": [ "VIEW", "CLICK", "OUTBOUND" ], "title": "Touchpoint", "type": "string" } }, "required": [ "tenant_id", "campaign_id", "creative_id", "placement_id", "source", "consent_ref", "touchpoint", "occurred_at", "request_key" ], "title": "PublicAttributionEventRequest", "type": "object" }, "PublicAttributionEventResponse": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "title": "Status", "type": "string" } }, "required": [ "id", "status" ], "title": "PublicAttributionEventResponse", "type": "object" }, "PublicCreatorDisplay": { "properties": { "id": { "title": "Id", "type": "string" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ], "title": "PublicCreatorDisplay", "type": "object" }, "PublicDiscoveryItem": { "properties": { "category": { "title": "Category", "type": "string" }, "id": { "title": "Id", "type": "string" }, "image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Image Url" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "category", "image_url" ], "title": "PublicDiscoveryItem", "type": "object" }, "PublicDiscoveryPage": { "properties": { "items": { "items": { "$ref": "#/components/schemas/PublicDiscoveryItem" }, "title": "Items", "type": "array" }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Next Cursor" } }, "required": [ "items", "next_cursor" ], "title": "PublicDiscoveryPage", "type": "object" }, "PublicDiscoveryReviewRequest": { "additionalProperties": false, "properties": { "request_key": { "title": "Request Key", "type": "string" }, "tenant_id": { "title": "Tenant Id", "type": "string" } }, "required": [ "tenant_id", "request_key" ], "title": "PublicDiscoveryReviewRequest", "type": "object" }, "PublicDiscoveryReviewStatus": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "title": "Status", "type": "string" } }, "required": [ "id", "status" ], "title": "PublicDiscoveryReviewStatus", "type": "object" }, "PublicMediaItem": { "properties": { "asset_id": { "title": "Asset Id", "type": "string" }, "mime_type": { "title": "Mime Type", "type": "string" }, "sha256": { "title": "Sha256", "type": "string" }, "url": { "title": "Url", "type": "string" }, "version": { "title": "Version", "type": "string" } }, "required": [ "asset_id", "version", "sha256", "mime_type", "url" ], "title": "PublicMediaItem", "type": "object" }, "PublicMediaSubmissionRequest": { "properties": { "asset_id": { "title": "Asset Id", "type": "string" }, "product_id": { "title": "Product Id", "type": "string" }, "region": { "title": "Region", "type": "string" }, "request_key": { "title": "Request Key", "type": "string" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "version": { "title": "Version", "type": "string" } }, "required": [ "tenant_id", "region", "product_id", "asset_id", "version", "request_key" ], "title": "PublicMediaSubmissionRequest", "type": "object" }, "PublicMediaSubmissionResponse": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "title": "Status", "type": "string" }, "version": { "title": "Version", "type": "string" } }, "required": [ "id", "status", "version" ], "title": "PublicMediaSubmissionResponse", "type": "object" }, "PublicRightsEvidenceRequest": { "additionalProperties": false, "properties": { "basis": { "enum": [ "FIRST_PARTY", "LICENSED" ], "title": "Basis", "type": "string" }, "evidence_ref": { "maxLength": 160, "minLength": 1, "title": "Evidence Ref", "type": "string" }, "request_key": { "maxLength": 160, "minLength": 1, "title": "Request Key", "type": "string" }, "tenant_id": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, "required": [ "tenant_id", "basis", "evidence_ref", "request_key" ], "title": "PublicRightsEvidenceRequest", "type": "object" }, "PublicRightsStatus": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "title": "Status", "type": "string" } }, "required": [ "id", "status" ], "title": "PublicRightsStatus", "type": "object" }, "PublicStoreDisplay": { "properties": { "id": { "title": "Id", "type": "string" }, "name": { "title": "Name", "type": "string" } }, "required": [ "id", "name" ], "title": "PublicStoreDisplay", "type": "object" }, "PublicWebhookEndpoint": { "properties": { "id": { "title": "Id", "type": "string" }, "key_id": { "title": "Key Id", "type": "string" }, "url": { "title": "Url", "type": "string" } }, "required": [ "id", "url", "key_id" ], "title": "PublicWebhookEndpoint", "type": "object" }, "PublicWebhookEndpointPage": { "properties": { "items": { "items": { "$ref": "#/components/schemas/PublicWebhookEndpoint" }, "title": "Items", "type": "array" }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Next Cursor" } }, "required": [ "items", "next_cursor" ], "title": "PublicWebhookEndpointPage", "type": "object" }, "PublicWebhookRegistrationRequest": { "additionalProperties": false, "properties": { "tenant_id": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" }, "url": { "maxLength": 2048, "minLength": 1, "title": "Url", "type": "string" } }, "required": [ "tenant_id", "url" ], "title": "PublicWebhookRegistrationRequest", "type": "object" }, "PublicWebhookRegistrationResponse": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "const": "PENDING", "title": "Status", "type": "string" } }, "required": [ "id", "status" ], "title": "PublicWebhookRegistrationResponse", "type": "object" }, "PublicWebhookRequestStatus": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "enum": [ "PENDING", "HOST_APPROVED", "REJECTED" ], "title": "Status", "type": "string" } }, "required": [ "id", "status" ], "title": "PublicWebhookRequestStatus", "type": "object" }, "PublicWebhookRevocationResponse": { "properties": { "id": { "title": "Id", "type": "string" }, "status": { "const": "REVOKED", "title": "Status", "type": "string" } }, "required": [ "id", "status" ], "title": "PublicWebhookRevocationResponse", "type": "object" } } }, "info": { "description": "FG3-SPEC-004.1; review draft, unavailable to external clients", "title": "FULLGEAR³ Developer API", "version": "1.0.0-unreleased" }, "openapi": "3.1.0", "paths": { "/api/developer/oauth/token": { "post": { "description": "Unreleased sandbox Client Credentials; no production token can be issued.", "operationId": "developer_oauth_token_api_developer_oauth_token_post", "parameters": [ { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "properties": { "grant_type": { "enum": [ "client_credentials" ], "type": "string" }, "scope": { "type": "string" } }, "required": [ "grant_type", "scope" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperTokenResponse" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Credential request is too large" }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Form encoding required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Developer Oauth Token", "tags": [ "developer-oauth" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 413, 415, 422, 429, 503 ], "x-example": { "access_token": "", "expires_in": 3600, "scope": "discovery.read", "token_type": "Bearer" }, "x-release-state": "UNRELEASED", "x-required-scope": "client_credentials" } }, "/api/developer/v1/analytics/aggregates/{metric}": { "get": { "operationId": "public_aggregate_api_developer_v1_analytics_aggregates__metric__get", "parameters": [ { "in": "path", "name": "metric", "required": true, "schema": { "maxLength": 80, "minLength": 1, "title": "Metric", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "region", "required": true, "schema": { "maxLength": 40, "minLength": 1, "title": "Region", "type": "string" } }, { "in": "query", "name": "purpose", "required": true, "schema": { "maxLength": 80, "minLength": 1, "title": "Purpose", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicAggregate" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Aggregate", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "as_of": "2026-01-01T00:00:00Z", "metric": "example", "purpose": "example", "region": "example", "value": 0 }, "x-release-state": "UNRELEASED", "x-required-scope": "analytics.aggregate.read" } }, "/api/developer/v1/attribution/events": { "post": { "operationId": "public_attribution_event_api_developer_v1_attribution_events_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Idempotency-Key", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicAttributionEventRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicAttributionEventResponse" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Conflicting submission" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Attribution Event", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 409, 422, 429, 503 ], "x-example": { "id": "example", "status": "RECEIVED_UNVERIFIED" }, "x-release-state": "UNRELEASED", "x-required-scope": "attribution.write" } }, "/api/developer/v1/creators/{creator_id}": { "get": { "operationId": "public_creator_display_api_developer_v1_creators__creator_id__get", "parameters": [ { "in": "path", "name": "creator_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Creator Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "region", "required": true, "schema": { "maxLength": 40, "minLength": 1, "title": "Region", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicCreatorDisplay" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Creator Display", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "id": "synthetic-creator", "name": "Synthetic creator" }, "x-release-state": "UNRELEASED", "x-required-scope": "creators.read" } }, "/api/developer/v1/discovery/items": { "get": { "operationId": "public_discovery_items_api_developer_v1_discovery_items_get", "parameters": [ { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "region", "required": true, "schema": { "maxLength": 40, "minLength": 1, "title": "Region", "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "anyOf": [ { "maxLength": 160, "type": "string" }, { "type": "null" } ], "title": "Cursor" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "maximum": 50, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicDiscoveryPage" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Discovery Items", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 422, 429, 503 ], "x-example": { "items": [] }, "x-release-state": "UNRELEASED", "x-required-scope": "discovery.read" } }, "/api/developer/v1/discovery/items/{product_id}/media": { "get": { "operationId": "public_discovery_media_api_developer_v1_discovery_items__product_id__media_get", "parameters": [ { "in": "path", "name": "product_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Product Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "region", "required": true, "schema": { "maxLength": 40, "minLength": 1, "title": "Region", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/PublicMediaItem" }, "title": "Response Public Discovery Media Api Developer V1 Discovery Items Product Id Media Get", "type": "array" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Discovery Media", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 422, 429, 503 ], "x-example": [], "x-release-state": "UNRELEASED", "x-required-scope": "discovery.read" } }, "/api/developer/v1/media/submissions": { "post": { "operationId": "public_media_submission_api_developer_v1_media_submissions_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Idempotency-Key", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicMediaSubmissionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicMediaSubmissionResponse" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Conflicting submission" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Media Submission", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 409, 422, 429, 503 ], "x-example": { "id": "example", "status": "SUBMITTED", "version": "1" }, "x-release-state": "UNRELEASED", "x-required-scope": "creator_media.write" } }, "/api/developer/v1/media/submissions/{submission_id}": { "get": { "operationId": "public_media_submission_status_api_developer_v1_media_submissions__submission_id__get", "parameters": [ { "in": "path", "name": "submission_id", "required": true, "schema": { "maxLength": 64, "minLength": 64, "title": "Submission Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicMediaSubmissionResponse" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Media Submission Status", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "id": "example", "status": "SUBMITTED", "version": "1" }, "x-release-state": "UNRELEASED", "x-required-scope": "creator_media.write" } }, "/api/developer/v1/media/submissions/{submission_id}/discovery-review": { "post": { "operationId": "public_discovery_review_request_api_developer_v1_media_submissions__submission_id__discovery_review_post", "parameters": [ { "in": "path", "name": "submission_id", "required": true, "schema": { "maxLength": 64, "minLength": 64, "title": "Submission Id", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Idempotency-Key", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicDiscoveryReviewRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicDiscoveryReviewStatus" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Conflicting submission" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Discovery Review Request", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 409, 422, 429, 503 ], "x-example": { "id": "example", "status": "REQUESTED" }, "x-release-state": "UNRELEASED", "x-required-scope": "discoverysubmission.write" } }, "/api/developer/v1/media/submissions/{submission_id}/distribution-status": { "get": { "operationId": "public_distribution_status_api_developer_v1_media_submissions__submission_id__distribution_status_get", "parameters": [ { "in": "path", "name": "submission_id", "required": true, "schema": { "maxLength": 64, "minLength": 64, "title": "Submission Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicDiscoveryReviewStatus" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Distribution Status", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "id": "example", "status": "REQUESTED" }, "x-release-state": "UNRELEASED", "x-required-scope": "distributionstatus.read" } }, "/api/developer/v1/media/submissions/{submission_id}/rights": { "get": { "operationId": "public_media_submission_rights_api_developer_v1_media_submissions__submission_id__rights_get", "parameters": [ { "in": "path", "name": "submission_id", "required": true, "schema": { "maxLength": 64, "minLength": 64, "title": "Submission Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicRightsStatus" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Media Submission Rights", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "id": "example", "status": "PENDING" }, "x-release-state": "UNRELEASED", "x-required-scope": "rights.write" } }, "/api/developer/v1/media/submissions/{submission_id}/rights-evidence": { "post": { "operationId": "public_rights_evidence_submission_api_developer_v1_media_submissions__submission_id__rights_evidence_post", "parameters": [ { "in": "path", "name": "submission_id", "required": true, "schema": { "maxLength": 64, "minLength": 64, "title": "Submission Id", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Idempotency-Key", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicRightsEvidenceRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicRightsStatus" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Conflicting submission" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Rights Evidence Submission", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 409, 422, 429, 503 ], "x-example": { "id": "example", "status": "RECORDED_UNVERIFIED" }, "x-release-state": "UNRELEASED", "x-required-scope": "rights.write" } }, "/api/developer/v1/products/{product_id}": { "get": { "operationId": "public_product_detail_api_developer_v1_products__product_id__get", "parameters": [ { "in": "path", "name": "product_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Product Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "region", "required": true, "schema": { "maxLength": 40, "minLength": 1, "title": "Region", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicDiscoveryItem" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Product Detail", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "category": "JACKET", "id": "synthetic-product", "title": "Synthetic item" }, "x-release-state": "UNRELEASED", "x-required-scope": "products.read" } }, "/api/developer/v1/stores/{store_id}": { "get": { "operationId": "public_store_display_api_developer_v1_stores__store_id__get", "parameters": [ { "in": "path", "name": "store_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Store Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "region", "required": true, "schema": { "maxLength": 40, "minLength": 1, "title": "Region", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicStoreDisplay" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Store Display", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "id": "synthetic-store", "name": "Synthetic store" }, "x-release-state": "UNRELEASED", "x-required-scope": "stores.read" } }, "/api/developer/v1/webhooks/endpoints": { "get": { "operationId": "public_reviewed_webhook_endpoints_api_developer_v1_webhooks_endpoints_get", "parameters": [ { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "anyOf": [ { "maxLength": 160, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Cursor" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "maximum": 50, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicWebhookEndpointPage" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Reviewed Webhook Endpoints", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 422, 429, 503 ], "x-example": { "items": [ { "id": "synthetic-endpoint", "key_id": "key-example", "url": "https://hooks.example.com/example" } ], "next_cursor": "synthetic-endpoint" }, "x-release-state": "UNRELEASED", "x-required-scope": "webhooks.manage" } }, "/api/developer/v1/webhooks/endpoints/{endpoint_id}": { "delete": { "operationId": "public_revoke_webhook_endpoint_api_developer_v1_webhooks_endpoints__endpoint_id__delete", "parameters": [ { "in": "path", "name": "endpoint_id", "required": true, "schema": { "maxLength": 32, "minLength": 32, "title": "Endpoint Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Idempotency-Key", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicWebhookRevocationResponse" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Conflicting submission" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Revoke Webhook Endpoint", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 409, 422, 429, 503 ], "x-example": { "id": "synthetic-endpoint", "status": "REVOKED" }, "x-release-state": "UNRELEASED", "x-required-scope": "webhooks.manage" } }, "/api/developer/v1/webhooks/requests": { "post": { "operationId": "public_request_webhook_endpoint_api_developer_v1_webhooks_requests_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Idempotency-Key", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicWebhookRegistrationRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicWebhookRegistrationResponse" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Conflicting submission" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Request Webhook Endpoint", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 409, 422, 429, 503 ], "x-example": { "id": "synthetic-request", "status": "PENDING" }, "x-release-state": "UNRELEASED", "x-required-scope": "webhooks.manage" } }, "/api/developer/v1/webhooks/requests/{request_id}": { "get": { "operationId": "public_webhook_request_status_api_developer_v1_webhooks_requests__request_id__get", "parameters": [ { "in": "path", "name": "request_id", "required": true, "schema": { "maxLength": 64, "minLength": 64, "title": "Request Id", "type": "string" } }, { "in": "query", "name": "tenant_id", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "Tenant Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicWebhookRequestStatus" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer credential missing or invalid" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Scope, tenant, rights or consent denied" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Requested resource unavailable" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Missing or invalid request field" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer sandbox rate limit exceeded" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeveloperErrorResponse" } } }, "description": "Developer authentication unavailable" } }, "summary": "Public Webhook Request Status", "tags": [ "developer-v1" ], "x-auth-flow": "OAuth2 Client Credentials (sandbox only, disabled by default)", "x-error-status": [ 400, 401, 403, 404, 422, 429, 503 ], "x-example": { "id": "synthetic-request", "status": "PENDING" }, "x-release-state": "UNRELEASED", "x-required-scope": "webhooks.manage" } } } }