{"openapi":"3.1.1","info":{"title":"Luximio Customer API","version":"1.3.0","description":"Project-scoped inspection, explicit draft editing, separately gated durable publication and server-side diagnostics. Existing credentials retain their original scopes; new publication and diagnostic permissions are explicit opt-ins. Customer credentials never authorize protected recovery setup, billing, account management, domain provisioning or internal resolver administration."},"servers":[{"url":"https://dash.luximio.app/api/v1"}],"paths":{"/projects/{projectId}":{"get":{"operationId":"getProject","summary":"Inspect the authorized project","description":"Requires project:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Query parameters are not accepted.","security":[{"ProjectBearer":[]}],"x-required-scopes":["project:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"},"example":{"project":{"id":"project_example","name":"Example app","slug":"example-app","primaryDomain":"example.links.luximio.app","createdAt":"2026-11-04T12:00:00.000Z","updatedAt":"2026-11-04T12:00:00.000Z"}}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getProjectHeaders","summary":"Inspect the authorized project (headers only)","description":"Requires project:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Query parameters are not accepted.","security":[{"ProjectBearer":[]}],"x-required-scopes":["project:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}}},"/projects/{projectId}/domains":{"get":{"operationId":"listProjectDomains","summary":"List stored domain and DNS setup state","description":"Requires project:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Ordered ascending by immutable stored (created_at, id). Pagination is not a snapshot; concurrent inserts or archival may change later pages. Unknown and duplicate query parameters are rejected.","security":[{"ProjectBearer":[]}],"x-required-scopes":["project:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"description":"Page size, without leading zeroes."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":2048},"description":"Opaque cursor returned by this project and collection. Do not construct or reuse it for another collection."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainsResponse"},"example":{"domains":[{"id":"domain_example","hostname":"example.links.luximio.app","type":"managed","isPrimary":true,"verificationStatus":"verified","deliveryStatus":"active","dnsRecords":[],"createdAt":"2026-11-04T12:00:00.000Z","updatedAt":"2026-11-04T12:00:00.000Z"}],"pagination":{"limit":25,"hasMore":false,"nextCursor":null}}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"listProjectDomainsHeaders","summary":"List stored domain and DNS setup state (headers only)","description":"Requires project:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Ordered ascending by immutable stored (created_at, id). Pagination is not a snapshot; concurrent inserts or archival may change later pages. Unknown and duplicate query parameters are rejected.","security":[{"ProjectBearer":[]}],"x-required-scopes":["project:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"description":"Page size, without leading zeroes."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":2048},"description":"Opaque cursor returned by this project and collection. Do not construct or reuse it for another collection."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}}},"/projects/{projectId}/configuration":{"get":{"operationId":"getProjectConfiguration","summary":"Read direct app-link configuration","description":"Requires configuration:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Query parameters are not accepted.","security":[{"ProjectBearer":[]}],"x-required-scopes":["configuration:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"If-None-Match","in":"header","schema":{"type":"string"},"description":"Strong or weak ETag from a previous read; authentication and rate limits are checked even for 304."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"},"description":"SHA-256 of the exact public response representation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigurationResponse"},"example":{"configuration":{"projectId":"project_example","iosTeamId":"ABCDE12345","iosBundleId":"com.example.app","androidPackageName":"","androidSha256CertFingerprints":[],"revision":1,"publishedRevision":null,"hasUnpublishedChanges":true,"updatedAt":"2026-11-04T12:00:00.000Z","publishedAt":null}}}}},"304":{"description":"Representation unchanged, after successful authorization.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getProjectConfigurationHeaders","summary":"Read direct app-link configuration (headers only)","description":"Requires configuration:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Query parameters are not accepted.","security":[{"ProjectBearer":[]}],"x-required-scopes":["configuration:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"If-None-Match","in":"header","schema":{"type":"string"},"description":"Strong or weak ETag from a previous read; authentication and rate limits are checked even for 304."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"},"description":"SHA-256 of the exact public response representation."}}},"304":{"description":"Representation unchanged, after successful authorization.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}},"put":{"operationId":"replaceProjectConfiguration","summary":"Replace direct app-configuration draft fields","description":"Requires configuration:write and API write mode. Saves a direct-link draft only; never publishes or contacts the resolver. At least one complete iOS or Android group is required. Entirely omitted groups become disabled empty fields. Existing two-platform records retain their shape. Unknown fields, deferred setup, ownership, domain, revision and publication fields cannot be supplied. When protected setup exists, changes to the whole base identity/proof set are rejected; omitted protected metadata is preserved exactly. Current owner authority and terms are rechecked. No-op replacements retain their revision and ETag. If-Match is compared atomically, including publication and hidden protected state. Single-platform direct setup does not establish deferred-recovery readiness.","security":[{"ProjectBearer":[]}],"x-required-scopes":["configuration:write"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"},"description":"Exactly one strong ETag from the configuration GET. Wildcards, weak tags, and lists are rejected."}],"requestBody":{"required":true,"x-max-body-bytes":16384,"description":"UTF-8 application/json, at most 16,384 bytes including whitespace. Query parameters are not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigurationInput"},"example":{"iosTeamId":"ABCDE12345","iosBundleId":"com.example.app"}}}},"responses":{"200":{"description":"Direct app-configuration draft replaced, or unchanged.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"}},"Location":{"schema":{"type":"string"},"description":"Canonical relative configuration resource path."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigurationResponse"},"example":{"configuration":{"projectId":"project_example","iosTeamId":"ABCDE12345","iosBundleId":"com.example.app","androidPackageName":"","androidSha256CertFingerprints":[],"revision":1,"publishedRevision":null,"hasUnpublishedChanges":true,"updatedAt":"2026-11-04T12:00:00.000Z","publishedAt":null}}}}},"400":{"description":"validation_failed: invalid JSON, unknown fields, incomplete platforms, invalid identities, unsupported query, or malformed If-Match.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"state_conflict, protected_configuration, or terms_acceptance_required. Protected setup must be managed through its existing authorized flow.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"revision_mismatch: read fresh configuration before retrying.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"request_too_large: the streamed body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"unsupported_media_type: send application/json.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"428":{"description":"precondition_required: If-Match is required.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"API disabled, api_read_only, maintenance, or temporary dependency failure.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/links":{"get":{"operationId":"listProjectLinks","summary":"List non-archived links","description":"Requires links:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Ordered ascending by immutable stored (created_at, id). Pagination is not a snapshot; concurrent inserts or archival may change later pages. Unknown and duplicate query parameters are rejected.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"description":"Page size, without leading zeroes."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":2048},"description":"Opaque cursor returned by this project and collection. Do not construct or reuse it for another collection."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinksResponse"},"example":{"links":[],"pagination":{"limit":25,"hasMore":false,"nextCursor":null}}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"listProjectLinksHeaders","summary":"List non-archived links (headers only)","description":"Requires links:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Ordered ascending by immutable stored (created_at, id). Pagination is not a snapshot; concurrent inserts or archival may change later pages. Unknown and duplicate query parameters are rejected.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"description":"Page size, without leading zeroes."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":2048},"description":"Opaque cursor returned by this project and collection. Do not construct or reuse it for another collection."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}},"post":{"operationId":"createProjectLink","summary":"Create a link draft","description":"Requires links:write and customer API write mode. Saves dashboard draft state only; never publishes or contacts the resolver. Query parameters and unknown body fields are rejected. Title, path and webFallbackUrl are required. Omitted optional destinations reset to null. Server-owned identity, ownership, revision and publication fields cannot be supplied. The idempotency key is bound to the project, method, normalized route and normalized request. Within its 24-hour window, identical replay returns the original 201 body, ETag and Location even if the link was subsequently edited. Current authentication, scope and account restrictions are rechecked before replay. A different request with the same key returns 409. After expiry, deduplication is not guaranteed.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:write"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[\\x21-\\x7e]{1,128}$"},"description":"Visible ASCII without whitespace. Reuse the same key and normalized input for retries within 24 hours. Missing/invalid keys return 400."}],"requestBody":{"required":true,"description":"UTF-8 application/json body capped at 16,384 bytes, including whitespace. Full replacement of the public editable fields.","x-max-body-bytes":16384,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkInput"},"example":{"title":"Example product","path":"product","webFallbackUrl":"https://example.com/product","appDestination":{"route":"products/details","data":{"productId":"123"}}}}}},"responses":{"201":{"description":"Link draft created, or the original successful response replayed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"},"description":"Strong ETag of the returned LinkResponse representation."},"Location":{"schema":{"type":"string"},"description":"Canonical relative link resource path: /api/v1/projects/{projectId}/links/{linkId}."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkResponse"},"example":{"link":{"id":"link_example","projectId":"project_example","hostname":"example.links.luximio.app","path":"product","url":"https://example.links.luximio.app/product","title":"Example product","webFallbackUrl":"https://example.com/product","iosFallbackUrl":null,"androidFallbackUrl":null,"appDestination":{"route":"products/details","data":{"productId":"123"}},"status":"draft","createdAt":"2026-11-04T12:00:00.000Z","revision":1,"publishedRevision":null,"hasUnpublishedChanges":true,"updatedAt":"2026-11-04T12:00:00.000Z","publishedAt":null}}}}},"400":{"description":"validation_failed: invalid JSON, unknown fields, invalid link fields, unsupported query or malformed conditional/idempotency header.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"account_restricted: the workspace account currently does not allow creating new drafts, including create replay.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"path_taken, state_conflict, idempotency_conflict, or terms_acceptance_required. A signed-in owner must accept current terms; the credential cannot do so.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"request_too_large: the streamed JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"unsupported_media_type: send application/json.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"API disabled, api_read_only, maintenance, or temporary dependency failure. Draft writes require write mode and no write freeze.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/links/{linkId}":{"get":{"operationId":"getProjectLink","summary":"Read a non-archived link","description":"Requires links:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Query parameters are not accepted.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-None-Match","in":"header","schema":{"type":"string"},"description":"Strong or weak ETag from a previous read; authentication and rate limits are checked even for 304."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"},"description":"SHA-256 of the exact public response representation."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkResponse"},"example":{"link":{"id":"link_example","projectId":"project_example","hostname":"example.links.luximio.app","path":"product","url":"https://example.links.luximio.app/product","title":"Example product","webFallbackUrl":"https://example.com/product","iosFallbackUrl":null,"androidFallbackUrl":null,"appDestination":{"route":"products/details","data":{"productId":"123"}},"status":"draft","createdAt":"2026-11-04T12:00:00.000Z","revision":1,"publishedRevision":null,"hasUnpublishedChanges":true,"updatedAt":"2026-11-04T12:00:00.000Z","publishedAt":null}}}}},"304":{"description":"Representation unchanged, after successful authorization.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getProjectLinkHeaders","summary":"Read a non-archived link (headers only)","description":"Requires links:read. Read-only; no session refresh, provisioning, publication, billing synchronization or outgoing probes. Query parameters are not accepted.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:read"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-None-Match","in":"header","schema":{"type":"string"},"description":"Strong or weak ETag from a previous read; authentication and rate limits are checked even for 304."}],"responses":{"200":{"description":"Project-scoped representation.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"},"description":"SHA-256 of the exact public response representation."}}},"304":{"description":"Representation unchanged, after successful authorization.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}},"put":{"operationId":"replaceProjectLink","summary":"Replace editable link draft fields","description":"Requires links:write and customer API write mode. Saves dashboard draft state only; never publishes or contacts the resolver. Query parameters and unknown body fields are rejected. Title, path and webFallbackUrl are required. Omitted optional destinations reset to null. Server-owned identity, ownership, revision and publication fields cannot be supplied. If-Match is compared atomically with current resource state. An unchanged replacement keeps its revision and creates no duplicate success event. Edits to an already published link preserve its live destination until a separate publication workflow.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:write"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"},"description":"Exactly one strong ETag from a link read/create/update. Missing returns 428; weak tags, *, lists and malformed tags return 400; stale tags return 412."}],"requestBody":{"required":true,"description":"UTF-8 application/json body capped at 16,384 bytes, including whitespace. Full replacement of the public editable fields.","x-max-body-bytes":16384,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkInput"},"example":{"title":"Example product","path":"product","webFallbackUrl":"https://example.com/product","appDestination":{"route":"products/details","data":{"productId":"123"}}}}}},"responses":{"200":{"description":"Link draft replaced.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"ETag":{"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"},"description":"Strong ETag of the returned LinkResponse representation."},"Location":{"schema":{"type":"string"},"description":"Canonical relative link resource path: /api/v1/projects/{projectId}/links/{linkId}."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkResponse"},"example":{"link":{"id":"link_example","projectId":"project_example","hostname":"example.links.luximio.app","path":"product","url":"https://example.links.luximio.app/product","title":"Example product","webFallbackUrl":"https://example.com/product","iosFallbackUrl":null,"androidFallbackUrl":null,"appDestination":{"route":"products/details","data":{"productId":"123"}},"status":"draft","createdAt":"2026-11-04T12:00:00.000Z","revision":1,"publishedRevision":null,"hasUnpublishedChanges":true,"updatedAt":"2026-11-04T12:00:00.000Z","publishedAt":null}}}}},"400":{"description":"validation_failed: invalid JSON, unknown fields, invalid link fields, unsupported query or malformed conditional/idempotency header.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"path_taken, state_conflict, idempotency_conflict, or terms_acceptance_required. A signed-in owner must accept current terms; the credential cannot do so.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"revision_mismatch: the link changed; read fresh state before replacing it.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"request_too_large: the streamed JSON body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"unsupported_media_type: send application/json.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"428":{"description":"precondition_required: If-Match is required.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"API disabled, api_read_only, maintenance, or temporary dependency failure. Draft writes require write mode and no write freeze.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/links/{linkId}/publish":{"post":{"operationId":"publishProjectLink","summary":"Submit publication of a saved link revision","description":"Requires links:publish, API write mode, PUBLICATION_MODE=enabled and CUSTOMER_API_PUBLISH_ENABLED=true. Enqueues a durable operation and returns 202; submission does not run the publisher. Pins the saved revision and immutable targets. No draft fields are accepted. Current project authority, terms and product publication rules apply. Reusing the same idempotency key and original request returns its original operation before stale ETag checks; a different request is rejected. Authentication and scope checks always precede replay. After detailed results are scrubbed, the original request returns 410 and never schedules another publication. Poll Location; status reads never resume work.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:publish"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[!-~]+$"},"description":"Visible ASCII key without whitespace. Publication identity tombstones outlive detailed results; do not reuse a key for another logical publication."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"},"description":"One strong ETag from the link or configuration GET. Use the original ETag when retrying an interrupted submission."}],"requestBody":{"required":false,"x-max-body-bytes":16384,"description":"No body, a zero-byte body, or application/json {} only. No query parameters or draft fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationInput"},"example":{}}}},"responses":{"202":{"description":"Publication accepted, or the same logical operation replayed. Inspect the operation state; 202 does not assert completion.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Location":{"schema":{"type":"string"},"description":"Canonical operation resource path."},"X-Luximio-Publication-Id":{"schema":{"type":"string"},"description":"Accepted operation identifier; background execution is scheduled by the server."},"Retry-After":{"schema":{"type":"string","const":"2"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"},"example":{"operation":{"id":"operation_example","projectId":"project_example","type":"link_publish","resourceId":"link_example","state":"pending","sourceRevision":1,"generation":1,"createdAt":"2026-11-04T12:00:00.000Z","updatedAt":"2026-11-04T12:00:00.000Z","completedAt":null,"error":null,"targets":[{"hostname":"example.links.luximio.app","state":"pending"}]}}}}},"400":{"description":"validation_failed: invalid key, malformed If-Match, nonempty or invalid body, or query parameters.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"account_restricted: current product publication rules require billing attention.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, plan_limit_reached, cross_origin_forbidden, or project authority withdrawn.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"idempotency_conflict, publication_in_progress, protected_configuration, state_conflict, or terms_acceptance_required.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"operation_expired: the original operation's detailed result was scrubbed. It will not execute again.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"revision_mismatch: use a fresh resource ETag for a new logical publication.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"request_too_large: the actual body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"unsupported_media_type: a nonempty body must be application/json.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"428":{"description":"precondition_required: If-Match is required.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"publication_unavailable, API disabled/read-only, maintenance, or temporary dependency failure.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/configuration/publish":{"post":{"operationId":"publishProjectConfiguration","summary":"Submit publication of the saved app configuration","description":"Requires configuration:publish, API write mode, PUBLICATION_MODE=enabled and CUSTOMER_API_PUBLISH_ENABLED=true. Enqueues a durable operation and returns 202; submission does not run the publisher. Pins the saved revision and immutable targets. No draft fields are accepted. Current project authority, terms and product publication rules apply. Reusing the same idempotency key and original request returns its original operation before stale ETag checks; a different request is rejected. Authentication and scope checks always precede replay. After detailed results are scrubbed, the original request returns 410 and never schedules another publication. Poll Location; status reads never resume work.","security":[{"ProjectBearer":[]}],"x-required-scopes":["configuration:publish"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[!-~]+$"},"description":"Visible ASCII key without whitespace. Publication identity tombstones outlive detailed results; do not reuse a key for another logical publication."},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[a-f0-9]{64}\"$"},"description":"One strong ETag from the link or configuration GET. Use the original ETag when retrying an interrupted submission."}],"requestBody":{"required":false,"x-max-body-bytes":16384,"description":"No body, a zero-byte body, or application/json {} only. No query parameters or draft fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationInput"},"example":{}}}},"responses":{"202":{"description":"Publication accepted, or the same logical operation replayed. Inspect the operation state; 202 does not assert completion.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Location":{"schema":{"type":"string"},"description":"Canonical operation resource path."},"X-Luximio-Publication-Id":{"schema":{"type":"string"},"description":"Accepted operation identifier; background execution is scheduled by the server."},"Retry-After":{"schema":{"type":"string","const":"2"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"},"example":{"operation":{"id":"operation_example","projectId":"project_example","type":"link_publish","resourceId":"link_example","state":"pending","sourceRevision":1,"generation":1,"createdAt":"2026-11-04T12:00:00.000Z","updatedAt":"2026-11-04T12:00:00.000Z","completedAt":null,"error":null,"targets":[{"hostname":"example.links.luximio.app","state":"pending"}]}}}}},"400":{"description":"validation_failed: invalid key, malformed If-Match, nonempty or invalid body, or query parameters.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"account_restricted: current product publication rules require billing attention.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, plan_limit_reached, cross_origin_forbidden, or project authority withdrawn.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"idempotency_conflict, publication_in_progress, protected_configuration, state_conflict, or terms_acceptance_required.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"operation_expired: the original operation's detailed result was scrubbed. It will not execute again.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"412":{"description":"revision_mismatch: use a fresh resource ETag for a new logical publication.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"request_too_large: the actual body exceeds 16,384 bytes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"unsupported_media_type: a nonempty body must be application/json.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"428":{"description":"precondition_required: If-Match is required.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"publication_unavailable, API disabled/read-only, maintenance, or temporary dependency failure.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/operations/{operationId}":{"get":{"operationId":"getPublicationOperation","summary":"Read an owned publication operation without resuming it","description":"Requires the original operation's publication scope: configuration:publish for configuration_publish; links:publish for link_publish, link_disable and link_archive. No general read grant is required. Project and minimal operation ownership are checked before scope selection, and scope is checked before detailed or expired results. This is a pure read even when publisher flags are off; it never retries, acquires a lease or calls the resolver. Detailed results retain no raw request payloads or provider errors.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:publish","configuration:publish"],"x-scope-selection":"operation.type","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Current safe operation metadata.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"},"example":{"operation":{"id":"operation_example","projectId":"project_example","type":"link_publish","resourceId":"link_example","state":"pending","sourceRevision":1,"generation":1,"createdAt":"2026-11-04T12:00:00.000Z","updatedAt":"2026-11-04T12:00:00.000Z","completedAt":null,"error":null,"targets":[{"hostname":"example.links.luximio.app","state":"pending"}]}}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"operation_expired: detailed results were scrubbed; no publication is resumed. Correct original scope is required before this response.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"getPublicationOperationHeaders","summary":"Read an owned publication operation without resuming it","description":"Requires the original operation's publication scope: configuration:publish for configuration_publish; links:publish for link_publish, link_disable and link_archive. No general read grant is required. Project and minimal operation ownership are checked before scope selection, and scope is checked before detailed or expired results. This is a pure read even when publisher flags are off; it never retries, acquires a lease or calls the resolver. Detailed results retain no raw request payloads or provider errors.","security":[{"ProjectBearer":[]}],"x-required-scopes":["links:publish","configuration:publish"],"x-scope-selection":"operation.type","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Current safe operation metadata.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"410":{"description":"operation_expired: detailed results were scrubbed; no publication is resumed. Correct original scope is required before this response.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"Customer API disabled, under maintenance, or temporarily unavailable. See error.code and Retry-After.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}}},"/projects/{projectId}/links/{linkId}/diagnostics":{"get":{"operationId":"runProjectLinkDiagnostics","summary":"Run bounded server-side link checks","description":"Requires diagnostics:run, the shared project inspection budget and the narrower diagnostics budget. Runs resolver, link, configured platform association and private activity probes without creating a click. Absent platforms are explicitly skipped. A 200 response contains each check's result even when probes fail; stable codes combine check id and status. The report excludes raw recent activity and never establishes device verification. Publication flags may remain off.","security":[{"ProjectBearer":[]}],"x-required-scopes":["diagnostics:run"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-side diagnostic results; deviceVerification is always not_checked.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnosticsResponse"},"example":{"diagnostics":{"linkId":"link_example","path":"product","publicUrl":"https://example.links.luximio.app/product","checkedAt":"2026-11-04T12:00:00.000Z","summary":"warning","destination":null,"deviceVerification":"not_checked","checks":[{"id":"link","label":"Link record","status":"warning","detail":"Draft link has not been published.","code":"link_warning"}]}}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"diagnostics_unavailable: publishing configuration or diagnostics dependencies are unavailable; or API access is disabled.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"runProjectLinkDiagnosticHeaders","summary":"Run bounded server-side link checks","description":"Requires diagnostics:run, the shared project inspection budget and the narrower diagnostics budget. Runs resolver, link, configured platform association and private activity probes without creating a click. Absent platforms are explicitly skipped. A 200 response contains each check's result even when probes fail; stable codes combine check id and status. The report excludes raw recent activity and never establishes device verification. Publication flags may remain off.","security":[{"ProjectBearer":[]}],"x-required-scopes":["diagnostics:run"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"},"description":"Exact project authorized by the credential."},{"name":"linkId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Server-side diagnostic results; deviceVerification is always not_checked.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"400":{"description":"validation_failed: unsupported/duplicate query parameters, invalid limit or cursor.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"401":{"description":"invalid_credential: missing, malformed, expired, revoked or otherwise invalid bearer credential.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"insufficient_scope, cross_origin_forbidden, or forbidden after project authority changes.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"404":{"description":"resource_not_found: resource absent or outside the credential's project. Archived links are not exposed.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"405":{"description":"method_not_allowed: this method is not supported by the resource.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"429":{"description":"rate_limited: project or invalid-auth request protection; Retry-After is in seconds.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}},"500":{"description":"internal_error: sanitized failure; use X-Request-Id for support.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}}}},"503":{"description":"diagnostics_unavailable: publishing configuration or diagnostics dependencies are unavailable; or API access is disabled.","headers":{"X-Request-Id":{"description":"Server-generated request identifier. Caller-provided IDs are ignored.","schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"schema":{"type":"string"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"Read this public OpenAPI contract","security":[],"responses":{"200":{"description":"Public OpenAPI 3.1.1 JSON; no customer state or cookies.","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Contract unchanged."}}},"head":{"operationId":"getOpenApiHeaders","summary":"Inspect public contract headers","security":[],"responses":{"200":{"description":"Public contract headers."},"304":{"description":"Contract unchanged."}}}}},"components":{"securitySchemes":{"ProjectBearer":{"type":"http","scheme":"bearer","bearerFormat":"opaque","description":"Owner-issued, project-scoped credential. Send Authorization: Bearer <credential>. Keep it in a server/agent secret store; never put it in a URL or mobile app. Scopes are listed by x-required-scopes. Browser cross-origin resource access is unsupported."}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"primaryDomain":{"type":["string","null"]},"createdAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"updatedAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."}},"required":["id","name","slug","primaryDomain","createdAt","updatedAt"],"additionalProperties":false},"DnsRecord":{"type":"object","properties":{"type":{"type":"string","enum":["TXT","CNAME"]},"name":{"type":"string"},"value":{"type":"string"}},"required":["type","name","value"],"additionalProperties":false},"Domain":{"type":"object","properties":{"id":{"type":"string"},"hostname":{"type":"string"},"type":{"type":"string","enum":["managed","custom"]},"isPrimary":{"type":"boolean"},"verificationStatus":{"type":"string","enum":["pending","verified"]},"deliveryStatus":{"type":"string","enum":["pending","active","failed"]},"dnsRecords":{"type":"array","items":{"$ref":"#/components/schemas/DnsRecord"}},"createdAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"updatedAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."}},"required":["id","hostname","type","isPrimary","verificationStatus","deliveryStatus","dnsRecords","createdAt","updatedAt"],"additionalProperties":false},"Configuration":{"type":"object","properties":{"projectId":{"type":"string"},"iosTeamId":{"type":"string"},"iosBundleId":{"type":"string"},"androidPackageName":{"type":"string"},"androidSha256CertFingerprints":{"type":"array","items":{"type":"string"}},"revision":{"type":"integer","minimum":1},"publishedRevision":{"type":["integer","null"],"minimum":1},"hasUnpublishedChanges":{"type":"boolean"},"updatedAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"publishedAt":{"type":["string","null"]}},"required":["projectId","iosTeamId","iosBundleId","androidPackageName","androidSha256CertFingerprints","revision","publishedRevision","hasUnpublishedChanges","updatedAt","publishedAt"],"additionalProperties":false},"ConfigurationInput":{"type":"object","properties":{"iosTeamId":{"type":"string","description":"10-character Apple Team ID, trimmed and uppercased. A disabled iOS group has both strings empty."},"iosBundleId":{"type":"string","description":"Apple bundle ID. Supply both iOS fields together, or omit the entire group."},"androidPackageName":{"type":"string","description":"Android package name. Supply the complete Android group, or omit it entirely."},"androidSha256CertFingerprints":{"type":"array","maxItems":20,"items":{"type":"string"},"description":"1–20 colon-delimited SHA-256 signing fingerprints for an enabled Android app. Values are uppercased and deduplicated. A disabled group has an empty package and array."}},"required":[],"additionalProperties":false,"allOf":[{"anyOf":[{"not":{"anyOf":[{"required":["iosTeamId"]},{"required":["iosBundleId"]}]}},{"required":["iosTeamId","iosBundleId"],"properties":{"iosTeamId":{"type":"string","pattern":"\\S"},"iosBundleId":{"type":"string","pattern":"\\S"}}},{"required":["iosTeamId","iosBundleId"],"properties":{"iosTeamId":{"pattern":"^\\s*$"},"iosBundleId":{"pattern":"^\\s*$"}}}]},{"anyOf":[{"not":{"anyOf":[{"required":["androidPackageName"]},{"required":["androidSha256CertFingerprints"]}]}},{"required":["androidPackageName","androidSha256CertFingerprints"],"properties":{"androidPackageName":{"type":"string","pattern":"\\S"},"androidSha256CertFingerprints":{"type":"array","minItems":1}}},{"required":["androidPackageName","androidSha256CertFingerprints"],"properties":{"androidPackageName":{"pattern":"^\\s*$"},"androidSha256CertFingerprints":{"maxItems":0}}}]}],"anyOf":[{"required":["iosTeamId","iosBundleId"],"properties":{"iosTeamId":{"type":"string","pattern":"\\S"},"iosBundleId":{"type":"string","pattern":"\\S"}}},{"required":["androidPackageName","androidSha256CertFingerprints"],"properties":{"androidPackageName":{"type":"string","pattern":"\\S"},"androidSha256CertFingerprints":{"type":"array","minItems":1}}}],"description":"Full replacement of direct app identities. At least one complete platform is required. Omission of an entire platform disables it; half-specified groups and protected/server-owned fields are rejected. Identity syntax is validated after normalization."},"AppDestination":{"type":"object","properties":{"route":{"type":"string","maxLength":200},"data":{"type":"object","additionalProperties":true}},"required":["route","data"],"additionalProperties":false},"LinkInput":{"type":"object","properties":{"title":{"type":"string","description":"Trimmed display name, 1–100 characters."},"path":{"type":"string","description":"Normalized link path, at most 200 characters. Outer slashes are removed; api, api/*, healthz and .well-known paths are reserved. A previously published path cannot change."},"webFallbackUrl":{"type":"string","description":"Complete HTTP or HTTPS URL, at most 2,000 characters after trimming."},"iosFallbackUrl":{"type":["string","null"],"description":"HTTPS URL without embedded credentials, at most 2,000 normalized characters. Omission, null, or an empty string clears it."},"androidFallbackUrl":{"type":["string","null"],"description":"HTTPS URL without embedded credentials, at most 2,000 normalized characters. Omission, null, or an empty string clears it."},"appDestination":{"anyOf":[{"$ref":"#/components/schemas/AppDestination"},{"type":"null"}],"description":"Omission or null clears the app destination. A destination fits within 4,096 UTF-8 bytes; data has at most 6 levels and 256 values, with reserved object keys rejected."}},"required":["title","path","webFallbackUrl"],"additionalProperties":false},"Link":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"hostname":{"type":"string"},"path":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"webFallbackUrl":{"type":"string"},"iosFallbackUrl":{"type":["string","null"]},"androidFallbackUrl":{"type":["string","null"]},"appDestination":{"anyOf":[{"$ref":"#/components/schemas/AppDestination"},{"type":"null"}]},"status":{"type":"string","enum":["draft","published","disabled"]},"createdAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"revision":{"type":"integer","minimum":1},"publishedRevision":{"type":["integer","null"],"minimum":1},"hasUnpublishedChanges":{"type":"boolean"},"updatedAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"publishedAt":{"type":["string","null"]}},"required":["id","projectId","hostname","path","url","title","webFallbackUrl","iosFallbackUrl","androidFallbackUrl","appDestination","status","createdAt","revision","publishedRevision","hasUnpublishedChanges","updatedAt","publishedAt"],"additionalProperties":false},"Pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"]}},"required":["limit","hasMore","nextCursor"],"additionalProperties":false},"ProjectResponse":{"type":"object","properties":{"project":{"$ref":"#/components/schemas/Project"}},"required":["project"],"additionalProperties":false},"DomainsResponse":{"type":"object","properties":{"domains":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Domain"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["domains","pagination"],"additionalProperties":false},"ConfigurationResponse":{"type":"object","properties":{"configuration":{"$ref":"#/components/schemas/Configuration"}},"required":["configuration"],"additionalProperties":false},"LinksResponse":{"type":"object","properties":{"links":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Link"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["links","pagination"],"additionalProperties":false},"LinkResponse":{"type":"object","properties":{"link":{"$ref":"#/components/schemas/Link"}},"required":["link"],"additionalProperties":false},"PublicationInput":{"type":"object","properties":{},"required":[],"additionalProperties":false},"OperationTarget":{"type":"object","properties":{"hostname":{"type":"string"},"state":{"type":"string","enum":["pending","applied","compatibility_pending"]}},"required":["hostname","state"],"additionalProperties":false},"PublicationOperation":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"type":{"type":"string","enum":["link_publish","configuration_publish","link_disable","link_archive"]},"resourceId":{"type":"string"},"state":{"type":"string","enum":["pending","applying","reconciling","succeeded","failed","superseded","cancelled"]},"sourceRevision":{"type":"integer","minimum":1},"generation":{"type":"integer","minimum":1},"createdAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"updatedAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"completedAt":{"type":["string","null"]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]},"targets":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/OperationTarget"}}},"required":["id","projectId","type","resourceId","state","sourceRevision","generation","createdAt","updatedAt","completedAt","error","targets"],"additionalProperties":false},"OperationResponse":{"type":"object","properties":{"operation":{"$ref":"#/components/schemas/PublicationOperation"}},"required":["operation"],"additionalProperties":false},"DiagnosticCheck":{"type":"object","properties":{"id":{"type":"string","enum":["resolver","link","ios","android","activity"]},"label":{"type":"string"},"status":{"type":"string","enum":["passed","warning","failed","skipped"]},"detail":{"type":"string"},"code":{"type":"string","pattern":"^(resolver|link|ios|android|activity)_(passed|warning|failed|skipped)$"}},"required":["id","label","status","detail","code"],"additionalProperties":false},"DiagnosticsReport":{"type":"object","properties":{"linkId":{"type":"string"},"path":{"type":"string"},"publicUrl":{"type":"string"},"checkedAt":{"type":"string","description":"Stored UTC creation/update time; ISO 8601 or SQLite UTC timestamp."},"summary":{"type":"string","enum":["passed","warning","failed"]},"destination":{"type":["string","null"]},"checks":{"type":"array","maxItems":5,"items":{"$ref":"#/components/schemas/DiagnosticCheck"}},"deviceVerification":{"type":"string","const":"not_checked","description":"Only server-side probes ran. No installed-app, signing, OS-cache or device routing behavior was verified."}},"required":["linkId","path","publicUrl","checkedAt","summary","destination","checks","deviceVerification"],"additionalProperties":false},"DiagnosticsResponse":{"type":"object","properties":{"diagnostics":{"$ref":"#/components/schemas/DiagnosticsReport"}},"required":["diagnostics"],"additionalProperties":false},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"retryable":{"type":"boolean"},"fields":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"webFallbackUrl":{"type":"string"},"iosFallbackUrl":{"type":"string"},"androidFallbackUrl":{"type":"string"},"appDestination":{"type":"string"},"iosTeamId":{"type":"string"},"iosBundleId":{"type":"string"},"androidPackageName":{"type":"string"},"androidSha256CertFingerprints":{"type":"string"}},"required":[],"additionalProperties":false}},"required":["code","message","requestId","retryable"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}